v2rayN 使い方ガイド · 症状から探す

v2rayNのトラブル対処

まず、端末全体がネットにつながらないのか、特定のノードだけ失敗するのか、特定のアプリだけプロキシを使わないのかを確認し、該当する項目に進んでください。

初めてインストールした場合や、まだサブスクリプションを追加していない場合は、まずクイックスタートガイドを確認してください。設定済みのクライアントで問題が起きている場合は、このページで症状から対処法を探せます。復旧後はガイドに戻り、追加、ノード選択、接続確認の手順を見直してください。

01 / 接続の基本確認

ネットに接続できない

まずプロキシを使わない接続を復旧し、その後ローカルのプロキシ入口と現在のノードを確認します。プロキシなしでも接続できない場合は、先にネットワーク自体の問題を解決してください。

プロキシを解除して直接接続を確認する

まず、接続できなくなる直前に行った操作を思い出してください。ノードの切り替え、スリープからの復帰、クライアントの更新などが該当します。デスクトップ版では、v2rayNのトレイアイコンを右クリックし、「システムプロキシ」から「システムプロキシをクリア」を選択します。TUNモードも使っていた場合は、いったん無効にしてください。ブラウザーを終了してから開き直し、これまで直接接続できていたサイトを2つ試します。2つ確認するのは、サイト側の障害を端末全体の接続障害と誤認しないためです。モバイル版では、まずクライアントのVPN接続を切り、同じようにブラウザーで確認してください。

プロキシなしでも接続できない場合は、OSがネットワークアドレスを取得しているか、接続中のネットワークでログインが必要かを確認します。公衆Wi-Fiは接続済みと表示されても、Web認証が完了していないことがあります。職場のネットワークでは、もともと必要なプロキシが設定されている場合もあります。プロキシをクリアした後は管理者の案内に従って設定を戻してください。「プロキシを無効にする」が常に正解とは限りません。通常は直接接続できるのに特定の端末だけ接続できない場合は、同じネットワーク上の別の端末でも同じサイトを試します。両方で失敗するならゲートウェイやネットワークを、片方だけ失敗するならその端末のネットワーク設定を確認してください。

直接接続できる場合はローカルの待受を確認する

v2rayNのメイン画面に戻り、利用できることが分かっている設定を選んで、アクティブサーバーに指定します。リストのハイライト表示は選択状態を示すだけです。ウィンドウのステータス欄を見て、アクティブ項目が実際に切り替わったことを確認してください。次に、メッセージ欄に直近で出力された起動ログを確認します。ポートの競合、設定の読み込み失敗、コアの起動失敗が表示されている場合は、まずその内容に対処してください。ウィンドウが開いていても、動作しているのはGUIだけかもしれません。プロキシの入口を利用できるかどうかは、コアプロセスが起動し、現在の設定で指定されたポートを待ち受けているかで判断します。

まずTUNを有効にせず、手動プロキシに対応したテスト用アプリに、クライアントに表示されるローカルのアドレスとポートを入力します。プロキシの種類も確認してください。アプリがHTTPプロキシを要求する場合は、クライアントが提供するHTTPまたは互換の混合入口を使います。SOCKSのみ対応するアプリには、対応する入口を指定してください。システムプロキシにリモートサーバーのアドレスを入力してはいけません。アプリが接続できない場合は、接続拒否、タイムアウト、接続先からのエラーのどれが報告されたかを記録します。接続拒否ならまずローカルの待受を、タイムアウトなら現在のノードやネットワークを確認してください。接続先からエラーが返った場合は、その応答がプロキシからなのか、接続先のサービスからなのかを確認します。

影響範囲に応じて次の手順を決める

手動プロキシでは接続できるのに、「システムプロキシを自動設定」した後もブラウザーでアクセスできない場合は、システムプロキシが効かないを確認してください。特定のノードだけが失敗する場合は、使えるノードを残したまま、ノードのタイムアウトを参照してポート、ハンドシェイク、接続先へのアクセスを切り分けます。ドメイン名だけでエラーが出る場合は、DNSの名前解決に失敗するを確認し、どのコンポーネントが名前解決を行っているかを調べます。トラブルシューティング中に、新しいサブスクリプションをインポートして状況を上書きしないでください。エラーの発生時刻、現在のアクティブ項目に付けたメモ、問題が起きたアプリを記録してから、一度だけ再試行します。そのリクエストと同時刻に出力されたログを確認してください。

