· トラブル対処 · 約8分

V2Rayのログの見方|よくあるエラーの意味と原因の特定方法

クライアントログの開き方とログレベルの変更方法を解説。ハンドシェイク失敗、接続タイムアウト、ポート競合、時刻ずれなどの原因を読み解き、段階的に切り分けます。

この記事の概要

コアの起動に失敗する、プロキシを有効にするとタイムアウトする、特定のサイトだけ開けないといった場合に役立ちます。まず失敗したリクエストのログを取得し、ローカルの待ち受け、ルーティング、ノードの名前解決、リモート接続、プロトコルのハンドシェイクの順に確認しましょう。設定は一度に一つだけ変更し、同じURLで再テストしてください。たまたま復旧しただけなのに、解決したと判断するのを防げます。

クライアントログを開き、失敗時の記録を取る

クライアントログとコアログでは、確認できる内容が異なります。前者ではサブスクリプションの取得や設定の読み込み状況、後者ではローカルポート、外向き接続、ハンドシェイクの問題を確認できます。サブスクリプションの更新に成功しても、そのURLにアクセスできたというだけで、登録されたノードすべてに接続できるとは限りません。

  1. ログを開く

    デスクトップ版は v2rayN 7.x を例に、メイン画面を開き、ノード一覧の下にある情報欄を確認します。Android では v2rayNG または v2flyNG を開き、左上の「☰」から「ログ」を選択します(ビルドによっては「Logcat」と表示)。クライアントのバージョンと、ログの起動行に表示されたコアのバージョンを記録してください。v2rayNG は Xray、v2flyNG は V2Fly コアを使用するため、エラーの表現は異なる場合があります。

  2. ログレベルを info にする

    v2rayN では「設定」→「パラメーター設定」から Core の基本設定を開き、「ログレベル」を探します。Android では「☰」→「設定」からログレベルの項目を確認してください。画面の項目名はビルドによって異なる場合があります。まず info を選択して保存し、接続を再起動します。情報が足りない場合に限り、一時的に debug に変更してください。項目が見つからない場合は、現在のログで切り分けます。

  3. 問題を再現する

    接続ボタンを押した時刻を記録し、コアの起動後、同じアプリで問題のURLを一度だけ開きます。速度テストやサブスクリプションの更新、ノードの切り替えは同時に行わないでください。ページを開く前にエラーが出た場合は、起動時のログを保存し、追加のリクエストは送らなくてかまいません。

  4. 前後のログも保存する

    エラー行の前後をそれぞれ5行ほどコピーします。ログに接続IDがある場合は、同じIDの記録だけをつなげて確認し、バックグラウンドアプリのエラーと今回のテストを混同しないようにします。調査後はログレベルを元に戻してください。共有する前に、サブスクリプションURL、アカウント情報、ノードのアドレス、アクセス先のドメインを伏せます。

どの段階で失敗したかを特定する

アプリからのリクエストローカル入口ルーティング判定外向き接続プロトコルのハンドシェイク

まずリクエストがコアに届いているかを確認し、次にどの外向き接続が選ばれたかを見ます。ログの accepted は通常、コアがリクエストを受け取ったことを示すだけです。その後に直接接続が選ばれている場合、ノードとのハンドシェイクは記録されません。リクエストの記録がない場合は、現在のログレベルで接続が記録されるかを確認し、システムプロキシ、TUN、Androidのアプリ別ルーティング対象を調べてください。

よくあるエラーのログ例・意味・対処法

以下は検索に使えるエラーの一部で、特定バージョンのログ全文ではありません。OS、コアのバージョン、通信方式によって、前後の表示は異なる場合があります。

bind: address already in use

原因:コアが待ち受けようとしているアドレスとポートが、すでに使用されています。対処法:ポートを使用しているアプリを確認し、重複起動したプロセスを終了するか、空いていることを確認したポートに変更します。プロキシポートを手動設定しているアプリがあれば、その設定も更新してください。

connect: connection refused

原因:接続が明示的に拒否されています。接続先ポートで待ち受けていない場合によく発生します。対処法:接続先が 127.0.0.1 なら、コアが起動しているか、アプリに設定したポートが正しいかを確認します。ノードのアドレスなら、サブスクリプションに記載されたポートを確認し、提供元にサーバーの稼働状況を問い合わせてください。

