トラブルシューティングガイド · 8つの症状

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

まず、影響が1つのアプリ、1つのノード、端末全体のどこに及んでいるかを確認します。該当する箇所を調べ、ノード・ルーティング・DNSを同時に変更しないでください。

初めてインストールした場合や、サブスクリプションの読み込みがまだの場合は、クイックスタートに沿って、サブスクリプションの読み込み、接続方法の選択、接続と確認を進めてください。具体的な問題を再現できる場合は、以下から該当する症状を選びます。このガイドでは問題が発生している箇所ごとに対処方法を説明します。解決後はチュートリアルに戻って接続を確認できます。

01 · 接続の基本確認

ネットに接続できない:まず通常接続を確認

クライアントを有効にするとWebページが開けない場合は、まず端末自体がインターネットに接続できるか確認します。クライアントの通信を取り込む機能を停止し、普段そのまま開けるサイトにアクセスしてください。停止後も接続できない場合は、Wi-Fi、ゲートウェイ、システム設定を確認します。停止するとすぐに接続できる場合は、クライアント側の通信経路を調べます。同じ端末・同じネットワーク・同じURLで停止前後を比較し、別の端末での結果と混同しないでください。

アプリの終了と通信の取り込み停止を分けて確認

デスクトップでv2rayNを使い、システムプロキシが有効な場合は、まずクライアントでシステムプロキシを解除してからアプリを終了します。仮想NICも有効にしている場合は、別途停止してください。その後、OSのネットワークプロキシ設定を開き、終了したクライアントのローカルアドレスが設定されたままになっていないか確認します。勤務先から提供されたプロキシや自動構成スクリプトを使っていた場合は、元の設定記録に従って戻してください。必ず無効にすればよいとは限りません。モバイル端末では、システムのネットワーク設定でVPN接続が実際に切断されたか確認します。

通常接続でも失敗する場合は、他のアプリから同じサイトにアクセスできるか確認し、同じネットワークにつながった別の端末でも試します。両方の端末で失敗する場合は、ネットワークへの接続時にログインが必要か確認するか、ネットワーク管理者に問い合わせてください。現在の端末だけ失敗する場合は、有線から無線に切り替えた直後やスリープから復帰した直後ではないか、古い固定ネットワーク設定が残っていないか確認します。テストではブラウザーの新しいタブからリクエストを送信してください。古いページが表示されるのは、内容がローカルキャッシュに残っているだけかもしれません。

再接続では方式を1つだけ有効にする

通常接続が復旧したらクライアントを起動し、以前使えたことを確認済みのノードを1つ選んで、コアの起動が完了するまで待ちます。まずはシステムプロキシかVPNのどちらか一方で通信を取り込み、テストしてください。ルーティングのプリセットも同時に変更しないでください。デスクトップでは、システムプロキシに従うブラウザーで対象サイトを開き、通常接続するサイトも対照として確認します。両方とも失敗する場合は、コアが正常に待ち受けているか確認してください。片方のサイトだけ失敗する場合は、そのURLへのリクエストに関するログを記録し、ルーティング、名前解決、対象サイトの応答を切り分けます。

ログを確認するときは、新しいリクエストを送信する直前から記録します。起動ログはプロセスが該当段階まで進んだことを示すだけで、ブラウザーがリクエストを渡した証拠にはなりません。アクセスログが記録される設定だと確認できているのに、リクエスト中に該当ログがない場合は、まずアプリの接続方法を調べてください。リモート接続のタイムアウトが明記されている場合はノードのタイムアウトへ、名前解決エラーが表示される場合はDNSの問題へ進みます。同じログが繰り返し表示されても、別々の問題が複数発生しているとは限りません。

通常接続と通信取り込み時の結果を比較

比較結果まず確認すること次の手順
通信の取り込みを停止しても失敗するクライアントより前の段階に問題がある可能性システムプロキシの設定残り、ネットワーク認証、端末の接続状態を確認します。
通常接続は正常だが、通信を取り込むと複数のサイトで失敗するローカル接続口またはノードを確認コアが起動していることを確認し、使用できると確認済みのノードで再テストします。
特定のアプリだけ失敗するアプリのプロキシ設定または接続再利用の問題アプリを再起動し、実際に使用しているプロキシと名前解決の設定を確認します。
特定のドメインだけ失敗する接続先の名前解決、ルール、サイト側の問題そのドメインへの新しいリクエストで、DNS、送信先名、応答状態を確認します。

