トラブル診断

V2Ray トラブルシューティングガイド

まず、問題がどの段階で起きているかを確認してから、該当する設定を見直してください。インストール、サブスクリプションの追加、初回確認がまだの場合は、入門ガイドの手順に沿って進めてください。接続実績があり、現在具体的な症状が出ている場合は、このページの目次から該当する項目へ進めます。入門ガイドでは通常の手順を、本ページではどの段階で止まったか、その確認方法、変更しても改善しない場合の戻し方を説明します。

接続後にネットが使えない

クライアントに「接続済み」と表示されても、ローカルで起動処理の一部が完了しただけで、Webリクエストが正しい経路から送信されたとは限りません。まず症状を2つに分けます。クライアントを終了してもWebページを開けない場合は、端末のネットワークや残存プロキシを確認します。終了すると直る場合は、クライアントの起動中に限った問題なので、ローカルの接続口、ルーティング、出力先を調べます。デスクトップ版では推奨クライアントのv2rayNを例に説明します。メニュー名は現在の画面に合わせて読み替えてください。

まず基本のネットワーク接続を確認する

v2rayNでは、まずトレイメニューからクライアントが設定したシステムプロキシを解除してから、プログラムを終了します。会社や組織が端末にプロキシを設定している場合は、元の設定に戻してください。安易に無効化しないでください。Androidではクライアントを切断し、システムのVPN画面で状態を確認します。「常時接続」や「VPN未接続時の接続をブロック」が有効な場合、切断後にネットへ接続できないのは、その設定による可能性があります。管理対象端末では設定を自分で変更せず、管理者に確認してください。

普段利用でき、同じサービスに依存しないWebサイトを2つ選び、ブラウザーでそれぞれ開きます。以前開いたままのタブだけで判断しないでください。キャッシュにページの一部が残り、接続が不安定に見えることがあります。基本ネットワークでも両方開けない場合は、正しいWi-Fiに接続しているか、公衆Wi-Fiのログインが必要か、同じネットワーク上の別端末では問題ないかを確認します。1台だけ失敗するなら、その端末のプロキシとネットワーク設定を確認します。複数台で失敗するなら、接続先のネットワーク自体を確認してください。

ローカルの待ち受けと実際のWebリクエストを分けて確認する

デスクトップ版ではカーネルを再起動し、クライアントを複数起動しないようにします。設定画面でローカルのSOCKSポートを確認してください。以下では一般的な 10808 を例にしていますが、実際の確認には画面に表示された値を使います。2つ目のコマンドはリクエストを明示的にローカルプロキシへ送り、ブラウザーがシステムプロキシを使っているかどうかに依存しません。ドメイン名の解決もプロキシ側に任せるため、この経路でWebページにアクセスできるか確認できます。システム設定は変更されません。

Test-NetConnection -ComputerName 127.0.0.1 -Port 10808
curl.exe --proxy socks5h://127.0.0.1:10808 --max-time 15 -I https://example.com/

1つ目のコマンドでポートに接続できない場合は、カーネルが起動しているか、待ち受けアドレスがループバックになっているか、ポート番号が正しいかを確認します。ノードを何度も切り替える必要はありません。1つ目は成功し、2つ目がすぐに拒否される場合は、そのポートに設定されたプロトコルを確認してください。ローカルHTTPプロキシとSOCKSプロキシは、どちらも待ち受けていても互換ではありません。2つ目のコマンドで接続先サイトのレスポンスヘッダーが返れば、そのリクエストは通っています。ただし、すべてのサイトにアクセスできることや、ブラウザーが同じ接続口を使っていることを示すものではありません。

ログからリクエストが止まった段階を確認する

ログ画面を表示したままテストリクエストを1回だけ送信し、時刻を記録します。該当時刻に接続記録がまったくない場合は、アプリが実際にどのプロキシを使っているかを確認してから、接続を記録できるログレベルかを確認します。リクエストが記録されているのに想定した出力先が選ばれていない場合は、有効なルーティング設定と、より広い条件のルールが先に並んでいないかを確認します。選択された出力先に渡された記録がある場合は、最後のリトライ失敗ではなく、最初に記録された接続タイムアウト、名前解決、ハンドシェイクのエラーを確認してください。

