接続・遅延診断
接続と遅延の問題を段階的に診断するガイド。
問題が発生した時、無作為な再試行は時間の無駄です。以下の手順で問題を切り分けてください。
ステップ 1: 症状を分類
| 症状 | 想定される原因 |
|---|---|
| まったく接続できない | ネットワークまたはエンドポイントの設定ミス |
| 接続はできるがターミナルが遅い | ネットワーク遅延または Mac の負荷 |
| 接続はできるが出力が古い | セッション状態の問題 |
| 通知が届かない | Hook 配信または iOS の権限 |
ステップ 2: サーバーを確認
Mac でサーバーがリッスンしていることを確認:
node プロセスが表示されるはずです。何も表示されなければサーバーが起動していません。
Cloudflare Tunnel を使用している場合は、あわせて確認:
ステップ 3: ネットワーク到達性をテスト
同一ネットワーク上の別のデバイス(または Mac 自身)から:
ポートに到達できない場合は以下を確認:
- Mac のファイアウォール設定
- 正しいネットワークインターフェース(WiFi は
en0、Ethernet はen1) - デバイスが同じサブネット上にあるか
ステップ 4: Mac のパフォーマンスを確認
接続はできるが動作が遅い場合:
負荷の高い Mac はターミナル出力を遅延させ、ネットワーク問題のように見えます。
ステップ 5: セッションをリフレッシュ
出力が古い、またはターミナルが空白の場合:
- iPhone アプリでセッションセレクターを開く
- セッションを再選択
- tmux セッションに再アタッチし、出力がリフレッシュされる
セッションが存在しない場合(削除またはサーバー再起動後)は、新規作成。
ステップ 6: 通知の配信を確認
プッシュ通知が機能しない場合:
- iOS の権限: 設定 > Tactic Remote > 通知 > 許可
- Hook イベント: サーバーが受信しているか確認:
- アプリバージョン: Mac アプリと iOS アプリの両方が最新バージョンであることを確認。
サポートに問い合わせる場合
上記で解決しない場合は、サポートに以下の情報を添えて問い合わせてください:
- アプリバージョン(Mac と iOS)
- 接続モード(ローカルまたはトンネル)
- 試した手順
- スクリーンショットまたはエラーメッセージ(API キーは除去)