v2rayNのコアが起動しない原因と対処法｜ログから設定エラーを特定

まず失敗箇所を特定：プロセス、設定、待ち受け

v2rayNは設定・操作用の画面で、通信処理はXrayやV2Flyなどのコアが担います。起動時には、実行ファイルの確認、設定の生成、プロセスの起動、ローカルポートへのバインドが順に行われます。どの段階で失敗しても「起動失敗」やコアの終了を繰り返す状態になりますが、原因に応じて対処法は異なります。

クライアントのログ表示を開き、現在のログを保存してから、もう一度起動します。今回の操作時刻を目印に、最初に現れる failed、error、またはプロセス起動時の異常を探してください。末尾の「プロセスが終了しました」は多くの場合、結果を示すだけです。本当の原因はその前の行にあることが多いため、特にコロンの後に続く詳細なエラーまで確認しましょう。

1. 選択中の設定、コア名、ログに記録された実行ファイルのパスを控えます。
2. 最後の状態表示だけでなく、最初のエラーと前後数行をコピーします。
3. 設定は一度に一つだけ変更し、再起動後のログと比較してエラーが変化したか確認します。

ポート競合：PIDを調べてから、プロセス終了かポート変更を判断

ログに bind、address already in use、またはWindowsのソケット使用中を示すメッセージが表示されたら、該当するローカルアドレスとポートを確認します。クライアントを重複して起動している、前のコアが終了していない、別のアプリが同じポートを使用している、といった理由で新しいコアが待ち受けできないことがあります。

ここでは 10808 と 10809 を例に確認します。これらは設定例であり、すべてのバージョンの既定値や、二つの入口を同時に有効にする必要性を示すものではありません。実際にバインドしようとしているポートとクライアントの設定を確認してください。

PowerShellで次のコマンドを実行します。出力された OwningProcess がPIDです。続けて2つ目のコマンドでプロセス名とパスを確認します。プロセス情報の一部は、管理者権限がないと取得できない場合があります。

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

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

• クライアントが重複起動している場合は、余分なインスタンスを通知領域から通常の手順で終了してください。同名のプロセスをすべて強制終了するのは避けましょう。
• ポートを変更する場合は、「設定」→「パラメーター設定」でローカルの待ち受け項目を確認します。項目名はバージョンによって異なるため、実際の画面を確認してください。
• ポートを変更したら、手動で設定したブラウザーのプロキシ、コマンドラインのプロキシ、システムプロキシも合わせて変更します。変更しないと、引き続き古いポートに接続します。
• アドレスの競合ではなくアクセス権限不足のエラーなら、システムの予約済みポートやローカルのセキュリティポリシーを確認します。すべての bind エラーをプロセスの重複と決めつけないでください。

JSON構文エラー：まず構文を直し、その後に設定内容を確認

JSONの解析に失敗すると、コアは設定の読み込みを完了できません。よくある原因は、オブジェクト末尾の余分なカンマ、日本語の引用符、文字列内のエスケープされていないバックスラッシュ、またはサブスクリプションの内容を完全なJSON設定として読み込むことです。入力形式は、ファイルの拡張子を変えるだけでは相互に変換できません。

以下は有効なJSONの一部分を示す例であり、そのまま使えるプロキシ設定ではありません。WindowsのパスをJSON文字列に記述する場合、バックスラッシュをエスケープする必要があります。エクスプローラーでパスを扱う場合は、二重にする必要はありません。

{
  "log": {
    "loglevel": "warning",
    "error": "C:\\v2rayN\\logs\\error.log"
  }
}

1. ユーザー設定をバックアップしてから、エラーが出たファイルが手動で読み込んだ設定か、クライアントが自動生成した実行設定かを確認します。
2. 自動生成ファイルは、設定の切り替えや再起動時に上書きされます。一時的な出力ファイルだけを編集せず、元の設定やクライアント側の項目を修正してください。
3. サブスクリプションURL、UUID、パスワード、鍵を含む設定全体を、オンラインのフォーマットツールにアップロードしないでください。共有する必要がある場合は、事前にローカルで機密情報を伏せてください。