調査が終わる前に、以前有効だった設定を1項目ずつ元に戻し、直結で開く普段使いのページと、プロキシ経由で確認するテストページを同時に開くなど、実際の利用状況でもう一度確認します。明示的なコマンドでは常に成功するのに、普段使うアプリで開けない場合は、システムプロキシが効かないへ進んでください。特定のサービスのドメインだけ開けない場合は、クライアントを再インストールせず、まずDNSの問題を確認します。

ノードのタイムアウトとハンドシェイク失敗

遅延テストでタイムアウトが出た場合、その意味はクライアントが使うテスト方法によって異なります。接続先ポートへの接続だけを試すものもあれば、ノード経由でテスト用Webページにアクセスするものもあります。前者が成功してもプロトコルのハンドシェイクが有効とは限らず、後者の失敗もテストサイト自体にアクセスできないことが原因かもしれません。まず同じノードで通常のWebリクエストを1回送り、ログの時刻を操作時刻と照らし合わせてから、アドレス、ポート、ハンドシェイクパラメーターのどれを調べるか判断します。

時刻、ノードアドレス、接続先ポートを確認する

システムの日付、時刻、タイムゾーンを確認し、信頼できる時刻源との同期を有効にします。証明書の有効期間はシステム時刻に依存するため、長時間スリープした後や時刻を手動で変更した後は特に確認してください。同期後にエラーが解消した場合は、正しい時刻を維持し、プロトコルの設定は変更しません。ログにサーバーのドメイン名が見つからないとある場合は、ドメインが正しく取り込まれているかを確認し、システムの名前解決結果とクライアントが実際に使った結果を比較します。テスト目的でサブスクリプション内のサーバー名を一時的なアドレスに置き換え、そのまま使い続けないでください。

TCP接続を確認する場合、そのサービスを自分で管理しているか、テストの許可を得ていることを確認したうえで、Windowsの Test-NetConnection を使い、実際のサービスポートを調べられます。明示的に接続拒否された場合は、サービスが想定したアドレスとポートで待ち受けているか、接続先を間違えていないかを確認します。タイムアウトが続く場合は、経路、アクセス制御、サービス停止も考えられます。ポートに接続できても、TCP接続が成功しただけであり、証明書、転送経路、認証は検証できません。UDPを使う転送では、このTCPテストの結果を結論として扱わないでください。

同じ再現テストでハンドシェイクの項目を確認する

ノードの詳細を開き、サーバーから提供された元のパラメーターと照合します。まずプロトコル、サーバーポート、転送方式、安全性の種類を確認し、次にサーバー名、ホストヘッダー、転送パスを確認します。サーバーアドレスは接続先で、TLSサーバー名はハンドシェイクと証明書の識別に使われます。転送層のホストヘッダーやパスは、その後のサービス振り分けに使われます。同じ値の場合もありますが、機械的にすべて同じ値に設定してはいけません。インポート後に表示されない項目を経験だけで補わず、設定の提供元に確認してください。

ログに証明書名の不一致、有効期限切れ、信頼できない証明書チェーンが最初に記録されている場合は、それぞれの内容に沿って対処してください。証明書検証のスキップを修正方法にしないでください。TLSエラーより前に読み取りタイムアウトがある場合、原因は証明書ではなく、上流への転送やサービスの応答待ちかもしれません。カーネルの対応機能に関するメッセージが出た場合は、クライアント比較で利用するクライアントを確認し、XrayとV2Flyのコアの違いも参照してください。コアを切り替える前に元の設定を保存し、ノードとコアを同時に変更して比較できなくなるのを避けます。

条件を変えて再確認し、相関関係だけで原因を決めない

端末とネットワークを変えず、すでに動作確認済みの別ノードを試します。次に問題のあるノードはそのままにして、正常と確認できている別のネットワークで試します。同じノードが2つのネットワークで失敗するなら、そのノードの設定やサーバーの状態を重点的に確認します。複数のノードが特定のネットワークだけで失敗するなら、接続先ネットワークを重点的に調べます。ネットワークを切り替えるとIPアドレスの種類や名前解決サービスも変わることがあるため、結果で原因の範囲は絞れますが、1回成功しただけで原因を断定できません。

