Xrayコアが起動しないときの対処法：ポート競合・JSON構文・設定項目を確認

1. 起動失敗か接続失敗かを見分ける

「Webページが開かない」からといって、「コアが起動していない」とは限りません。Xrayは起動時に設定を読み込み、インバウンドとアウトバウンドを構成して、待ち受けポートを開きます。このいずれかに失敗すると、プロセスがすぐ終了することがあります。コアの起動後に発生する接続先へのタイムアウト、認証失敗、TLSハンドシェイクエラーは、別の手順で確認します。まず問題が起きた段階を見分ければ、正しいノード設定を何度も変更せずに済みます。

v2rayNはクライアントの画面を提供し、実際の接続処理はXrayコアが行います。画面が動作していても、コアが正常とは限りません。バージョンによってメニューの位置が変わる場合があるため、以下ではWindowsデスクトップ版の一般的な画面を例に説明します。同じ名前の項目が見つからないときは、括弧内の機能を目印にしてください。他のクライアントのメニューをそのまま当てはめないようにしましょう。

1. エラーを保存する

   メイン画面の下部にある情報またはログ欄を開き、今回の起動時刻を記録します。Failed to startから始まるエラー全体をコピーし、後続の>で区切られた内容も残してください。通常、最後の階層により具体的な原因が示されています。

2. コアを確認する

   「設定」→「パラメーター設定」→「Coreの種類」を開き、現在のノードのプロトコルに合ったコアが選択されているか確認します。バージョンによっては「Coreの種類の設定」というタブ名の場合もあります。次に起動ログの実行ファイルのパスを確認し、実際にXrayが呼び出されていることを確かめます。

3. 一度だけ再現する

   TUNを一時的に無効にし、v2rayNを1つだけ起動した状態で、元のノードを選んでサービスを一度再起動します。ノードを次々に切り替えてログを流さないでください。再起動の前後約10秒分のログを残すと、エラーが同じ起動処理で発生したか判断しやすくなります。

4. 変更点を記録する

   最後に正常起動してから変更した項目を記録します。ローカルポート、ルーティングルール、カスタム設定、コアファイルなどが該当します。現在の設定をバックアップし、1回のテストで変更するのは1項目だけにして、結果も記録してください。

2. ポート競合：待ち受けプロセスを調べてからポートを変更する

エラーにfailed to listenやaddress already in useが含まれる場合は、接続先の443番ポートではなく、まずローカルの待ち受けポートを確認します。WindowsではOnly one usage of each socket addressと表示されることもあります。よくある原因は、前回のコアプロセスが終了していない、クライアントを複数起動している、または別のプログラムが同じアドレスとポートを使用していることです。

以下ではTCPポート10808を検索例に使いますが、すべてのv2rayNでこの値が標準とは限りません。まず「設定」→「パラメーター設定」→「基本設定」で実際のローカル待ち受けポートを確認し、コマンド内の数字を置き換えてください。混合インバウンドを使う場合、1つのポートで複数のプロキシプロトコルを受け付けられるため、無理に2つのポートに分ける必要はありません。

netstat -ano -p tcp | findstr ":10808"

powershell -NoProfile -Command "Get-NetTCPConnection -State Listen -LocalPort 10808 | Select-Object LocalAddress,LocalPort,OwningProcess"

• netstatの出力から、「ローカルアドレス」が:10808で終わり、状態がLISTENINGになっている行を探します。一番右の列がPIDです。TIME_WAITだけでは、待ち受けポートの競合があるとは判断できません。
• PIDが4260だった場合は、tasklist /FI "PID eq 4260"を実行してプロセス名を確認します。このPIDは例なので、実際の操作では見つかった値を使ってください。
• 別のv2rayNが起動したコアであれば、まず該当するクライアントのタスクトレイメニューから正常に終了し、もう一度調べてください。どのプロセスがどのクライアントに属するか確認せず、同じ名前のプロセスをすべて終了しないようにしましょう。
• ポートを使用中のプログラムを終了できない場合は、ローカル待ち受けポートを未使用の10818に変更し、保存してサービスを再起動します。手動でプロキシを設定しているアプリでも、ポートを同じ値に変更してください。

Windowsで待ち受けプロセスが見つからないのにソケットへのアクセス拒否が表示される場合は、netsh interface ipv4 show excludedportrange protocol=tcpを実行してIPv4 TCPの除外範囲を確認します。使用したいポートが範囲内にある場合は、範囲外の利用可能なポートを選んでください。システムの予約項目を直接削除しないでください。TUNや権限に関する記録がログにある場合に限り、該当する権限設定を確認します。

3. JSON形式：実際に使うコアでオフラインテストする

テキストエディターで設定ファイルを開けても、Xrayが読み込めるとは限りません。カンマの抜け、全角の引用符、閉じていない括弧があると、解析が中断します。構文エラーには行番号や文字位置のほか、invalid character、unexpected EOFなどのメッセージが含まれることがあります。具体的な文言はコアのバージョンや読み込み方法によって異なります。

クライアントで関連サービスを停止した後、ログに記載されたXrayのプログラムフォルダーに移動し、そのフォルダー内の実行ファイルで保存した設定のコピーをテストします。以下はWindows PowerShellでの例です。check.jsonは今回テストするファイル名です。テストではプロキシの待ち受けを開始しませんが、設定から参照される証明書やルールデータなどのローカルファイルが読み込まれる場合があります。

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

行番号は多くの場合、解析器が問題を検出した位置を示しており、最初に問題が発生した位置とは限りません。24行目のエラーなら、まず23行目もあわせて確認してください。認証情報を含む設定ファイル全体をオンラインの整形ツールに貼り付けないでください。ローカルエディターの括弧対応機能とコアのテストコマンドで、通常は十分に確認できます。

