· トラブル対処 · 約8分

v2rayNが起動直後に落ちるときの対処法|.NETランタイム・フォルダー権限・設定ファイルを確認

起動直後にウィンドウが消える場合は、.NETデスクトップランタイム、フォルダーの書き込み権限、設定ファイルを順に確認。Androidで落ちる場合の対処法も解説します。

この記事の要点

Windowsでは、まずv2rayNのプロセスが終了しているか確認し、起動ログからランタイム不足、フォルダーへの書き込み失敗、設定ファイルの読み込みエラーを切り分けます。更新後にだけ落ちる場合は、旧フォルダーを残し、同じビルドを新しいフォルダーで初回起動してください。Androidでは、アプリ画面が終了するのか、接続後にVPNサービスが停止するのかを確認します。

v2rayNのプロセスが終了したか確認する

ウィンドウが消えても、プロセスがクラッシュしたとは限りません。まずWindowsのタスクバー通知領域を開き、v2rayNのアイコンを右クリックしてメイン画面を表示できるか試してください。または Ctrl + Shift + Esc を押し、タスク マネージャーの「詳細」タブで v2rayN.exe が実行中か確認します。プロセスが残っていて画面が応答しない場合は、画面のフリーズとして状況を記録してください。ランタイム不足と決めつけて再インストールを繰り返す必要はありません。

プロセスの状態起動ログランタイムのアーキテクチャフォルダーの権限設定の切り分け

.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

原因:ファイルまたはフォルダーへのアクセスが拒否されています。対処法:まずイベントの詳細に記載された実際のパスを確認してください。書き込み先がアプリのフォルダー内なら、同じビルドを現在のアカウントで書き込める新しいフォルダーに置いて再確認します。

フォルダーの権限を確認し、旧設定を切り分ける

ログに記載されたデータフォルダーで、現在のアカウントを使って空のテキストファイルを作成し、保存後に削除してください。失敗した場合、その場所では現在のアカウントに必要な操作が許可されていません。成功しても、そのファイルを書き込めることが確認できただけです。既存のデータベースに読み取り専用属性が付いている、別のプロセスが使用中、または個別のアクセス制限がある可能性は残ります。起動させるためにシステムフォルダーの権限を一括変更しないでください。

  1. 終了してバックアップする

    通知領域の右クリックメニューから終了し、タスク マネージャーで旧プロセスが終了したことを確認してから、旧展開フォルダーと別途指定したデータ保存先をバックアップします。クライアントの実行中にデータベースファイルだけをコピーしないでください。サブスクリプションURLやノードの認証情報は、ローカルのバックアップ内で管理してください。

  2. 新しいフォルダーに展開する

    元のインストールパッケージから同じビルドをすべて展開します。たとえば、エクスプローラーのアドレスバーに %LOCALAPPDATA% と入力して開き、そこで v2rayN-test フォルダーを作成します。圧縮ファイル内から直接実行したり、新しいパッケージを旧フォルダーに上書きしたりしないでください。

  3. 初回起動を確認する

    旧データはコピーせず、新しいフォルダー内の v2rayN.exe を通常のユーザーアカウントで実行してください。使用中のビルドが共有場所からユーザーデータを読み込む場合、アプリのフォルダーを変えただけでは初回起動になりません。ログで実際のデータパスを確認し、バックアップを取ってから該当データを一時的に別の場所へ移してください。

  4. データを段階的に戻す

    初回起動できたら、まず元のサブスクリプションURLから再登録し、その後にカスタム設定を戻します。データを戻すたびにアプリを終了して再起動してください。特定のデータを戻した後だけ問題が再発する場合は、そのデータに範囲を絞って調べます。旧バージョンの設定、データベース、コアをまとめて新しいフォルダーに上書きしないでください。

Androidでアプリが落ちる場合とVPNサービスが終了する場合

v2rayNGはXrayコア、v2flyNGはv2flyコアを使用します。どちらのAndroidクライアントも、Windowsの.NETデスクトップランタイムには依存しません。アイコンをタップしたとき、設定をインポートしたとき、接続をタップした後のどの段階で問題が起きるか記録し、アプリの起動とVPNの許可設定のどちらを調べるか判断してください。

起動時に落ちる場合のよくある質問

.NETをインストール済みなのに、ランタイム不足と表示されるのはなぜ?

エラーダイアログに表示されたフレームワーク名、バージョン、アーキテクチャを照合してください。通常のランタイムだけがインストールされている場合や、x86版のデスクトップランタイムが入っている一方で、起動しているのがx64版の場合に注意が必要です。インストール後は、古いショートカットの影響を避けるため、展開先フォルダーから直接起動してください。

管理者として実行した場合だけ起動できます。ずっとこの方法で使う必要がありますか?

まず同じビルドを、通常のユーザーアカウントで書き込み可能なフォルダーに置いて試してください。起動できる場合は、データフォルダーの移動か、問題のパスに対する権限の修正を優先します。通常の画面を起動することと、TUNを有効にするためにシステム権限が必要なことは別の問題です。日常的な書き込みの問題を回避するために、常に管理者権限で実行する必要はありません。

初回起動にも失敗します。問い合わせには何を添えればよいですか?

OSのバージョン、パッケージのファイル名、アプリのアーキテクチャ、再現時刻、関連する最初の例外を添えてください。同じビルドを新しいフォルダーに置いて再確認したかどうかも明記します。ログを共有する前に、サブスクリプションURL、アクセストークン、ノードの認証情報、ユーザー名を含むローカルパスを隠してください。設定フォルダー全体をそのままアップロードしないでください。

クライアントのダウンロードとインストール