Windowsでv2rayNをダブルクリックしてもウィンドウが表示されない、起動後すぐ消える、アップデート後に起動できない場合に役立つ内容です。まずプロセスが本当に終了しているか確認し、ランタイム、完全な展開、フォルダーへの書き込み権限、セキュリティソフトの履歴、既存の設定を順に調べます。一度に変更する条件は一つに絞り、起動トラブルの解決時にサブスクリプション設定を失わないよう、元のフォルダーとログを保管してください。
1. ウィンドウの非表示・アプリの終了・コアのエラーを切り分ける
「起動しない」ように見えても、必ずしもアプリがクラッシュしたとは限りません。v2rayNのメインウィンドウ、通知領域のアイコン、プロキシコアはそれぞれ別の要素です。ウィンドウを閉じてもプロセスがバックグラウンドで動いていることがあり、コアのエラーが画面の終了につながるとも限りません。まずタスクバー右側の隠れているインジケーターを確認し、Ctrl + Shift + Escを押してタスクマネージャーを開き、「詳細」からv2rayN.exeを探してください。
| 症状 | まず確認すること | 主な原因 |
|---|---|---|
| プロセスは動いているが、ウィンドウが見当たらない | 通知領域のアイコンをクリックし、別のモニターにウィンドウがないか確認する | バックグラウンド動作またはウィンドウの位置 |
| プロセスが表示された後、消える | 起動時刻を記録し、起動時のメッセージとイベントログを確認する | ランタイム、権限、設定の異常 |
| 画面は正常だが、ログにエラーがある | コアのエラー全文を保存し、待ち受けポートとノード設定を確認する | コアの起動または接続の問題 |
以下では、よくある確認順に原因を解説します。特定の原因がすべてのバージョンに当てはまるとは限りません。主にWindows版のデスクトップ画面が起動しない場合を対象としています。サブスクリプションの利用不可やVMess・VLESSの設定不一致は、通常、画面が起動した後に確認する接続上の問題です。起動直後に終了する場合、まずノードを変更するのは適切な対処ではありません。
2. .NETのバージョン・アーキテクチャ・デスクトップランタイムを確認する
システムランタイムが必要な配布パッケージでは、対応する.NET環境が必要です。「インストールされているアプリ」に.NETがあるかだけでなく、メジャーバージョン、CPUアーキテクチャ、ランタイムの種類も確認してください。WPF版にはWindows Desktop Runtimeが必要です。通常の.NET RuntimeやASP.NET Core Runtimeをインストールしても、デスクトップランタイムの代わりにはなりません。自己完結型の配布パッケージは、通常、対応するランタイムを別途システムにインストールする必要がありません。まずダウンロードしたパッケージの説明を確認してください。
-
エラーメッセージを記録する
You must install or update .NET to run this application.と表示された場合は、画面に表示されるFramework、Version、Architectureを記録してください。画面を閉じてから記憶を頼りにダウンロードしないようにしましょう。 -
システム情報を確認する
Windowsの「設定」→「システム」→「バージョン情報」で「システムの種類」を確認します。一部のバージョンでは「詳細情報」と表示されます。x64かARM64かを確認し、配布パッケージのアーキテクチャと照合してください。
-
必要なランタイムを確認する
展開先のフォルダーにある
v2rayN.runtimeconfig.jsonを探します。ファイルがある場合は、メモ帳でframeworkまたはframeworksの名前とバージョンを読み取り専用で確認してください。要件を回避するためにファイルを書き換えないでください。 -
インストール済みのランタイムを確認する
PowerShellを開いて、次のコマンドを実行します。WPFパッケージでは、出力に対応するメジャーバージョンの
Microsoft.WindowsDesktop.Appがあるか確認してください。また、コマンドで使用されるdotnetのアーキテクチャがアプリと一致しているかも確認します。 -
不足分を補って再試行する
エラーメッセージに応じて、Microsoft公式の.NETダウンロードページから対応するメジャーバージョンとアーキテクチャのランタイムを選びます。インストール後、残っているプロセスを終了してから、元のフォルダーにあるメインプログラムを起動してください。
dotnet --info
dotnet --list-runtimesたとえば、ファイルにMicrosoft.WindowsDesktop.Appの8.0.0が指定されている場合、通常は同じアーキテクチャの8.0系列のデスクトップランタイムをインストールします。適用されるパッチの選択はランタイムのロールフォワード設定によって異なります。9.0だけをインストールしても、8.0の要件を満たすとは限りません。これはバージョンを見分ける方法の説明であり、すべてのv2rayNに.NET 8が必要という意味ではありません。
3. 完全に展開し、フォルダーへの書き込み権限を確認する
圧縮ファイルのプレビュー画面からメインプログラムを直接起動したり、v2rayN.exeだけをデスクトップにドラッグしたりしないでください。アプリが必要とするアセンブリ、リソース、コアのファイルは複数のサブフォルダーに分かれている場合があります。まずアプリを終了し、圧縮ファイル全体を、現在のアカウントで書き込み可能な専用フォルダーに展開してください。たとえばユーザーフォルダー内にTools\v2rayN-testを作成し、その中から起動します。
- 書き込み可能か確認：対象フォルダーにテキストファイルを新規作成し、保存してから削除します。できない場合は、フォルダーの権限、ディスクの空き容量、またはコントロールされたフォルダーアクセスの問題を先に解決してください。
- 上書きによる混在を避ける：新しいバージョンは新しいフォルダーに展開してください。異なるアーキテクチャや画面バージョンのファイルを混在させないようにします。上書き展開すると、互換性のない古いファイルが残ることがあります。
- ファイルの保存場所を確認：メールの添付ファイル、一時フォルダー、ネットワーク共有から実行している場合は、まずこのPC上の書き込み可能なフォルダーにコピーしてください。パスに日本語が含まれていることだけで、故障と決めつけることはできません。
- ファイルのプロパティを確認：圧縮ファイルを右クリックして「プロパティ」を開き、「許可する」が表示されている場合は、入手元が信頼できることを確認してチェックを入れ、「適用」をクリックしてから全体を再展開します。項目がなければ、この手順は不要です。
メインプログラムを右クリックして「管理者として実行」する方法は、比較テストとして一度試すことができます。管理者権限でのみ起動する場合は、権限の違いを詳しく調べる必要があります。今後も常に管理者として実行すべきという意味ではありません。通常の画面起動に管理者権限は不要です。TUNなどの機能では別途権限が必要な場合があるため、今回の起動トラブルとは分けて判断してください。
エラー：Access to the path … is denied.
原因と対処：プログラムがアクセスしようとしたパスへのアクセスが拒否されています。エラーに表示された実際のパスを確認し、フォルダーの「プロパティ」→「セキュリティ」を調べます。まずは現在のアカウントで書き込み可能な新しいフォルダーに移してテストしてください。システムドライブ全体のアクセス権を緩めないでください。
エラー：Could not load file or assembly
原因と対処：アセンブリの不足、バージョンの競合、またはセキュリティソフトによるブロックが考えられます。まずエラーに続くファイル名を記録し、圧縮ファイル全体が展開されているか、保護履歴に記録がないか確認してください。同じ配布パッケージを空のフォルダーに再展開し、他のPCからDLLを一つだけ持ち込むような対応は避けてください。
4. セキュリティソフトの履歴を確認する（保護機能は無効にしない）
展開直後にメインプログラムが消える場合や、画面は起動してもコアのファイルが見つからない場合は、まずセキュリティソフトの履歴を確認します。Windowsセキュリティでは通常、「ウイルスと脅威の防止」→「保護の履歴」から確認できます。起動した時刻、ファイルのフルパス、検出名を照合し、処理されたのがメインプログラム、依存ファイル、コアファイルのどれかを確認してください。
- メッセージの内容とファイルパスを記録し、今回ダウンロードして展開したフォルダー内のファイルか、同じ名前の古いフォルダー内のファイルかを確認します。
- 配布パッケージの入手元と選択したプラットフォームを確認します。入手元が不明、ファイル名が不自然、またはブロック理由を説明できない場合は、すぐにファイルを復元して実行しないでください。
- 誤検知であることを確認してから、セキュリティソフトの画面に表示される操作に従って該当ファイルを復元します。組織が管理する端末では、管理者に対応を依頼してください。
- 再展開後、ファイルが再び隔離されないか確認します。処理が繰り返される場合は履歴を保存してさらに調べ、広範囲の除外設定を何度も追加しないでください。
5. 独立したフォルダーで設定破損とプログラムの問題を切り分ける
同じPCで以前は使えていたのに、アップデート後から起動直後に終了する場合は、設定の移行、データベースへのアクセス、ファイルの混在を疑います。まずv2rayNのプロセスをすべて終了し、古いフォルダーをコピーしてバックアップしてください。サブスクリプションURL、共有リンク、データベース、ログには接続情報が含まれる場合があります。バックアップは自分で管理できる場所に保存し、公開の掲示板などにアップロードしないでください。
| 確認する操作 | 結果 | 次の手順 |
|---|---|---|
| 同じ配布パッケージを空のフォルダーに完全展開し、古い設定はまだコピーしない | 起動できる | 古いフォルダー内のファイル、権限、設定を優先して調べる |
| 新しいフォルダーでもすぐに終了する | 古い設定以外に原因がある可能性が高まる | ランタイム、アーキテクチャ、システムイベントの確認に戻る |
| 古いバックアップを読み込んだ後に再び終了する | 読み込んだデータに問題が関連している可能性がある | 元のバックアップを保管し、一度にすべて上書きせず、少しずつ復元する |
設定の保存場所は配布方式によって異なります。独立したフォルダーでテストする前に、パッケージがデータをプログラムフォルダーに保存するか確認してください。ユーザー設定フォルダーを引き続き読み込む場合、「フォルダーを変えた」だけでは完全に初期化したテストになりません。該当バージョンの説明とログに記録された実際のパスを確認し、特定のファイル名を推測して削除しないでください。
- 新しいフォルダーから起動できたら、まず基本画面が安定して動作することを確認してから、サブスクリプション、サーバー、ルーティングの設定を一つずつ復元します。
- 新旧バージョンでデータ形式が異なる場合は、クライアントのバックアップ読み込み機能を使うか、既存のサブスクリプションを再追加してください。データベース全体を新バージョンに直接上書きするのは避けましょう。
- 設定の種類を一つ復元するたびに、アプリを終了して再起動してください。問題を引き起こす範囲を絞り込めるため、一度にすべての設定を戻すよりも原因を特定しやすくなります。
6. システムイベントとポート情報で原因を絞り込む
エラー画面が表示されない場合は、Win + Rを押してeventvwr.mscと入力します。「Windowsログ」→「アプリケーション」を開き、起動時刻前後の「.NET Runtime」と「Application Error」のイベントを確認してください。障害が発生したアプリケーション、障害モジュール、例外コード、例外メッセージを記録します。システムDLLの名前だけを見て、システムファイルが破損していると断定することはできません。
エラー：Only one usage of each socket address (protocol/network address/port) is normally permitted.
原因と対処：待ち受け先のアドレスとポートが別のプロセスに使用されています。メインウィンドウが正常に表示されている場合は、画面のクラッシュではなくコアの起動失敗であることが多いです。ポートを使っているプロセスを特定し、重複したインスタンスを終了するか、実際に使用する待ち受けポートを変更してください。
エラー：database is locked
原因と対処：別のインスタンスや他のプロセスがデータベースにアクセスしていて、書き込みがロックされている可能性があります。まず重複したプロセスを終了し、フォルダーをバックアップしてから再試行してください。繰り返し発生する場合は、同期ソフト、フォルダーの権限、データベースのアクセスログを確認します。データベースをそのまま削除しないでください。
ログに待ち受けポートとして10808が明記されている場合は、次のコマンドでPC上のTCPポートの使用状況を確認し、最後の列に表示されるPIDからプロセスを調べられます。10808は確認方法を示す例です。必ずログに記録された実際のポートに置き換えてください。数字が一致するだけで、正体の分からないシステムプロセスを終了しないでください。
netstat -ano -p tcp | findstr ":10808"
tasklist /FI "PID eq 1234"2つ目のコマンドにある1234はPIDの例です。実行時には1つ目のコマンドで確認した値に置き換えてください。問い合わせを報告する際は、クライアントのバージョン、配布パッケージの種類、Windowsのシステムの種類、再現手順、エラー全文を記載します。サブスクリプションURL、UUID、パスワード、サーバーアドレスは伏せてください。ログを明確に記録しておけば、再インストールや手当たり次第の試行を繰り返さずに済みます。
7. 起動トラブルについてよくある質問
.NETをインストール済みなのに、なぜインストールを求められるのですか？
まずメッセージに表示されるFrameworkとArchitectureを確認し、dotnet --list-runtimesを実行してください。通常のランタイムはデスクトップランタイムの代わりにならず、x64とARM64も「インストール済み」というだけでは互換になりません。配布パッケージの要件に合わせて不足分をインストールしてください。
再インストールすると、サブスクリプションやノードは消えますか？
配布方式、データの保存場所、アンインストール時の選択肢によって異なります。まず古いプログラムフォルダーと実際のユーザーデータフォルダーをバックアップし、新しいフォルダーでテストしてください。「再インストール」すれば自動でバックアップされると思い込まず、古い設定の唯一のコピーに上書きしないでください。
毎回、管理者として起動する必要がありますか？
一度のテストだけで常に管理者として起動する設定にするべきではありません。まず現在のアカウントで書き込み可能なフォルダーに移して確認してください。TUNを有効にしたときだけ権限の昇格が必要なら、その機能の案内に従います。通常起動でも昇格が必要な場合は、アクセスを拒否されている具体的なパスを調べてください。
画面は起動したのに、ブラウザーでインターネットに接続できません。解決したと考えてよいですか？
メインプログラムの起動問題と接続問題を切り分けられました。次にコアのログ、システムプロキシ、選択中のノード、ルーティングルールを確認してください。終了後もシステムが使えないローカルプロキシを参照している場合は、Windowsの「設定」→「ネットワークとインターネット」→「プロキシ」で手動プロキシの設定を確認します。組織の端末では、先に管理上のルールを確認してください。