サービスの管理者に問い合わせる記録には、失敗した時刻とタイムゾーン、使用した転送方式、サーバーポートまで接続できたか、ログで最初に出たエラーを含めます。認証情報、共有リンク、スクリーンショット内のサブスクリプションURLは公開しないでください。エラーの意味を詳しく知りたい場合は、よくあるログエラーの解説を参照してください。v2rayNの画面に沿って操作手順を確認する場合は、ノードのタイムアウトを調べる手順をご覧ください。

サブスクリプションの更新失敗・リストが空

サブスクリプションの更新は、内容の取得とノードの解析の2段階に分かれます。「更新失敗」と表示された場合は、まずネットワークリクエストを確認します。「更新完了」と表示されてもノードが見つからない場合は、選択中のグループ、取得した本文、形式を確認します。作業前に、まだ使える既存グループを残してください。リストを先に消去したり、テスト目的で個人用サブスクリプションをオンライン変換ツールに送信したりしないでください。サブスクリプションURL自体にアクセス権限が含まれることが多いため、URL全体の漏えいもパスワード漏えいと同様に扱う必要があります。

更新対象のURLとグループを確認する

v2rayNのサブスクリプショングループ設定で、対象のグループとURLを確認し、保存後に別のグループではなくそのグループを更新したか確かめます。Androidではv2rayNGまたはv2flyNGのサブスクリプショングループ管理で同じ項目を確認し、ノード一覧に戻って更新します。コピー時は先頭や末尾の空白、改行、チャットアプリが自動で付けた句読点に注意してください。URLのクエリパラメーターは通常必要な情報なので、手動で削ったり、むやみに再エンコードしたりしないでください。

リストに古い項目が残る場合は、キーワード検索、グループの絞り込み、現在のグループのみ表示する設定が有効か確認します。「グループの追加」と「グループの更新」も区別してください。前者はURLを保存するだけで、内容が正常に取り込まれたことを示しません。比較用に一時グループを追加する場合も、元のグループをすぐに削除しないでください。まず新しいグループからノードを選択して接続できることを確認してから、重複項目を整理します。

取得結果に応じて対処する

ログに名前解決エラー、接続タイムアウト、証明書エラーがある場合は、まずサブスクリプションを取得するネットワーク経路を確認します。クライアントの更新方法が直接接続か、プロキシ経由かを確認し、後者の場合は必要となる既存ノードがまだ使えるか確かめてください。すべてのノードが利用できない場合、プロキシ経由の更新は循環依存になることがあります。サブスクリプションサービスに正常にアクセスできるネットワークを使うか、管理者に有効な接続先を確認してください。同じ失敗リクエストを何度も繰り返さないでください。

未認証またはアクセス禁止の場合は、サブスクリプションの期限切れや権限のリセットを確認し、管理者から提供された新しいURLを使います。リソースが見つからない場合はパスが変更されていないか確認し、リクエスト過多の場合はサービスのルールに従って待ちます。成功と表示されても、実際にはログインページ、メンテナンスページ、エラー説明が返っている可能性があります。信頼できる端末で返却形式を確認し、本文をフォーラムに貼り付けないでください。ブラウザーでそのURLにログインが必要な場合、GUIクライアントがブラウザーのログイン状態を自動で引き継ぐことは通常ありません。

返却形式とノードの対応状況を確認する

単一ノードの共有リンク、ノード一覧のサブスクリプション、コア全体の設定ファイルを区別してください。入口が異なるため、設定ファイル全体をサブスクリプション欄に貼り付けても、有効な一覧にはなりません。サービスによっては、リクエスト元のクライアントに応じて異なる形式を返します。同じURLからブラウザーでテキストをダウンロードできても、現在のクライアントで解析できるとは限りません。エンコードされたテキスト全体を手作業で分解・変更せず、URLに対応するクライアント形式を提供元に確認してください。一部の項目だけ表示される場合は、欠けているプロトコルや転送方式を記録し、利用可能なコアが対応する項目を確認します。

更新後、対象グループに想定したノードが表示されるか確認し、ノードを1つ手動で選んでWebリクエストを送ります。リストが表示されても、すべてのノードが接続できるとは限りません。反対に、古いノードが使えても、サブスクリプションが更新されたことにはなりません。何度更新しても古い内容が返る場合は、クライアントに表示された更新結果を記録し、サーバー側のキャッシュや公開処理が完了しているか確認してください。新旧の違いを確認してからグループを整理します。該当メニューが見つからないだけの場合は、入門ガイドでインポート手順を確認してください。

