まず、問題が画面を開いたとき、接続を開始したとき、画面ロック後のどの段階で起きるかを確認しましょう。v2rayNが起動直後に終了する、コアが起動しない、v2rayNGが接続後に切れる場合は、症状に応じてログやランタイム、ファイル権限、システム設定を確認できます。最初から設定を消去したり、再インストールしたりする必要はありません。
アプリの強制終了・コアの停止・バックグラウンド切断を見分ける
ウィンドウが消えても、プロセスが終了したとは限りません。Windowsではタスクバーの通知領域にある隠れたアイコンを確認し、タスクマネージャーでv2rayNが動作中か調べてください。通知領域からウィンドウを再表示できるなら、起動時の強制終了として扱う必要はありません。Androidでも「ホーム画面に戻ったがVPNは接続中」と「VPN接続自体が切れた」を区別しましょう。アプリが最近使ったアプリに残っているかだけでなく、システムのVPN画面で状態を確認してください。
| 発生するタイミング | まず確認すること | ひとまず変更不要 |
|---|---|---|
| ダブルクリック後に画面が表示されず、プロセスも終了する | ランタイムのエラー表示、アプリケーションイベントログ | サブスクリプション、ルール設定 |
| 画面は正常に開くが、接続開始時にエラーが出る | コアファイル、書き込み権限、ローカルポート、VPNの許可 | システムの電源プラン |
| 画面表示中は接続できるが、画面ロック後に切れる | Androidのバッテリー制限、画面表示中にも切れるか | クライアントのインストールパッケージ |
最初に表示されたエラーから原因を絞る
発生時刻を記録してから同じ操作を一度だけ再現し、そのとき最初に出た具体的なエラーを控えます。後に表示される「起動に失敗しました」は、原因ではなく結果であることがほとんどです。一度に変更する項目は一つだけにし、同じ操作で再確認すると、どの変更が有効だったか判断できます。
v2rayNが起動直後に落ちるときは.NETデスクトップランタイムを確認
まず、使用しているパッケージとエラーメッセージを確認してください。バージョンによって必要な環境は異なります。外部ランタイムが必要なWPFパッケージでMicrosoft.WindowsDesktop.Appが見つからないと表示された場合は、対応するアーキテクチャとメジャーバージョンの.NET Desktop Runtimeが必要です。.NET RuntimeやASP.NET Core Runtimeだけをインストールしても、デスクトップ用コンポーネントは補えません。自己完結型パッケージの場合は、ダブルクリックしても反応しないという理由だけでランタイム不足と判断しないでください。
- 不足コンポーネントのダイアログが表示されたら、フレームワーク名、バージョン、アーキテクチャを記録します。たとえば
Microsoft.WindowsDesktop.App、8.0.0、x64と表示された場合は、x64版の.NET 8デスクトップランタイムを確認し、同じ系列の利用可能な更新版を選んでください。この例は、すべてのv2rayNパッケージが.NET 8を必要とするという意味ではありません。 - Windowsターミナルで次のコマンドを実行し、該当するフレームワークが一覧にあるか確認します。表示されるのは、現在のターミナルから
dotnetが認識できるランタイムです。異なるアーキテクチャをインストールしている場合、一覧一つだけでPC全体の状態を判断しないでください。「設定」→「アプリ」→「インストールされているアプリ」でも、名前とアーキテクチャを確認できます。 - ダイアログが表示されない場合は、「イベント ビューアー」→「Windowsログ」→「Application」を開き、先ほどの時刻に該当する
.NET RuntimeまたはApplication Errorの記録を探します。問題が発生したアプリ名と例外の説明を確認してください。ランタイム不足を示す証拠がなければ、原因を確かめずに複数のメジャーバージョンを次々とインストールしないでください。
dotnet --list-runtimes
v2rayNは起動するのにコアが起動しない場合:ブロック、フォルダー、ポートを確認
まず、クライアントのログにコアのパス、設定ファイルのパス、待ち受けアドレスが記録されているか確認します。画面が開くのはGUIが動作しているというだけで、コアの実行ファイルが存在することや、設定を書き込めること、ローカルポートを使用できることを意味しません。
エラー:The system cannot find the file specified.
原因:コアファイルを示すエラーの場合、展開が不完全、ファイルの移動、またはセキュリティソフトによる隔離が考えられます。対処:まずログに記載されたパスを確認し、「Windows セキュリティ」→「ウイルスと脅威の防止」→「保護の履歴」に同じ時刻の記録がないか調べます。
エラー:Access is denied.
原因:設定ファイルの書き込み時にエラーが出る場合、現在のユーザーに対象フォルダーへの書き込み権限がないか、セキュリティポリシーによって書き込みがブロックされている可能性があります。対処:設定をバックアップし、通常のユーザーアカウントで書き込めるローカルフォルダーに完全展開したポータブル版を置いて試します。そのうえで元のパスの権限や保護の履歴を確認してください。
エラー:Only one usage of each socket address (protocol/network address/port) is normally permitted.
原因:コアが待ち受けようとしているアドレスとポートを、別のプロセスがすでに使用している可能性があります。対処:ログに記録されたポートの使用状況を調べ、不要だと確認できた重複クライアントを終了するか、v2rayNの「設定」→「パラメータ設定」で該当するローカル待ち受けポートを変更します。
保護の履歴に隔離記録がある場合は、検出対象、検出名、インストールパッケージの入手元を確認してください。起動を試すためにPC全体の保護を無効にしたり、入手元が不明なファイルを復元したりしないでください。会社や学校の管理下にあるPCでアプリ制御が設定されている場合は、記録を残して管理者に相談します。フォルダーの調査で、管理者として常時実行する必要はありません。ポータブル版をユーザーが書き込めるローカルフォルダーに完全展開すると、権限を上げるより原因を特定しやすくなります。インストール版はインストーラーから修復し、プログラムフォルダーを直接移動しないでください。
netstat -ano | findstr ":10808"
コマンド内のポート番号をログに記録された値に置き換えてください。TCPの使用状況を調べるときは、該当行のローカルアドレス、ポート、状態がLISTENINGであることを確認し、最後の列のPIDからタスクマネージャーの「詳細」タブでプロセスを特定します。リモートポートだけが一致していても、ローカルの待ち受け競合とは限りません。ローカルポートを変更した場合、ブラウザーやほかのツールに以前のポートを手入力していたら、そちらも更新してください。
v2rayNGで接続できないときはAndroidのVPN許可を確認
v2rayNGの画面は開くのに、接続をタップすると未接続に戻る場合は、まずシステムがVPN接続を許可しているか確認します。接続時に表示される確認画面はAndroidのシステム画面で、サブスクリプションのインポート画面ではありません。設定の場所はメーカーによって異なります。見つからない場合は、システム設定で「VPN」を検索してください。
- アプリを前面に表示した状態で接続を一度タップし、AndroidのVPN接続リクエストに表示されたアプリ名を確認して許可します。「キャンセル」をタップした場合は、アプリに戻ってもう一度接続を開始してください。ノードをインポートできても、VPN接続が許可されたとは限りません。
- 通常、同じユーザーやプロファイルで同時に有効にできるVPNは一つです。「設定」→「ネットワークとインターネット」→「VPN」で、既存の接続を確認してください。自分で管理している古い接続なら、一度切断してから試せます。常時接続VPNやデバイス管理ポリシーが設定されている場合は、用途を確認し、組織のポリシーを無断で解除しないでください。
- アプリの画面自体を開けない場合、VPNの許可は最初に調べるべき原因ではありません。Androidのバージョン、v2rayNGのバージョン、インストールパッケージのアーキテクチャ、直近でアップデートしたかを記録してください。特定の設定を選んで接続したときだけ問題が起きるなら、以前正常に接続できた設定と比較し、設定単体の問題かアプリ全体のクラッシュかを切り分けます。
v2rayNGが画面ロック後に切れるときはバッテリー最適化を確認
バッテリー最適化が関係するのは、アプリを前面で使っているときは正常なのに、バックグラウンドや画面ロック後に接続が切れるケースです。すべての起動失敗を説明できるわけではありません。同じネットワークで、画面を表示したまま使う場合とロックした場合を比較します。画面をつけたままでも切れるなら、まずログの接続エラーを確認し、Wi-Fiとモバイルデータの間でネットワークが切り替わっていないか調べてください。
- v2rayNGのアイコンを長押しして「アプリ情報」→「アプリのバッテリー使用量」または「バッテリー」を開き、バックグラウンドでの使用が制限されていないか確認します。機種によっては「制限なし」や「バックグラウンドでの使用を許可」といった項目があります。テストの対象はこのアプリだけにし、バッテリー全体の設定は変更しないでください。
- 同じ設定を使い、画面を表示した状態とロックした状態でそれぞれ5分間接続を維持します。ロック解除後にシステムのVPN状態を確認し、切断したおおよその時刻を記録してください。5分は比較しやすい目安です。通常もっと長くしてから切れる場合は、同じ長さで再テストします。
- 制限を緩めても切断が続く場合は、効果のなかった変更を元に戻し、ネットワークの切り替わり、バックグラウンドプロセスの終了、クライアントログの接続タイムアウトを確認してください。特定の省電力設定の名前だけを、原因の証拠とみなさないでください。
再インストールやデータ消去、問い合わせの前によくある質問
.NETをインストールしたのに、v2rayNが起動直後に終了するのはなぜ?
起動時のメッセージにあるフレームワークとアーキテクチャをもう一度確認してください。たとえばx64パッケージで必要なのがMicrosoft.WindowsDesktop.Appなのに、Microsoft.NETCore.Appしか見つからない場合や、別のアーキテクチャ用のデスクトップランタイムだけをインストールしている場合は、依存関係が満たされたとはいえません。メッセージが消えても終了する場合は、新しい発生時刻のアプリケーションイベントを調べ、古い判断をそのまま当てはめないでください。
アップデート後に落ちる場合、新しいフォルダーで動作を試せますか?
はい。ポータブル版では古いフォルダーと設定を残し、同じバージョンの完全なパッケージを新しい書き込み可能なフォルダーに展開します。古い設定はコピーせず、初期状態の画面が開くか確認してください。開ける場合は、設定を一つずつ戻します。新旧のコアファイルを同じフォルダーに混在させると、違いの原因を特定しにくくなります。
Androidでキャッシュを削除する操作とストレージを消去する操作はどう違いますか?
「アプリ情報」→「ストレージとキャッシュ」にあるキャッシュの削除では、通常、一時データだけが消去されます。ストレージの消去ではアプリのデータがリセットされ、サブスクリプション、ノード、設定などが失われる場合があります。アプリを開けるなら、まずアプリのエクスポート機能でバックアップし、バックアップを読み込めることも確認してください。バックアップがない場合、ストレージの消去を最初の対処にしないでください。
ログを添えて問い合わせるとき、何を残せばよいですか?
OSのバージョン、クライアントのバージョン、インストールパッケージの種類、発生時刻、発生させた操作、最初に表示されたエラーを記録してください。サブスクリプションURL、ノードの認証情報、共有リンク全文、パスに含まれるアカウント名は削除します。画面ロック後やアップデート後だけ発生する場合は、その前後で変わった条件も伝えてください。