コアの起動に失敗する、ノードがタイムアウトする、Webページが開かないといった問題に直面しているv2rayNユーザー向けです。WindowsでXrayコアを使う場合を例に、まず失敗時のログを記録します。エラーに含まれるアドレスや操作を手がかりに、ローカルの待ち受け、名前解決、リモート接続、TLSハンドシェイクのどこで失敗したかを切り分け、変更は一度に1項目だけにして再確認します。
実行ログを開き、失敗を記録する
まずv2rayNのメイン画面にあるログ欄を確認します。画面にはクライアントの操作メッセージとコアの出力が同時に表示されることがあります。サブスクリプションの更新失敗はリンクから情報を取得する処理、コアの接続失敗は個別のネットワーク接続を示します。ログが連続していても、同じリクエストとは限りません。
テスト条件をそろえる
現在のノード、ルーティング設定、接続方式は変えず、システムプロキシまたはTUNの状態を記録します。起動に失敗する場合は起動だけを再現し、Webページが開かない場合は、以前アクセスできたページを1つだけ再読み込みします。速度測定やサブスクリプション更新を同時に実行しないでください。
ログレベルを確認する
「設定」→「パラメータ設定」を開き、コアの基本設定でログレベルを確認します。Xrayの場合、まずは
warningで警告やエラーを確認し、接続処理の詳細を見る必要があればinfoに切り替えます。設定項目の場所はクライアントのバージョンによって異なるため、現在の接続で使われているコアを先に確認してください。設定を反映して再現する
設定を保存し、コアに設定が再読み込みされたことを確認してから、操作した時刻を記録してもう一度再現します。リクエストと失敗理由が含まれる同じ時間帯のログを数行抜き出してください。リクエストIDがある場合は同じIDの行を優先して照合し、バックグラウンド処理のエラーを今回の問題と取り違えないようにします。
重要な情報を記録する
失敗が
listen、lookup、dial、証明書検証のどの段階で起きたかを記録します。ログを共有する前に、サブスクリプションURL、ユーザー識別情報、実際のドメイン名やグローバルIPアドレスを伏せてください。一方で、ポート番号、エラーの文言、アドレスがローカルかリモートかは残します。
よくあるエラー:タイムアウト、接続拒否、ハンドシェイク失敗
以下は検索に使えるエラーの一部で、すべてのコアが同じ完全な文言を出力するとは限りません。1行に複数のエラーが連なっている場合は、具体的なアドレスや失敗した操作を含む内側の原因を見つけてから、外側のエラーがどのインバウンド、アウトバウンド、リクエストに関するものかを確認します。
エラー:i/o timeout
原因:ネットワーク操作が制限時間内に完了していません。リモートへの接続、データの読み込み、名前解決の待機などで発生します。
対処:同じ行にdial tcpとある場合は、記載されたアドレスをもとにノードのリモートホストとポートを確認し、TCP接続をテストします。lookupが含まれている場合は、まず名前解決の経路を調べてください。
エラー:no such host
原因:問い合わせ元が、そのホスト名を解決できませんでした。エラーになった名前が、ブラウザーでアクセスしているWebサイトとは限りません。
対処:lookupの後にある完全なホスト名とノード設定を確認し、システムの名前解決とコアが使うDNS経路を比較します。システム側で解決できたという理由だけで、コアの名前解決に問題がないと判断しないでください。
エラー:connection refused
原因:接続が拒否されています。接続先ポートで待ち受けているプロセスがない場合によく発生しますが、途中の機器が拒否している可能性もあります。
対処:接続先が127.0.0.1なら、アプリが使うポートとコアの待ち受けポートを確認します。リモート接続なら、サブスクリプションに記載されたポートを確認し、サービス提供元に待ち受け状態を問い合わせてください。
エラー:x509: certificate signed by unknown authority
原因:TLSの証明書検証まで進んでいますが、接続時に使われた信頼チェーンでは相手の証明書を検証できません。
対処:ログにあるTLSの接続先がノードかアクセス先のWebサイトかを確認し、証明書チェーンとPCの信頼設定を調べます。検証を無効にしてエラーを回避しないでください。
エラー:remote error: tls: handshake failure
原因:TLSハンドシェイク中にリモート側から失敗の通知が返されています。この一般的なエラーだけでは、どの設定が一致していないか特定できません。
対処:TLSを使うノードでは、サーバー側の設定に従ってトランスポート方式、TLSの有効・無効、サーバー名(SNI)を1項目ずつ照合します。必要に応じて、サービス提供元に同じ時刻のサーバーログを確認してもらってください。
ローカルポートの競合:待ち受けプロセスを確認してからポートを変更
コアの起動時にaddress already in use、またはWindowsのOnly one usage of each socket addressが表示された場合は、バインドに失敗したアドレスとポートを書き留めます。以下の2つのポートはログ内の違いを説明する例です。実際の調査では、自分の設定とエラー内容を確認してください。
判断のポイント:エラーが示す側だけを変更する
エラーがlisten tcp 127.0.0.1:10808なら、ローカルの待ち受けプロセスを調べます。サブスクリプションにあるリモートポートは変更しません。リモートの443へのdial tcpがタイムアウトする場合も、ローカルポートを変えてもリモートには接続できるようになりません。
Windows PowerShellでTCPの待ち受けプロセスを確認します。1行目の数値を、ログでバインドに失敗したポートに置き換えてください。ログにUDPと明記されている場合は、Get-NetUDPEndpoint -LocalPort $portで該当するエンドポイントを確認します。
$port = 10808
Get-NetTCPConnection -LocalPort $port -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess
OwningProcessの値を、タスクマネージャーの「詳細」タブにあるPIDと照合します。待ち受けアドレスが0.0.0.0の場合も、コアがバインドしようとしているローカルアドレスと競合していないか確認してください。- クライアントが重複して起動していると確認できたら、不要なインスタンスをタスクトレイから通常の手順で終了します。引き続き必要なプログラムがポートを使っている場合は、v2rayNの「設定」→「パラメータ設定」で該当するローカル待ち受けポートを変更し、そのポートを手動設定しているアプリも合わせて更新してください。
- コアを再起動して待ち受け状態をもう一度確認し、プロセスが想定したポートにバインドされていることを確認してからWebページを再読み込みします。ポートで待ち受けているのにページが開かない場合は、新しいリクエストのインバウンドとアウトバウンドのログを確認してください。むやみにポートを変更しないでください。
コア起動後の切り分け:プロキシ接続、ルーティング、リモート接続
コアの起動に成功したことは、プロセスが動作していることを示すだけです。ブラウザーのリクエストがコアに届いたことや、ノード・アクセス先のWebサイトに接続できることを保証するものではありません。ログレベルを一時的にinfoに変更し、同じURLと接続方式で再現して、次の3点を確認します。
- インバウンドを確認。今回の操作に対応する接続ログが見つからない場合は、アプリがシステムプロキシを使っているか、ローカルポートを正しく手動設定しているかを確認します。TUNを使う場合は、TUNが正常に起動したか、その通信がTUNを通っているかを調べます。まず現在の接続方式を確認し、2つの方式を同時に切り替えないでください。
- アウトバウンドを確認。インバウンドの記録があり、ログにアウトバウンドのタグが表示されている場合は、現在のルーティングルールと照合します。ノード経由になるはずのドメインがダイレクト接続ルールに一致しているなら、ノードの証明書設定を変更する前に、ルールの一致条件と並び順を確認してください。
- リモート接続を確認。想定したアウトバウンドが選択され、TCPノードへの接続時に失敗していることを確認できたら、PowerShellの
Test-NetConnectionでノードのホストと実際のポートをテストします。このテストで確認できるのは、現在の環境からTCP接続を確立できるかどうかだけです。TLS、プロトコル認証、Webページへの接続が正常かどうかは確認できず、UDP通信の可否判定にも使えません。
変更後は同じノード、同じURLで再テストし、同じ段階のログを比較します。以前の接続タイムアウトが証明書エラーに変わった場合は、調査が次の段階に進んだことを示しますが、接続が直ったわけではありません。Webページにアクセスできることを確認したら、一時的に上げたログレベルを元に戻してください。
ログの調査でよくある質問
ログが流れるのが速く、自分の操作に関係する行を見つけられません。
速度測定とサブスクリプション更新を停止し、操作を1回だけ再現して開始時刻を記録します。まず時刻で範囲を絞り、次に接続先アドレスやリクエストIDを使って関連する行をたどります。infoでも重要な情報が不足する場合に限り、短時間だけdebugに切り替え、ログの取得後に元のレベルへ戻してください。
Webページにはアクセスできるのに、サブスクリプションの更新がタイムアウトするのはなぜですか?
サブスクリプション更新ではサーバーに接続するため、ブラウザーとは異なる接続方式が使われることがあります。失敗したグループだけを更新し、表示されたメッセージを記録してください。次に、サブスクリプションURLが有効か、更新時にプロキシを経由しているか、同じ時間帯にノードを使えるかを確認します。既存のグループは削除しないでください。
証明書の有効期限切れが表示されたら、ノードを変更する必要がありますか?
まずWindowsの「設定」→「時刻と言語」→「日付と時刻」でシステム時刻を確認し、同期してから再テストします。時刻が正しいのに期限切れのエラーが続く場合は、ログがどのTLS接続先を示しているか確認し、その接続先を管理する側に証明書の有効期間と設定状況を確認してもらってください。
速度測定の結果が出るのに、特定のWebサイトだけ開けないのはなぜですか?
速度測定のリクエストと、そのWebサイトへのリクエストは別の接続です。速度測定を終了してWebサイトだけにアクセスし、新しいログで選択されたアウトバウンドと、名前解決・接続・ハンドシェイクのどの段階で失敗したかを確認します。そのドメインだけで失敗する場合は、まずルーティングルールの一致先と名前解決結果を調べてください。