通信速度が遅い・断続的に止まる

まず「遅い」の内容を特定します。ドメインを初めて開くまで時間がかかるのか、ダウンロード開始後の速度がずっと遅いのか、リアルタイム音声・動画がときどき止まるのかで、原因は異なります。それぞれ名前解決や接続確立、継続的な転送、遅延のばらつきやパケットロスが関係している可能性があります。画面に表示される単発の遅延値は、そのときの応答時間にすぎず、大容量ファイルの転送速度を示すものではありません。速度測定サイトが速くても、仕事で使うサービスが同じ経路で同じ性能になるとは限りません。

再現できる条件で比較する

同期、バックアップ、ほかのダウンロードを一時停止し、一般公開されている同じテスト用リソースを選び、近い時間帯に基本ネットワークとプロキシ経由の状態を記録します。近いサイズのリソースで数回繰り返し、最も速い結果ではなく代表的な結果を比べてください。2つの経路で同じサイトにアクセスできない場合は、それぞれアクセスできる基準を比較し、同じ接続先を使った厳密な比較とは扱わないでください。初回表示までの待ち時間、転送中の速度の変化、中断の有無をそれぞれ記録すると、似て見える症状を区別しやすくなります。

ノードを変えずにWi-Fi、LANケーブル、モバイルデータのうち2つの条件で試し、次にネットワークを固定して利用可能な別ノードと比較します。基本ネットワークとプロキシの両方が遅い場合は、電波状態、バックグラウンド通信、接続回線を確認してください。同じ条件で特定のノードだけが継続して遅い場合は、帯域制限や負荷についてサービス提供元に確認します。特定の時間帯だけ発生する場合は別の時間にも測定し、夜間の一時的な混雑を設定の恒常的な問題と決めつけないでください。

比較対象の経路を実際に通信が通っているか確認する

クライアントのログに実際のリクエストを記録し、対象ドメインと出力先ラベルを確認します。アプリが独自のプロキシ設定で直結している場合や、現在のルーティングでデフォルトルールに一致している場合は、比較したい経路と異なる結果になることがあります。システムのプロキシ接続口が主にHTTPまたはHTTPSリクエストを受け付ける場合、リアルタイムアプリのUDP通信も同じ経路を通るとは限りません。そのアプリが現在の接続方式に対応しているか、ドキュメントとログで確認してから、プロトコルの違いが停止の原因かを判断してください。

Webページは複数のドメインからスクリプト、画像、APIを読み込みます。メインのページはすぐ表示されるのに操作できるまで時間がかかる場合は、ブラウザーのネットワークパネルで最も遅いリクエストを確認し、名前解決、接続、コンテンツのダウンロードのどの段階で待っているかを分けて、クライアントログと照合します。特定のリソースドメインだけ遅い場合は、そのドメインの振り分けと接続先サービスを重点的に確認します。1つのリソースのためにルーティング全体をリセットしないでください。ログレベルをデバッグにした場合は、再現中だけ有効にし、完了後は通常のレベルに戻します。

端末の負荷と設定変更の副作用を確認する

速度が落ちたときに、システムのタスクマネージャーやリソースモニターも確認します。クライアントでダウンロード中にCPU使用率が高い状態が続く、端末が高温になる、ディスク書き込みがボトルネックになる場合は、高負荷のプログラムを停止し、端末の温度が落ち着いてから再測定してください。ブラウザー単体でのテストと複数の作業を同時に行うテストを比べると、ダウンロード画面だけを見るより端末側のボトルネックを見つけやすくなります。Android端末で画面消灯後だけ不安定になる場合は、Androidのバックグラウンド切断を確認し、システムがサービスを停止していないか調べてください。

根拠がないまま転送方式の変更、多重化の有効化、仮想インターフェースの調整を同時に行わないでください。小さなページは正常なのに大容量転送が頻繁に止まる場合も、現象だけでパケットサイズの問題と決めつけず、リソース側の帯域制限や経路上のパケットロスを先に確認します。必要に応じてネットワーク管理者に経路を調べてもらってください。設定変更を残すのは、同じテストを繰り返して改善し、新たなタイムアウト、音声・動画の不具合、LANアクセスの問題が発生しない場合に限ります。そうでなければ変更を元に戻し、比較結果をもとに調査を続けます。

DNSの名前解決・ルーティングの問題

