Windowsで初めてインストールしたときや、アップデート後にv2rayNが起動しなくなった場合に役立つ内容です。まずメインプロセスがバックグラウンドで動いているか確認し、起動時のメッセージに従ってランタイムをチェックします。別の場所に新たに展開したコピーで、フォルダーや古い設定の影響も切り分けましょう。ノード選択時だけ失敗する場合は、メインプログラムを何度も再インストールせず、コアのログを確認してください。
メインプログラムの終了とコアの起動失敗を切り分ける
この流れは確認箇所を切り分けるためのもので、すべてのバージョンでコアが同じタイミングに起動するとは限りません。ダブルクリックしたら、まずタスクバーの通知領域を確認し、必要なら隠れているアイコンを表示します。タスクトレイからメイン画面を開ける場合、プログラムは終了していません。ランタイムを入れる前に、ウィンドウが最小化されていないか確認しましょう。
- Ctrl + Shift + Esc を押して「タスク マネージャー」を開き、「詳細」タブで
v2rayN.exeを確認します。プロセスが現れてすぐ消える場合は時刻を記録し、システムログと照合できるようにしてください。 - Win + R を押して
eventvwr.mscと入力します。「Windowsログ」→「アプリケーション」を開き、起動時刻の前後に.NET RuntimeまたはApplication Errorの記録がないか確認してください。イベントID 1026や1000は手がかりになりますが、記録されたプログラム名も確認し、同じ時間帯に発生した別アプリのエラーと混同しないようにしましょう。 - ウィンドウは開くものの、ノードを切り替えた後にコアの起動エラーが出る場合は、まずメイン画面のログを確認してください。ブラウザーでページを開けないだけでは、デスクトップアプリが落ちたとは判断できません。先にコアのエラーを確認し、その後プロキシ設定を調べましょう。
エラーメッセージをもとに.NET Desktop Runtimeを確認する
インストール済みアプリに「.NET」があるかどうかだけで判断しないでください。外部ランタイムが必要なWindowsデスクトップ版では、Microsoft.WindowsDesktop.App が求められることがあります。通常の.NET Runtimeや古い.NET Frameworkを入れていても、この要件を満たすとは限りません。自己完結型のパッケージには必要なランタイムが含まれている場合があるため、まずダウンロードしたパッケージの種類を確認してから、追加インストールが必要か判断しましょう。
You must install or update .NET to run this application.
原因:起動プログラムが要件を満たす共有ランタイムを見つけられていません。対処法:メッセージに表示された Framework、バージョン、Architecture を控えます。フレームワーク名が Microsoft.WindowsDesktop.App の場合は、Microsoft公式の配布元から、該当するアーキテクチャとバージョン系列の.NET Desktop Runtimeをインストールしてください。
Only one usage of each socket address (protocol/network address/port) is normally permitted.
原因:このメッセージがコアのリスニングログに出ている場合は、ローカルの待ち受けアドレスとポートが使用中でないか確認してください。対処法:ログに記載されたポートを使っているプロセスを調べ、古いインスタンスの重複起動が確認できた場合は、通常の方法で終了します。このコアのエラーをランタイム不足と混同しないでください。
たとえば、Microsoft.WindowsDesktop.App 8.0.0、アーキテクチャがx64と表示された場合は、x64版の8.0系列Desktop Runtimeがインストールされているか確認します。通常、最初の8.0.0のパッチを探す必要はありませんが、9.0系列だけでは8.0の代わりになりません。アーキテクチャはアプリのメッセージを基準に確認してください。Windowsが64ビットだからといって、プログラムも必ずx64とは限りません。
dotnet --list-runtimes
ターミナルでこのコマンドを実行し、Microsoft.WindowsDesktop.App で始まる行と、右側に表示されるインストール先を確認します。このコマンドに表示されるのは、現在呼び出されている dotnet が認識するランタイムだけです。複数のアーキテクチャのランタイムがインストールされていても、この一覧だけでは別のアーキテクチャの状態は確認できません。コマンドが見つからない場合は、「設定」→「アプリ」→「インストールされているアプリ」でDesktop Runtimeを確認し、クライアントを再起動してみてください。
再展開してフォルダーの権限と古い設定を切り分ける
古いフォルダーを残す
まず起動中のインスタンスを通常の方法で終了します。タスクトレイのメニューを開ける場合は、そこから終了し、タスク マネージャーでメインプロセスが終了したことを確認してください。古いプログラムフォルダーと設定はバックアップし、元のファイルを上書きしないようにします。サブスクリプションURLやノードの認証情報が含まれている場合があるため、フォルダー全体をそのまま他人に送らないでください。
すべてのファイルを展開する
エクスプローラーで圧縮ファイルを右クリックし、「すべて展開」を選びます。
%LOCALAPPDATA%\v2rayN-testなど、現在のユーザーが書き込みできるローカルフォルダーを指定してください。圧縮ファイルのプレビューから直接起動したり、v2rayN.exeだけを取り出したりしないでください。通常の権限で起動する
新しいフォルダーからメインプログラムをダブルクリックします。古いショートカットは使わず、以前の設定もコピーしないでください。ログに書き込み失敗のパスが記録されている場合は、そのパスのフォルダーで空のテキストファイルを作成して削除できるか試します。テスト用フォルダーに書き込めても、エラーが出た別のフォルダーに書き込めるとは限りません。
設定を段階的に戻す
新しいコピーが起動したら、いったん終了して再度起動し、基本設定を保存できることを確認します。その後、使えるノードを1つ、またはサブスクリプションを1つだけ読み込んでテストし、最後にカスタムルーティングなどの設定を戻します。設定の種類を戻すたびに再起動してください。問題が再発した場合は、直前に追加した内容をまず取り除きます。
権限の問題とアップデートの影響を切り分けるには、できるだけ同じバージョン・同じアーキテクチャの配布パッケージを使い、新しい場所に展開して試してください。新しいバージョンだけが起動した場合、新しいフォルダーでその版が動くことは確認できますが、それだけで旧版の原因がフォルダーの権限不足だったとは断定できません。管理者権限でしか起動しない場合は、エラー記録にある書き込み先を優先して調べましょう。常に管理者として実行することを解決策にしないでください。
メイン画面が開く場合はコアファイルと待ち受けポートを確認する
- ログにファイルが見つからないと表示される:ログに記載された完全なパスを確認します。Xrayの場合、該当するフォルダー内の
xray.exeを探してください。同名のファイルをメインプログラムの隣に置けばよいわけではありません。まず選択した配布パッケージに必要なコアが含まれているか確認し、新しく展開したコピーのフォルダー構成と照らし合わせます。 - 展開後にファイルが消える:「Windows セキュリティ」→「ウイルスと脅威の防止」→「保護の履歴」を開き、検出時刻、対象のパス、処理結果を確認します。該当する記録があれば検出情報を控え、信頼できる配布元から完全なパッケージを再入手してください。再びブロックされる場合は、管理者に相談するか誤検知の再審査を依頼します。リアルタイム保護を無効にしたり、フォルダー全体を除外に追加したりしないでください。
- ログにバインド失敗と表示される:ログに記録された実際のポートを確認します。たとえば
127.0.0.1:10808と表示された場合は、コマンドプロンプトで下のコマンドを実行し、ローカルアドレスが該当ポートで、状態がLISTENINGの行を探します。最後の列はPIDです。「タスク マネージャー」→「詳細」で、どのプログラムか確認できます。
netstat -ano -p tcp | findstr ":10808"
このコマンドは、リモートアドレスやより長いポート番号の文字列にも一致することがあります。結果が表示されただけでポートが競合していると判断しないでください。使用中のプロセスを特定したら、まず重複起動したインスタンスを通常の方法で終了します。引き続き必要なプログラムがポートを使用している場合は、v2rayNの「設定」→「パラメータ設定」でローカルの待ち受けポートを確認してください。変更後は、プロキシを手動設定したブラウザーやアプリのポートも更新します。
まだ起動しない場合によくある3つの疑問
ショートカットをダブルクリックしても反応せず、プログラム本体からなら起動できる?
古いショートカットを右クリックして「プロパティ」→「ショートカット」を開き、「リンク先」が移動前の v2rayN.exe を指していないか、「作業フォルダー」も確認します。リンク先が無効なら、現在のメインプログラムからショートカットを作り直してください。
ランタイムを追加したのに同じメッセージが表示される?
ダイアログに表示されたフレームワーク名とアーキテクチャをもう一度確認し、通常のRuntimeではなくDesktop Runtimeをインストールしたか確認します。また、今回展開したコピーを起動しているか確認してください。タスクバーにピン留めされた古いバージョンを起動している可能性もあります。新旧のバージョンで必要なランタイム系列が異なることがあります。
ウィンドウもエラーダイアログも表示されない場合、問い合わせに何を添えればよい?
Windowsのバージョン、システムの種類、配布パッケージのファイル名、ダブルクリックした時刻を記録します。イベント ビューアーに該当する記録があれば、障害が発生したアプリケーション名、例外コード、障害モジュールを抜き出してください。新しいコピーでも試した場合は、起動できたかどうかも記載します。送信前に、個人のフォルダー名、サブスクリプションURL、ノードの認証情報を削除してください。