復旧後は逆方向の確認も行います。プロキシが必要なアプリで接続できることを確認してから、システムプロキシをクリアし、直接接続が必要なサービスも使えることを確かめてください。クライアントを起動している間だけネットワークが正常で、終了すると再び切れる場合は、システムプロキシが終了済みのローカルポートを指していないか、TUNが解除されているかを確認します。再起動で一時的に解消しても、原因が分かったことにはなりません。「残ったプロキシ設定をクリア」して直接接続が復旧したのか、「コアの待受を復旧」してプロキシが使えるようになったのかを記録しておけば、次回は該当箇所から確認できます。

02 / ポートとハンドシェイク

ノードがタイムアウトする

まずテスト方法の違いを確認します。ポートに接続できてもプロトコルのハンドシェイクに成功したとは限らず、テストがタイムアウトしても、すべての接続先にアクセスできないとは限りません。

1つのノードか、同じグループか、すべてがタイムアウトするのか確認する

v2rayNのサーバーリストから、問題が起きたノードと、同じ端末で最近実際に使えたノードを1つずつ選んで比較します。同じ入口に別のメモを付けただけの項目は、比較対象として適しません。グループ全体を同時にテストすると、ローカルネットワークに負荷がかかったり、サーバー側の接続制限に触れたりするため、この2つだけをテストしてください。リストに表示される遅延が以前のテスト結果なら、改めて個別に測定し、テスト方法と時刻を記録します。過去の結果で現在の接続状態を判断しないでください。

同じグループ内の複数ノードが同時にタイムアウトする場合、共通の入口ドメイン、アカウント、またはトランスポート設定を使っている可能性があります。複数の独立した障害とは限りません。異なるグループや入口もすべて失敗する場合は、まずメッセージ欄のコア起動ログを確認し、端末の時刻と現在のネットワークも調べてください。1つの入口だけが連続して失敗し、同じルーティングモードを使う別の設定では同じページを開ける場合は、失敗した項目のサービス状態と設定を確認します。グローバル設定を変更する必要はありません。どの項目も一度も接続できていない場合は、インポートと選択の手順で基本設定を確認してから、新しい設定の非互換性かネットワーク経路の問題かを判断してください。

テスト結果を層ごとに読み解く

テスト方法ごとに確認できる範囲
テスト方法確認できること失敗した場合にまず確認すること
システムPing接続先がネットワーク層の探査に応答するか。プロキシポートは確認しない接続先が応答を許可しているかを確認し、適切なトランスポートでテストする
TCP接続テスト現在の端末から指定したTCPポートに接続できるか入口ドメイン、リモートポート、ネットワーク経路
実接続テストプロキシ経由でテスト対象のアドレスにアクセスできるかコアのログ、ハンドシェイクの設定、テスト対象のアドレス

TCP接続テストは、TCP接続が必要な入口でのみ使えます。UDPトランスポートを使う実際の通信の代わりにはなりません。実接続テストでは、リモートポートに加え、プロトコルのハンドシェイク、アウトバウンド転送、テスト対象からの応答も確認します。テスト先のアドレスが無効になった、応答方法が変わった、またはリクエストに制限がある場合、画面ではタイムアウトと表示されても、実際の接続先にはアクセスできることがあります。同じアクティブ設定を使って、普段利用する接続先を2つ試してください。両方とも正常なら、問題はテスト対象の段階にあると記録します。

ログで接続失敗とハンドシェイク失敗を切り分ける

ノードをアクティブにした状態で実際にアクセスし、テスト時刻の直前・直後に出たエラーを確認します。ログにサーバーアドレスの名前解決失敗が先に記録されている場合、リモートポートへの接続はまだ試されていません。DNSの項目を参照して入口ドメインを確認してください。接続タイムアウトの場合は、ポートの入力ミス、サーバーの待受状態、同じ端末を別の利用可能なネットワークに接続した場合の違いを調べます。接続拒否の場合は、接続が明示的に拒否されています。タイムアウト時間を延ばし続けるのではなく、ポート上のサービスと入口アドレスを確認してください。

ポートには接続できるのにハンドシェイクが失敗する場合は、プロトコル、トランスポート方式、TLSの状態、サーバー名、トランスポート経路を、設定の入手元から案内された情報と一つずつ照合します。接続先アドレスとTLSのサーバー名は異なる場合があります。値が違うからといって、同じ値に変更しないでください。証明書の有効期限に関するエラーなら、まずシステムの日付、時刻、タイムゾーンを同期します。エラーを隠すために証明書の検証を無効にしてはいけません。同じ設定で別の端末ならハンドシェイクできる場合も、両方が同じ入口、同じコア、同じトランスポート設定を使っているか確認してください。同じ名前の別項目ではないかも確かめます。

元の通信経路が復旧したことを確認する