名前解決エラーは、異なる2つの対象で起きることがあります。サーバー名を解決できない場合はクライアントが出力先へ接続できず、接続先Webサイトのドメインを解決できない場合は一部のリクエストだけが失敗することがあります。まずログからエラーのドメインがどちらに当たるかを確認し、名前解決を行ったのがシステム、アプリ、コアのどれかを調べます。Webページに「サーバーが見つからない」と表示されても、システムDNSの不具合とは限りません。Webリクエストがプロキシ経由で送られた後に、名前解決に失敗した可能性もあります。

システムでの問い合わせとアプリの実際のリクエストを比べる

まずシステムの既定設定で一般公開ドメインを1つ検索し、返されたアドレス、エラー、待ち時間を記録します。Windowsでは以下のシステム標準の問い合わせツールを使えます。特定のドメインを再現する場合は、例を公開されていてテスト可能な対象に置き換えてください。この結果が示すのは今回の問い合わせだけです。ブラウザーのセキュアDNS、コア設定のリゾルバー、プロキシ接続先も同じ結果を得たとは限りません。

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

IPv4とIPv6のアドレスを別々に検索する目的は、どちらの種類に問題があるかを確認することであり、すべてのドメインで両方のアドレスが返ることを求めるものではありません。特定の種類のレコードが返っても、現在のネットワークからそのアドレスに接続できるとは限りません。システムの検索は成功するのにブラウザーでは失敗する場合は、ブラウザーが独自のセキュアDNSを使っているか確認し、既定のネットワーク設定を使う別のアプリとも比較します。明示的なプロキシリクエストだけ失敗する場合は、コアまたは接続先が対象ドメインの名前解決を行っているか確認し、その経路のログと照合してください。比較が終わったら、元のセキュアDNS設定に戻します。

ドメイン一致とIPアドレス一致の順序を確認する

コアはドメインを受け取ると、ドメインルールに基づいて出力先を決定できます。さらにドメインをIPアドレスに解決してルーティング条件に使うかどうかは、ルーティングのドメイン戦略によって異なります。AsIs はルーティング判定のためにドメインを積極的に解決しません。IPIfNonMatch は、ドメインのリクエストがルールに一致しなかった場合に、名前を解決してからアドレスで照合します。アプリ側ですでに名前解決し、接続先アドレスだけをコアに渡している場合、ドメインルールではそのリクエストに一致しないことがあります。まずログに記録された接続先の形式を確認してから、どの種類のルールを調べるか判断してください。

以下は、direct 出力先ラベルが設定済みのコアで使う設定例です。ローカル管理用ドメインを1つ直結にするルールだけを示しています。自分の設定で使う場合は、実際に管理しているドメインに置き換え、既存ルールに統合してください。完全な設定ファイルではなく、リゾルバーを自動的に割り当てるものでもありません。そのドメインが社内ネットワークでしか解決できない場合、直結ルールが正しくても公開DNSから有効なアドレスが返るとは限りません。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["full:router.home.arpa"],
        "outboundTag": "direct"
      }
    ]
  }
}

内部ドメイン、キャッシュ、起動時の依存関係を確認する

家庭内の管理ドメインや組織内ドメインは、そのネットワークで信頼されているリゾルバーを引き続き使ってください。テストのために内部名を外部の公開リゾルバーへ送信しないでください。ルールを変更した後は変更前後の結果を記録し、古い接続の再利用を避けるためテスト対象のアプリを再起動します。キャッシュの有効期間が残っている場合があり、システム、アプリ、コアが同じタイミングで更新されるとは限りません。新旧の結果が交互に出る場合は、複数のDNSサービスを次々に切り替えるのではなく、どの層がどのレコードを返したかを特定してください。

よくある問題に、ノードのアドレスがドメイン名に依存し、そのアドレスを解決するリクエストも、まだ接続できていない同じノード経由に設定されているケースがあります。この場合、プロキシの出力先が正しくても起動できません。まずノードのドメイン名に使われる初期の名前解決経路を確認し、次に接続先ドメインの名前解決方針を確認します。修正後はノードの起動、一般のWebサイト、維持が必要な内部名をそれぞれ再確認してください。用語の意味は用語集で確認できます。既存の内部ネットワーク設定を新しいルールで上書きしないでください。

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