修正後は、まず以前失敗した操作をもう一度行い、次に以前アクセスできていたサイトもテストします。ほかの通信の処理方法が変わっていないか確認してください。端末を再起動するたびに復旧する場合は、次の障害時にログを残し、通信の取り込み停止、アプリの再起動、ネットワークへの再接続を個別にテストします。どの手順で最初に復旧したか記録すれば、システム設定の残り、アプリの接続未再確立、ネットワーク自体の不通を切り分けられます。一度再起動して成功しただけで、根本原因を特定できたと判断しないでください。

02 · ノードへの接続経路

ノードがタイムアウトする:ポート・ハンドシェイク・接続先リクエストを切り分け

遅延テストにタイムアウトと表示されても、ノードが無効になったとは限りません。ポートテスト、プロトコル接続、Webサイトへの接続テストでは確認する段階が異なり、テスト先も別々の場合があります。まず、どのテストで失敗したか、ブラウザーからの実際のリクエストも失敗するかを記録します。一括テストだけでエラーになる場合は、ノードを1つ選んで個別にテストしてください。すぐにグループ全体を削除したり、同じテスト結果からすべてのノードについて結論を出したりしないでください。

まずタイムアウトが1つのノードか、グループ全体に及ぶか確認

同じ端末・同じネットワークで、以前正常に使えた2つのノードから同じ接続先にアクセスします。片方だけ失敗する場合は、そのノードの有効な設定とサーバーの状態を確認してください。グループ全体が失敗し、別のグループは正常な場合は、対象ノードが同じサーバーアドレス、ポート、サービス接続口を共用していないか調べます。すべてのグループで同時に失敗する場合は、コアの起動、ネットワークの切り替え、名前解決を確認してください。特に接続方式を切り替えた直後に問題が発生していないか確認します。

ノードの設定はサービス提供元から案内された値を基準にします。サーバーアドレス、ポート、プロトコル、トランスポート方式、安全設定を組み合わせて確認してください。TLSで使うサーバー名と接続先アドレスは異なる場合があります。エラーを消すために推測でサーバー名を変更したり、証明書の検証を無視したりしないでください。ログに証明書の時刻異常が表示された場合は、まず端末の時計とタイムゾーンを確認し、サービス提供元にも証明書の状態を問い合わせます。サブスクリプションの上書き後にエラーが発生した場合は、更新前後のプロトコル項目を比較してください。ノードの表示名だけを比べても原因は分かりません。

TCPポートとローカルの待ち受けを個別に確認

起動失敗とリモート接続のタイムアウトは別の問題です。コアが正常に待ち受けていない場合、ローカルでの確認の段階で先に失敗します。以下はWindows PowerShellでの対話式チェックです。TCPを使用するノードのポートだけを対象とします。表示に従ってクライアントに設定済みのサーバーアドレスとポートを入力してください。通常のTCP接続を試みるだけで、プロキシプロトコルの確認は行わず、ブラウザーのシステムプロキシも経由しません。サブスクリプションURL、パスを含むURL、認証情報は入力しないでください。

$server = Read-Host 'ノードのサーバーアドレス'
$port = [int](Read-Host 'ノードのTCPポート')
Test-NetConnection -ComputerName $server -Port $port -InformationLevel Detailed

結果のTcpTestSucceededがTrueの場合、今回のTCP接続が成功したことだけを示します。Falseでも、それだけでサービス停止とは判断できません。名前解決の結果、現在のネットワーク経路、サービスの待ち受け状態が影響します。ポートに接続できてもクライアントでハンドシェイクに失敗する場合は、プロトコル、安全設定、コアの対応状況を確認してください。ハンドシェイクは成功するのにWebサイトの接続テストが失敗する場合は、テスト先に到達できるか、ルーティングルールがリクエストを想定したアウトバウンドに送っているかを確認します。通常のping応答がないことだけを理由に、ポートが使えないとは判断できません。

比較できる再テスト結果をひと組記録

クライアントの接続テスト先に到達できない場合は、状態を確認できる別のテスト先に切り替えて、実際のリクエストを送信します。まず小さなページでテストし、その後、最初に失敗したリソースを開いてください。ポート、ハンドシェイク、ページのうち、最初に失敗した段階を記録します。実接続テストと初回確認も参考にしてください。特定のネットワークだけで失敗する場合は、利用が認められた環境で正常と確認済みの別のネットワークに切り替え、同じ操作を繰り返します。この結果から分かるのは問題がネットワーク環境に関係していることまでで、具体的な障害箇所を特定することはできません。