i/o timeout

原因:ネットワークの読み書きや接続処理が、制限時間内に完了しませんでした。このエラーだけでは、ノードに到達できないとは断定できません。対処法:同じログ行にある lookup、dial tcp、読み書きのタイムアウトのどれかを確認します。ノードは変えず、接続できることが分かっている別のネットワークで再テストしてください。

no such host

原因:今回のドメイン検索で、有効なレコードを取得できませんでした。対処法:失敗したドメインを確認します。ノードのドメインなら、サブスクリプションに記載された文字列と照合してください。アクセス先のドメインなら、システム、コア、リモートのどこで名前解決する設定かを確認し、該当するDNS設定を調べます。

remote error: tls: handshake failure

原因:接続先が TLS ハンドシェイクを拒否しました。このログだけでは拒否の具体的な理由は分かりません。対処法:サブスクリプションに記載されたノードのポート、通信方式、TLSの有効・無効、サーバー名を確認します。それでも失敗する場合は、ハンドシェイクの時刻と個人情報を伏せたログをノードの提供元に送って確認してください。

x509: certificate has expired or is not yet valid

原因:端末の時刻を基準にすると、証明書が有効期間外です。システム時刻がずれているか、証明書の期限が実際に切れている可能性があります。対処法:まずシステム時刻を同期します。時刻が正しいのに失敗する場合は、提供元に証明書の確認を依頼してください。証明書の検証は無効にしないでください。

ローカルポートとシステム時刻を確認する

ログにコアが 127.0.0.1:10808 で待ち受けようとしたものの、バインドに失敗したと表示された場合を考えます。Windows の PowerShell で、そのポートを待ち受けているプロセスを調べます。10808 は例なので、実際にはログにあるポートに置き換えてください。エラーが UDP に関するものなら、この TCP 用の確認だけではポート競合を否定できません。

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

タスクマネージャーの「詳細」タブで、OwningProcess が返したプロセスIDからプログラムを特定します。正体の分からないプロセスをそのまま終了しないでください。ポートを変更する場合は、空いていると確認した 10818 などを設定し、保存後にコアを再起動して、アプリに設定したプロキシの種類とポートも確認します。HTTPとSOCKSの入口が分かれている場合は、それぞれ正しく対応させてください。ポートが待ち受け中でも、両方の入口を相互に使えるとは限りません。

障害の範囲に合わせて再テストする

ログにリクエストの受信が記録されているのに、ウェブページが開かないのはなぜ?

同じリクエストの後続ログを確認し、選択された外向き接続を探します。直接接続になっていて、本来はプロキシ経由のはずなら、現在のルーティングモードと適用されたルールを確認してください。プロキシ経由なら、該当する接続やハンドシェイクのエラーを調べます。同じURLで再テストし、ルーティングモードとノードを同時に変更しないでください。

一つのノードだけタイムアウトする場合、クライアントを再インストールすべき?

まず再インストールは不要です。端末、ネットワーク、URL、ルーティングモードはそのままにして、同じプロトコルの正常なノードに一つだけ切り替えます。比較用のノードで接続できるなら、問題のノードのアドレス、ポート、通信設定を優先して確認します。どちらもタイムアウトする場合は、現在のネットワークとローカル設定を調べてください。

デスクトップでは使えるのに、スマートフォンでは接続後のアクセスログがないのはなぜ?

まず、Android で現在のクライアントのVPN接続が許可されていることと、別のVPNが同時に動作していないことを確認します。アプリごとのプロキシ設定を有効にしている場合は、テストに使うブラウザーが対象外になっていないか、プロキシ対象のリストに追加されているかを確認してください。再テストでは同じノードを使い、アプリの通信が捕捉されない問題とノードの障害を混同しないようにします。

サブスクリプションを更新した直後にエラーが出た場合、どのログを確認すべき?

まず、サブスクリプションの取得や解析に明確なエラーが出ていないか確認します。更新に成功している場合は、新しいグループのノードが現在有効になっていることを確かめ、いったん切断して再接続し、コアの起動ログを確認してください。コアは起動するのに新しいノードだけハンドシェイクに失敗する場合は、更新前後の通信方式とTLS設定を一つずつ比較します。以前の設定を一式そのまま戻さないでください。

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