V2Rayコアが起動しないときの対処法｜v2rayNのログで設定エラーを特定

1. コアの起動失敗と接続失敗を見分ける

v2rayNはクライアントの画面で、V2RayやXrayは設定の解析、待ち受けの開始、プロキシ通信の処理を担うコアです。画面にサーバー一覧が表示されていても、クライアント側のデータを読み込めているだけの場合があります。コアのプロセスが終了すると、ローカルプロキシの接続先も使えなくなることがあります。この段階では、システムプロキシの設定変更や速度テストを繰り返しても、起動エラーは解決しません。

メイン画面下部のログ欄で、直近の起動記録を確認します。ログ欄が折りたたまれている場合は、該当するパネルを開いてください。パネル名はバージョンによって異なることがあります。起動時刻、コア名とバージョン、最初のエラー、終了時の情報を記録し、特にfailed、error、ファイルパス、ポート番号を含む行は全文を残します。「起動失敗」という最後の一文だけを切り取らないでください。

この流れは障害の発生段階を切り分けるための目安であり、すべてのコアが必ず同じ順序で処理するわけではありません。設定の読み込み、ルール用リソースの読み込み、待ち受けの開始に失敗した場合は、リモート接続の確認より先に対処します。一方、コアが動作を続けてポートも待ち受け中なのに、アクセス時にi/o timeoutやハンドシェイクエラーが出る場合は、ノードのアドレス、ネットワーク、トランスポート、安全性の設定を確認しましょう。

• 起動直後に終了する：起動ログから下へ追い、最初に現れる具体的なエラーを探します。ポート、フィールド名、ファイル不足がよくある手掛かりです。
• コアは動作しているのにWebページが開かない：アプリがローカルプロキシを使っているか確認し、リクエストログの接続先エラーを調べます。
• TUNだけ起動に失敗する：まずTUNを無効にして通常のプロキシ接続を試し、仮想ネットワークアダプターの権限問題と設定解析の問題を切り分けます。

2. ポート競合：使用中のプロセスを確認して待ち受け設定を変更

ポート競合は、以前のコアが終了していない、クライアントを二重に起動した、別のローカルサービスが同じポートを使っているときによく発生します。以下では127.0.0.1:10808を例に確認します。この数値は説明用で、現在のインストール環境の既定値ではありません。「設定」→「パラメータ設定」で実際のローカル待ち受けポートを確認し、コマンド内の数値を置き換えてください。

Windows PowerShellで、まず次のコマンドを実行します。出力のOwningProcessはプロセスIDです。2つ目のコマンドでプロセス名と、取得できる場合は実行ファイルのパスも確認できます。最初のコマンドで結果が返らなくても、その時点で該当するTCPの待ち受けがないことを示すだけです。UDPの競合やシステム予約ポートの問題までは否定できません。

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

Get-NetTCPConnection -LocalPort 10808 -State Listen -ErrorAction SilentlyContinue |
  ForEach-Object { Get-Process -Id $_.OwningProcess } |
  Select-Object Id, ProcessName, Path

Get-NetUDPEndpoint -LocalPort 10808 -ErrorAction SilentlyContinue |
  Select-Object LocalAddress, LocalPort, OwningProcess

3. JSON形式エラー：構文の破損と設定フィールドの非互換を切り分ける

カスタム設定を読み込んだ直後に起動できなくなった場合は、まずJSONを解析できるか確認し、その後にフィールドがコアに対応しているか調べます。JSONの構文エラーには、余分なカンマ、引用符の欠落、括弧の不整合などがあります。一方、フィールドの互換性エラーは、構文が正しいファイルでも起こることがあります。対処の順番が異なるため、設定エラーをすべてサブスクリプションの無効化が原因だと決めつけないでください。

厳密なJSONでは、オブジェクトの最後の要素の後にカンマを置けません。以下は構文の例であり、そのまま起動できる完全なコア設定ではありません。カスタムファイルを検証するときは、ノードの認証情報を含むファイルをオンラインの整形サービスに送らず、まずローカルのエディターで構文を確認してください。

{
  "log": {
    "loglevel": "warning"
  }
}

1. 最初に元のカスタム設定をバックアップし、エラーに記録されたパスと行・列番号を残します。エラーによっては文字位置しか示されないため、前後の内容も確認してください。
2. 通常のノードを使い、v2rayNがパラメータから設定を生成する場合は、ノード編集画面に戻ってフィールドを修正してください。一時的に生成された実行ファイルだけを変更しないでください。
3. 完全なカスタム設定を使う場合は、元のファイルを修正してから再読み込みします。再起動は一度だけ行い、その起動時のログを比較してください。
4. 構文エラーが解消しても起動できない場合は、プロトコル、トランスポート、安全性の設定、ルール用リソースを引き続き確認します。「解析できる」ことと「動作する」ことは別です。