修正方法は状況に応じて選びます。サービス提供元が古い接続先の停止を確認している場合は、サブスクリプションを更新するか、正確な設定を再読み込みします。コアがプロトコル項目を認識しない場合は、クライアントの対応範囲に合った設定を選びます。新しい設定でWebサイトをテストするまでは古い設定を残し、確認後に重複項目を整理してください。同じ設定項目のエラーを隠すためにタイムアウト時間を延ばさないでください。接続がときどき成功し、ログに固定的な設定エラーがない場合に限り、タイムアウト設定の変更が比較テストに役立ちます。

03 · サブスクリプションの更新

サブスクリプションの更新に失敗する:取得・解析・書き込みを切り分け

サブスクリプションの更新に失敗しても、すぐに古いグループを削除しないでください。更新処理は、サブスクリプションURLへのリクエスト、応答の解析、結果のグループへの書き込みという3段階に分かれます。ダウンロードに成功しても応答を解析できるとは限らず、一覧の件数が増えても選択中のノードが置き換わったとは限りません。まず、現在のグループ、最後に更新が成功した日時、現在使用できるノードを記録します。問題のあるグループだけを更新し、ほかのグループの結果がログに混ざらないようにしてください。

取得に失敗する:更新リクエストが実際にどの経路を使うか確認

サブスクリプションURLが現在有効なサービスの接続先であること、コピー時に引用符・改行・末尾の空白が混ざっていないことを確認します。クライアントのエラーが名前解決の失敗、接続タイムアウト、サーバーからのステータスコードのどれに該当するか調べてください。未認証またはアクセス禁止の応答が返る場合は、サービス提供元の管理画面で利用権限とURLの変更有無を確認します。サーバーがリダイレクトを返す場合は、最終的な応答がログインページではなくサブスクリプションデータであることを確認してください。URLのパラメーターを何度も手動で書き換えないでください。

v2rayNの使用中のバージョンに「直接更新」と「プロキシ経由で更新」の区別がある場合は、現在の設定を残したまま、それぞれ1回ずつ比較します。直接接続できなくても使用可能なノードがある場合は、そのノード経由で更新を試せます。現在のノード自体が使えない場合、そのノード経由で代わりのノードを取得しようとしないでください。利用が許可されたネットワークからサブスクリプションURLにアクセスできるか確認するか、サービス提供元から使える設定を入手します。ブラウザーでページを読み込めても、クライアントの更新リクエストが同じプロキシ設定や認証状態を使っているとは限りません。

取得には成功するが結果が空:応答内容とグループを確認

サーバーが正常なステータスコードを返していても、ログインページ、エラーメッセージ、別のクライアント専用設定が応答本文に含まれている場合があります。まずクライアントが表示する判定結果を確認し、サブスクリプションの形式と対応クライアントをサービス提供元に問い合わせてください。サブスクリプションの内容全体をオンライン変換・デコードページに送信しないでください。すぐに利用できる認証情報が含まれている可能性があります。クライアント内で分けてテストできる場合は、元のグループを残し、同じURLを試す一時グループを別に作成します。空の応答で使用可能な一覧が上書きされるのを防げます。

一覧に項目があるのに画面に表示されない場合は、検索語を消し、更新したグループに切り替えて、項目を非表示にするフィルターがないか確認します。一部のノードだけ読み込めた場合は、成功した項目と失敗した項目のプロトコル、トランスポート設定、クライアントの認識結果を比較してください。サービス提供元が現在のコアで認識できない項目を追加しても、サブスクリプション全体が無効とは限りません。スマートフォンではサービス提供元の対応情報を確認し、v2rayNGまたはv2flyNGを選んでください。3つのクライアントで読み込み結果が同じとは限りません。

まず手動更新を直し、その後に自動更新を再設定

手動更新が安定してから、自動更新の間隔と更新時のプロキシ方式を確認します。自動処理の実行時にPCがスリープ中、クライアントが未起動、または選択中のノードがすでに無効になっている場合があります。更新間隔を確認するには、設定の保存時刻と次回の実行時刻を記録し、ログと照合してください。手動更新は正常なのに自動更新が一度も実行されない場合は、実行状態と該当グループの自動更新設定を確認します。タスクが実行されてエラーが返る場合は、取得または解析の段階を引き続き調べます。詳しくはv2rayNのサブスクリプション更新に失敗した場合の対処法をご覧ください。

