TURN NAT 越え検証 — テスト結果ログ

実施日: 2026-06-27
担当: ashigaru6 (subtask_023_batch3_002)
API: http://localhost:3402（TURN 環境変数あり）
Web: http://localhost:5175（Vite dev + API プロキシ）

Step 1: STUN のみ（LAN）— batch3_001 参照

デフォルト stun:stun.l.google.com:19302 で LAN 内転送は batch3_001 手順で検証済み（本タスクでは再確認のみ）

Step 2–3: TURN 環境変数 + API 起動

# apps/api/.env
STUN_URLS=stun:stun.l.google.com:19302
TURN_URLS=turn:openrelay.metered.ca:443?transport=tcp
TURN_USERNAME=openrelayproject
TURN_CREDENTIAL=openrelayproject

API_LISTEN_ADDR=0.0.0.0:3402 API_BOARD_ADDR=0.0.0.0:3403 cargo run --bin api

Step 4: GET /v1/config/ice-servers

{
  "iceServers": [
    { "urls": "stun:stun.l.google.com:19302" },
    {
      "urls": "turn:openrelay.metered.ca:443?transport=tcp",
      "username": "openrelayproject",
      "credential": "openrelayproject"
    }
  ]
}

結果: ✅ TURN が iceServers に含まれる

Step 5: ファイル転送（TURN 設定有効・LAN 環境）

項目	結果
ユーザー A/B ログイン	✅ turn_a@test.local / turn_b@test.local
/share → 合言葉生成	✅
/receive → 受信・結合	✅
進捗バー	✅ 1/1 完了
filehash 照合	✅ SHA-256 一致（緑表示）
送信側完了表示	✅ 「送信が完了しました」

自動検証: node scripts/turn-e2e-test.mjs（Playwright）

補足

LAN 同一ホスト検証のため ICE は host/srflx で確立される可能性が高い（TURN relay 候補 0 でも転送成功）
TURN 設定は API 経由でフロントに正しく配信されることを確認
本番 NAT 越えでは Metered ダッシュボード取得の認証情報を推奨（docs/TURN_SETUP.md 参照）
開発時 WebSocket プロキシに ws: true を追加（vite.config.ts）

既知の問題

なし（本検証スコープ内）