V2Rayクライアントのインストール・設定ガイド
インストーラー、サブスクリプションの追加、システムプロキシ、TUN
初期設定で接続を1つ確立するだけなら、クイックスタートに沿って、インポート・接続・確認の順に進めてください。このページはプラットフォーム別に調べられるマニュアルです。インストーラー選びやシステム権限、ルーティングの違いを確認するときは該当する章へ進んでください。インストール済みで接続に問題がある場合は、接続確認と設定の切り戻しから確認できます。
共通の準備
クライアント、コア、インストーラー
デスクトップではv2rayNが第一候補です。サブスクリプションのグループやサーバー、ルーティング、ローカル接続口を管理し、実際の通信処理は起動中のコアが担います。AndroidではXrayコアを採用するv2rayNGを優先し、V2Flyコアが必要な場合はv2flyNGを選びます。互換性は接続設定全体で判断してください。どちらもVLESSと表示されていても、通信方式やセキュリティ方式、フロー制御が異なる場合があり、プロトコル名だけではクライアントを置き換えられるか判断できません。サブスクリプションにREALITYが含まれると分かっている場合は、Xrayクライアントが該当ノードを正しく認識できるか確認しましょう。
| プラットフォーム | クライアント | インストーラーの選び方 | 主な通信の通し方 |
|---|---|---|---|
| Windows | v2rayN | x64デスクトップ版または従来のWPF版 | システムプロキシ、TUN |
| macOS | v2rayN | Apple Siliconはarm64、Intelはx64を選択 | システムプロキシ、TUN |
| Linux | v2rayN | ディストリビューションに合ったdeb / rpmを選び、次にアーキテクチャを確認 | デスクトッププロキシ、明示的なプロキシ、TUN |
| Android | v2rayNG、v2flyNG | 64ビットARMアプリに対応していればarm64、対応状況が不明ならユニバーサル版を確認 | システムVPNインターフェース |
クライアントのダウンロードページから該当するプラットフォームを選びます。まずシステム情報でアーキテクチャを確認し、次にインストーラーの種類を確認してください。Linuxでは、ディストリビューションが対応するパッケージ形式も確認が必要です。ARMチップ搭載のデバイス同士でも、同じインストーラーが使えるとは限りません。デスクトップとスマートフォンではアプリの形式が異なり、同じプラットフォームでもシステムによって利用できる実行環境が異なる場合があります。インストールに失敗したら、まずシステムに表示されたメッセージを残し、アーキテクチャの不一致、実行コンポーネントの不足、インストール権限の不足を切り分けてから、インストーラーの変更や環境の修復を検討しましょう。
サブスクリプションURL、単一ノードのリンク、サービス設定
サブスクリプションURLは、複数のサーバー情報を定期的に取得するためのものです。単一ノードのリンクでは、サーバー情報を1件だけインポートします。また、Web上のサブスクリプション管理ページと、クライアントが読み込むサブスクリプションURLは別物です。コピーする前に用途を確認し、ログインページのURLをサブスクリプショングループに登録しないでください。サブスクリプションURLにはアクセス情報が含まれることがあるため、スクリーンショットやログ、問い合わせにそのまま載せるのは避けましょう。サービス提供元からQRコードだけが提示された場合は、単一ノードかサブスクリプションかを確認してから、読み取り方法を選んでください。
手動で管理しているノードがある場合は、サブスクリプションからインポートしたノードと別のグループに分けるのがおすすめです。サブスクリプションを更新すると、対象グループが再構成される場合があります。サブスクリプションのノードを直接編集しても、変更が保持されるとは限りません。グループ名には用途が分かるメモを付け、アカウント名やパスワード、完全なURLは記載しないでください。更新後は、使用中のノードがどのグループに属し、どのプロトコルを使っているか記録しておくと、似た名前のサーバーを取り違えにくくなります。複数のデバイスで同じサブスクリプションを使う場合は、サービス提供元が定めるデバイス数や同時接続数の上限も確認しましょう。
初期状態を記録し、最初のテスト範囲を絞る
デバイスの日付・時刻・タイムゾーンが正しいことと、プロキシを使わない状態でテストページにアクセスできることを確認します。現在のシステムプロキシ、社内ネットワークの設定、ほかのVPNの状態、クライアントに表示されているローカル待ち受けポートを記録してください。組織管理下のデバイスでは、変更可能な設定を事前に確認しましょう。初回設定ではノードを1つ、通信の通し方を1つだけ選び、以前のルーティングやカスタムDNS、ほかの転送設定を同時に持ち込まないでください。初期状態を繰り返し確認できてから、追加設定を1つずつ導入します。
繰り返しアクセスできるテスト先を2つ用意します。1つは直接接続の確認用、もう1つはプロキシ経由での接続を確認する業務用URLです。初回テストではネットワーク、ノード、接続先を固定し、Wi-Fiを切り替えるのと同時にノードも変更することは避けてください。既存のクライアントから移行する場合は、従来の起動方法と設定ディレクトリを残してから新しいインストールをテストします。書き込み可能な同じディレクトリを、複数のクライアントで同時に使わないでください。後から変更に失敗しても、元のネットワーク状態に戻せます。
Windows:v2rayNのインストールとシステムプロキシ
デスクトップ版と従来のWPF版
Windowsのダウンロードページを開きます。v2rayNデスクトップ版はクロスプラットフォームのインターフェースを採用し、従来のWPF版はWindows向けの従来型インターフェースを採用しています。メニューの位置は異なる場合がありますが、インストール後の基本的な流れは共通です。サブスクリプショングループを追加し、更新してからサーバーを選び、通信の通し方を設定します。インターフェースの種類を切り替える際は、先に起動中のアプリを終了し、タスクバーの通知領域にプロセスが残っていないか確認してください。2つのインスタンスを同時に起動すると、同じ待ち受けポートを取り合ったり、終了時に相手が書き込んだシステムプロキシ設定を上書きしたりすることがあります。
「設定 → システム → バージョン情報」で「システムの種類」を確認します。x64インストーラーはアプリのアーキテクチャに対応するもので、システムに「64ビット」と表示されているだけではx64と判断できません。ARMプロセッサ搭載と表示される場合は、システムの互換実行条件も別途確認してください。起動時に実行コンポーネントを求められたら、表示されたコンポーネント名とアーキテクチャを確認します。メインウィンドウは開くのにコアの起動に失敗する場合は、クライアントのログを確認してください。アプリの起動エラーをサブスクリプションの無効と混同せず、インストーラーとノードを同時に変更しないようにしましょう。
サブスクリプションを追加して使用するサーバーを選択
「サブスクリプショングループ」メニューを開きます。「サブスクリプショングループの設定」でグループを追加するか、画面に表示される「サブスクリプショングループを追加」から、メモとサブスクリプションURLを入力します。保存後、「すべてのサブスクリプションを更新」に相当する操作を実行してください。メニューにプロキシ経由・プロキシなしの更新がある場合、利用可能な接続がまだない初回は、現在のネットワークから直接サブスクリプションを取得できるか確認します。サービス提供元が特定の取得経路を指定している場合は、その案内に従ってください。管理ページやエラーページをサブスクリプションの内容と取り違えないようにしましょう。
ノードが所属グループに表示されるまで待ち、一覧から使用するサーバーを明示的に選択します。行がハイライトされているだけでは選択状態にすぎません。現在のサーバーになっているかどうかは、ステータスバーや通知領域の表示で確認してください。更新後にノードが表示されない場合は、グループのURL、更新ログ、サービスの有効期限を確認します。一部のノードだけ表示されない場合は、該当する設定の形式と現在のコアの対応範囲を確認してください。インストールが正常か確かめるためにグループ全体の速度測定をする必要はありません。利用できることが分かっているノードを1つ選ぶと、問題を切り分けやすくなります。
システムプロキシ、TUN、終了時の手順
まず通知領域の「システムプロキシ」メニューから「システムプロキシを自動設定」を選び、システムプロキシに従うブラウザーでテストします。必要に応じてWindowsの「設定 → ネットワークとインターネット → プロキシ」を開き、プロキシのアドレスとポートが現在のクライアントを指しているか確認してください。ここでの「システムプロキシを自動設定」は、クライアントがシステムプロキシを設定する操作です。Windowsの「設定を自動的に検出する」とは別の機能です。一部のターミナルツールやバックグラウンドサービス、独自のプロキシ設定を持つアプリはシステム設定を使いません。ブラウザーで接続できても、すべてのアプリの通信が転送されているとは限りません。
対象のアプリがシステムプロキシを使わない場合は、まずアプリ独自のプロキシ設定があるか確認してください。仮想ネットワークインターフェースで通信を制御する必要がある場合は、「TUNモードを有効にする」を試します。テスト前にクライアントが設定したシステムプロキシを解除し、接続経路を1つに絞ってください。有効化時は案内に従って必要な権限を与え、仮想インターフェースやルーティング、ローカルネットワークが正常か確認します。インストールやトラブル対処のために、すべてのツールを管理者権限で常時実行しないでください。デフォルトルートを制御する別のアプリも同時に使わないようにしましょう。終了前に、今回変更したプロキシとTUNの状態を解除し、記録しておいた元の設定に戻します。
macOS:チップに合ったインストーラーとネットワークサービス
チップに合った版を選び、システムの警告を確認
Appleメニューから「このMacについて」を開きます。情報欄に「チップ」と表示され、Apple Siliconの場合は、macOSのダウンロードページからarm64のインストールイメージを選びます。「プロセッサ」にIntelと表示される場合はx64を選んでください。インストールイメージを開いたら、画面の案内に従ってアプリを「アプリケーション」フォルダへ移し、そのフォルダから起動します。マウントしたイメージから長期間起動しないでください。更新時はメニューバーの旧バージョンを終了してからアプリを置き換え、複数のコピーが同じ設定を使ったり、システム設定を同時に変更したりしないようにします。
初回起動をシステムに阻止された場合は、まず表示内容をよく確認します。アーキテクチャの不一致、アプリが破損しているという警告、提供元が未確認という警告、組織のポリシーによる制限は、それぞれ別の問題です。インストールイメージとシステムのアーキテクチャを再確認しても警告が出る場合は、システムが案内するアプリ単位の手順と組織の要件に従って対処し、セキュリティ機能全体を無効にしないでください。画面は起動するのにネットワーク機能が使えない場合は、クライアントのログを確認します。これはアプリ自体が起動できない状態とは異なり、別のフォルダへ移すだけでは解決しません。
サブスクリプショングループとメニューバーの状態
v2rayNの「サブスクリプショングループ」でURLと見分けやすいメモを追加し、保存後に更新します。グループを開き、ノードに実際のアドレス、ポート、プロトコルが設定されていることを確認してから、使用するサーバーを選択してください。更新に失敗した場合は、まずブラウザーで通常のページにアクセスできるか、現在のネットワークでログインが必要かを確認します。次に、サブスクリプションの応答がクライアントで解析できる内容か確認してください。ブラウザーでサービスの管理画面にログイン済みでも、クライアントにそのログイン状態が引き継がれるわけではありません。ログインページが取得される場合は、サービス提供元の管理画面で専用のサブスクリプションURLをコピーし直してください。
ウィンドウを閉じてもプロセスが終了するとは限りません。使用中のノード、プロキシモード、終了状態を確認する際は、アプリのメニューバーやステータス領域も確認してください。初回の接続確認ではノードを変えず、同じブラウザーウィンドウで同じ接続先にアクセスします。保存済みの設定にルーティングやカスタムDNSがある場合は、まず記録し、簡単なルールで一時的に初期状態をテストしましょう。ノードを変更する前に、現在のサーバーが実際に適用されているか確認してください。ノード一覧のハイライト表示だけで接続状態を判断しないようにします。
現在のネットワークサービス、TUN、スリープ復帰
クライアントの「システムプロキシを自動設定」を有効にしたら、「システム設定 → ネットワーク」で現在接続中のサービスを開き、「詳細 → プロキシ」を確認します。Wi-Fiと有線接続は別々のネットワークサービスとして扱われる場合があります。片方で使えても、もう片方に切り替えたときも有効とは限りません。以前から自動プロキシ設定スクリプトや組織のプロキシを使っている場合は、上書きせずに設定を記録してください。ブラウザーは使えるのにターミナルツールが使えない場合は、そのツール独自のプロキシ設定を確認します。すべてのコマンドラインプロセスがシステムプロキシを読み込むとは限りません。
システムプロキシを使わないアプリをテストする場合は、まず今回設定したシステムプロキシを解除し、クライアントの案内に従ってTUNを有効にします。ほかのVPNやネットワークフィルター、組織の管理ポリシーが同じ通信を制御していないか確認してください。権限の確認が表示されるのは、今回の操作に対するものであることを確かめます。必要なネットワーク状態がシステムに作られていない場合は、この段階で原因を調べ、サブスクリプションを何度も更新しないでください。TUNを無効にした後は、プロキシが必要なアプリとローカルサービスをそれぞれ確認し、通信が想定した経路に戻ったことを確かめます。
スリープから復帰した後、Webページの読み込みが長時間終わらない場合は、今回の通信制御をいったん解除し、現在のWi-Fiまたは有線接続が単独で使えることを確認してから、元のモードに戻し、同じノードで再テストします。ターミナルで scutil --proxy を実行すると、システムが認識しているプロキシの状態を確認できます。ただし、すべてのアプリがその設定に従う証明にはなりません。ネットワークを切り替えた後だけ発生する場合は、サーバー側の設定を変更する前に、アクティブなネットワークサービス、古いプロキシポート、仮想インターフェースを確認してください。
Linux:パッケージ、デスクトッププロキシ、TUN
パッケージ形式とプロセッサアーキテクチャ
Linuxのダウンロードページからv2rayNを選びます。一般にDebianやUbuntu系ではdeb、Fedora系ではrpmを選びます。それ以外のディストリビューションでは、ファイルの拡張子を書き換えるのではなく、パッケージ形式と依存関係を先に確認してください。次のコマンドでマシンのアーキテクチャとディストリビューションの識別情報を確認します。出力が x86_64 ならダウンロードページのx64、aarch64 ならarm64の項目を確認します。ディストリビューションの識別情報はインストール方法の判断に使い、プロセッサのアーキテクチャを推測するためには使いません。
uname -m
cat /etc/os-release
ダウンロードしたパッケージは、ファイルマネージャーからシステムのソフトウェアインストーラーで開けます。デスクトップ環境にインストール機能がない場合は、ディストリビューションのパッケージマネージャーでローカルファイルを指定してください。該当する apt install または dnf install コマンドに、ダウンロードしたパッケージの絶対パスを渡します。パスに空白が含まれる場合は、パス全体を引用符で囲んでください。debとrpmを同じインストール処理で混在させたり、依存関係のエラーを無視する強制オプションを使ったりしないでください。依存関係を解決できない場合は、システムを一律に再インストールせず、エラーに記載されたライブラリやアーキテクチャ、リポジトリを確認します。
現在のデスクトップユーザーでクライアントを起動
アプリケーションメニューから現在のユーザーでv2rayNを起動し、メインウィンドウとステータス表示が正常か確認します。設定は通常、実行ユーザーごとに保存されます。同じクライアントを一般ユーザーと権限昇格したユーザーで交互に実行すると、別の設定が読み込まれたり、一般ユーザーが変更できないファイルが作成されたりすることがあります。TUNに権限が必要な場合は、該当する権限昇格の操作だけを行い、デスクトップアプリ全体を常に高い権限で実行しないでください。ウィンドウを閉じた後にアプリが見つからない場合は、現在のデスクトップ環境がトレイ表示に対応しているか確認してから、インスタンスを再起動します。
「サブスクリプショングループ」でURLを追加して更新し、使用するサーバーを1つ選びます。更新時にネットワークエラーが出る場合は、デスクトップのブラウザーとクライアントがそれぞれどのプロキシを使っているか確認してください。ブラウザーでサブスクリプション関連のページを開けても、クライアントの更新リクエストが同じ経路を通るとは限りません。インポート後にコアの起動時にポートの競合が表示された場合は、ss -ltn を実行してローカルのTCP待ち受けを確認し、クライアントに表示された接続口と照合します。競合しているプロセスを特定するまでは、不明なプロセスを終了しないでください。
デスクトップ、コマンドライン、仮想インターフェースを個別に確認
デスクトッププロキシが使えるかどうかは、デスクトップ環境とアプリが設定を取得する方法によって異なります。GNOMEやKDEのプロキシ設定を読み込むデスクトップアプリもありますが、コマンドラインアプリは通常、独自のオプションやプロセス環境を使います。クライアントに自動設定の成功が表示されたら、まずデスクトッププロキシに従うことが分かっているアプリでテストし、次に明示的なプロキシ設定で待ち受けポートを確認します。ターミナルで設定した環境変数が、デスクトップから起動したアプリに渡るとは限りません。新しく開いたターミナルも、別のターミナルで一時的に設定した変数を引き継ぐとは限りません。
TUNを使う場合は、デスクトッププロキシやアプリ側のプロキシをテスト用に無効にしてから、クライアントのTUN機能を有効にします。コンテナや制限付き環境、管理対象のワークステーションでは、デスクトップ画面があっても仮想インターフェースを利用できない場合があります。権限のあるホストでは、ip link show で有効化前後のインターフェースを比較し、ip route show で一般的なルートを確認できます。ただし、後者に表示されるのは通常の問い合わせ範囲に限られ、ポリシールーティングの影響までは否定できません。ポリシールーティングを使うシステムでは、ip rule show と実際の接続先への経路も確認してください。
GUIアプリだけで失敗する場合は、まずデスクトッププロキシとアプリの設定を確認します。TUN使用時だけ失敗する場合は、権限、インターフェース、ルーティング、DNSの制御範囲の違いを優先して調べてください。クライアント終了後もターミナルに問題が残る場合は、古いプロキシ環境変数を読み続けていないか確認します。セッションの終了、テスト用環境変数の削除、デスクトッププロキシの復元は、それぞれ別の操作です。実際に変更した項目だけを順に戻せばよく、デバイス全体のネットワークをリセットする必要はありません。
Android:サブスクリプション、VPN権限、アプリ別プロキシ
アーキテクチャに合った版とクライアントを選ぶ
Androidのダウンロードページを開きます。第一候補はXrayコアを使うv2rayNGです。V2Flyコアが必要な場合は、v2flyNGを選びます。64ビットARMアプリを実行できるデバイスではarm64を優先してください。アーキテクチャが不明な場合やarm64版が非対応と明示された場合は、ユニバーサル版とシステム要件を確認します。プロセッサが64ビットに対応していても、現在のシステムであらゆる64ビットアプリをインストールできるとは限りません。インストールに失敗する原因には、システム要件の不一致、ストレージ不足、既存アプリと新しいパッケージの署名の不一致などもあります。
ブラウザーやファイルマネージャーからインストーラーを開くと、現在のアプリにインストール権限を許可するよう求められる場合があります。入手元と今回のインストール内容を確認したうえで許可し、完了後は該当する権限を取り消せます。アップグレード時に競合が起きても、使用中のクライアントをすぐにアンインストールしないでください。入手元が同じか、サブスクリプションに利用可能な項目が残っているか、手動で追加したノードをバックアップする必要があるかを先に確認します。2つのクライアントは別々にデータを保存するため、もう一方をインストールしても、既存のグループやルーティング、アプリ一覧は自動で移行されません。
サブスクリプションを追加してサーバーを選択
クライアントのメニューから「サブスクリプショングループの設定」を開き、グループのメモとサブスクリプションURLを追加して保存します。設定一覧に戻り、「サブスクリプションを更新」または同等の更新操作を実行してください。画面の変更によってメニューやボタンの名称は変わる場合があります。サブスクリプショングループの追加と、クリップボードからの単一ノードのインポートを区別することが重要です。更新後はノードが属するグループを確認し、使うノードを選択します。想定した数と異なる場合は、別のグループやフィルターが表示されていないか確認してから、サブスクリプションの内容が対応形式か調べてください。
あるクライアントで解析できた項目を、別のクライアントの動作確認にそのまま使わないでください。サブスクリプションに異なる通信方式やセキュリティ方式の組み合わせが含まれる場合は、現在のコアが明確に対応するノードを選んでテストします。失敗時はエラーの種類、プロトコル、発生時刻を記録し、チャットグループや公開スクリーンショットにサブスクリプションURLを載せないでください。モバイルデバイスでWi-Fiとモバイルデータ通信を切り替えた場合は、まず同じノードで再テストします。その後に別のノードを試すと、ネットワークの切り替えとサービス側の変化を区別しやすくなります。
VPNインターフェースとアプリ別の対象範囲
サーバーを選択したら、メイン画面の接続ボタンをタップします。初回起動時、Androidはシステム画面を表示してVPN接続の許可を求めます。起動したクライアントからの要求であることを確認してから許可してください。どちらのクライアントもAndroidのVPNインターフェースを利用します。デスクトップの「システムプロキシを自動設定」の手順をそのまま適用することはできません。接続アイコンやステータス表示は、インターフェースが確立された可能性を示すだけです。実際にアプリを開き、通信がクライアントに届いて応答が返ることを確認してください。
アプリ別のフィルターを使わず、まずブラウザー1つで接続を確認してから、必要に応じて「アプリ別プロキシ」を設定します。現在のモードは画面の説明で判断してください。許可リストは選択したアプリだけがVPNインターフェースを使い、除外リストは選択したアプリがそのインターフェースを迂回します。インターフェースに入った後もクライアントのルーティング判定があるため、そのアプリのすべてのリクエストが必ずプロキシ経由で外部接続されるわけではありません。ブラウザーは接続できるのに対象アプリが接続できない場合は、対象アプリが制御範囲に含まれているかを確認してから、ドメイン名と出力ルールを調べてください。
しばらく使った後に接続が切れる場合は、常時接続の別のVPNが有効になっていないか、システムがクライアントのバックグラウンド動作を制限していないかを確認し、画面消灯前後のログを比較します。バッテリー使用量に「制限なし」などの設定がある場合は、バックグラウンドでの切断が実際に起きているときに限り、このクライアントの設定を変更し、電池消費と安定性を確認してください。端末によってはバックグラウンドでの起動も制限されます。メニュー名は機種ごとに異なるため、別メーカーの手順を探して設定しないようにしましょう。画面やモードの詳しい違いはv2rayNGのAndroid利用ポイントを参照してください。
接続確認、ログ、設定の切り戻し
まず通信がどの接続口に入るか確認
通信の流れを4段階に分けて考えます。アプリがリクエストを送る、ローカルの接続口が受け取る、ルーティングが出力先を選ぶ、出力先が接続して応答を返す、という順序です。画面に接続済みと表示されても、通常は必要なサービスやインターフェースが起動したことを示すだけです。ブラウザーでページが開いても、そのリクエストがプロキシ経由とは限りません。キャッシュから表示されたり、ルールによって直接接続されたりする場合があります。クライアントのログ、接続先、テスト時刻を照合し、異なるリクエストの結果を混同しないようにしましょう。
デスクトップでは、v2rayNの設定やステータスバーでポート、待ち受けアドレス、接続口の種類を確認します。HTTPとSOCKSは異なるアプリケーション層の接続口です。どちらもローカルにあるという理由だけで入れ替えてはいけません。設定によっては混合接続口を使い、別々のポートを使う場合もあるため、現在の画面表示を確認してください。システムに古いプロキシ設定が残っている場合は、現在の接続口と項目ごとに照合します。AndroidではVPN権限、使用中のクライアント、アプリ別の対象範囲を確認し、デスクトップのポートテストをスマートフォンの全アプリの通信に当てはめないでください。
同じ接続先で明示的なプロキシを比較テスト
以下のコマンドはcurlをインストール済みのデスクトップ環境で使えます。WindowsのPowerShellでは、コマンド名を curl.exe としてください。1行目はアプリケーション層でcurlのプロキシを無効にし、2行目はローカルのSOCKS接続口を明示的に使います。クライアントが実際に 127.0.0.1:10808 でSOCKSを待ち受けている場合に限り、2行目をそのまま実行できます。そうでない場合は画面に表示されたローカルアドレスとポートに変更してください。比較の前にTUNを無効にします。1行目では、システム層ですでに制御されている通信を迂回できません。
curl --noproxy '*' --max-time 15 -I https://example.com/
curl --noproxy "" --proxy socks5h://127.0.0.1:10808 --max-time 15 -I https://example.com/
socks5h は接続先のドメイン名をSOCKS接続口に渡す指定で、すべてのドメインをリモート側で名前解決するという意味ではありません。その後の処理はコアのルーティングと名前解決の設定に従います。ここでのコマンドはローカル接続口を切り分けるためのもので、ノードを評価するものではありません。どちらのコマンドも応答が返る場合は、プロキシのリクエストが実際にどの出力先を通ったか確認します。接続先がHEADリクエストに対応していない場合は、同じ接続口で通常のGETリクエストを実行して確認してください。メソッドが拒否されたという理由だけで、ネットワークが切断されたと判断しないようにしましょう。
エラーが発生した段階から原因を絞り込む
エラーがローカルのループバックポートを指している場合は、クライアントが起動しているか、待ち受けに成功しているか、ポートやプロトコルの指定が正しいかを確認します。ログにリモートへの接続開始が記録されている場合は、接続先アドレス、ポート、接続タイムアウト、ハンドシェイク設定の順に調べてください。connection refused はどちら側が拒否したか確認が必要で、すべてのサーバーが無効という意味ではありません。i/o timeout も、接続・読み書き・名前解決のどの段階でタイムアウトしたかを確認します。TLSハンドシェイクに繰り返し失敗する場合は、まずシステム時刻と、サブスクリプションで必要なサーバー名、セキュリティ方式、通信設定を確認し、サービス提供元にも問い合わせてください。詳しくはv2rayNの実行ログで原因を調べる方法を参照してください。
初期状態に戻し、設定を一段ずつ追加
設定を戻すときは、まず今回有効にしたTUNを無効にし、既存のシステムプロキシを復元します。対象アプリに手動入力したテスト用プロキシを削除し、元のネットワークから基準ページに直接アクセスできるか確認してください。それでも復旧しない場合は、サブスクリプションを変更し続けるのではなく、ネットワーク自体や既存の管理設定を先に調べます。初期状態に戻ったら、ノード、通信の接続口、ルーティング設定をそれぞれ1つずつ追加します。変更した項目、接続先、結果を毎回記録し、変更直後に問題が起きたら直前の設定だけを戻して再テストしてから判断してください。項目ごとに確認する場合は接続済みなのにインターネットに接続できないときのチェックリストもご覧ください。
ルーティングとDNSの設定
通信の制御範囲と出力先を分けて考える
システムプロキシ、明示的なプロキシ、TUNは、どのリクエストがコアに届くかを決めます。ルーティングルールは、コアに届いたリクエストの出力先を決めます。システムプロキシが特定のプロセスの通信を制御していない場合、コアのドメインルールを変えても、そのプロセスの動作は通常変わりません。逆に、アプリの通信がコアに届いていても、ルーティングによって直接接続されることがあります。原因を調べるときは、まず接続口のログ、次に出力先の記録を確認してください。リクエストがログに見つからない場合は、ルールの順番をむやみに変えるのではなく、アプリのプロキシ設定や仮想インターフェースに戻って確認しましょう。
v2rayNの「ルーティング設定」を開き、現在どのルールセットが実際に使われているかを確認してから、変更する項目を決めます。ルールは通常、一覧の順番に照合されます。広い条件のルールが先に一致すると、後ろの例外ルールが適用されないことがあります。変更前に元のルールセットを残し、テスト用のルールセットには別の名前を付けてください。例外条件を確認する際は、接続先とアプリを固定し、ノードと名前解決の方法を同時に変更しないようにします。テスト後は別の接続先も使い、既存の振り分けが維持されているか確認してください。1つのサイトが直った一方で、別のアプリが誤った出力先に送られる事態を防げます。
ルールの項目とコア設定の例
以下はXrayコアの設定にある routing フィールドの例です。direct というタグの出力先が定義済みの設定で使えます。1つ目のルールは完全一致するドメイン example.com のみ、2つ目は指定されたプライベートアドレス範囲に一致します。これはクライアント設定全体ではなく、サブスクリプションURL欄に貼り付けるものでもありません。v2rayNのGUIを使う場合は、自作ルールに対応するドメインまたはIPの条件を設定し、現在のルールセットに存在する直接接続の出力先を選んでください。出力先の実体を確認せずにタグ名だけをコピーしないようにしましょう。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"domain": ["full:example.com"],
"outboundTag": "direct"
},
{
"type": "field",
"ip": ["10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"],
"outboundTag": "direct"
}
]
}
}
full: は指定した完全なドメイン名にのみ一致し、サブドメインには自動で適用されません。ドメインとそのサブドメインを対象にするには、domain: を検討してください。outboundTag は実際の出力先を参照する項目であり、単独で使えるプロトコルではありません。上の例の AsIs は、ドメインルールをIPルールに一致させる目的だけで、自動的に名前解決を行うものではありません。コアに入った時点で接続先がIPアドレスの場合は、判定に使えるドメイン名がないため、ドメインルールが適用されないこともあります。デバッグではブラウザーのアドレスバーからすべてのリクエスト形式を推測せず、ログに記録された実際の接続先を確認してください。
DNSの診断と変更する順番
アプリ、OS、コアのそれぞれがドメインの名前解決に関わる場合があります。ブラウザー独自のセキュアDNS、クライアントの名前解決設定、TUNによるDNS通信の制御によって、ドメイン名とIPアドレスのどちらがコアに届くかが変わります。その結果、同じドメインでもアプリごとに異なるIPアドレスが返ることがあります。問題を調べる際は、失敗するドメイン名全体、発生時刻、現在のモードを記録してください。システムからの直接接続と明示的なプロキシの結果を比べるときは、最終的にページを開けるかだけでなく、それぞれが名前解決をどこに委ねているかを確認します。
特定のドメインにアクセスできない一方で、同じサービスの別のアドレスが使える場合は、まずログに名前解決エラーがあるかを確認し、ルールがドメイン、IP、外部の分類データのどれを使っているか調べます。HTTPSのURLにあるホスト名をIPアドレスへ置き換えても、同じ条件でのテストにはなりません。サーバー名や証明書の照合結果も変わるためです。ローカル共有フォルダー、プリンター、組織内ネットワークのサービスでは、必要な経路にプライベートアドレスが残っているか確認してください。一般公開されているWebページにアクセスできるだけで正常と判断しないようにしましょう。変更前のDNSとルーティングの値を残し、一度に変更するのは1つの層だけにします。各項目の意味は用語のクイックガイドを参照してください。
設定に関するよくある質問
サブスクリプションの更新に成功したのに、使用できるノードがありません。なぜですか?
まず更新メッセージが現在のグループを示しているかを確認し、ノード一覧が検索語やグループ、フィルターによって絞り込まれていないか確認します。更新成功は、クライアントが取得または解析のいずれかの段階を完了したことを示すもので、以前の使用中サーバーが一覧に残っているとは限りません。サービス提供元が元のノードを改名または廃止した可能性があります。その場合は同じグループからサーバーを選び直し、使用中の状態を確認してください。グループが空の場合は、サブスクリプションの応答がクライアントの対応形式かを確認し、サブスクリプションの権限や有効期限を調べます。管理画面のURLをサブスクリプションURLと取り違えていないかも確認してください。
ブラウザーは使えるのに、ほかのアプリが使えないのはなぜですか?
まず、ブラウザーでシステムプロキシが使われているのか、ブラウザー独自のプロキシ設定が使われているのか確認します。デスクトップアプリにプロキシ設定がある場合は、クライアントが実際に待ち受けているプロトコルとポートを設定してください。アプリに設定項目がない場合は、TUNの利用を検討します。Androidでは対象アプリがアプリ別の設定で除外されていないか確認します。ログに対象アプリのリクエストが記録されているのにページを開けない場合は、そのドメインの出力先と名前解決を調べてください。クライアントを再インストールし直す必要はありません。テスト前に、業務用アプリ自体に正常にログインできることも確認しましょう。
システムプロキシとTUNは同時に有効にできますか?
通信が重複した場合の処理は、OSやクライアント、ルールセットによって異なります。両方の設定が有効だからといって、アプリがどの経路を使うかは判断できません。初期設定やトラブル対処では、接続口を1つだけ有効にすると再現性のある結果を得やすくなります。システムプロキシからTUNに切り替える場合は、今回設定したシステムプロキシを先に解除してからTUNを有効にします。逆に切り替える場合は、TUNを無効にしてネットワークが使えることを確認した後、システムプロキシを自動設定してください。組織指定のプロキシやVPNがある場合、勝手に無効にせず、通信の制御範囲と管理上の要件を確認します。テスト設定を無効にした後は、すべて空にするのではなく元の値に戻してください。
ノードの問題とローカル設定の問題を見分けるには?
デバイス、ネットワーク、テスト先をそれぞれ1つに固定します。ローカルの接続口にリクエストが届いていることを確認したうえで、同じグループにある独立したノードを2つ比較します。一方だけ失敗し、もう一方が正常なら、失敗したノードの稼働状況や設定を優先して確認してください。複数のノードで同じ段階、たとえばローカルポートへの接続時に拒否される場合は、まずローカルの接続口を調べます。すべて出力先での名前解決に失敗する場合は、DNSとネットワークの条件を確認してください。複数ノードが同時に失敗しても、サーバー側すべての障害とは限りません。共通するネットワーク条件、名前解決経路、認証状態が原因の可能性もあります。
クライアントの切り替えや再インストールの前に、何を保存すればよいですか?
サブスクリプショングループ名、使用中のルールセット、通信の通し方、ローカル待ち受けポート、手動で追加したノードを記録します。クライアントにエクスポート機能がある場合は、設定にURLやアクセス情報が含まれる可能性があるため、管理された安全な場所だけに保存してください。公開クラウドストレージやチャットグループへのアップロードは避けましょう。別のクライアントへ移行するときは、サブスクリプションを再インポートしてルーティングを1つずつ戻します。別のアプリが旧設定ディレクトリを完全に読み込めるとは限りません。移行の完了は、設定項目が表示されること、使用中のノードが正しいこと、ローカル接続口が使えること、対象の通信が想定どおりに振り分けられることを基準に判断します。旧ディレクトリをコピーできたかどうかだけでは判断できません。クライアントの違いはクライアント比較を参照してください。
ほかの人に相談するとき、どの情報を伝えると役立ちますか?
OSとアーキテクチャ、クライアント名と画面に表示されたバージョン、使用中のコア、通信の接続口、問題が起きる範囲、最初に発生した時刻を伝えます。サブスクリプションの更新、ネットワークの切り替え、TUNの有効化を直前に行ったか、元のネットワーク状態に戻せるかも説明してください。ログは問題が起きた前後の必要な行だけを残し、サーバーアドレス、サブスクリプションURL、認証情報を隠します。スクリーンショットにアカウント情報や組織内ネットワークの情報が映り込まないようにしてください。「ずっとつながらない」だけでなく、「同じブラウザーと接続先で、システムプロキシは使えるがTUNは使えない」のように条件をそろえて説明すると、調査の開始点を判断しやすくなります。