Tactic Remote

接続・遅延診断

接続と遅延の問題を段階的に診断するガイド。

問題が発生した時、無作為な再試行は時間の無駄です。以下の手順で問題を切り分けてください。

ステップ 1: 症状を分類

症状想定される原因
まったく接続できないネットワークまたはエンドポイントの設定ミス
接続はできるがターミナルが遅いネットワーク遅延または Mac の負荷
接続はできるが出力が古いセッション状態の問題
通知が届かないHook 配信または iOS の権限

ステップ 2: サーバーを確認

Mac でサーバーがリッスンしていることを確認:

lsof -nP -iTCP:8765 -sTCP:LISTEN

node プロセスが表示されるはずです。何も表示されなければサーバーが起動していません。

Cloudflare Tunnel を使用している場合は、あわせて確認:

ps aux | grep cloudflared

ステップ 3: ネットワーク到達性をテスト

同一ネットワーク上の別のデバイス(または Mac 自身)から:

# ポートに到達できるかテスト
nc -zv <mac-ip> 8765
 
# トンネル使用時
curl -I https://your-tunnel-url.trycloudflare.com

ポートに到達できない場合は以下を確認:

  • Mac のファイアウォール設定
  • 正しいネットワークインターフェース(WiFi は en0、Ethernet は en1)
  • デバイスが同じサブネット上にあるか

ステップ 4: Mac のパフォーマンスを確認

接続はできるが動作が遅い場合:

# CPU とメモリ
top -l 1 -s 0 | head -10
 
# tmux セッション(多すぎないか確認)
tmux list-sessions

負荷の高い Mac はターミナル出力を遅延させ、ネットワーク問題のように見えます。

ステップ 5: セッションをリフレッシュ

出力が古い、またはターミナルが空白の場合:

  1. iPhone アプリでセッションセレクターを開く
  2. セッションを再選択
  3. tmux セッションに再アタッチし、出力がリフレッシュされる

セッションが存在しない場合(削除またはサーバー再起動後)は、新規作成。

ステップ 6: 通知の配信を確認

プッシュ通知が機能しない場合:

  1. iOS の権限: 設定 > Tactic Remote > 通知 > 許可
  2. Hook イベント: サーバーが受信しているか確認:
    curl -X POST http://localhost:8765/hook -d '{"type":"test"}'
  3. アプリバージョン: Mac アプリと iOS アプリの両方が最新バージョンであることを確認。

サポートに問い合わせる場合

上記で解決しない場合は、サポートに以下の情報を添えて問い合わせてください:

  • アプリバージョン(Mac と iOS)
  • 接続モード(ローカルまたはトンネル)
  • 試した手順
  • スクリーンショットまたはエラーメッセージ(API キーは除去)