Windowsでは、まずv2rayNのプロセスが終了しているか確認し、起動ログからランタイム不足、フォルダーへの書き込み失敗、設定ファイルの読み込みエラーを切り分けます。更新後にだけ落ちる場合は、旧フォルダーを残し、同じビルドを新しいフォルダーで初回起動してください。Androidでは、アプリ画面が終了するのか、接続後にVPNサービスが停止するのかを確認します。
v2rayNのプロセスが終了したか確認する
ウィンドウが消えても、プロセスがクラッシュしたとは限りません。まずWindowsのタスクバー通知領域を開き、v2rayNのアイコンを右クリックしてメイン画面を表示できるか試してください。または Ctrl + Shift + Esc を押し、タスク マネージャーの「詳細」タブで v2rayN.exe が実行中か確認します。プロセスが残っていて画面が応答しない場合は、画面のフリーズとして状況を記録してください。ランタイム不足と決めつけて再インストールを繰り返す必要はありません。
- ウィンドウと同時にプロセスも終了する:起動時刻と使用中のビルドを記録し、実際に展開したフォルダーから直接起動します。ショートカットが古いコピーを参照している可能性を除外できます。エラーダイアログが表示された場合は、最後の一行だけでなくメッセージ全体を保存してください。
- ウィンドウは正常で、接続だけ失敗する:まずコアのログを確認します。たとえばローカルの待ち受け先が
127.0.0.1:10808に設定され、そのポートが使用中なら、通常はコアの待ち受けに失敗しており、クライアント画面のクラッシュではありません。ポート番号は現在の設定を確認し、例示の値を既定値と決めつけないでください。 - ダイアログが表示されない:Win + R を押して
eventvwr.mscを実行し、「Windowsログ」→「アプリケーション」を開きます。同じ時刻に記録された.NET RuntimeまたはApplication Errorのイベントを探し、障害が発生したアプリ名、例外の種類、ファイルパスを確認してください。
.NETデスクトップランタイムとアプリのアーキテクチャを確認する
PCにインストールされた.NETに依存するWindows版では、エラーに表示されたフレームワーク名、バージョン、アーキテクチャを確認してください。WPF版が Microsoft.WindowsDesktop.App を要求する場合、Microsoft.NETCore.App がインストール済みでもデスクトップフレームワークがあるとは限りません。自己完結型ビルドにはランタイムが同梱されています。展開が不完全な場合は、DLLを個別に追加せず、パッケージ全体を展開し直してください。
dotnet --list-runtimes
PowerShellで上記のコマンドを実行します。x64版の Microsoft.WindowsDesktop.App 8.0.0 が必要と表示された場合は、x64ランタイムに要件を満たす8.0系デスクトップフレームワークがあるか確認してください。任意の.NETの記録が一つ見つかっただけで、確認を終えないでください。ここでのバージョンはエラーの読み方を示す例であり、すべてのv2rayNビルドが同じ要件という意味ではありません。このコマンドに表示されるのは、実行した dotnet が認識しているランタイムだけです。x86版とx64版の両方がインストールされている場合は、エラーに記載されたアーキテクチャとランタイムの検索場所を確認してください。コマンドで見つからないことだけを根拠に、ランタイムが未インストールだと判断することもできません。
エラー:You must install or update .NET to run this application.
原因:必要な.NETフレームワークが見つかりません。対処法:エラーに表示された Framework、Architecture、バージョンに合うランタイムをインストールし、同じアプリのコピーで再確認してください。
エラー:System.UnauthorizedAccessException
原因:ファイルまたはフォルダーへのアクセスが拒否されています。対処法:まずイベントの詳細に記載された実際のパスを確認してください。書き込み先がアプリのフォルダー内なら、同じビルドを現在のアカウントで書き込める新しいフォルダーに置いて再確認します。
フォルダーの権限を確認し、旧設定を切り分ける
ログに記載されたデータフォルダーで、現在のアカウントを使って空のテキストファイルを作成し、保存後に削除してください。失敗した場合、その場所では現在のアカウントに必要な操作が許可されていません。成功しても、そのファイルを書き込めることが確認できただけです。既存のデータベースに読み取り専用属性が付いている、別のプロセスが使用中、または個別のアクセス制限がある可能性は残ります。起動させるためにシステムフォルダーの権限を一括変更しないでください。
終了してバックアップする
通知領域の右クリックメニューから終了し、タスク マネージャーで旧プロセスが終了したことを確認してから、旧展開フォルダーと別途指定したデータ保存先をバックアップします。クライアントの実行中にデータベースファイルだけをコピーしないでください。サブスクリプションURLやノードの認証情報は、ローカルのバックアップ内で管理してください。
新しいフォルダーに展開する
元のインストールパッケージから同じビルドをすべて展開します。たとえば、エクスプローラーのアドレスバーに
%LOCALAPPDATA%と入力して開き、そこでv2rayN-testフォルダーを作成します。圧縮ファイル内から直接実行したり、新しいパッケージを旧フォルダーに上書きしたりしないでください。初回起動を確認する
旧データはコピーせず、新しいフォルダー内の
v2rayN.exeを通常のユーザーアカウントで実行してください。使用中のビルドが共有場所からユーザーデータを読み込む場合、アプリのフォルダーを変えただけでは初回起動になりません。ログで実際のデータパスを確認し、バックアップを取ってから該当データを一時的に別の場所へ移してください。データを段階的に戻す
初回起動できたら、まず元のサブスクリプションURLから再登録し、その後にカスタム設定を戻します。データを戻すたびにアプリを終了して再起動してください。特定のデータを戻した後だけ問題が再発する場合は、そのデータに範囲を絞って調べます。旧バージョンの設定、データベース、コアをまとめて新しいフォルダーに上書きしないでください。
Androidでアプリが落ちる場合とVPNサービスが終了する場合
v2rayNGはXrayコア、v2flyNGはv2flyコアを使用します。どちらのAndroidクライアントも、Windowsの.NETデスクトップランタイムには依存しません。アイコンをタップしたとき、設定をインポートしたとき、接続をタップした後のどの段階で問題が起きるか記録し、アプリの起動とVPNの許可設定のどちらを調べるか判断してください。
- アイコンをタップするとすぐホーム画面に戻る:システムの「設定」→「アプリ」→該当するクライアント→「強制停止」の順に操作し、もう一度開きます。「ストレージ」または「ストレージとキャッシュ」から、まずキャッシュを削除してください。「ストレージを消去」はローカルのアプリデータをリセットするため、誤って選択しないよう注意してください。
- 接続をタップしたときだけ終了または切断する:まずメイン画面を開けるか確認します。VPNサービスだけが停止する場合は、システムのVPN許可を確認し、端末のVPN接続を使用中のほかのアプリを切断してから再試行してください。画面ロック後だけ切断される場合は、システムがクライアントのバックグラウンド動作を制限していないか確認します。
- 設定のインポート後だけ再発する:画面を開ける場合は、まず使用可能な設定を書き出し、元のサブスクリプションURLも保存してください。復元時は、現在のコアに対応していると確認できた設定を一つだけ追加します。サブスクリプションをインポートできても、クライアントが項目を読み取れたことを示すだけで、コアがすべての通信方式やセキュリティ層のパラメーターに対応しているとは限りません。
起動時に落ちる場合のよくある質問
.NETをインストール済みなのに、ランタイム不足と表示されるのはなぜ?
エラーダイアログに表示されたフレームワーク名、バージョン、アーキテクチャを照合してください。通常のランタイムだけがインストールされている場合や、x86版のデスクトップランタイムが入っている一方で、起動しているのがx64版の場合に注意が必要です。インストール後は、古いショートカットの影響を避けるため、展開先フォルダーから直接起動してください。
管理者として実行した場合だけ起動できます。ずっとこの方法で使う必要がありますか?
まず同じビルドを、通常のユーザーアカウントで書き込み可能なフォルダーに置いて試してください。起動できる場合は、データフォルダーの移動か、問題のパスに対する権限の修正を優先します。通常の画面を起動することと、TUNを有効にするためにシステム権限が必要なことは別の問題です。日常的な書き込みの問題を回避するために、常に管理者権限で実行する必要はありません。
初回起動にも失敗します。問い合わせには何を添えればよいですか?
OSのバージョン、パッケージのファイル名、アプリのアーキテクチャ、再現時刻、関連する最初の例外を添えてください。同じビルドを新しいフォルダーに置いて再確認したかどうかも明記します。ログを共有する前に、サブスクリプションURL、アクセストークン、ノードの認証情報、ユーザー名を含むローカルパスを隠してください。設定フォルダー全体をそのままアップロードしないでください。