最終確認では「更新成功」の表示だけで判断しないでください。対象グループを開き、項目が実際に追加されたことを確認してから、新しい設定のノードを1つ選んで接続します。画面で古い項目が選択されたままの場合は、選び直してリクエストを送信してください。自動更新を再開した後も、同じグループが更新されていること、手動で残した項目が上書きされていないことを確認します。グループの作成方法が分からない場合は、サブスクリプションの読み込み手順を確認してください。

04 · 速度の比較

速度が遅い:初回応答と継続的な転送を分けて測定

Webページの表示が遅い、ファイルのダウンロードが遅い、動画が頻繁に止まるといった症状は、同じ性能問題とは限りません。ページが長時間真っ白になった後に突然表示される場合は、まずDNS、接続、ハンドシェイクを確認します。ダウンロードはすぐ始まるのに転送速度が低い場合は、通信経路のスループット、同時接続数、接続元と接続先の負荷を調べます。安定して再現できる操作で測定し、一度の高速な遅延テストを理由に、大容量ファイルの転送が継続的に遅い問題を否定しないでください。

接続先を固定し、条件を1つだけ変える

同じ端末から、使用が認められた同じテスト先にアクセスし、できるだけ近い時間帯に測定します。まずOSの更新、クラウドストレージの同期、ほかの大容量通信を停止します。通常接続または現在の設定での結果を記録してください。テスト先に通常接続できない場合、その失敗を速度0として記録せず、双方で確認できる別の接続先を使って一般的な通信経路を比較します。ダウンロードでは同じファイルを使い、開始までの待ち時間と安定後の速度を記録します。単位を統一し、1秒あたりのバイト数とビット数を同じ数値として扱わないでください。

同じノードでも有線接続は正常で無線接続だけ遅い場合は、Wi-Fiの電波強度、距離、同じネットワークを使う他の端末の通信量を確認します。同じネットワークで特定のノードだけ遅い場合は、そのノードから接続先までの経路、サービスの状態、混雑する時間帯の状況を調べてください。異なるノードから同じリソースへのアクセスが遅く、別の配信元は正常な場合は、リソース側の速度制限や応答異常が考えられます。ノードとリソースを同じテストで同時に変えると、どの変更で改善したか判断できません。

計測時間から遅延箇所を特定

デスクトップにcurlがインストールされ、ローカルのHTTPプロキシが有効な場合は、次のコマンドでHTTPSリクエストをテストできます。この例の一般公開ドメインは時間の内訳を確認するためのもので、スループット測定には使いません。ローカルポートが10809以外の場合は、クライアントに表示されているHTTPプロキシのポートに置き換えてください。Windows PowerShellではコマンド名をcurl.exeにし、出力先の/dev/nullをNULに置き換えます。

curl --proxy http://127.0.0.1:10809 --max-time 20 --silent --show-error --output /dev/null --write-out 'connect=%{time_connect}s tls=%{time_appconnect}s first_byte=%{time_starttransfer}s total=%{time_total}s http=%{http_code}\n' https://example.com/

これらの数値はコマンド実行時からの累積時間で、4つの時間をそのまま足し合わせることはできません。ローカルプロキシを明示した場合、接続時間が主に示すのはcurlからローカル接続口までの時間です。プロキシがリモートに接続する時点は、この項目だけでは分かりません。TLS完了時間には、プロキシがトンネルを確立するまでの時間が含まれる場合があります。最初の1バイトまでの時間には、接続先の処理時間も含まれます。ブラウザーと比較するときは、ブラウザーが接続を再利用したり、キャッシュを使ったりする点に注意してください。毎回同じ数値になるとは限りません。コマンドがエラーになった場合は、0の値を読み取らず、エラーメッセージと応答ステータスを確認します。

再テストの結果に応じて設定を変更

最初のデータが届くまで遅く、ログに名前解決の再試行が頻繁に出る場合は、DNSの章へ進みます。継続的な転送が遅い場合は、同じ操作を行いながら、端末のCPU使用率、ネットワークの使用量、コアのログを確認します。エラーログが繰り返し出る場合は、まずエラーを解決してください。詳細ログを長期間有効にすることを速度改善策にしないでください。複数のタスクを同時に実行したときだけ問題が起こる場合は、並列タスク数を減らして比較し、1つの接続が制限されているのか、すべてのタスクが通信経路を取り合っているのかを確認します。改善した設定だけを残し、効果がなければ元に戻します。