原因を特定したら、元のアクティブノードで実際にアクセスし、メッセージ欄に同じエラーが繰り返し出ないことを確認してから、遅延を再測定します。サーバー移行でアドレスが変わった場合は、信頼できる提供元から該当グループを更新し、新しい入口を確認してからアクティブ項目を切り替えてください。新しい設定で無効なポートが実際に置き換わった場合に限り、サブスクリプションの更新で問題が解決したと言えます。更新前後でエラーがまったく変わらない場合は、入口またはハンドシェイクの段階をログから確認してください。リストを何度も更新するだけでは原因を特定できません。

03 / リクエストとインポート

サブスクリプションを更新できない

入力したものがサブスクリプションURLであることを確認し、リクエストが成功したか、取得した内容をインポートできるかを分けて調べます。

グループとURLを確認し、元の設定を残す

デスクトップ版では「サブスクリプショングループ」から「サブスクリプショングループ設定」を開き、エラーが出たグループを選択します。「メモ」と「URL」が対応しているか、更新が有効になっているかを確認してください。メモが同じでもURLが同じとは限りません。複数のグループを整理した後は、選択を間違えやすくなります。「URL」は末尾のクエリパラメーターや、コピー時に混入した改行も含めて正確に貼り付けてください。URLにアクセス情報が含まれる場合はクライアント内でのみ確認し、オンライン解析ツール、検索欄、公開の問い合わせフォームには貼り付けないでください。

vmess://またはvless://で始まる共有リンクは、通常1つのサーバー設定を表します。クリップボードからインポートし、サブスクリプションURL欄には入力しないでください。提供元のログインページやサブスクリプション管理ページも、サブスクリプションの取得先として使わないでください。ブラウザーで管理ページを開けても、Webページにアクセスできることしか分かりません。v2rayNGではサイドメニューの「サブスクリプショングループ」で保存済みURLを確認し、メイン画面に戻って更新します。メニュー名は言語やバージョンによって多少異なる場合があります。両クライアントでのサブスクリプションのインポート手順も参考にしてください。更新する前に、まだ使える設定を残して比較用のノードを失わないようにします。

現在のグループを手動で一度更新し、リクエストの失敗箇所を特定する

v2rayNの「サブスクリプショングループ」メニューから、現在のサブスクリプションを更新します。「プロキシ経由」と「プロキシを使わない」の両方を選べる場合は、現在の接続状態に合わせてください。直接接続でサブスクリプションサービスにアクセスできるなら、まずプロキシを使わずに更新します。プロキシ経由でのみアクセスできる場合は、先にアクティブノードが使えることを確認してから、プロキシ経由で更新してください。唯一のアクティブノードが使えない状態では、そのノード経由で更新しようとしても依存関係が循環します。サブスクリプションサービスにアクセスできる別のネットワークか、すでに使える別の設定を利用してください。すべてのグループで同じ更新方法を使う必要はありません。

更新を一度実行したら、すぐにそのときのログを確認します。接続が確立されていない場合は、サブスクリプションのドメイン名解決とアクセス経路を確認してください。ステータスコードがある場合は、応答内容に応じて対処します。認証エラーやアクセス拒否なら、URLが変更されていないか、権限が失効していないかを確認し、提供元に問い合わせてください。クエリパラメーターを何度も変更して試すのは避けます。404なら取得先のパスが変わっていないか確認します。レート制限がかかった場合は連続して再試行せず、サーバーの案内に従って待ちます。サーバーエラーの場合は元のリストを残し、しばらくしてから同じ経路で再テストしてください。何度もクリックすると、最初のエラー情報が新しいログに埋もれることがあります。

応答は成功しているのにノードがない場合:形式とフィルターを確認する

応答を正常に受信できたことは、クライアントが内容を取得したことを示すだけで、インポート可能な設定が含まれているとは限りません。サーバーからログインページ、ネットワーク認証ページ、通常のテキストメッセージ、または別の種類のクライアント向け設定ファイルが返される場合があります。サブスクリプション提供元が案内する出力形式が、使用中のクライアントに対応しているか確認してください。エンコードされたリンク一覧と、1行ずつの共有リンクのどちらが返される仕様なのかも提供元に確認します。形式を確認するために、レスポンス全体を外部ツールにアップロードしないでください。多くの場合、ログの解析メッセージと提供元のサブスクリプション形式の説明で十分です。

ログにはインポート済みと表示されるのに新しいノードが見当たらない場合は、該当するサブスクリプショングループに戻り、メインリストの検索条件を解除してから確認します。「サブスクリプショングループ設定」に「フィルター」が入力されているかも確認してください。元のフィルターを記録し、その条件だけを一時的に外して再試行します。外した後にノードが表示されるなら、URLではなくフィルター範囲に問題がある可能性があります。フィルターを戻すときは、必要な項目が残ることを確認してください。新しいノードが表示されているのにアクティブ項目が古い設定を指している場合は、新しい項目を手動で選び、個別に接続を確認します。

