V2Ray クライアント導入・設定ガイド
初回接続では、まず入門ガイドに沿って、設定のインポート、プロキシの有効化、接続確認を行ってください。クライアントをインストール済みの場合や、インストーラー、システムへの適用範囲、ルーティング、名前解決の詳細を確認したい場合は、該当する章から読み進めてください。トラブル対処では、一度に変更する項目を一つに絞り、問題を再現できる設定を残しましょう。
共通の準備:インストーラー、サブスクリプション、接続確認
クライアント・コア・サブスクリプションの違い
デスクトップでは、まずv2rayNを選びましょう。Androidでは、Xrayコアを使用するv2rayNGが基本です。サブスクリプションの提供元からv2flyコアを指定された場合に、v2flyNGを検討してください。クライアントはサブスクリプションの管理、ノードの選択、システム通信の取り込みを担い、コアは接続を処理します。サブスクリプションは提供元から渡される設定の取得先で、通常はインポート可能なノード情報を返します。インストーラーが起動しても、使用中のコアがサブスクリプション内のすべての通信方式やセキュリティ設定に対応しているとは限りません。
インストーラーを選ぶ際は、製品名ではなく、OS上で実行できるプログラムのアーキテクチャを確認してください。デスクトップではシステム情報を確認し、モバイル端末ではアプリに提供されるアーキテクチャも考慮します。別の端末に移行するときはインストーラーを選び直し、古い端末のプログラム一式をそのままコピーしないでください。提供元が複数のサブスクリプション形式を用意している場合は、使用するクライアント向けと明記されたものを選びましょう。どちらのクライアントでも同じリンクを開けるからといって、生成されるノード設定まで同じとは限りません。
| プラットフォーム | クライアント | 選び方 |
|---|---|---|
| Windows | v2rayN | x64システム。デスクトップ版または従来のWPF版 |
| macOS | v2rayN | Apple SiliconまたはIntel |
| Linux | v2rayN | ディストリビューションのパッケージ形式。x64またはarm64 |
| Android | v2rayNG / v2flyNG | arm64または汎用版。コアとの互換性でクライアントを選択 |
再インポートできる元データを保管する
サブスクリプションURLと提供元の利用案内は、自分だけが閲覧できる場所に保管してください。URLに認証情報が含まれる場合があります。ノードの共有テキスト、QRコード、エクスポートした設定にも接続情報が含まれることがあります。公開サポート窓口に貼り付けたり、出所の不明なオンライン変換ツールに渡したりしないでください。記録する場合は、グループ名、プロトコル、通信方式、更新日時にとどめましょう。新しい端末に同期する前に、同時接続できる端末数の制限を提供元に確認してください。端末数の上限による問題を設定ミスと誤認するのを防げます。
サブスクリプションの更新とノードへの接続は別の処理です。前者はサブスクリプションサービスから設定を取得し、後者は設定に記載されたサーバーへ接続します。更新に成功したのは、今回取得した内容を解析できたということにすぎません。通信方式の不一致、証明書の検証失敗、現在のネットワークからの到達不能などにより、ノードに接続できない場合があります。提供元がURLを変更した場合は、まず既存グループのURLを更新し、そのグループを手動で再取得してください。同じ名前のグループを何度も作ると、古い設定を選びやすくなります。
再現可能な手順でテストする
プロキシを有効にする前に、現在のネットワークで普段使うサイトが開くか確認します。ログインが必要な公衆ネットワークでは、先にログインを済ませてからクライアントを起動してください。システムの日付、時刻、タイムゾーンを確認し、自動時刻設定を有効にします。次に、グループを一つだけインポートして手動更新し、接続実績のあるノードを一つ選びます。まずコアのログに起動エラーがないか確認し、次にプラットフォームに合った接続方式を有効化します。最後に、同じアプリで同じ接続先へアクセスし、有効化前後の動作を比べます。
デスクトップで初めて使う場合は、まずシステムプロキシで接続を確認してください。Androidでは、最初にシステムのVPN接続を利用します。この段階では、カスタムDNSの有効化、ルーティングルールの変更、コアの切り替えを同時に行わないでください。テストに失敗したら、サブスクリプション更新の失敗、コアの起動失敗、アプリからのアクセス失敗のどれかを記録します。古い端末から移行する場合は、新端末で接続を一つ確認してから、ルーティングや定期更新を順に戻しましょう。古い設定の問題まで持ち込まずに済みます。
Windows:v2rayNのインストールとシステムプロキシ
デスクトップ版と従来のWPF版から選ぶ
Windows版ダウンロードを開き、システム設定のデバイス情報で確認した種類と、インストーラーの表記が一致しているか確認します。デスクトップ版はクロスプラットフォームのUIを採用し、ほかのデスクトップOSに近いメニュー構成です。従来のWPF版はWindowsでおなじみのUIを使います。まずはどちらか一方をインストールしてください。2つの版を同時に自動起動すると、同じローカルポートを取り合ったり、終了時にシステムプロキシ設定を上書きし合ったりするおそれがあります。
インストールウィザードに従ってインストールします。先に展開が必要なパッケージの場合は、一般ユーザーが書き込める場所にフォルダー全体を展開してから起動してください。圧縮ソフトのプレビュー画面から直接実行しないでください。起動時に実行環境が不足していると表示されたら、使用中のインストーラーの案内とダウンロードページの説明を確認します。別のプログラムフォルダーからコンポーネントをコピーしてはいけません。設定を移行する場合は、正常に終了してから、クライアントがサポートする方法でエクスポートまたはバックアップしてください。起動できなくなった古いフォルダーを、新しいバージョンに直接上書きしないでください。
グループをインポートしてコアの起動を確認する
サブスクリプションのグループ設定を開き、新しいグループを追加します。提供元を区別できる名前とURLを入力して保存し、そのグループを更新してください。メイン画面に戻り、対象グループを表示してノードを選択し、使用するサーバーに設定します。ノードが一覧に表示されただけでは有効になっていません。現在のサーバーを示す表示と起動ログで確認してください。更新結果が空の場合は、選択中のグループと提供元が案内するサブスクリプション形式を確認してから、更新ログを調べます。すぐにポートを変更したり、既存グループを削除したりしないでください。
設定画面でローカルの待ち受けアドレスとポートを確認します。自分の端末でテストする場合は、ループバックアドレスのままにしてください。ポート番号は実際の設定値を使います。ログにアドレスの使用中と表示されたら、どのプロセスが待ち受けているかを調べましょう。以下のPowerShellコマンドは一般的なポートを例にしています。実行前に画面に表示されたポート番号へ置き換えてください。コマンドは待ち受けアドレスとプロセスIDを表示するだけで、設定は変更しません。IDが分かったら、タスクマネージャーの詳細タブで対応するプロセスを確認してください。見覚えのないシステムプロセスを終了しないでください。
Get-NetTCPConnection -State Listen -LocalPort 10808 |
Select-Object LocalAddress, LocalPort, OwningProcess
システムプロキシを確認してからTUNを検討する
通知領域のメニューからシステムプロキシの自動設定を選び、Windowsのネットワークプロキシ設定で現在のアドレスとポートを確認します。システムプロキシを使うアプリは通常この設定を読み込みますが、独自のプロキシ設定があるブラウザーやツールは読み込まない場合があります。まずシステム設定に従うことが確認できているブラウザーで新しいリクエストを送り、対応する接続がクライアントのログに記録されるか確認してください。ブラウザーの既存タブは以前の接続を再利用することがあります。テストには新しいウィンドウを使い、必要に応じてブラウザーを通常の手順で終了して再起動してください。
システムプロキシを使わないアプリだけを接続したい場合は、まずアプリ自身にプロキシアドレスを設定できるか確認してください。より広い範囲の通信を取り込む必要がある場合に限り、デスクトップ版TUNの確認手順に沿って有効化し、クライアントの案内に従って必要な権限を付与します。初回テストではシステムプロキシを基準状態に戻し、接続経路が重なって判断しづらくなるのを防ぎます。会社のPCで権限が制限されている場合は管理者の手順に従ってください。管理ポリシーを無効にしたり、管理者権限の付与を通常の接続失敗への対処として使ったりしないでください。
スリープからの復帰、Wi-Fiの切り替え、異常終了のあと、クライアントを終了するとネットに接続できなくなる場合は、Windowsが停止中のループバックポートを参照していないか確認します。まず元のプロキシ設定に戻し、通常の接続を再確認してください。組織から自動構成スクリプトが配布されていた場合は、手動プロキシだけをオフにするのではなく、元のポリシーも復元します。再インストールしても、システムに残ったプロキシ設定が消えるとは限りません。展開先、実行環境、初回起動の関係については、v2rayNの初回インストール設定チェックリストも参考にしてください。
macOS:v2rayNのインストールとネットワークサービス設定
チップに合った版をダウンロードして初回起動する
Appleメニューから「このMacについて」を開きます。Apple Silicon搭載と表示される場合はApple Silicon版、Intelプロセッサと表示される場合はIntel版を選んでください。macOS版ダウンロードから該当するディスクイメージを入手します。マウント後、画面の案内に従ってアプリを「アプリケーション」へコピーし、コピー先から起動してください。正常に動作することを確認したら、インストール用ディスクイメージを取り出せます。マウントしたボリュームから長期間アプリを起動しないでください。ボリュームを取り出すと、起動元が使えなくなります。
初回起動時の警告は、通常の確認、システムのセキュリティポリシーによるブロック、アプリ自体の起動失敗に分けて対応します。パッケージの入手元、チップの種類、使用中のシステム要件を確認してください。会社の端末に関する制限は管理者に確認します。アプリを起動するために、端末全体のセキュリティチェックを無効にしないでください。画面は開くもののコアプロセスが起動しない場合は、ログで対象のプログラムとパスを確認します。システム更新後に問題が起きた場合は、既存設定を変更する前に、新しいシステムとインストーラーの互換性情報を確認してください。
サブスクリプション更新後に接続を確認する
サブスクリプションメニューからグループを追加し、名前とURLを入力して保存後、手動で一度更新します。項目が表示されたら使用するノードを選び、コアが起動したか確認してください。古い設定を移行するときは、再インポートできるサブスクリプション情報と、必要最低限のカスタムルールを優先して残します。別の端末にあるコアプログラム、絶対パス、起動補助設定をそのまま移行しないでください。パスやチップが異なる可能性があり、ノード名が同じでも呼び出すプログラムが動作しない場合があります。
グループの更新時にHTTPエラーが記録された場合は、サブスクリプションの利用権限と、現在のネットワークからURLにアクセスできるかを確認します。URL全体を他人に送って動作確認を頼まないでください。更新は成功しても接続のハンドシェイクに失敗する場合は、使用中のノードのプロトコル、通信方式、セキュリティ設定が合っているか確認します。同じグループの大半のノードが接続できるなら、問題の項目を絞り込みましょう。すぐにシステムのネットワーク設定をリセットしたり、DNSを手動で変更したりしないでください。
現在のネットワークサービスに沿ってシステムプロキシを確認する
クライアントでシステムプロキシを有効にしたら、システム設定の「ネットワーク」で現在使用中のネットワークサービスを開き、詳細画面の「プロキシ」を確認します。Wi-Fiと有線LANは別のサービスとして登録されている場合があります。使っていないサービスに設定すると、現在のアプリには想定した接続先が反映されません。ドッキングステーションの着脱やWi-Fiから有線LANへの切り替え後は、使用中のサービスとクライアントのローカルポートが待ち受け中かを確認してください。以下のコマンドはシステムプロキシの状態を表示するだけです。組織が設定したアドレスが結果に含まれる場合は、全体を公開しないでください。
scutil --proxy
出力に表示された有効な種類、ホスト、ポートを照合してください。「プロキシ」という文字があるかだけでは判断できません。クライアントのポートがシステムの接続先と一致し、プロトコルの種類も合っている必要があります。ブラウザーは使えるのに別のアプリが接続できない場合は、そのアプリ独自のネットワーク設定がないか、プロキシ有効化前の接続を再利用していないか確認します。一度に変更するのは一項目だけにし、アプリを開き直してテストしてください。システムプロキシの項目をすべて有効にする必要はありません。
ネットワーク切り替えやTUN有効化後の戻し方
システムプロキシを使わないプログラムの通信を取り込む必要がある場合は、まず現在のネットワークサービス、プロキシ、DNSの値を記録します。そのうえで、クライアントのTUN機能と必要なシステム権限を確認してください。有効化後は、普段使うWebページと、引き続きアクセスできるはずのローカルリソースの2種類をテストします。Webページが開いても、ローカル通信が別経路に変わっていないとは限りません。社内ネットワークやローカル機器に突然接続できなくなったら、まずTUNを無効にして以前の接続方法に戻し、問題が解消するか確認してください。ルーティングを調べる代わりに、権限を何度も付与しないでください。
スリープ復帰後に切断された場合は、デフォルトのネットワークが変わっていないかを確認し、次にループバックの待ち受けと現在のサービスのプロキシ設定を確認します。クライアントを終了したときは、すべてを一律に消去するのではなく、変更前の状態へ戻してください。特定のWi-Fiでのみ失敗する場合は、そのネットワークでWebログインが必要か、独自のプロキシポリシーがあるかを調べます。問題を特定のネットワークの設定とインストール自体の問題に切り分けられ、ほかのネットワークに不要な変更を加えずに済みます。
Linux:v2rayNのパッケージ形式、デスクトッププロキシ、TUN
ディストリビューションとアーキテクチャに合うインストーラーを選ぶ
まずシステム情報でディストリビューションを確認し、Linux版ダウンロードからv2rayNを選びます。Debian系のパッケージ管理を使うシステムでは通常deb、RPMパッケージ管理を使い、そのパッケージの依存条件を満たすシステムではrpmを選びます。同じ形式でも依存関係に互換性があるとは限らず、古いディストリビューションでは特に注意が必要です。一般にx86_64はx64、aarch64はarm64に対応します。コンテナーや互換レイヤー内の情報は、デスクトップセッションの実行環境と異なる場合があります。クライアントを実際に起動するシステム上で確認してください。
cat /etc/os-release
uname -m
ディストリビューションのソフトウェアインストーラー、またはローカルパッケージに対応したパッケージマネージャーでインストールし、依存関係の競合が表示された場合は内容を確認します。アーキテクチャが合わないと表示されたら、ダウンロードページに戻って適切なパッケージを選んでください。依存パッケージが見つからない場合は、使用中のディストリビューションが要件を満たしているか確認し、依存関係を無理に無視しないでください。インストール時に認証が必要でも、普段は一般ユーザーのデスクトップセッションからクライアントを実行します。デスクトップアプリ全体を管理者権限で起動すると、設定ディレクトリやファイルの所有者が変わり、後から一般ユーザーが設定を読み込めても保存できなくなる場合があります。
サブスクリプションをインポートしてコアの待ち受けを確認する
一般ユーザーのデスクトップセッションでv2rayNを起動し、サブスクリプショングループを作成します。名前とURLを入力してグループを更新し、ノードを選択してください。切り替える前に、そのノードが必要とするコアと通信設定を確認します。設定のインポートで作成されるのはノード項目だけです。コアプロセスがパラメーターを受け付け、待ち受けを開始したかも確認してください。アプリ画面が開かない場合は起動時のメッセージを確認し、画面は開くがコアが起動しない場合は、パラメーターの解析、プログラムの権限、待ち受けポートを調べます。あらゆる失敗をサブスクリプションの期限切れと決めつけないでください。
ポートの確認はローカルから始めます。以下のコマンドはssがインストールされているシステムで、ローカルのTCP待ち受けを確認します。例の値を画面に表示されたポートに置き換えてください。何も表示されない場合は、まずコアが起動しているか確認します。すぐにファイアウォールの許可ルールを追加しないでください。待ち受けが確認できても、ローカルの接続口があることを示すだけで、リモートとの通信が正常とは限りません。待ち受け範囲が想定より広い場合は、LANからのアクセスを誤って有効にしていないか確認し、自分の端末だけで使うアドレスに戻してからテストを続けます。
ss -ltn 'sport = :10808'
現在のデスクトップセッションがプロキシを参照しているか確認する
システムプロキシの保存場所はデスクトップ環境によって異なります。同じクライアントのボタンを使っても、すべてのセッション、ブラウザー、バックグラウンドサービスに同じ設定が適用されるとは限りません。システムプロキシを有効にしたら、使用中のデスクトップ環境のプロキシ設定を確認し、その設定に従うアプリから新しいリクエストを送ります。ターミナルのプログラムは、実行中のプロセス環境にあるプロキシ変数を参照する場合もあれば、独自設定を使う場合もあります。別のターミナルセッションに一時的な変数が自動で引き継がれることはありません。切り分けでは、テストするプログラムだけで適切なプロキシの種類を明示し、全プロセスに影響する環境変数を設定しないでください。
ブラウザーはプロキシを通るのにコマンドラインのリクエストは直接接続する場合、必ずしもルーティング設定の誤りではありません。まずコマンドラインのリクエストがコアに届いているか確認し、次にHTTPとSOCKSのどちらの接続口に対応しているかを調べます。ポート番号だけで接続方式を判断しないでください。サービス管理ツールから起動したプログラムは、ログイン後のデスクトップとは実行環境が異なります。ブラウザーで成功したからといって、サービスの動作まで正常と判断しないでください。特定のアプリだけで目的を満たせるなら、設定範囲を狭く保つほうが元に戻しやすくなります。
TUNに必要な権限とルートを確認する
TUNが本当に必要な場合は、端末が仮想ネットワークインターフェースに対応し、クライアントがディストリビューションの仕組みに沿って必要な権限を取得できるか確認します。切り替えの前後でルートを確認してください。複数のネットワークカードや仮想マシンを使っている場合は、維持すべきローカルネットワークの経路も比較します。以下のコマンドはIPv4のルートとポリシーを表示するだけで、システムは変更しません。現在のネットワークでIPv6も使用している場合は、IPv6のルートも確認してください。社内ネットワークや仮想マシンに影響する変化があれば、デフォルトルートを上書きせず、まずTUNを無効にして確認します。
ip route show
ip rule show
ip -6 route show
終了後も接続できない場合は、仮想インターフェースとクライアントプロセスが停止したか、デスクトップのプロキシ設定が残っていないか、現在のネットワークが元の接続経路に戻ったかを確認します。ネットワーク管理サービスが設定を管理する端末では、生成されたファイルを手動で上書きせず、元のサービスを通じて復元してください。再起動で一時的に直る場合も、クライアントの終了手順、スリープからの復帰、ネットワーク切り替えのどれがきっかけだったか記録します。次回の再現時に、問題が起きている状態を比較できるようになります。
Android:v2rayNG、v2flyNGとVPN接続
クライアントとインストーラーを選ぶ
Android版ダウンロードでは、まずv2rayNGを確認してください。サブスクリプションの提供元がv2flyコアを指定している場合はv2flyNGを選びます。初回テストで2つを同時に実行しないでください。システムがarm64に対応していると確認できた場合は、対応するパッケージを選べます。判断できない場合や、プロセッサーは対応していてもシステム上では別のアーキテクチャのアプリしか動かない場合は、汎用版の対応範囲を先に確認します。インストーラーで非対応と表示されたら、アーキテクチャだけでなくシステム要件と空き容量も確認してください。インストールエラーの対処にサブスクリプションを何度も変更しないでください。
ブラウザーやファイルマネージャーからインストーラーを開くと、現在のアプリを提供元として許可するよう求められる場合があります。出所が分かっているインストーラーを開くために必要な権限だけを許可し、完了後に取り消してもかまいません。更新時にインストールの競合が表示されたら、既存アプリが別の配布経路からインストールされたものか、異なるユーザープロファイルにあるかを確認します。アンインストールして再インストールする場合は、サブスクリプションの元URLと必要な設定を先に控えてください。ローカルのグループ、カスタムルール、選択中の項目が削除される可能性があります。
サブスクリプションを追加してVPNを起動する
サブスクリプショングループの管理画面でグループを追加し、名前とURLを入力して保存後、更新を実行します。単一の共有項目とサブスクリプションは別の接続方法です。単一ノードはクライアントの単体インポート機能から、サブスクリプションはグループから更新します。新しく作成したグループを表示していることを確認し、項目を選んでからメイン画面で起動してください。メニューの表記はバージョンによって変わることがありますが、「URLを保存」「項目を取得」「項目を選択」「接続を開始」はそれぞれ別の状態です。
VPNを初めて起動すると、AndroidからクライアントによるローカルVPN接続を許可するか尋ねられます。起動したクライアントからの要求であることを確認して許可してください。ステータスバーの表示はVPN接続が確立したことを示すだけで、選択したノードへの接続成功を保証するものではありません。続けてブラウザーから新しいリクエストを送り、クライアントのログと照合してください。別のアプリがすでにVPN接続を管理している場合は、そのアプリを一時停止できるか確認します。仕事用プロファイルや端末管理ポリシーによる接続は、自分で解除しないでください。
バックグラウンド停止、アプリ別制限、ネットワーク切り替えを切り分ける
画面表示中は正常でも、画面を消すと切断される場合は、まず接続サービスが動作中か確認し、次にシステムのアプリごとのバッテリー設定とバックグラウンド制限を調べます。一度問題を再現し、画面を消してから切断までの時間、通知が表示され続けているか、ロック解除後に自動再接続するかを記録してください。システムがサービスを停止していると確認できた場合に限り、使用中のクライアントだけバックグラウンド実行の権限を調整します。すべてのアプリのバッテリー制限を一度に解除せず、常駐通知があることをリモート接続が維持されている証拠とみなさないでください。
特定のアプリだけ接続できない場合は、アプリ別プロキシが有効になっていないか確認します。選択したアプリだけを含める設定か、選択したアプリを除外する設定かを確認し、一覧のチェックマークだけで判断しないでください。変更後はクライアントの案内に従って接続を再確立し、対象アプリから新しいリクエストを送ります。Androidの「VPNを常時接続」と「VPNを使用しない接続をブロック」も区別してください。前者はVPN接続の維持を求め、後者はVPN切断中のほかの通信にも影響します。初回接続を確認するまでは、これらの設定を修復手段として使わないでください。
Wi-Fiからモバイルデータ通信に切り替えた後に失敗する場合は、まず元のネットワークで再テストし、次にモバイルネットワークで新しいリクエストを送ります。既存の接続はネットワーク切り替えで切れることがあり、一部のアプリはシステムによってモバイルデータ通信を制限されている場合もあります。画面消灯時や切り替え時だけ発生するなら、まずシステムの制限を確認してください。同じノードが両方のネットワークでハンドシェイクに失敗する場合は、ノード設定を調べます。バッテリー消費とバックグラウンドでの安定性を調整したい場合は、v2rayNGのバッテリー最適化とバックグラウンド実行設定を参考にし、権限を一つずつ変更して結果を記録してください。
ルーティングとTUN:接続口、ルール、出口
まず通信がコアに届いているか確認する
システムプロキシとTUNは、通信をどのようにクライアントへ取り込むかを決めます。システムプロキシはアプリが利用できるプロキシ設定を提供しますが、アプリがそれを使わない場合もあります。TUNは仮想ネットワークインターフェースとシステムルートを組み合わせ、条件に合う通信を受け取ります。ルーティングは、受け取った通信の出口を選択します。ルールをグローバルプロキシに切り替えても、システムプロキシを無視するアプリが自動で接続するわけではありません。逆に、TUNを有効にしても、取り込んだすべての接続がリモートへ転送されるとは限りません。
「特定のアプリがプロキシを経由しない」場合は、そのアプリが新しい接続を開始した時刻のログを確認します。コアに該当する記録がなければ、システムプロキシ、アプリ独自の設定、システムルートを調べます。ログがあり、直結が選ばれているならルールを確認します。ログがあり、想定した出口が選ばれているのに接続できない場合は、名前解決とハンドシェイクを調べます。ログの詳細度はログレベルで変わるため、必要であれば一時的に一段階上げ、再現後に元へ戻してください。この3段階を切り分けてから対処すれば、リクエストを受け取っていない段階でルール全体を書き直さずに済みます。
範囲を絞ったルールから確認する
クライアント内蔵のルーティング設定を使う場合は、まず各設定のマッチ条件とデフォルトの出口を確認してください。名前が似ていてもデフォルトの動作が異なることがあるため、名前だけで結果を判断しないでください。カスタムルールは、具体的なドメイン名またはネットワークから始めます。まずコアがドメイン名とIPアドレスのどちらを受け取っているか確認してください。ドメインルールが照合するのは、ルーティング判定に使えるドメイン名であり、ブラウザーに入力したURL全体ではありません。通常、ドメインの照合項目にプロトコル、パス、クエリパラメーターを含める必要はありません。
同じ通信が複数のルールに一致する場合、一般的なコアでは上から順に評価され、最初に一致したルールが適用されます。優先して確認したい例外は、広範囲のルールより前に置き、一致しなかった場合の出口も確認してください。プロキシグループの別名を実際のアウトバウンド識別子と取り違えたり、別のコア向けの設定をそのまま現在のルール編集画面へ貼り付けたりしないでください。コアを切り替えた後は、簡単なルールで一度動作を確認し、元の設定の高度な条件を順に戻します。
ローカルプリンター、共有フォルダー、社内サービスには、それぞれ異なるアクセス経路が使われることがあります。実際に使用するローカルドメイン名、アドレス範囲、社内ネットワークの要件を確認し、必要に応じて直結ルールやシステム側の除外設定を行います。これらは必ずしも同じ階層の設定ではありません。ローカルリソースと通常のWebページをそれぞれテストしてください。Webページは正常でも共有リソースに接続できない場合は、ローカル通信が仮想ネットワークインターフェースに入っていないか確認します。コアに届いている場合は、選択された出口を確認してください。
デスクトップ版TUNを元に戻せる手順で有効化する
既存の接続方法で同じノードに接続できることを確認し、システムプロキシとルートの基準状態を保存します。その後、クライアントが使用する実装と必要な権限を確認してください。テスト用のシステムプロキシを無効にしてTUNを起動し、通常のWebページ、システムプロキシを使わない対象アプリ、維持する必要のあるローカルサービスを個別にテストします。テストでは新しいリクエストを送り、起動前から確立していた長時間接続を使わないでください。TUNの有効化後にすべてのリクエストがタイムアウトする場合は、まず無効にして基準状態に戻します。元の接続方法が動作することを確かめてから、仮想インターフェースとシステムルートを調べてください。
仮想インターフェースと別のVPNを同時に使うと、デフォルトルート、宛先ネットワーク、名前解決の経路が互いに上書きされる場合があります。複数の通信取り込み機能を同時に有効にして解決しようとしないでください。Wi-Fiと有線LANの切り替えでデフォルトゲートウェイが変わることもあります。再現時には、接続方式、接続先の種類、クライアントログを記録してください。通常終了の後だけ問題が起きる場合は、終了時にプロキシとルートが元に戻るかを確認してから、アプリの再起動が必要か判断します。Webページを一つ開くために設定を重ねるより、安定して元に戻せることのほうが原因の特定に役立ちます。
DNS設定:名前解決を行う場所と経路を確認する
リクエストごとに名前解決の場所を確認する
問題が起きているのがサブスクリプションサービス、ノードサーバー、アクセス先のドメイン名のどれかを特定します。これらの名前解決は、同じ段階で行われるとは限りません。サブスクリプションの更新は通常クライアントが行います。ノードサーバーのドメイン名はリモート接続の確立前に解決する必要があります。接続先のドメイン名は、接続方式やアウトバウンド設定によって、アプリ、システム、コア、リモートのいずれかが解決します。「名前解決に失敗」としか分からない場合は、同じ時刻のログから対象を特定し、端末全体のDNSをすぐに変更しないでください。
アプリが解決済みのIPアドレスをプロキシに渡す場合もあれば、ドメイン名を渡す場合もあります。コアがIPアドレスしか受け取らない場合、ドメイン名に依存するルーティングルールが適用されないことがあります。ドメイン名を受け取る場合は、出口の選択前にIPアドレスへ解決する必要がないこともあります。ドメイン名ベースのルーティングを使う前に、ドメイン名でルールを照合したいのか、解決後のアドレスをネットワーク範囲に照合したいのかを明確にしてください。対応するプロトコルと条件では、トラフィックのスニッフィングでドメイン名を識別できる場合がありますが、すべての接続からドメイン名を復元できるわけではなく、適切な名前解決経路の代わりにもなりません。
変更を最小限にしてDNS設定を確認する
最初のトラブル対処では、以前動作していたDNS設定を使います。同じネットワーク、同じアプリで、普段使うドメイン名と維持すべき内部ドメイン名をテストしてください。両者で適切な名前解決サービスが異なる場合があります。内部ドメイン名を社内ネットワークでしか解決できない場合は、設定を統一するために外部サービスへ切り替えないでください。暗号化DNSに対応したブラウザーでは、その機能が有効か記録します。ブラウザーの結果がOS全体の結果を示すとは限りません。変更後はアプリやシステムのキャッシュも考慮し、新しいリクエストで再確認してください。既存タブの表示だけで判断しないでください。
以下はV2Flyコア設定のdnsセクションの例です。localhostは、端末のシステム名前解決を使うことを示します。既存のコア設定に組み込めるJSONの一部であり、単独で起動できる完全な設定ではありません。また、DNSサーバーのアドレスをループバックアドレスにする設定でもありません。GUIクライアントでは通常、最終的な設定は画面から生成されます。該当する設定項目を変更し、この内容で元のファイルを上書きしないでください。別のコアを使用する場合は、変更前に対応する設定項目とバージョンのサポート状況を確認してください。
{
"dns": {
"servers": ["localhost"]
}
}
名前解決のループとアドレスファミリーの違いを調べる
TUNやカスタムDNSを有効にした後は、名前解決サービスのリクエストが同じ接続経路に再度取り込まれていないか確認します。ノードサーバーのドメイン名をプロキシ接続後にしか解決できない場合、起動時に互いの完了を待つ状態になることがあります。最初にエラーが記録されたログと、元のシステムDNSを照らし合わせ、接続を開始するための名前解決リクエストがどの経路を通っているか確認してください。最近の変更を元に戻し、名前解決関連の設定を一つずつ復元します。DNS、ルーティングルール、コアを同時に置き換えると、復旧後にどの変更が有効だったのか分からなくなります。
同じドメイン名にIPv4とIPv6のアドレスが登録されている場合があります。名前解決に成功しても、現在のネットワークからすべてのアドレスへアクセスできるとは限りません。自宅では正常でもモバイルネットワークでタイムアウトする場合は、ログにある実際の接続先アドレスと、ネットワークが対応するアドレスファミリーを確認します。HTTPSサイトへIPアドレスを直接入力して、ドメイン名の設定が正しいか判断しないでください。証明書名、サーバー名、実際のアクセス先ドメイン名が一致している必要がある場合があります。同じドメイン名を使って比較し、アドレスを取得できないのか、取得後に接続できないのかを確認してください。
一つのブラウザーだけで名前解決エラーが起きる場合は、そのブラウザーのプロキシ設定と暗号化DNS設定を比べます。すべてのプログラムで失敗する場合は、システムの名前解決と現在のネットワークの接続経路を確認してください。TUNを有効にしたときだけ発生するなら、無効時と有効時の名前解決経路およびローカルサービスへの接続性を比較します。調査後は不要な一時設定を元に戻し、明確に問題を解決した設定だけを残して理由を記録してください。ネットワークを切り替えた際に、検証用の設定を必要な設定と誤認せずに済みます。
設定時によくある問題:ローカルの状態からリモート接続まで確認する
サブスクリプションを更新できない、または更新後にノードが表示されない
まず現在のグループを編集しているか確認し、URLに余分な空白がないか、コピー時に途中で切れていないかを調べます。ログに未認証やアクセス禁止の応答がある場合は、提供元にURLの利用権限と状態を確認してください。内容を受信しているのに解析に失敗する場合は、ログイン画面、案内ページ、別のクライアント向け形式が返されていないか確認します。以前は古いノード経由でしか更新できなかったURLの場合は、更新前に接続を確認できている設定を残し、更新時に直接接続と現在のプロキシのどちらを使っているか調べてください。新しいグループが使えると確認する前に、古い項目をすべて削除しないでください。
更新に成功しても古い内容が表示される場合は、一覧のフィルター、グループの選択、使用中のサーバーを確認します。自動更新の間隔と手動更新は別の操作です。テストでは手動更新を一度実行し、記録された時刻と結果を確認してください。新しい項目が追加されても使用中のノードが変わっていない場合は、該当項目を選び直して新しいリクエストを送ります。特定のグループだけで問題が起きるなら、そのグループを切り分け、クライアント設定全体をリセットしないでください。
コアの起動エラー、ポート競合、権限不足
起動時に記録された最初の重要なエラーを確認します。アドレスが使用中の場合は、プラットフォーム別の手順に沿って、古いクライアントのプロセス、誤った待ち受けアドレス、または別のプログラムのどれがポートを使用しているか調べます。変更してよいと確認できた場合は、クライアントの待ち受けポートを変更し、古いポートを手動設定しているアプリも更新してください。ファイルが見つからない、または実行できない場合は、インストーラーのアーキテクチャ、プログラムのパス、ファイル権限を確認します。パラメーターが無効なら、最近追加したルールやカスタム設定を一度無効にして、シンプルなノードでテストしてください。エラーごとに原因の層が異なるため、システムプロキシを再設定しても、コアが無効なパラメーターを読み取れるようにはなりません。
コアは動作しているのにタイムアウトする、またはハンドシェイクに失敗する
まずリクエストが正しいローカル接続口に届いていることを確認し、システム時刻、選択中のノード、コアとの互換性を調べます。ハンドシェイクに失敗する場合は、提供元が案内するプロトコル、通信方式、セキュリティ設定を照合してください。エラーを隠すために証明書の検証を無効にしないでください。タイムアウトの場合は、名前解決が完了しないのか、接続が確立しないのか、確立後に想定した応答がないのかを切り分けます。同じアプリ、同じ接続方法で、接続実績のある別のノードを試してください。またはノードを変えず、利用が許可された別のネットワークでテストします。一度に変更する条件は一つだけにしてください。
ブラウザーとクライアントの速度テスト結果が異なる場合は、それぞれが何をテストしたのか確認します。速度テストは選択した接続経路の一部だけを検証することがあり、実際のアプリの通信の代わりにはなりません。Webページは開くのに動画、会議、ほかのアプリで問題が起きる場合は、同じ接続口とプロトコルを使っているか、現在の接続方式が対象の通信を処理しているかを確認します。一つのテストが成功したからといって、端末全体とすべてのアプリが同じ設定で動作していると判断しないでください。
クライアントを停止してもネットワークが復旧しない
デスクトップでは、停止したローカルポートをシステムプロキシが参照したままになっていないかを確認し、TUNの終了、デフォルトネットワーク、DNSが基準状態に戻ったかを調べます。モバイル端末では、システムVPNの「常時接続」と「VPNを使用しない接続をブロック」の設定を確認してください。今回変更した項目だけを戻し、組織が事前設定したプロキシやネットワーク設定を削除しないでください。プロキシを戻しても通常の接続が復旧しない場合は、クライアントを使わない状態でテストし、現在のネットワークへのログイン、IPアドレスの割り当て、基本的な接続を調べます。ルーティングルールをさらに追加しないでください。
あとから確認できるトラブル記録のまとめ方
OS、クライアントとコアの種類、接続方式、切り替え前後の状態、問題が再現した時刻、エラー前後のログを記録してください。ネットワーク切り替え、画面消灯、スリープ復帰の後だけ問題が起きる場合は、発生までの手順とアプリの状態も書き添えます。調査用のスクリーンショットを共有する前に、サブスクリプションURL、アカウント情報、サーバーアドレス、内部ドメイン名を隠してください。取り消した変更と、変更前に正常だったかどうかを明記すると、接続の問題とテスト中に発生した新たな変更を区別しやすくなります。
エラーメッセージを手がかりに調べる場合は、V2Rayの実行ログを使ったトラブル対処をご覧ください。インストールや利用時によくある問題は、ヘルプセンターで確認できます。初回接続の手順をやり直す場合は、入門ガイドのサブスクリプション追加手順に戻り、グループ、ノード、接続方式をそれぞれ一つに絞って基準状態を作り直してください。