特定の時間帯だけ速度が低下する場合は、その時間帯と正常な時間帯の結果を分けて記録し、同じノード、同じ接続先、同じルーティングを使用しているか確認します。サービス提供元はその情報を使って負荷を確認できます。端末側では、定期更新やバックアップの実行状況を調べてください。問題を再現できない場合は、設定を元のままにして記録を取り続けます。一度の速度測定を改善するためだけに、トランスポート設定を変えたり、複数の最適化を一度に有効にしたり、使用できている設定を上書きしたりしないでください。

05 · ドメインの名前解決

DNSの問題:どのドメインがどこで名前解決されたか確認

ほかのサービスが正常なのに特定のドメインだけ開けない場合でも、すぐにDNSの問題とは判断できません。エラーがドメインの不存在、名前解決のタイムアウト、名前解決後の接続失敗のどれに該当するか確認します。また、問題のドメインがノードのサーバー名か、Webサイトのドメインかを確認してください。前者ではノードへの接続自体を確立できないことがあり、後者では特定のサイトまたは特定のアウトバウンド通信だけに影響する場合があります。問題の発生箇所は異なるため、同じ設定で一括して対処しないでください。

システム・アプリ・コアそれぞれの名前解決経路を確認

システムプロキシを使っても、すべてのドメインがコアで名前解決されるとは限りません。ブラウザーが独自のセキュアDNSを使う場合や、アプリが独自に名前解決する場合があります。通信の取り込み方式、プロキシプロトコル、ルーティング設定によっても、名前解決がローカルとリモートのどちらで行われるか変わります。まず失敗したリクエストのログにドメイン名が残っているか、宛先アドレスが記録されているか、名前解決を行ったのがアプリ・コア・システムのどれかを確認します。関連するログがない場合は、現在のログレベルと接続方式を調べてください。ログの空欄だけを見て「DNSリクエストが送信されなかった」と判断しないでください。

デスクトップでは次のコマンドで、システム環境から行う一般的なDNS問い合わせを確認できます。例のドメインを、障害が発生しておりテストが許可されているドメインに置き換えてください。名前解決に使われたサーバー、返されたアドレス、エラーの種類を記録し、クライアントのログと比較します。このコマンドはブラウザーのセキュアDNSを示すものではなく、コアが同じリゾルバーを使ったことを保証するものでもありません。サーバー名が不明と表示されてもドメインのアドレスが正常に返る場合は、今回の問い合わせ結果を基準にします。表示名がないことを障害とみなさないでください。

nslookup -type=A example.com
nslookup -type=AAAA example.com

問い合わせの失敗と、返されたアドレスへの接続失敗を分けて対処

問い合わせがタイムアウトする場合は、現在のネットワークから使用中のDNSサーバーに接続できるか、DNSサーバーへの接続自体を未接続のノード経由にしていないか確認します。ドメインが存在しないという応答が返る場合は、ドメイン名全体を確認し、プライベートドメインに勤務先ネットワークや特定のDNSサーバーが必要か調べてください。一方のアドレスレコードが見つからなくても、必ずしも異常ではありません。公開するアドレスの種類が一方だけのサイトもあります。アドレスが返るのに接続できない場合は、そのアドレスへのネットワーク経路、証明書、ルーティングを引き続き調べてください。DNSサーバーを何度も変更しないでください。

アドレスファミリーの違いが原因と分かった場合は、2種類の問い合わせ結果と実際の接続に使われたアドレスをそれぞれ記録します。デュアルスタック端末でIPv6アドレスが返っても、端末に安定したIPv6経路があるとは限りません。ブラウザーが別のアドレスファミリーへ自動で切り替えられても、コアや対象アプリが同じ方法を取るとは限りません。まずクライアントにある設定を使って対象を絞って比較し、実際のリクエストが改善したか確認してから、その設定を残すか判断します。端末全体のIPv6を無効にする方法を既定の対処にしないでください。正常に動作しているサービスに影響するおそれがあります。

ルーティングが参照するドメインと名前解決の順序を確認

ドメイン名で照合するルールもあれば、IPアドレスで照合するルールもあります。アプリがコアに渡すのが名前解決済みのアドレスだけの場合、ドメインルールが適用されるかどうかは、コアがドメイン情報を取得できるか、実際の設定がどうなっているかで変わります。ルーティングでドメインをアドレスに変換する必要がある場合、名前解決の失敗がルーティング異常に見えることもあります。まず、ルールの適用結果か実際のアウトバウンドを照合し、どの段階でリクエストが変わったか確認してください。用語の関係は用語早見表、設定変更の順序はシステムプロキシとルーティングを参照してください。

