v2rayNが起動しない、またはWebページを開けない場合は、まずコアが設定を読み込めているか、ローカルで待ち受けているかを確認し、その後に外向きの接続を調べます。この記事では、WindowsでXrayコアを使うv2rayNを例に、トラブル時のログの取得方法と、アドレス・ポート・エラー前後の情報から原因を絞り込む手順を解説します。
v2rayNのログ確認場所とログレベルの選び方
まずメイン画面の「情報」欄で、サーバーの切り替えやコアの起動直後に出力されたログを確認します。ログレベルは「設定」→「パラメーター設定」から「Core基本設定」を開き、「ログレベル」で変更できます。バージョンによって項目名や配置が異なる場合があります。カスタム設定を使っている場合は、読み込まれている設定でログの出力先やレベルが個別に指定されていないかも確認してください。
現在の環境を記録する
v2rayNのバージョン、ノードで使用するコアの種類、ローカルプロキシのポートを控えておきます。サブスクリプションの更新、ノードの変更、ポートの変更を同時に行うのは避けてください。接続が復旧しても、どの変更が効果をもたらしたのか分からなくなります。
infoに設定する
コアのログレベルを一時的に
infoに設定し、保存してから現在のコアを再起動します。Xrayの設定では、該当する項目はlog.loglevelです。warningやerrorでは記録される範囲が狭く、通常利用には適していますが、リクエストの処理経路を確認できないことがあります。問題を一度再現する
リクエストを実行した時刻を控え、エラーが出たアプリで一度だけ再試行します。起動時に発生する問題なら、コアだけを再起動すれば十分です。Webページを何度も再読み込みする必要はありません。エラー行と前後のログを残し、最後の一行だけをコピーしないようにします。
必要な情報を記録したら元に戻す
infoで失敗箇所を特定できない場合は、一時的にdebugに変更して再試行し、その後、元のレベルに戻します。ログを共有する前に、サブスクリプションURL、認証情報、プライベートドメイン名、グローバルIPアドレスを伏せてください。エラーのキーワード、ポート、同じリクエストに関係する識別情報は残します。
ログの構成:ローカルのインバウンド、ルーティング、リモートへのアウトバウンド
ログにはクライアントの通知、コアの出力、速度測定の結果が混在することがあります。コアのログを読むときは、まず操作した時刻と照らし合わせ、次にコンポーネント名と失敗した処理を確認します。コアによっては、複数段階のエラーが>で連結されます。左側は処理失敗の概要、右側にはより具体的なシステムエラーが示されることが多いです。同じエラーチェーンの中を確認し、前後の別リクエストのログを一つの原因として扱わないでください。
| ログの例 | 分かること | 次に確認する箇所 |
|---|---|---|
listen tcp 127.0.0.1:10808 | このログはローカルでの待ち受け処理を示しています | 同じ行にバインド失敗がないか確認します。サーバー側のポートをテストする箇所ではありません |
accepted | コアがこのインバウンドリクエストを受け付けました | 続けてインバウンドからアウトバウンドへのタグが表示される場合は、想定したルートが選ばれているか確認します |
dial tcp | コンポーネントがTCP接続を試みています | ログに記録された接続先アドレスとポートから、ノード、直接接続先、ローカルサービスのどれかを見分けます |
判断のポイント:同じリクエストでルーティングを確認する
ブラウザーのエラーが発生した時点で該当するacceptedが記録されていても、アウトバウンドのタグが直接接続ルールへの一致を示している場合は、該当ルールとその優先順位を確認してください。この場合、クライアントの再インストールやノードの頻繁な切り替えをしても、そのリクエストのアウトバウンド選択は変わりません。
コアの起動失敗:ポート競合と設定の解析エラー
起動時にエラーが出ている場合、ブラウザーのプロキシエラーはその後に起きた症状であることがほとんどです。まずコアが設定を正常に読み込めたかを確認し、次にローカルポートで待ち受けできているかを調べます。どちらのエラーもリクエストがコアに届かない原因になりますが、対処方法は異なります。
エラー:Only one usage of each socket address (protocol/network address/port) is normally permitted.
原因と対処:Windowsでこのバインドエラーが返されるのは、通常、そのアドレスとポートを現在のプロセスで使用できないためです。待ち受け中のプロセスを確認し、別のクライアントや終了しきれていないコアがないか調べます。競合するプログラムを正常終了するか、ローカルポートを変更し、アプリ側のプロキシ設定も合わせて更新してください。
エラー:invalid character '}' looking for beginning of object key string
原因と対処:次のオブジェクトキーを待っている解析処理が、閉じ波括弧を読み取っています。よくある原因は、最後の項目の後に余分なカンマがあることです。エラーに表示されたファイル名や行・列番号、オフセットを手がかりに、実際に読み込まれた設定を確認します。まず構文を修正し、その後、項目の型とコアが対応しているかを確認してください。
エラーに表示された待ち受けポートが10808の場合は、Windows PowerShellで確認できます。ログに別のポートが表示されている場合は、コマンド内の数字をそのポート番号に置き換えてください。待ち受けの記録が見つからない場合は、まずエラーの発生時刻を再確認します。競合していたプロセスがすでに終了している可能性があります。
Get-NetTCPConnection -LocalPort 10808 -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess
OwningProcessはプロセスIDです。タスクマネージャーの「詳細」タブで照合できます。ローカルプロキシのポートを変更した場合は、v2rayNのシステムプロキシ設定を適用し直し、プロキシアドレスを手動設定したアプリも確認してください。自動生成された設定の解析エラーなら、まずノードの編集画面で設定元を修正します。一時設定を直接編集しても、次回の起動時に上書きされることがあります。
接続タイムアウト、接続拒否、TLSハンドシェイク失敗
コアがリクエストを受け取ったら、次は接続先への接続自体に失敗したのか、TCP接続後のハンドシェイクで失敗したのかを確認します。前者では実際の接続先アドレスとポートを、後者ではセキュリティ方式、サービス名、証明書などの設定を調べます。
エラー:i/o timeout
原因と対処:ネットワーク処理が制限時間を超えていますが、この表示だけではどの段階でタイムアウトしたか分かりません。直前にdial tcpがある場合は、ログに記録された接続先のTCPポートをテストしてください。応答の読み取り中やハンドシェイク中に発生している場合は、同じエラーチェーンの前後を確認します。
エラー:connection refused
原因と対処:接続先から明示的に拒否されています。接続先ポートでサービスが待ち受けていない場合や、途中の機器が接続を拒否した場合によく発生します。アドレスがローカルかどうかを確認してください。ローカルなら待ち受け中のプロセスを、リモートならノードのポートを確認し、サービスの管理者に待ち受け状態とアクセス許可を問い合わせます。
エラー:x509: certificate signed by unknown authority
原因と対処:通常のTLS証明書検証で、受信した証明書チェーンを信頼済みルート証明書までたどれません。まず接続先が意図したサービスか確認し、サービスの管理者に証明書チェーンを確認してもらいます。組織が管理するネットワークの場合は、管理者に必要な信頼チェーンを確認してください。検証を無効にしてエラーを回避するのは避けてください。
エラー:remote error: tls: handshake failure
原因と対処:ハンドシェイク中にリモート側から失敗のアラートが返されていますが、この行だけではどの設定が一致していないか特定できません。ノードのセキュリティ方式、サービス名、ポートを確認してください。REALITYを使用している場合は、サービス側から提供されたサービス名・公開鍵・Short IDを照合します。通常のTLS証明書の設定をそのまま適用しないでください。
TCPを使用するノードでは、PowerShellでサーバーの接続先を個別にテストできます。入力するのはノードのサーバーアドレスとリモートポートです。サブスクリプションURL、TLSのサービス名、ローカルプロキシのポートは入力しないでください。
$serverAddress = Read-Host 'ノードのサーバーアドレス'
$serverPort = [int](Read-Host 'ノードのリモートポート')
Test-NetConnection -ComputerName $serverAddress -Port $serverPort
ログでのトラブルシューティング:よくある質問
Webページを開けないのに、情報欄に新しいログが表示されない場合は?
まずログレベルを一時的にinfoに変更して再試行します。該当するインバウンド記録が見つからない場合は、コアが待ち受けていることを確認し、v2rayNのシステムプロキシの状態と、Windowsの「設定」→「ネットワークとインターネット」→「プロキシ」を確認してください。アプリ側でプロキシを設定している場合は、指定したアドレス・ポート・プロキシ方式が実際のインバウンド設定と一致しているか調べます。
failed to find an available destinationしか表示されません。DNSの問題と判断できますか?
いいえ。これはアウトバウンド接続の確立に失敗したことを示す概要であり、必ずしもドメイン名の解決に問題があるとは限りません。続きに具体的なエラーがないか確認してください。lookupとno such hostがあれば、ドメイン名の綴りと名前解決を調べます。接続先IPアドレスと接続タイムアウトがすでに表示されている場合は、そのIPアドレスとポートへの接続を確認してください。
ノードには接続できるのに、サブスクリプションの更新がタイムアウトするのはなぜですか?
サブスクリプションの更新では、ノードではなくサブスクリプションサーバーに接続します。ノードに接続できても、サブスクリプションサーバーにアクセスできるとは限りません。メイン画面の「サブスクリプショングループ」を開き、「プロキシを使用しない場合」と「プロキシを使用する場合」の更新方法を確認し、どちらで失敗しているかを特定します。プロキシ経由で更新する前に、現在のノードでWebページに正常にアクセスできることを確認してください。更新ログを共有する場合は、サブスクリプションURLからパスとクエリパラメーターを削除します。
ログにEOFが時々表示されます。ノードを変更する必要がありますか?
まずWebリクエストが実際に失敗したかを確認します。EOFはストリームの終端を読み取ったことを示すだけで、単独では誰が、なぜ接続を閉じたか分かりません。同じ操作でハンドシェイク中に毎回unexpected EOFが発生する場合は、リモートポートとトランスポート設定を確認し、同じリクエストで再テストしてください。