04 / 遅延と通信速度

速度が遅い

ページ表示開始までの待ち時間、通信中の速度低下、断続的な遅延を区別してください。必ずしも同じ通信段階で起きているとは限りません。

同じ条件で比較テストする

アクセスする権限のある、サイズが一定のファイルか、よく利用するページをテスト対象にします。ネットワークの種類、テスト時刻、アクティブノードを記録してください。バックグラウンド同期や進行中の大容量ダウンロードを一時停止し、端末、アプリ、ルーティング方式を同じにしたまま、ノードだけを変えて2回テストします。速度テストは一度実行して最大値を見るだけでは不十分です。初回だけ読み込みに時間がかかるのか、開始後は安定するのか、最初は速くてもすぐに低下するのかなど、同じ症状が繰り返されるかを確認します。ブラウザーのキャッシュで2回目の表示が速くなることもあります。新しいセッションで初回アクセスと比較し、キャッシュ済みの結果は別に記録してください。

対象への直接接続が許可されている場合は、直接接続でも比較します。直接接続とプロキシ接続の両方が同じ時間帯に遅いなら、Wi-Fiの電波、同じネットワーク上の他端末による通信、対象サービスの状態、ゲートウェイが上り通信中かを確認してください。プロキシ経由だけが遅い場合は、再現した時刻を記録し、別の利用可能なノードと比較します。直接接続のサイトとプロキシ経由の別サイトを比べても、通信速度の比較にはなりません。対象ごとにデータ量、キャッシュの場所、速度制限が異なる可能性があります。同様に、午前中のテザリングと夜間のWi-Fiを比べても、どの設定が速いかは判断できません。

接続待ちと通信中の速度低下を区別する

遅延テストで表示されるミリ秒の値は、ダウンロード速度を表すものではありません。ページの初回表示が遅く、次からスムーズになる場合は、名前解決、接続確立、ハンドシェイク、接続先サービスの応答準備に時間がかかっている可能性があります。ブラウザーの開発者ツールにある「ネットワーク」パネルでリクエスト時間を確認し、メインドキュメントを選択して、最初の1バイトを受信するまでの時間とコンテンツのダウンロード時間を分けて見ます。プロキシ利用中は、ブラウザーからクライアントやリモート側で完了したDNS問い合わせを直接確認できないことがあります。そのため、パネルにDNS時間が表示されないからといって、名前解決の問題を否定することはできません。同じ時刻のクライアントログも確認してください。

ファイルのダウンロード開始は速いのに、しばらくすると明らかに遅くなる場合は、別のノードと別の接続先でも比較します。1つの接続先だけで起きるなら、そのサイトやダウンロード元の速度制限を確認してください。同じノードで複数の接続先に発生するなら、プロキシ経路、現在の同時接続数、端末の負荷を確認します。システムモニターで、通信中にコアプロセスやセキュリティ関連プロセスがCPUを継続的に大量消費している場合は、同時リクエストを減らし、負荷と速度が連動して変化するかを見ます。1回の速度測定が低かっただけでシステム保護を無効にしたり、多重化の有効化、トランスポート方式の変更、コアの変更を一度に行ったりしないでください。

通信経路の誤りとネットワーク切り替えを確認する

アプリ全体が遅いのか、一部のリソースだけが遅いのかを確認します。Webページのメインドキュメントと動画、画像は別のドメインから読み込まれる場合があります。メインサイトにルーティングルールが適用されても、後続のリクエストが同じ出口を使うとは限りません。現在のルーティング設定を確認し、接続ログで遅いリソースのアウトバウンドを照合します。プロキシモードを切り替えて表示が改善した場合は、どの種類のドメインが別のルールに一致したのかを確認してください。速度測定の結論として、常にグローバルプロキシを使うのは避けてください。本来は直接接続する通信まで、不要な経路を通ることになります。

Wi-Fiの切り替え直後、端末のスリープ復帰直後、有線からWi-Fiに切り替えた後だけ遅延する場合は、新しいリクエストを一度送信し、まだ終了していない古い接続と比較してください。古い接続は切り替え前のネットワーク経路に結び付いたままの場合があり、タイムアウトしても新しい接続に問題があるとは限りません。ビデオ会議やリアルタイム通信だけが途切れ、通常のファイルダウンロードは問題ない場合は、そのアプリのトランスポート方式が現在の接続方式で処理されているかを確認します。Webページのダウンロードだけでは、リアルタイム通信の状態は判断できません。ネットワークの不安定さが原因なら、ノード設定全体を変えるより先に接続環境を改善してください。