再テストでは古いタブを閉じ、影響を受けたアプリを再起動します。必要に応じてキャッシュの有効期限が切れるまで待ってから、最初に失敗したドメインと、以前は正常だったドメインをテストしてください。勤務先のプライベートサービスの場合は、修正後も社内ドメインが所定の名前解決経路を使うことを確認します。DNS設定は一度に1つだけ変更し、変更前後の想定と結果を記録してください。元に戻す場合は、追加したアドレスを一覧から削除するだけでなく、元のDNSサーバーと接続方式を復元します。

06 · 通信の取り込みとアウトバウンド

システムプロキシが効かない:接続の取り込みとルーティングを分けて確認

システムプロキシは、一部のアプリがリクエストをクライアントに渡すかどうかを決めます。ルーティングルールは、コアに届いたリクエストをどのアウトバウンドに送るかを決めます。システムプロキシを有効にしても、すべてのアプリが設定を参照するとは限りません。ルーティングルールを選んでも、コアに届いていない通信が自動的に取り込まれるわけではありません。まずリクエストがコアに届いているかを判断し、その後、想定したアウトバウンドを通っているか確認してください。2つの設定を同時に変更すると、Webページが復旧しても原因が分からなくなります。

ローカルプロキシの接続口とアプリ設定を確認

デスクトップではまずv2rayNを使います。クライアントで待ち受けアドレス、ポート、プロキシの種類を確認し、システムプロキシの設定と照らし合わせます。アプリに個別のプロキシ設定がある場合は、システム設定に従う指定になっているか、以前使っていたポートが残っていないか確認してください。システムプロキシが有効になったら、対象アプリを再起動するか、新しい接続を確立して確認します。既存の接続が以前の経路を使い続けることがあります。接続を確立し直さずにページを再読み込みするだけでは、その影響を除外できません。

ローカルの待ち受けポートが正しくても、HTTPとSOCKSの違いを確認する必要があります。アプリでHTTPプロキシを使うのにSOCKS専用のポートを指定すると、ローカルプロセスには接続できてもリクエストを完了できない場合があります。信頼できるテスト先を使い、ローカルプロキシを明示したリクエストとアプリ自身のリクエストを比較してください。前者は正常で、後者がコアを通らない場合は、ノードを変更する前にアプリ設定やプロセス環境を確認します。プロキシをローカル端末だけで使う場合は、接続問題を解消するために待ち受けアドレスをすべてのネットワークインターフェースに公開しないでください。

コアに到達している場合:ルールの順序とアウトバウンドタグを確認

ルーティングルールは通常、一覧の順に照合されます。広い条件のルールが先にあると、後続の例外に到達できない場合があります。1つのルールに複数の条件を書いた場合も、どれか1つに合えば適用されるとは限りません。まず、失敗したリクエストが実際に使ったアウトバウンドを特定し、より広いルールに先に一致していないか確認します。クライアントのプリセットを変更した場合は、保存後も変更した設定が選択されていることを確認してください。変更を反映するにはコアの再読み込みが必要な場合があります。

以下はコア設定に追加できるルーティング設定の一部で、予約済みのサンプルドメインを使った完全一致の例です。起動設定全体ではありません。既存アウトバウンドのタグが実際にdirectであり、ネットワークのルール上その接続先への直接接続が許可される場合にのみ使ってください。full:はドメイン全体に一致しますが、サブドメインには一致しません。ここでのAsIsは、ルーティングの照合時にアドレスルールとの一致を目的とした名前解決を積極的に行わないことを表し、アプリが名前解決を必要としないという意味ではありません。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["full:example.com"],
        "outboundTag": "direct"
      }
    ]
  }
}

現在の設定でテストする場合は、必要なルールだけを追加します。既存のrouting全体をこの設定で置き換えたり、現在のネットワークのドメイン処理方針をついでに変更したりしないでください。ルールのアウトバウンドタグは、定義と完全に一致させます。テストでは、サンプルルールの対象、従来ノード経由だった対象、従来直接接続していた対象にそれぞれリクエストを送り、想定どおりに処理されるか確認してください。特定のドメインルールだけ機能しない場合は、コアがドメイン名とIPアドレスのどちらを受け取ったか確認します。

影響範囲に応じて対処方法を選ぶ

特定のアプリだけがシステムプロキシに従わない場合は、そのアプリが対応している接続設定を優先します。多くのアプリの通信がコアに届かない場合は、システムプロキシの接続口、クライアントの動作状態、または勤務先の管理要件に沿った端末全体の通信取り込み設定を確認します。通信がコアに入っているのにアウトバウンドが違う場合に限り、ルールを変更してください。プリセットの名前は用途の目安にすぎず、実際のルールやログとの照合に代わるものではありません。関連項目はシステムプロキシとルーティングモードの違いをご覧ください。