未対応プロトコル・フィールド：フィールド名を変えるだけでなく、コアの対応状況を確認

JSON構文のチェックに通っても、設定が起動できるとは限りません。選択したコアの設定形式と機能に合っている必要があります。VMessとVLESSはプロトコル名で、REALITYは対応するコアを必要とする通信のセキュリティ方式です。任意に置き換えられるラベルとして扱わないでください。

「不明なフィールド」と「必須フィールドの不足」は分けて対処します。不明なフィールドの扱いは、コア、設定の読み込み方法、パーサーによって異なり、無視される場合もあれば拒否される場合もあります。そのため、不明なフィールドのエラーが出ないからといって、そのフィールドが反映されたとは限りません。起動ログと使用中のバージョンの設定仕様を確認してください。

v2rayNGはXrayコア、v2flyNGはV2Flyコアを使用します。ただし、どちらから出力した実行設定もデスクトップ版でそのまま使えるわけではありません。移行時は、まずクライアントが対応するサブスクリプションまたは共有リンクを使い、プロトコルと通信パラメーターを確認してください。対応機能はクライアント名ではなく、実際に使用するコアのバージョンによって異なります。

コアファイルが見つからない：展開状態、アーキテクチャ、ファイルへのアクセスを確認

コアのバージョン情報さえ表示されず、ログにファイルが見つからないと出る場合は、ノードではなくプログラムファイルを確認します。クライアントの画面が起動するのは画面側のプログラムが動作していることを示すだけで、コアや関連ファイルが指定のフォルダーに揃っているとは限りません。

• プログラム全体を、たとえば C:\Tools\v2rayN のような、現在のアカウントで書き込み可能な専用フォルダーに展開します。アーカイブのプレビュー画面から直接実行しないでください。
• Windowsの「設定」→「システム」→「システム情報」でシステムの種類を確認し、OSとプロセッサーのアーキテクチャに合ったパッケージを選びます。
• コアのフォルダーを変更した場合は、クライアントが実際に参照するパスを確認してください。新しいファイルを別のフォルダーにコピーしても、古いパスは自動で変更されません。
• ログにルール用のリソースファイルが不足していると明記されている場合は、該当するリソースを確認します。実行ファイルの不足とルーティング用リソースの不足を同じ問題として扱わないでください。

設定テストと再起動で修復を確認

設定自体の問題とクライアントの起動環境を切り分けるには、コアに備わっているテスト機能を使えます。次の例は、このコマンドに対応するXrayだけを対象としています。実際のコアがあるフォルダーでPowerShellを開き、まずヘルプを確認してから、保存済みの完全な設定のコピーをテストします。例のファイル名は diagnosis.json です。事前に用意してください。前述のログ用設定の断片をコピーするだけではテストできません。

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

テストに使うパラメーターは、実際の実行ファイルが表示するヘルプに従ってください。Xrayのコマンドを他のコアにそのまま使わないでください。設定テストで確認できるのは設定の読み込み可否が中心で、実際の起動、ポートへのバインド、リモート接続の確認には代えられません。テストに合格しても、ポート競合やノードへの接続不可が残る場合があります。

1. 単独で実行したテストプロセスを終了してから、v2rayNに戻り、現在の設定で起動します。手動で起動したプロセスが同じポートを使用し続けないようにしてください。
2. ログに元のエラーが再発せず、プロセスが起動直後に終了しないことを確認します。
3. ローカルの待ち受けポートを再度調べ、該当するPIDが今回起動したコアのものか確認します。
4. 最後に必要なシステムプロキシまたはTUNを有効にし、ブラウザーからの通信を確認します。まず基本的なプロキシ通信ができることを確かめてから、複雑なルーティングルールを追加してください。

よくある質問：再インストール、管理者権限、ログのマスキング