05 / ドメイン名の解決

DNSの名前解決に失敗する

プロキシの入口ドメインと接続先のドメインを区別します。DNSレコードが見つかっても、どのコンポーネントが使った結果なのかを確認してください。

どの段階の名前解決で失敗したかを特定する

まずブラウザーに表示されたエラーの種類を正確に記録し、同じ時刻のv2rayNメッセージ欄と照らし合わせます。ログにサーバーの入口ドメインが記録されている場合、プロキシ接続がまだ確立していない可能性があります。閲覧先やルール内のドメインが記録されている場合は、アプリ、OS、プロキシのアウトバウンドのどれが名前解決を担当しているか確認してください。ブラウザーのアドレス欄でドメイン名を数字のIPアドレスに置き換えて判断してはいけません。多くのサイトはTLSのサーバー名とHTTPのホスト名を必要とし、1つのIPアドレスに複数のサイトがある場合もあります。IPアドレスで接続できなくても、DNSの問題が証明されたことにはなりません。

名前解決エラーが特定のブラウザーだけで起きる場合は、別のブラウザーまたは同じブラウザーの新しいセッションで比較し、「セキュアDNS」とブラウザー独自のプロキシ設定も確認します。アプリが独自の名前解決を使っている場合、システムの問い合わせが正常でも別のDNSサーバーを使っている可能性があります。TUNを有効にしている場合、DNS問い合わせもその対象になることがあります。有効時と無効時の結果を分けて記録してください。職場のネットワークの内部ドメインは、内部のDNSサービスが応答します。公共のDNSサービスに問い合わせても元の設定の代わりにはならず、内部ドメイン名を本来知らせるべきでない相手に送る可能性もあります。

システムの問い合わせ経路を確認し、DNSレコードと実際の接続性を区別する

WindowsのPowerShellで次の2つのコマンドを実行し、公開されているサンプルドメインの2種類のアドレスレコードをそれぞれ確認します。実際の問題を調べる場合は、ローカルでサンプルドメインをエラーが出たドメインに置き換えてください。サブスクリプションURLのパスやパラメーターを問い合わせに含めないでください。実行前にVPN、TUN、ネットワークの状態を記録します。これはその状態でシステムツールから行う問い合わせです。ブラウザー、プロキシコア、接続先サーバーが同じDNSサーバーを使っているとは限りません。

Resolve-DnsName -Name example.com -Type A -DnsOnly
Resolve-DnsName -Name example.com -Type AAAA -DnsOnly

ドメインが存在しないという結果なら、まずスペル、ネットワークの範囲、現在のネットワークから見えるはずのドメインかを確認してください。問い合わせがタイムアウトする場合は、現在のDNSサーバーに到達できるかを確認します。サーバーが「ドメインが存在しない」と明示的に応答する場合とは異なります。アドレスレコードが一方の種類だけ返る場合もあり、それ自体は異常ではありません。両方のレコードが返ってもアプリがタイムアウトする場合、レコードがあるだけで該当するネットワークに接続できるとは限りません。アプリが実際に試したアドレスの種類とエラー時刻を記録し、同じネットワークで確認してください。最初からIPv6を全体で無効にするのは避けます。

問題の段階を担当するDNS設定だけを変更する

デスクトップ版クライアントの設定から「DNS設定」を開き、現在のアクティブ設定が使うコアと、この画面の設定がそのコアに適用されるかを確認します。設定を変更する前に、元の値を保存してください。入口ドメインはプロキシ接続の確立前に名前解決する必要があります。まだ確立していない同じ接続に依存することはできません。接続確立後の接続先ドメインの名前解決は、現在のルーティングとプロキシのトランスポート方式によって異なります。DoHを使う場合は、DNSサービス自体のドメインを先に解決できるか、接続を確立できるか、システム時刻が正しいかも確認します。「暗号化された問い合わせを使う」ことと「すべてのDNS問い合わせがプロキシ経由になる」ことを混同しないでください。

特定のドメインルーティングルールだけが原因の場合は、既知のドメインを使い、対象を絞ってテストします。ルールが照合する名前、ルールの優先順、アウトバウンドを確認し、内部ドメインに影響しないことも確かめてください。詳しい設定の背景はDNS分流と名前解決の解説を参照してください。用語が分からない場合は用語集も利用できます。修正後はアプリを開き直して新しい接続を確立します。キャッシュがある場合はローカルで再度問い合わせてください。ただし、システムキャッシュを消してもブラウザーやプロキシコアのキャッシュまで消えるとは限りません。