07 · 起動とプロセス

クライアントがクラッシュする:画面とコアの終了を切り分け

ダブルクリックしてもウィンドウが開かない、画面が一瞬表示されて消える、画面は表示されているのに接続できない状態は、それぞれ異なる問題です。画面のプロセスとコアのプロセスが動作しているか確認し、起動時・設定読み込み時・接続ボタンを押した後のどの段階で発生したか記録します。クラッシュによってネットワークが切断された場合は、以降のテストを行う前に元の接続設定を復元してください。続けてアプリを再起動すると前回のログが失われることがあるため、まず最初に確認できたエラーを保存します。

プラットフォーム・アーキテクチャ・インストール方法を確認

デスクトップではまずv2rayNを使います。インストールパッケージのアーキテクチャは端末とシステムに合わせてください。WindowsではWindows版ダウンロードからデスクトップ版と従来のWPF版を選びます。macOSではmacOS版ダウンロードでチップに合ったパッケージを選択します。LinuxではLinux版ダウンロードでプロセッサーのアーキテクチャとディストリビューションに適したパッケージ形式を確認します。実行環境が見つからないというメッセージが表示された場合は、実際の配布パッケージの説明を参照してください。ほかのプログラムのフォルダーからランタイムを集めて組み合わせないでください。

解凍が必要なパッケージは、管理権限があり、安定したパスを保てるフォルダーに全体を解凍してから実行してください。圧縮ファイルのプレビュー画面から直接起動しないでください。設定ファイルの一部しか書き込めない場合、画面が起動後に終了したり、次回起動時に設定が失われたりすることがあります。まず、フォルダーのアクセス権、空き容量、セキュリティソフトの検知記録を確認します。管理対象の端末でシステムが実行をブロックした場合は、管理者に確認を依頼してください。端末全体のセキュリティ設定を変更して試さないでください。

画面は表示されるがコアが停止する:最初のエラーを確認

コアの起動に失敗した場合、最後のログは一般的な終了通知で、原因はそれより前に記録されていることがよくあります。「アドレスは既に使用されています」と表示されたら、ローカルの待ち受けアドレスとポートを確認し、クライアントの重複起動や既知の別サービスによる占有がないか調べてください。終了してよいと明確に分かっているプロセスだけを停止するか、空いているポートを使用して関連するアプリの設定も合わせて変更します。設定の解析エラーが表示された場合は、指定された項目やルールの位置から確認します。先にシステムプロキシを切り替えないでください。

特定のノードを選んだときだけ終了する場合は、システム通信を取り込まずに、以前使えたノードを選んでテストします。前者が失敗し後者が成功するなら、トランスポート設定、プロトコル項目、関連ルールを比較します。すべてのノードで失敗する場合は、共通設定、ファイルの読み書き、現在のクライアントからコアを起動できるかを確認してください。起動と最初の接続は正常で、スリープ復帰後やネットワーク切り替え後だけ終了する場合は、その時刻の前後のログを保存し、プロセス終了前にネットワークが変化したかも記録します。

クリーンな環境でのテストと設定の段階的な移行

リセットする前に設定と使用可能なノードをバックアップし、画面の設定とシステムの元の接続方式を記録します。クライアントの対応方法に従って古い設定を切り分け、新しい環境には使用可能と確認済みのノードを1つだけ読み込み、起動・停止・再起動をテストします。安定して動作したら、サブスクリプションや古い設定に基づくルールを小分けにして戻し、そのつど再テストします。特定の設定を戻した後に再発する場合は、その一部に絞って原因を探します。古い設定全体を上書きして同じ障害を繰り返さないでください。

新しい環境でも再発する場合は、接続せずに画面だけを起動するテストと、接続後すぐに手動で終了するテストをそれぞれ行います。画面の起動直後に終了する場合は、画面の実行環境やアプリデータを調べます。ネットワークを取り込んだ場合だけ失敗するなら、関連する権限、コアのログ、システムのネットワークコンポーネントを確認してください。古い環境だけで失敗する場合は、再現に必要な設定の一部を保存して診断に利用します。端末全体を元に戻したり、正常なほかの設定を削除したりする必要はありません。インストールパッケージの変更後は、アプリの再起動と接続の一連の動作確認を行ってください。

08 · モバイル端末のトラブル