システムプロキシは、システム設定に従うアプリのリクエストをどこへ渡すかを決めます。ルーティングは、コアがリクエストを受け取った後、どの出力先へ送るかを決めます。この2つは別々に確認する必要があります。Webページがルーティングによって直結されていても、ローカルクライアントを経由していないとは限りません。反対に、クライアントのステータス欄にプロキシ設定済みと表示されても、すべてのアプリがシステム設定を使うとは限りません。どの段階に問題があるか調べるため、まず実際のリクエストがローカルの待ち受けに届いているか確認します。

デスクトップで実際の接続口を確認する

v2rayNのトレイメニューでシステムプロキシの自動設定を選び、システムのネットワーク設定で反映された内容を確認します。プロキシを手動設定するアプリでは、そのアプリが対応するプロトコルに合わせて、クライアント画面に表示された待ち受けアドレスとポートを入力してください。リモートノードのポートをローカルの接続口に指定してはいけません。同じPCで確認する場合は通常ループバックアドレスを使います。トラブル調査のために「LANからの接続を許可」を有効にする必要はありません。ローカルのポートを変更したことがある場合は、手動設定したアプリが古いポートを参照していないかも確認してください。

システムまず確認する場所確認方法
Windows設定 → ネットワークとインターネット → プロキシ手動プロキシと自動構成スクリプトを確認します。サービスによってはデスクトップアプリとは異なるプロキシ設定を使用します。
macOSシステム設定 → ネットワーク → 現在のサービス → 詳細 → プロキシ使用中のネットワークサービスを表示しているか確認し、選択したプロキシの種類とポートを確認します。
Linuxデスクトップのネットワークプロキシ設定、対象アプリの設定、または起動環境デスクトップのセッションとコマンドラインのプロセスが同じ接続口を使っているか確認します。両者でプロキシの状態が共有されるとは限りません。

システム画面に自動構成スクリプトと手動設定の両方がある場合は、元の値と組織のポリシーで管理されているかを記録します。古いスクリプトが特定のドメインを直結にする場合や、別のネットワークツールがクライアント設定後に元の値へ戻す場合があります。アプリ終了後もローカルポートを指すプロキシが残っている場合は、クライアントのシステムプロキシ解除機能を使って元に戻します。管理対象端末では管理者から提供された元の設定に戻し、出所不明の管理項目を削除しないでください。

アプリ側の設定とルーティング結果を切り分ける

まだ問題がある場合は、アプリを1つ選んで個別に再確認します。アプリの設定で「システムプロキシを使用」が選ばれているか、独自のプロキシ設定や「直接接続」の優先設定がないかを調べます。テスト用のタブを閉じて新しいリクエストを送り、必要ならアプリを再起動して、既存の接続が古い設定を使い続けないようにしてください。コマンドラインツールは環境変数からプロキシアドレスを取得することがあります。ローカルプロキシを明示すると成功する場合でも、その呼び出し方法が使えることを示すだけで、システム設定が有効かどうかの確認にはなりません。

クライアントがリクエストを受け取っている場合は、ログで選択された出力先を確認します。出力先ラベルが直結なら、リクエストはコアに届いた後、ルールに従って直接送信されています。システムプロキシを変更し続けるのではなく、ルーティングを確認してください。より具体的な接続先ルールが前にある広範なルールに遮られていないか、最終的にデフォルトの出力先が選ばれていないかを確認します。仮想インターフェースモードを明示的にテストする場合は、既存のシステムプロキシとほかのネットワークツールの状態を記録してから、それぞれ個別に試してください。2つの接続口が同時に有効になり、判断が難しくなるのを避けます。

終了、再起動、ネットワーク切り替え後の状態を確認する

修正後は2段階で動作を確認します。クライアント起動中にシステム設定と実際の待ち受け状態が一致することを確認し、終了後にはアプリが元のプロキシ状態に戻ることを確認します。次に普段使うネットワーク間で一度切り替え、別のネットワークサービスや元のスクリプトに切り替わっていないか調べます。再起動のたびに別のプログラムが設定を上書きする場合は、複数のツールで同じポートを何度も設定するのではなく、どのプログラムがプロキシ設定を書き換えているかを確認してください。1つのアプリだけ機能しない場合は、よくある質問でアプリの接続方法を確認します。

クライアントのクラッシュ・起動失敗