06 / プロキシの適用とルーティング

システムプロキシが効かない

まずシステム設定に値が反映されたかを確認し、次にアプリがその設定を読み込んでいるかを確認します。ルーティングルールが処理するのは、クライアントに渡された通信です。

トレイのモードとシステム上の実際の設定を確認する

v2rayNのトレイアイコンを右クリックし、「システムプロキシ」を開きます。「システムプロキシを自動設定」を選択したら、すぐにOSのプロキシ設定画面で実際に反映された値を確認してください。Windowsでは「設定 → ネットワークとインターネット → プロキシ」、macOSでは現在使用中のネットワークサービスの詳細にある「プロキシ」、Linuxではデスクトップ環境とアプリが同じプロキシ設定を参照しているかを確認します。システムに表示されるポートは、v2rayNが現在提供するローカル入口と一致する必要があります。ポートが変わったのにシステム側に古い値が残っている場合は、モードを再適用し、新しいポートでコアが正常に起動しているか確認してください。

「システムプロキシをクリア」は、このモードで設定したシステムプロキシを解除します。各アプリ独自のプロキシ設定まで無効にする機能ではありません。「システムプロキシを変更しない」は、現在のシステム設定を積極的に書き換えないという意味です。システムが直接接続の状態だとは限らず、別のツールが残した値を初期値に戻す機能でもありません。会社の端末で管理ポリシーや自動設定スクリプトによりプロキシが配布されている場合は、元の設定を記録し、許可された範囲でテストしてください。ポリシーを変更したりスクリプトを削除したりしないでください。システムプロキシを切り替えても同じ古い値に戻る場合は、トレイメニューを何度もクリックするのではなく、別のツールや管理ポリシーが設定を書き換えていないか確認します。

システム設定を実際に参照するアプリで確認する

システムプロキシを使うよう明示的に設定されたブラウザーを選びます。完全に終了してから開き直し、普段使う接続先にアクセスしながら、v2rayNに新しい接続が記録されるか確認してください。メッセージ欄で接続ログが無効になっている場合は、クライアントのログ設定から一時的に有効にし、テスト後に元のレベルに戻します。ページが開いただけでは、直接接続かプロキシ経由か判断できません。システム設定に正しい値が反映されているのにブラウザーのアクセスが記録されない場合は、プロキシ拡張機能、独自プロキシ設定、管理ポリシー、またはシステムの除外リストを確認してください。

一部のツールだけプロキシを使わない場合は、独自のネットワーク設定がないか確認します。コマンドラインツールは環境変数や起動オプションだけを参照することがあります。また、デスクトップアプリによっては起動時にプロキシを読み込み、実行中にシステム設定を切り替えても反映されません。HTTPとSOCKSの入口は自由に入れ替えられません。プロキシ用の環境変数にリモートサーバーのアドレスを入力しないでください。アプリ内の手動プロキシだけが使える場合、ローカル入口は動作しています。残る確認点はアプリがプロキシをどう読み込むかであり、サブスクリプションの差し替えやクライアントの再インストールではありません。

リクエストが届いた後に、適用されたルーティングを確認する

ログにアプリのリクエストが記録されているのに、想定と異なるアウトバウンドが使われる場合は、クライアントの「ルーティング設定」を開き、現在の設定を確認します。テストリクエストを使って「全般」と現在の分流プリセットのアウトバウンドを一時的に比較し、その後は普段の設定に戻してください。接続先によっては直接接続のルールに一致し、プロキシを通らないのが正しい場合があります。プロキシが適用されても、リモート側に必ず接続できるとは限りません。テスト中にリクエストが記録されない場合、クライアントに通信が届いていないため、分流ルールを変更しても意味がありません。

アプリ側でプロキシを設定できず、システムプロキシでも対象にできない場合に限り、TUNモードと必要な権限を検討します。有効にする前に、現在のシステムプロキシ、ネットワーク、テスト対象アプリの状態を記録してください。まずは一つの方法だけで通信を取り込み、複数の方式を同時に有効にしてどれが働いたか分からなくならないようにします。終了時は今回のテストで有効にした方式を解除してから、以前は直接接続できていたアプリでもう一度確認してください。終了済みの待受ポートを指すプロキシ設定が残っている場合は、システムのプロキシ設定画面で今回追加した項目を削除するか、記録しておいた元の設定に戻します。

07 / 起動と復旧

クライアントがクラッシュする

ウィンドウの異常終了、トレイへの最小化、コアプロセスの終了を区別してから、アプリ本体、実行環境、設定のどれを確認するか判断します。

最初のエラーを記録し、インストール方法を確認する