モバイル端末で切断される:VPNの通信取り込みとバックグラウンド動作を確認

Androidでよくある症状は、接続をタップしてもシステムのVPN接続が確立されない、バックグラウンドにしたり画面をロックしたりすると切断される、Wi-Fiとモバイルデータを切り替えた後に復旧しない、の3つです。まず症状ごとに分けてテストし、画面をロックしながらネットワークを切り替えないでください。v2rayNGはXrayコアを使用し、v2flyNGはV2Flyコアを使う代替クライアントです。パッケージと対応アーキテクチャはAndroid版ダウンロードをご覧ください。クライアントを変更する前に、システムのVPN接続管理が原因か確認します。

接続できない:権限・既存のVPN接続・アプリの対象範囲を確認

Androidで初めてVPNによる通信の取り込みを有効にすると、システムから許可を求められます。画面上は接続中でもシステム設定に該当するVPN接続がない場合は、許可の確認画面とクライアントのログを確認し、現在のユーザーでほかのVPNが接続位置を使用していないか調べます。管理対象の端末では、常時接続VPNや仕事用プロファイルの接続方針を管理者が制御していることがあります。管理対象の設定を強制的に無効にしないでください。現在のアプリが属するユーザーまたは仕事用プロファイルを確認し、システムの方針に沿って競合を解決します。

システムのVPN接続が確立しているのに、特定のアプリだけ開けない、または想定した経路を使わない場合は、クライアントのアプリ別通信取り込みリストを確認します。そのリストが「選択したアプリだけを処理」するものか、「選択したアプリを除外」するものかを見分けてください。変更後は再接続し、影響を受けたアプリを再起動して、同じユーザー環境でテストします。ステータスバーにVPNアイコンが表示されても、VPN接続が存在することしか分かりません。アプリが対象に含まれているか、コアがノードに接続できているか、ルーティングが正しいかは、実際のリクエストで確認してください。

画面ロックで切断される:プロセスの停止とノードの切断を切り分け

まず画面を点灯したままページを連続して開き、クライアントの状態を記録します。次に同じネットワークで、再現可能な一定時間だけ画面をロックします。ロック解除後は、まずシステムのVPN接続とクライアントのログを確認してから、元の接続先を開いてください。VPN接続が消えている、プロセスが再起動している、起動時のログが再び表示されている場合は、まずシステムのバックグラウンド動作制限を調べます。VPN接続が残っているのにリクエストがタイムアウトする場合は、ネットワークの切り替え、アイドルタイムアウト、ノードの状態を確認します。通知が表示され続けているだけで接続が有効だと判断しないでください。

バックグラウンド制限が関係している場合は、システムで許可される範囲で、このクライアントのバッテリー使用量またはバックグラウンド動作に関する設定だけを変更します。設定名は端末によって異なります。変更前の値を記録し、関係のないアプリや端末全体の省電力設定には触れないでください。データセーバーも有効な場合は、前面とバックグラウンドでモバイルデータにアクセスできるかを個別に比較します。バッテリー制限とデータ制限を同時に変更しないでください。比較しても改善しなければ元の値に戻し、一定の時刻にクライアントの再起動やネットワークの切り替えが発生していないか確認します。

ネットワーク切り替え後に失敗する:まず新しいネットワークの基本接続を確認

Wi-Fiからモバイルデータに切り替えると、既存の接続が無効になり、新しい接続はシステムが利用可能な経路を取得してから確立される場合があります。まず個人用クライアントの通信取り込みを停止し、新しいネットワークで、以前アクセスできたサイトに接続できるか確認します。新しいネットワーク自体が使えない場合は、接続時の認証やモバイルデータの設定を確認してください。通常接続が正常なら、同じノードに接続して再テストします。一方向の切り替えだけ失敗する場合は、切り替え前後のネットワークの種類、再接続までの時間、最初のエラーを記録し、モバイルネットワークの経路とクライアントの再接続失敗を切り分けます。

最後に、同じアプリで前面での接続、画面ロックからの復帰、ネットワーク切り替えの3つを再テストし、別のアプリでも確認して、影響が特定のアプリだけか調べます。接続が自動復旧しても毎回しばらく待つ必要がある場合は、ネットワークが利用可能になってからリクエストが成功するまでの時間を記録してください。待機時間を継続的な切断として扱わないでください。ネットワーク切り替え後にドメインへのリクエストだけ失敗する場合は、DNSの章に戻り、アプリ・システム・コアが実際に使用している名前解決経路を確認します。

症状一覧に戻る ↑