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

1. コアの終了と通信リクエストの失敗を見分ける

v2rayNは管理用の画面で、Xrayはプロキシ設定を実行するコアです。画面が開いていても、コアが正常に動作しているとは限りません。また、特定のサイトがタイムアウトしても、コアの起動失敗とは限りません。起動に失敗した場合はローカル設定や実行環境を確認し、サイトへの接続に失敗した場合はノード、DNS、接続先までの経路を確認します。

画面に最後に表示されたメッセージだけで判断しないでください。メイン画面の情報またはログ欄を開き、古い記録を消してから、現在の設定で再起動します。設定の読み込みからプロセス終了までのログを続けて保存してください。ログ画面の名称や場所はバージョンによって異なるため、実際の画面で確認してください。

• 起動時の失敗：設定の解析失敗、リソースファイルを開けない、待ち受けアドレスのバインド失敗などがログに記録され、その後プロセスが終了します。この場合、ノードを変更してもローカルの問題は解決しません。
• 実行中の失敗：コアは動作し続け、リクエストを送信した後にタイムアウト、接続拒否、ハンドシェイク失敗などが発生します。まずリクエストがどのアウトバウンド経由で送信されたかを確認し、その後サーバー側の設定を調べます。
• コアが実行されていない：実行ファイルが見つからない、またはプロセスを作成できないというメッセージが表示され、Xrayからの出力がありません。まずコアのパス、ファイルが隔離されていないか、実行権限があるかを確認してください。ルーティングルールから変更する必要はありません。

2. ログレベルとエラーの連鎖から原因を探す

Xrayのログレベルには、debug、info、warning、error、noneがあります。noneは通常のログ出力を無効にする設定のため、一時的なトラブル対処には向きません。通常はinfoから確認し、リクエストの経路が分かりにくい場合に限り、一時的にdebugへ変更します。調査後は元に戻し、接続の詳細が大量に出力され続けないようにしてください。

該当する設定項目があるv2rayNでは、「設定」→「パラメーター設定」からログ関連の設定を探して保存し、現在の設定を再起動します。カスタムJSONを使っている場合は、ファイル内のlogセクションも確認してください。画面側の設定が必ず反映されるとは限りません。設定の解析中に発生したエラーはプロセスのコンソールにのみ出力される場合もあるため、画面に表示されるコアの出力も保存してください。

エラーの連鎖では、複数のコンテキストが>でつながっていることがあります。以下は典型的な構成例です。実際のモジュール名やメッセージはコアのバージョンによって異なる場合があります。外側のメッセージが「読み込みに失敗した」ことを示し、その内側で「設定内容を読み込めない」と説明され、末尾に構文上の直接的な手がかりが示されます。

Failed to start: main: failed to load config files: [config.json]
> infra/conf/serial: failed to read config file
> invalid character '}' looking for beginning of object key string

3. ポート競合：待ち受けアドレスと使用中のプロセスを確認する

ローカルのインバウンドは、アドレスとポートを指定して待ち受けます。同じ待ち受けエンドポイントを複数のプロセスが同時に使用することはできません。コアの二重起動、別のプロキシプロセス、同じ設定内で重複して定義されたインバウンドなどが競合の原因になります。ログに記録された実際のポートを確認し、ガイドに書かれた標準値を推測して使わないでください。

PowerShellで次のコマンドを実行すると、例として使用しているTCPポート10808の待ち受けプロセスを確認できます。プロセス名とパスを調べてから終了するか判断してください。プロセスIDが表示されたからといって、すぐに強制終了しないでください。

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

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

1. 使用中のプロセスが古いXrayなら、まずそのプロセスを起動したクライアントから正常に終了します。プロセスが終了したことを確認してから、v2rayNを再起動してください。
2. 終了できない別のプログラムがポートを使用している場合は、ローカルのインバウンド設定で空いているポートを指定してください。カスタム設定を使っている場合は、すべてのinboundsも確認し、ポートの重複がないようにしてください。
3. ポートを変更した後は、ブラウザーの手動プロキシ設定とシステムプロキシ設定が古いポートを参照していないか確認してください。コアが正常に起動しても、アプリが古いポートに接続し続けると、別の接続エラーが発生します。
4. forbidden by its access permissionsと表示されても、すぐにポート競合と判断しないでください。netsh interface ipv4 show excludedportrange protocol=tcpを実行してシステムの予約範囲を確認し、セキュリティポリシーもあわせて調べてください。

4. JSON構文エラー：実際に起動時に使われるファイルをテストする

ノード編集画面で保存できても、すべてのカスタム設定を組み合わせたJSONが有効とは限りません。よくある原因は、最後の項目の後に余分なカンマがある、全角の引用符をコピーした、文字列の閉じ引用符がない、Windowsのパスに含まれるバックスラッシュをJSON内にそのまま記述した、といったものです。パスにはスラッシュを使うか、文字列内のバックスラッシュを\\と記述してください。