4. 未知のプロトコルやフィールド：実際に起動したコアを確認する

v2rayN、V2Ray、Xrayのバージョンはそれぞれ別のものです。クライアント画面を更新しても、使用中のすべてのコアファイルが更新されるとは限りません。新しいコアがディスク上にあっても、今回の起動で選ばれているとは限りません。起動ログに記録されたコア名とバージョンを基準に、ノードが必要とする機能を確認してください。インストールパッケージの名前から推測せず、実際のバージョンを記録しましょう。

VLESSプロトコルとREALITYの安全性設定は、別々の項目です。VLESSに対応するコアだからといって、設定内のすべてのトランスポートや安全機能に対応しているとは限りません。サーバー側で必要な条件は維持したうえで、互換性のあるコアを選びます。安全性のフィールドをむやみに削除すると、起動エラーが後続のハンドシェイクエラーに変わることがあります。

5. ルールファイルが見つからない：パス、リソース形式、アクセス権を確認する

ルーティング設定が外部リソースを参照している場合、ファイルが存在しない、または読み込めないと起動を妨げることがあります。V2RayやXrayの設定では、geoip.datはIPアドレスの分類に、geosite.datはドメインの分類に使われます。ほかのコアでは別のルール形式を使う場合があるため、拡張子だけ変更して流用しないでください。エラー行に記録された実際のパスとリソースの種類を確認します。

• インストールファイルを確認：起動プログラムだけを移動すると、元のフォルダーにあるコアやリソースが不足することがあります。対応するフォルダー構成を復元してから起動してください。
• 相対パスを確認：カスタム設定の相対パスは実行環境に依存し、設定ファイルの保存先を基準にするとは限りません。存在が確認できる絶対パスを使って切り分けてください。
• セキュリティソフトの記録を確認：ファイルが隔離されていないか、検出元と操作履歴を確認します。保護機能全体を無効にしないでください。
• 最後にルール参照を確認：ファイルを読み込めてもカテゴリが存在しない場合は、バックアップしたルールを戻すか、リソース内に実在するカテゴリを使います。安易にすべての通信を直接接続に変更しないでください。

6. 一度に一項目だけ変更し、待ち受けとリクエストで確認する

修正前に現在の設定とログを保存し、変更は一度に一項目だけにします。基本的には「ポートのバインド、JSON構文、プロトコルフィールド、ルール用リソース」の順に確認します。ただし、ログにファイル不足が明記されている場合は、手順にこだわらずそのエラーを先に解決してください。各変更と結果を記録し、サブスクリプション更新、コアの切り替え、ルーティングの変更を同時に行って原因が分からなくなるのを防ぎます。

1. 最小限の条件に戻す：TUNと、当面不要なカスタムルールを無効にします。必要なパラメータが揃ったノードを1つ選び、通常のローカルプロキシ待ち受けは有効にしておきます。
2. 一度だけ再起動する：今回の起動時刻からログを確認し、すぐに終了しないことを確かめます。実際のコア名とバージョンも記録してください。
3. ローカルの待ち受けを確認する：前述のコマンドで実際のポートを調べ、その待ち受けが別のクライアントではなく、今回起動したコアのものか確認します。
4. プロキシ経由のリクエストを送る：該当ポートがSOCKSを提供している場合は、以下のコマンドで確認できます。リクエストログも見て、DNS、接続、ハンドシェイクのどの段階で失敗したか判断します。
5. 機能を一つずつ戻す：まずルーティングルールを戻し、その後にTUNを有効にします。項目を追加するたびにログを確認し、問題が再発する境目を特定してください。

curl.exe --proxy socks5h://127.0.0.1:10808 --connect-timeout 10 --max-time 20 --head https://example.com/

このWindows向けコマンド例では、接続タイムアウトを10秒、全体のタイムアウトを20秒に設定しています。実行前に実際のSOCKSポートへ置き換えてください。socks5hは接続先のドメイン名の解決をプロキシ側で行う指定です。ローカルでHTTPプロキシだけを使っている場合は、対応するプロキシ形式に変更します。HTTPレスポンスが返っても、そのリクエストに応答があったことを示すだけで、すべてのWebサイトに接続できるとは限りません。リクエストのタイムアウトだけでコアの起動失敗と判断することもできません。

7. ログによるトラブル対処のよくある質問