まず、起動のどの段階で問題が起きているかを確認します。ウィンドウが表示される前に終了する場合は、配布形式、依存コンポーネント、フォルダーのアクセス権を確認します。ウィンドウは開くがコアの起動時に失敗する場合は、ログ、待ち受けポート、現在の設定を確認します。プログラムが終了せずウィンドウだけ消えた場合は、トレイに最小化されていないか確認します。症状によって対処の順序は異なります。初めてクラッシュした時点で古いファイルに上書きせず、原因調査や復元のため、まず元のデータを保ってください。

インストールパッケージと実行環境の適合を確認する

デスクトップ版ではインストールパッケージのページで、OS、CPUアーキテクチャ、配布形式を改めて確認します。Windowsのデスクトップ版と従来のWPF版では画面が異なり、必要なランタイムも選んだパッケージの説明を確認してください。特定の.NETランタイムがないというエラーが明示されている場合は、必要なランタイムの種類とアーキテクチャを確認します。デスクトップランタイムと基本ランタイムは別のコンポーネントです。圧縮ファイルの場合は、実行ファイルを圧縮プレビューから直接起動せず、ユーザーが読み書きできる場所に完全に展開してください。

macOSではチップの種類とパッケージのアーキテクチャが一致するか確認し、システムの警告が配布元の制限、アーキテクチャ不一致、アクセス権不足のどれを示すかを確認します。Linuxではディストリビューションに合うパッケージ形式とアーキテクチャを確認し、パッケージマネージャーが示す不足依存関係に対処します。手間を省くためにシステム保護を一括で解除したり、管理者権限で常時実行したりしないでください。書き込み不可のフォルダーがエラーに示されている場合は、プログラムのフォルダー全体に不要な権限を与えず、通常のユーザーデータ用パスを選んでください。

コアの終了、ポート競合、設定エラーを切り分ける

ウィンドウが操作できる場合は、クライアントログでローカルコアの起動に失敗した最初のメッセージを探します。アドレスが使用中と表示される場合は、古いインスタンスが残っているか、別の正常なサービスがそのポートを使用していないか確認します。Windowsでは実際のポートを指定して以下のコマンドを実行し、待ち受けプロセスのIDを調べてからタスクマネージャーで該当するプロセスを確認できます。見覚えのないプロセスをすぐ終了しないでください。クライアントに空いているポートを設定し、その接続口を使うプロキシ設定も合わせて更新できます。

Get-NetTCPConnection -LocalPort 10808 -State Listen |
  Select-Object LocalAddress, LocalPort, OwningProcess

ログにコアファイルを読み込めないとある場合は、展開が完全か、対象パスが存在するか、システムのセキュリティ記録に該当する通知がないかを確認します。不明なフィールド、無効な出力先、設定の解析失敗が示されている場合は、以前使えていたノードと既定のルーティングに戻してください。エラーに記載されたフィールドがクライアント生成の設定に由来する場合は、起動のたびに上書きされるファイルを直接編集するより、GUIで生成元の設定を変更するほうが有効です。

データを保全し、独立した環境で再現する

ユーザー設定の破損が疑われる場合は、まずクライアントと残存するコアのプロセスを終了し、ソフトウェアが実際に使うデータフォルダーをバックアップします。バックアップは自分だけがアクセスできる場所に保存してください。新しいフォルダーや独立したデータで起動できる機能が明示的にサポートされている場合は、空の設定で比較できます。そうでなければ、まず説明書で実際のデータパスを確認してください。プログラムの保存先を変えるだけでデータも自動的に分離されるとは限りません。空の設定で起動できた場合は、サブスクリプションを1つ、または正常と確認済みのノードを1つだけ戻し、ルーティングや画面設定を順に復元します。

空の設定でも失敗する場合は、OSとアーキテクチャ、配布形式、クライアントのウィンドウが表示されたか、同じ時刻にローカルのイベント記録にあった異常モジュールを記録します。ログフォルダーがないからといって、エラーがなかったとは限りません。アプリがログを作成する前に問題が起きている場合があります。Androidではアプリデータを消去するとローカル設定が削除されるため、バックアップを取り、再インポートできることを確認してから検討してください。デスクトップ版の事例はv2rayNの起動時クラッシュと実行環境の確認を参照してください。

Androidの権限、アプリ別設定、バックグラウンド切断