Xray実行ファイルのあるフォルダーでPowerShellを開き、今回実際に使用する設定ファイルのコピーをconfig.jsonという名前で保存してから、次のコマンドを実行します。ファイルが別の場所にある場合は、実際の絶対パスを指定してください。古いバックアップだけをテストしても、v2rayNが直近の起動時に生成した設定を確認したことにはなりません。

.\xray.exe version
.\xray.exe run -test -config .\config.json

run -testは、現在のコアで設定を読み込めるか確認するためのコマンドです。通常の待ち受けテストや、接続先への疎通確認の代わりにはなりません。テスト時はクライアントと同じリソースディレクトリや環境変数を使ってください。手動テストでgeoファイルが見つからなくても、クライアントの起動時にも見つからないとは限りません。自動生成されたファイルは次回起動時に上書きされることがあります。最終的な修正は、ノード編集項目、ルーティング設定、またはカスタム設定の元ファイルに反映してください。

5. geoファイルが見つからない：ファイルパスとルール分類を確認する

geoip:privateやgeosite:cnは、設定に書くだけで自動的に展開される通常の文字列ではありません。Xrayがこれらのルールを読み込むには、対応するデータファイルが必要です。ファイルの不足、作業ディレクトリの違い、リソースパスの誤設定、分類名の不一致などがあると、設定を構築できない場合があります。JSONだけを別の場所にコピーすると、必要なリソースが抜けてしまうこともよくあります。

• まず、参照されたパスを確認：ログに記録された実際のパスを基準にしてください。ダウンロードフォルダーに同名のファイルがあるだけでは、必要なリソースが揃っているとは限りません。
• 次に、リソース設定を確認：カスタム実行環境のXRAY_LOCATION_ASSETはリソースの検索先に影響します。想定したディレクトリを指しているか確認してください。
• ファイル不足と分類不足を区別：「ファイルが見つからない」ことと「ファイルに指定された分類がない」ことは別の問題です。後者の場合は分類名を修正するか、その分類を含むデータを使用してください。同じファイルを繰り返しコピーしても解決しません。
• 必要なリソースだけを復元：クライアントに用意されているリソース更新機能で、使用するファイルを復元してください。切り分けのために関連ルールを一時的に削除する場合は、事前にバックアップを取り、テスト後に元のルーティング設定へ戻してください。

6. フィールド名と階層：有効なJSONでも設定が誤っている場合がある

JSON構文のテストに成功しても、括弧や引用符などの形式が解析できることしか分かりません。フィールドの場所や値が正しいか、使用中のコア機能に対応しているかは別に確認が必要です。特に、コピーした設定例がどのコア向けの形式なのか確認してください。v2rayNの画面設定とXrayネイティブJSONも別の形式です。画面設定ファイルをそのままXrayに渡して実行することはできません。

ルーティングを例にすると、domainStrategyはroutingに属し、rules内の個々のルールには属しません。以下はルーティング部分のみの例です。完全な設定内でdirectという名前の直結アウトバウンドが定義され、必要なgeoデータを読み込めることを前提としています。このままでは起動できる完全な設定ではありません。

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "domain": ["geosite:cn"],
        "outboundTag": "direct"
      }
    ]
  }
}

• 大文字・小文字を確認：outboundTagは、名前を適当に変更したフィールドと同じではありません。アウトバウンドタグの値も、定義した内容と一致させてください。
• データ型を確認：rulesは配列である必要があります。ルール内のdomainやipには、それぞれのフィールドで求められる形式を指定してください。他のソフト用のルールテキストをJSONにそのまま貼り付けないでください。
• バージョンの対応状況を確認：xray.exe versionを実行して実際の出力を記録し、使用するトランスポートやセキュリティ関連のフィールドがそのコアでサポートされているか確認してください。クライアント画面のタイトルからコアのバージョンを推測しないでください。
• 設定の反映を確認：不明なフィールドは必ずしもエラーにならず、無視される場合があります。設定テストに成功した後も、実行ログとリクエスト結果を確認し、ルールが実際に反映されているか確かめてください。

7. 修正後の動作確認とよくある質問

毎回、原因が明確な項目を一つだけ修正し、再起動後に新しいログを保存してください。コアの更新、ポートの変更、ルーティングの変更、ノードの切り替えを同時に行うと、接続が復旧しても、どの操作が有効だったのか判断できません。復旧を確認したら、一時的に変更したログレベルを元に戻し、正常に動作する設定のコピーを保存してください。

1. 設定の確認：現在のコアで実際に使う設定をテストし、読み込み、フィールド、リソースに関するエラーが出ないことを確認します。
2. プロセスの確認：正常起動後もプロセスが動作し続け、想定したローカルポートで待ち受けていることを確認します。起動直後に終了してはいけません。
3. リクエストの確認：アプリが新しいポートを使って対象にアクセスするよう設定します。ログでリクエストがコアに届いたことを確認し、新たなリモート接続エラーが発生していないか確認してください。
4. 設定の保持を確認：v2rayNを終了してから再度開き、自動生成された設定に修正内容が上書きされていないことを確認します。