v2rayNのログの見方|よくあるエラーの意味と原因の調べ方

ログレベルの設定から、connection refused、i/o timeout、TLSハンドシェイク失敗などの原因と、確認する順番を解説します。

この記事の要点

Windows版 v2rayNを使っていて、コアの起動に失敗する、またはWebページがタイムアウトする方に向けた内容です。1回のリクエストを再現してログと症状を照らし合わせ、ローカルの待ち受け、ノードへの接続、名前解決、TLS検証のどこで問題が起きているか確認します。設定は一度に1つだけ変更し、同じリクエストで効果を確かめましょう。

ログレベルの設定:障害を1回だけ再現する

v2rayNの画面に表示されるメッセージには、クライアント由来のものと、実行中のコア由来のものがあります。サブスクリプションの取得、設定の生成、コアによる通信転送はそれぞれ別の処理です。サブスクリプションの更新時にタイムアウトしても、インポート済みノードへの接続に失敗しているとは限りません。ここではWindows版 v2rayN 7.xとXrayを例に説明します。ビルドによって項目の配置が異なる場合があるため、まず実行中のコアを確認し、ログレベルの設定が該当するか判断してください。

  1. 診断ログを有効にする

    「設定」→「パラメータ設定」→「Core: 基本設定」を開き、「ログレベル」を一時的にinfoに設定します。同じ画面にログの有効・無効を切り替える項目があれば、有効になっていることも確認してください。保存後、新しいコア起動メッセージが表示されるか確認します。現在のログだけでは情報が足りない場合に限り、短時間だけdebugに切り替えます。

  2. テスト条件を固定する

    現在のノードとルーティングモードは変えず、テストした時刻を記録します。Windowsのシステムプロキシを調べる場合は、タスクトレイの「システムプロキシ」から「システムプロキシを自動設定」を選び、システムプロキシ設定に従うブラウザーで、以前開けなかったURLにアクセスします。元の障害がTUNモードで発生した場合は、まず同じモードで再現してください。プロキシの接続方式を同時に切り替えないようにします。

  3. 最初のエラーを記録する

    メインウィンドウのメッセージ欄で、テスト時刻の前後にあるログを探します。まず起動結果を保存し、続けて今回のリクエストで最初に出た具体的なエラーと、その前後数行を記録してください。エラーが対象としているアドレス、ポート、処理も控えます。最後に表示された再試行失敗の行だけをコピーしないでください。

  4. ログレベルを元に戻す

    テスト後はログレベルを元に戻し、アクセス先が長時間記録されないようにします。ログを共有する際は、サブスクリプションURL、ユーザーID、トークン、ノードのアドレス、実際にアクセスしたドメインを隠してください。どの通信区間で失敗したか判断できるよう、ポートの種類とエラーの文言は残します。

ローカルポート:リクエストがコアに届いているか確認

クライアントのウィンドウが開いていても、ローカルプロキシが待ち受けているとは限りません。「設定」→「パラメータ設定」で「ローカルリスニングポート」を確認し、Windowsのシステムプロキシに設定されたアドレスとポートを照合してください。以下の数値はログの読み方を示す例であり、すべての環境で同じとは限りません。

127.0.0.1
IPv4ループバックアドレス:リクエストはまだローカル
10808
ローカル待ち受けポートの例:実際の設定を確認してください
443
リモートTLSポートの例:ノードの設定を確認してください

ポイント:まずアドレス、次にエラーを確認

connection refusedが表示されたら、まずエラー行のアドレスを確認します。接続先が127.0.0.1:10808なら、ローカルの待ち受けを調べます。接続先がノードのアドレスとポートなら、Windowsのシステムプロキシのポートを変更しても、このリモート側の拒否は解決しません。

PowerShellでローカルの待ち受け状態を確認できます。コマンド内の10808は実際のポートに置き換えてください。この確認ではリモートへの接続は行いません。

Get-NetTCPConnection -State Listen -LocalPort 10808 |
  Select-Object LocalAddress, LocalPort, OwningProcess

よくあるエラー:拒否・タイムアウト・TLS検証を見分ける

同じエラー文でも、発生する段階は異なります。エラー行の前後にある処理とアドレスを手がかりに判断してください。外側の失敗メッセージしか見えない場合は、すぐにプロトコルを変更せず、同じリクエストの内側にあるエラーを確認します。

エラー:bind: address already in use

原因:ローカルポートをバインドできません。別のプロセスや別のインスタンスがすでに待ち受けている場合によく発生します。Windowsでは、OS固有のソケットエラーとして表示されることもあります。

対処:ポートからPIDを調べ、使用していないことを確認できた重複インスタンスを終了します。または未使用のポートに変更し、手動設定したプロキシの接続先も合わせて変更してください。

エラー:connection refused

原因:接続先から拒否応答を受け取っています。接続先が待ち受けていない場合のほか、通信経路上の機器が拒否している場合もあります。