Androidでは切断するタイミングに応じて調べます。接続ボタンを押すとすぐ失敗する場合は、システム権限と既存VPNを確認します。特定のアプリだけ通信できない場合は、アプリ別の対象リストとモードを確認します。画面ロック後しばらくして切断する場合は、バックグラウンド動作とバッテリー設定を確認します。同じノードを使い、前面表示中、画面ロック中、ネットワーク切り替え後の3つの条件でそれぞれ確認し、コアの接続タイムアウト、システムによるサービス停止、アプリがプロキシ対象外である状態を混同しないようにします。

VpnServiceの権限とシステム上の競合を確認する

v2rayNGでVPNモードを初めて起動すると、Androidに接続許可の確認が表示されます。表示されたクライアントが使用予定のものか確認してから許可してください。接続を押してもダイアログが表示されない場合は、以前に許可済みか、既存のVPNや端末管理ポリシーが新しい接続を妨げている可能性があります。システムのVPN画面で現在の接続元を確認してください。同じユーザーまたは仕事用プロファイルでは、通常、同時に有効にできるVPNは1つです。別のネットワークアプリが接続を引き継ぐと、先に使っていたVPNが切断されることがあります。

「VPNを常時接続」と「VPN未接続時の接続をブロック」は、影響の異なる設定です。前者はシステムがVPN接続を維持または再確立するかを決め、後者はVPN切断中の通常のネットワークリクエストをブロックすることがあります。基本ネットワークをテストする前に、それぞれが有効か確認してください。ポリシーが適用されている状態をWi-Fiの不具合と誤認しないようにします。仕事用プロファイルや管理対象端末では設定がロックされている場合があります。保護を無効にして長期的に運用するのではなく、管理者に相談してください。

アプリ別リストの意味を確認する

クライアントのアプリ別プロキシ設定を開き、現在のリストが「選択したアプリのみVPNを使用」する設定か、「選択したアプリはVPNを経由しない」設定かを確認します。バイパスモードが有効だと、同じチェック状態でも意味が反対になる場合があります。調査時は区別しやすいアプリを2つ選び、一方はVPNを使い、もう一方は元のネットワークを使うように設定します。保存後にVPNを再接続し、それぞれ新しいリクエストを送ってください。既存ページの再読み込みでは古い接続が使われることがあります。新しいページを開くか、対象アプリを再起動して確認します。

同じアプリでも、最近再インストールした、仕事用プロファイルにインストールした、システムのアプリ複製機能で作成した場合は、リストに同じ名前が表示されても、現在テストしているアプリとは別のインスタンスの可能性があります。アイコンの識別表示、所属するプロファイル、クライアントに表示されるアプリ項目を確認してください。ログイン画面がシステムブラウザーや別のコンポーネントで開き、元のアプリからリクエストされていないこともあります。リクエストを送ったアプリを特定してからリストを変更してください。1つのアプリを使えるようにするために、すべてのアプリを同じ出力先に設定し続けないでください。

画面ロックとネットワーク切り替えでバックグラウンド切断を調べる

まずアプリを前面に表示した状態で接続し、使えることを確認してから、問題が再現するまでの時間だけ画面をロックします。ロック解除後はすぐ再接続せず、VPNの表示、継続通知、クライアントログを確認してください。ノードエラーがなくサービス自体が停止している場合は、システムがバックグラウンド動作を制限していないかを重点的に調べます。サービスが動作中で、ログに接続の再確立や名前解決のタイムアウトがある場合は、待機後に接続回線が変わっていないか確認します。同じノードでWi-Fiとモバイルデータを一度切り替え、切り替え後に既存の接続が正常に再確立するかを個別に確認してください。

バックグラウンド制限が原因と確認できた場合は、システムのアプリ情報でバッテリーまたはバックグラウンド使用量の設定を開き、使用中のクライアントだけ「バックグラウンド実行を許可」または「制限なし」を試します。端末によっては自動起動やバックグラウンド動作の制限もあります。名称はシステムによって異なるため、端末の説明に沿って確認してください。1項目を変更するたびに同じ画面ロックテストを行い、改善の有無とバッテリー消費の変化を確認します。v2flyNGも同じ手順で確認できます。画面上の項目名は実際の表示に合わせてください。詳しい手順はAndroidの権限・省電力・アプリ別設定をご覧ください。