ダブルクリックしてもウィンドウが表示されない場合は、システムトレイ、メニューバー、プロセス一覧を確認します。ウィンドウを閉じても画面が隠れただけのことがあり、すでに起動中のインスタンスが新しい起動要求を受け取っている可能性もあります。GUIが残っているのに接続できない場合、問題はコアプロセスに限られているかもしれません。GUIとコアの両方が終了した場合は、起動から終了までのどの段階で起きたか記録します。Windowsでは「イベントビューアー → Windowsログ → アプリケーション」で同時刻のアプリケーションエラーを確認します。他のデスクトップ環境では、システムログまたはクライアントログから該当時刻のエラーを探してください。まず最初に出た関連ログを確認し、終了後に続いて出たエラーを原因と取り違えないようにします。

インストール直後の初回起動から終了する場合は、クライアントのダウンロードページでOSとインストーラーを確認します。Windowsのデスクトップ版と従来のWPF版は、それぞれの手順に従ってインストールしてください。必要な依存環境が同じとは限りません。macOSでは実際のチップのアーキテクチャに合ったパッケージを選び、Linuxではパッケージ形式とシステムアーキテクチャの両方を確認します。実行環境が不足していると明示された場合は、現在のインストール方法に対応した手順に従って必要な依存関係を入れてください。出所不明のページから不足しているライブラリだけをダウンロードしないでください。OSが実行を明示的に拒否した場合は、表示内容と入手元を確認します。システム全体のセキュリティ設定を緩めても解決にはなりません。

既存データを残し、最小構成で再現する

以前は正常に起動していて、更新後にクラッシュするようになった場合は、現在の設定とログを自分だけがアクセスできる場所にバックアップします。設定にはサブスクリプションURLや接続情報が含まれることがあります。インストール先とユーザー設定の保存先は別の場合があり、インストール先を変えても新しい設定が使われるとは限りません。OSとインストール形式に応じた設定の保存場所を確認してから、クライアントを完全に終了し、クライアントのものと確認できた設定フォルダーを一時的に移動します。元に戻せるよう、古いフォルダーは保管してください。再インストールと同時に設定、サブスクリプション、ログをすべて削除すると、復旧が難しくなり、プログラム更新が原因なのか特定のデータが原因なのかも判断できなくなります。

新しい設定で起動したら、まずTUNもルーティングルールも有効にせず、正常に使えることが分かっているノードを1つだけインポートします。GUIが開きコアが起動することを確認したら、サブスクリプショングループ、ルーティング、DNS設定を一つずつ戻し、そのたびに終了して起動し直して確認します。特定のグループをインポートした直後に終了する場合は、そのグループのインポートと自動更新を分けてテストしてください。データ形式、個別項目のフィールド、ルールファイルに問題がある可能性があります。新しい設定でもクラッシュする場合は、実行環境、フォルダーのアクセス権、GUIのエラーを先に確認し、サブスクリプションの変更は後回しにします。

ログで示された箇所だけを対処する

ウィンドウが残ったままコアプロセスが終了する場合は、ログが示すファイル、ポート、設定項目を重点的に確認します。ポートが使用中なら、v2rayNの別インスタンスか、正規の別プログラムが使っていないかを確認してください。不要と確認できたインスタンスを終了するか、クライアントで利用可能なポートを選び、そのポートを使うローカルアプリの設定も合わせて変更します。「アクセス拒否」の場合は、現在のユーザーにコアファイルの読み取り権限と該当する設定フォルダーへの書き込み権限があるか確認します。TUNを有効にしたときだけ失敗するなら、まずTUNを無効にして通常のプロキシが使えるか確認し、OSの案内に従って必要な権限を調べてください。クライアント全体を常に高い権限で実行して回避しないでください。

問い合わせや報告をする場合は、OS、チップのアーキテクチャ、ダウンロードページに記載されたインストール形式、実際に使用しているバージョン、再現に必要な最短手順を記載します。エラーの種類と発生時刻を残し、サブスクリプションURL全体、認証情報、不要な端末内のパスは削除してください。復旧時は、テストで追加したプロキシ設定を解除し、問題のある新しいインスタンスを終了してから、バックアップした設定を戻します。同じノードで接続を再テストし、正常終了後にシステムから直接接続できることも確認してください。ウィンドウだけ戻り、コアの問題が残る場合は、最初に出たコアのエラーを引き続き調べます。

08 / Android版

Android版のトラブル対処

まずVPN権限と競合を確認し、その後、アプリ別の対象リスト、ネットワーク切り替え、画面ロック中のバックグラウンド動作を確認します。

接続をタップしても反応がない:VPNセッションを確認する