4. 設定項目のエラー：階層を確認し、名前だけに注目しない

JSON構文を通過した後は、Xrayの設定構造に合っているか確認します。inboundsとoutboundsは配列です。プロトコル固有のパラメーターは対応するsettingsに、通信方式やセキュリティのパラメーターは通常streamSettingsに記述します。項目を誤った階層に置くと、JSONとしては有効でも、設定の構築に失敗したり、指定が反映されなかったりすることがあります。

あるコア向けの設定例を、別形式の設定にそのまま貼り付けないでください。v2rayNのノード編集フォームは、Xrayの設定JSON全体と同じものではありません。クライアントはノード、ルーティング、全体設定に基づいて実行用設定を生成します。特にVLESSとVMessではプロトコルのパラメーターが異なります。どちらもユーザー識別情報を使うからといって、settings全体を入れ替えることはできません。

• キー名を確認：streamSettingsのSは大文字です。routing.rulesでアウトバウンドのタグを指定するキーはoutboundTagです。キー名の大文字・小文字は、使用するコアの設定仕様に合わせてください。
• タグを確認：ルールのoutboundTagは、いずれかのアウトバウンドのtagと一致している必要があります。タグを間違えると、ルールに一致した後のアウトバウンド選択に影響します。テストに成功しただけで、ルーティングが機能していると判断しないでください。
• 値を確認：protocol、通信方式、セキュリティ方式には、現在のコアが認識できる値を指定します。説明文をパラメーター値として入力すると、未知のプロトコルや種類のエラーが発生します。
• リソースを確認：geoip.dat、geosite.dat、証明書ファイルの読み込みに失敗する場合は、リソースのフォルダー、ファイル名、アクセス権を確認します。相対パスは実際の作業ディレクトリに左右されるため、実行するフォルダーを変えると結果も変わることがあります。

注意点として、一部の解析処理では未知の項目が無視され、エラーにならない場合があります。そのため「エラーがない」ことから分かるのは、現在の検査を通過したことだけで、手入力したすべての項目が反映されたとは限りません。ルーティングを変更した後は、具体的な対象ドメインでアウトバウンドの選択を確認してください。Webページが1つ開けるだけでは、十分な検証になりません。

5. 最小構成：環境の問題とノードの問題を切り分ける

設定全体が長い場合は、まず以下の内容をcheck.jsonとして保存してください。ローカルの127.0.0.1:10818でSOCKSインバウンドだけを提供し、接続先へ直接接続します。リモートプロキシノードは含まれず、サブスクリプションが使えるかどうかの確認にも使えません。現在のXrayが設定を読み込み、アウトバウンドを構築し、ローカルポートを開けるかを調べるためのものです。

{
  "log": {
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "tag": "local-check",
      "listen": "127.0.0.1",
      "port": 10818,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": false
      }
    }
  ],
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {}
    }
  ]
}

1. まず.\xray.exe run -test -config .\check.jsonを実行します。失敗した場合は出力を保存し、現在のコアとファイルの内容を優先して確認してください。実際のノードのパラメーターは追加しないでください。
2. テストに成功したら、.\xray.exe run -config .\check.jsonを実行します。プロセスが動作し続け、127.0.0.1:10818が待ち受け中であることを確認できれば、バインドのテストは成功です。画面にしばらく新しい出力がなくても、フリーズしたとは限りません。
3. Ctrl+Cでテストプロセスを停止し、元の設定を少しずつ戻します。まずノードのアウトバウンド、次に通信方式とセキュリティの設定、最後にルーティングとルールデータを追加します。追加するたびにテストしてください。
4. 最小構成では起動し、設定の一部を戻した後に失敗する場合は、原因を追加した項目や依存ファイルに絞れます。同じテストでノード、ポート、コアをまとめて変更しないでください。

6. バージョンの互換性：実際に使われているファイルを確認する

クライアントのバージョンとコアのバージョンは別です。v2rayN本体を更新しただけでは、Xrayも更新されたとは限りません。コアのファイルを手動で上書きしても、クライアントがそのファイルを使うとは限りません。起動ログのパスとxray.exe versionの出力を確認し、プロセッサーのアーキテクチャも記録してください。

新しい項目や通信方式、仕様が変更された既存の項目は、コアのバージョンによって利用できないことがあります。その場合は、起動できるバージョンと設定のコピーを保存してから、クライアントの更新機能またはダウンロードセンターで対応するコンポーネントを入手してください。設定を無理に起動させるために項目を次々と削除し、必要な接続動作まで変えてしまわないようにしましょう。

• 設定の互換性がない：プログラムが起動して設定エラーを出力する場合は、そのバージョンでサポートされている項目とパラメーターを重点的に確認します。コアのテスト結果を参考に原因を特定し、公開日だけで対応状況を推測しないでください。
• プログラムを実行できない：システムに実行できない、または実行ファイル形式が正しくないと表示される場合は、Windowsとプロセッサーのアーキテクチャ、ダウンロードが完了しているか、安全ソフトに隔離されていないかを確認します。この段階では、まだJSONの解析に進んでいません。
• 更新後に元へ戻す：まずクライアントと残っているコアを終了し、関連するバックアップ一式を復元します。新しいクライアントが新形式の設定を生成する場合、古いコアに戻すだけでは引き続き失敗することがあります。
• Android版との違い：v2rayNGはXrayコアを使用し、v2flyNGはv2flyコアを使用します。対応範囲は互いに代用できません。また、Windowsのプロセス検索コマンドをAndroidでそのまま使うこともできません。

7. 起動失敗についてよくある質問