対処:接続先がローカルアドレスなら、待ち受けているプロセスを確認します。ノードのアドレスなら、インポートしたポートを確認し、サーバーの管理者に該当する受信設定が待ち受けているか問い合わせてください。

エラー:i/o timeout

原因:処理が制限時間内に完了しませんでした。dial tcpの後に発生する接続時のタイムアウトと、接続確立後のread tcpのタイムアウトは、異なる段階で発生します。

対処:接続時のタイムアウトなら、ノードのアドレスとポートを確認します。読み取り時のタイムアウトなら、ハンドシェイクと最初の読み取りエラーを記録し、同じネットワークで動作確認済みの別ノードと比較してください。

エラー:no such host

原因:現在の名前解決経路で必要なホスト名を解決できていません。ノードのドメイン名、またはアクセス先のドメイン名が原因の可能性があります。

対処:まずlookupの対象になっている名前を書き留め、スペルを確認します。次に、OS側の名前解決とコア側のDNSを切り分けてください。OSで名前解決できても、コアが使うDNSで解決できるとは限りません。

エラー:x509: certificate has expired or is not yet valid

原因:通常のTLS証明書検証で、証明書が現在の有効期間外と判定されています。PCの時計がずれている場合にも発生します。

対処:Windowsの「設定」→「時刻と言語」→「日付と時刻」で時刻を同期します。それでも失敗する場合は、サーバーの管理者に証明書と証明書チェーンの有効期間を確認してもらってください。

ハンドシェイクとルーティング:TCP接続だけではWebページは表示できない

ノードのポートに到達できることは、トランスポート層で通信できる可能性を示すだけです。通常のTLSを使うノードでは、その後にサーバー名と証明書の検証が必要です。ハンドシェイクに成功した後も、リクエストが想定した出力先にルーティングされているか確認してください。エラーを消すために証明書検証を無効にしたり、通常のTLS証明書の確認手順をそのままREALITYの設定に当てはめたりしないでください。

  1. まずセキュリティ方式を確認します。現在のノードの編集画面を開き、信頼できる情報源の元設定と、通信方式およびセキュリティ方式を照合してください。通常のTLSで、証明書の有効な名前とリクエスト名が一致しないというエラーが出る場合は、サーバー名(SNI)と証明書の対象ドメインを確認します。接続先のアドレスを名前解決できても、そのアドレスが設定すべきサーバー名とは限りません。
  2. 次に実際の出力先を確認します。同じリクエストのログから、ルーティングまたは出力先の情報を探してください。対象ドメインが実際には直接接続されている場合は、ノードを何度も切り替えるのではなく、v2rayNで選択中の「ルーティング」ルールと適用順序を確認します。acceptedはコアがリクエストを受け取ったことを示すだけで、接続先のWebサイトから応答があったことを意味しません。
  3. 最後に比較して原因を絞り込みます。同じ接続先へのアクセスが2つのノードで失敗したら、別のテスト先でも試します。1つのドメインだけで失敗する場合は、名前解決とルーティングを優先して確認してください。ノードを変えずにネットワークを切り替える場合は、テスト先を同じにして結果を記録し、ネットワークの変更を設定修正の効果と取り違えないようにします。

ログのトラブルシューティング:よくある質問

速度測定では数値が出るのに、ブラウザーでページを開けないのはなぜ?

速度測定とブラウザーでは、同じ接続経路や接続先を使うとは限りません。ブラウザーを更新した時刻を記録し、コアがそのリクエストを受信したことを確認してから、出力先のログを読みます。受信記録がなければ、まずシステムプロキシとブラウザーのプロキシ設定を確認してください。

最後の行に利用可能な接続先がないとあります。どの行を確認すればよいですか?

failed to find an available destinationは、複数回の接続試行が失敗した後に表示されるまとめのエラーで、名前解決の失敗だけを指すわけではありません。同じリクエストをさかのぼり、lookup、dial、証明書エラーを探してください。複数のログが混在する場合は、ほかのテスト用ページを閉じてから1回だけ再現します。

デバッグログを有効にしてもWebのリクエストが表示されないのはなぜ?

ログレベルを変更した後、コアが正常に起動していることを確認してから、システムプロキシを明示的に使うアプリでテストします。システムプロキシモードではリクエストが見え、元のTUNモードでは見えない場合は、それぞれの接続方式の設定を個別に確認してください。異なる方式のログを同じテストの記録として扱わないようにします。

サーバー管理者に送るログには何を残せばよいですか?

v2rayNのバージョン情報からクライアントの完全なバージョン番号を記録し、起動メッセージからコアの名前とバージョンを控えます。さらに、動作モード、再現した時刻、個人情報を伏せた最初の具体的なエラーを添えてください。同じノードでネットワークを変えた結果と、同じネットワークでノードを変えた結果も伝えます。実施していない比較は未実施と明記してください。

V2Rayクライアントをダウンロード