Android版v2rayNGで初めてVPNモードを起動すると、システムの接続許可ダイアログが表示されます。一度キャンセルした場合は、アプリに戻ってもう一度接続をタップし、再度確認が表示されるか確かめてください。表示されない場合は、システムの「設定」からVPN画面を開き、検索で場所を探して、別のアプリや仕事用プロファイルがセッションを使用していないか確認します。許可された範囲で競合するセッションを切断してから、v2rayNGに戻ってください。仕事用端末の管理対象設定は勝手に削除せず、別のVPNを使えるか管理者に確認します。

接続アイコンの表示は、システムがVPNセッションを確立したことを示すだけです。ノードとのハンドシェイクや、すべてのアプリが同じアウトバウンドを使うことを示すものではありません。まずv2rayNGを前面に表示したまま、使用可能と分かっている設定を選び、VPNの対象に含まれるブラウザーから新しいリクエストを送信します。失敗する場合はクライアントに戻り、同時刻のログを確認してノードがタイムアウトするの項目に沿って入口とハンドシェイクを調べてください。クライアントが起動しない場合や、インストール時にアーキテクチャの不一致が表示される場合は、Android版のダウンロードページでarm64版とユニバーサル版を確認します。V2Flyコアが必要な場合に限り、設定に合わせてv2flyNGを選んでください。クライアントを変更してもシステムのVPN権限の問題は解決しません。

一部のアプリだけ接続できない:アプリ別リストを確認する

v2rayNGの設定を開き、「アプリ別プロキシ」が有効かどうかを確認し、対象アプリのリストと「バイパスモード」の状態も確認します。リストによる制限を有効にすると、選択したアプリだけをVPNに通すモードと、選択したアプリをVPNから除外するモードがあります。リストは共通なので、モードを間違えると正反対の結果になります。元の設定を記録し、テスト用アプリを1つだけ選んで比較します。現在のセッションを停止して再接続し、アプリも完全に終了してから開き直し、新しい接続を確認してください。以前開いたページや、バックグラウンドで続いているダウンロードだけで設定が反映されたか判断しないでください。

同じ名前のアプリでも、個人用プロファイルと仕事用プロファイルでは別のアプリとして扱われることがあります。テストを行うのが、今回の設定対象となる方のアプリか確認してください。また、システムのVPN画面で「常時接続VPN」と「VPN未使用時の接続をブロック」が有効か確認します。ブロックが有効だとVPNに含まれないアプリがネットに接続できず、ノードではなく、除外リストとシステムポリシーの競合が原因かもしれません。許可なくシステムポリシーを変更しないでください。自分で管理する端末でも、必要な動作を確認したうえで、リストを変更するか強制接続を維持するか決めます。

画面ロック時の切断、ネットワーク切り替え時の切断、電池消費を分けて調べる

まず短時間で比較します。同じネットワークとノードで、前面表示中に正常に動くことを確認し、しばらく画面をロックします。ロック解除後はVPNとクライアントの状態を確認してから、新しいリクエストを送信してください。セッションが終了し、ロック後に毎回再現する場合は、システムのアプリ情報にあるバッテリー最適化、バックグラウンド実行の制限、メーカー独自のバックグラウンド設定を確認します。まずv2rayNGに対する制限を1つだけ緩和して、同じテストを繰り返してください。バックグラウンド動作を許可すると電池消費が増えることがあります。修正が有効と確認できたら、必要な設定だけを残します。詳しい確認方法はバッテリー最適化とバックグラウンド動作の確認を参照してください。

セッションが維持され、Wi-Fiからモバイルデータに切り替えたときだけ古いリクエストがタイムアウトする場合は、新しいネットワークへの接続が完了するまで待ってから新しいリクエストを送信します。それも失敗する場合は、2種類のネットワークそれぞれで手動で再接続し、同じ接続先をテストして、新しいネットワークで入口に到達できるか、名前解決や認証に問題がないか確認してください。切断ではなく電池消費が主な問題なら、システムのバッテリー使用量画面で同じ時間帯の統計を比較し、画面点灯時とロック中の違いを確認します。クライアントが頻繁に再接続やサブスクリプション更新をしていないか、アプリが通信を続けていないかも確認してください。VPNの常駐通知だけで電池消費量を判断することはできません。

修正後は3つの状態で確認します。前面でテスト用アプリを開く、画面をロックしてから復帰する、ネットワークを手動で切り替える、のそれぞれで新しいリクエストを送信してください。各状態でセッションが表示されるか、プロキシを使うアプリが動作するか、直接接続が必要なアプリが想定どおりかを記録します。特定の状態だけ問題が残る場合は、その再現手順と同時刻のログを保管してください。端末全体のネットワーク設定をリセットする必要はありません。