クライアント設定ガイド

V2Rayクライアントのインストール・設定ガイド

OSに合ったインストーラーを選び、サブスクリプションの追加から接続確認まで解説。ブラウザーは使えるのにターミナルがつながらない場合は、通信の入口、ルーティング、出力先を順に確認します。

初めて接続する場合は、クイックスタートガイドに沿って設定してください。このページは参照用のガイドです。システム要件やプロキシの権限、OSごとの違いを確認し、目次から該当する項目に進めます。

01 · 共通の事前準備

インストール前に確認:端末、サブスクリプション、通信の入口

クライアントを選んでからインストーラーを選ぶ

デスクトップではv2rayNが第一候補です。Windowsではデスクトップ版と従来のWPF版を区別し、OSのアーキテクチャも確認してください。macOSはApple SiliconかIntelかを確認します。Linuxはディストリビューションに対応するパッケージ形式とCPUアーキテクチャを確認してください。AndroidではXrayコアを使用するv2rayNGが標準的な選択肢です。既存の設定でV2Flyコアが指定されている場合は、v2flyNGも検討できます。クライアントは画面表示や設定管理を担い、コアは実際の接続を処理します。役割は異なります。デスクトップ版でコアを切り替えられても、従来の通信方式やセキュリティ設定をそのまま使えるとは限りません。

圧縮ファイルの名前だけでOSのアーキテクチャを判断したり、別の端末のダウンロード履歴を本機の確認代わりにしたりしないでください。同じサブスクリプションをPCとスマートフォンに追加することはできますが、PCのシステムプロキシに設定するアドレスはPC本体のものです。そのままスマートフォンにコピーしても使えません。端末ごとにクライアント名、OSのアーキテクチャ、利用する通信の取り込み方法を記録しておきましょう。組織管理下の端末では、ソフトウェアのインストール、仮想ネットワークインターフェースの作成、プロキシ設定の変更が許可されているか事前に確認してください。権限を昇格させて組織の制限を回避しないでください。

OSごとに確認するインストーラーと通信の取り込み条件
OSインストーラーの選び方通信確認の第一歩
WindowsOSのアーキテクチャ、デスクトップ版または従来のWPF版まずシステムプロキシに対応したブラウザーで確認
macOSApple SiliconまたはIntel現在のネットワークサービスのプロキシ設定を確認
Linuxディストリビューション、debまたはrpm、CPUアーキテクチャまず単一のアプリにローカルプロキシを設定
Androidアプリが対応するアーキテクチャと必要なコアシステムVPNを許可してから、対象アプリを確認

サブスクリプションURLと個別の共有リンクを区別する

サブスクリプションURLを使うと、クライアントがリモートから複数の設定を取得します。通常はサブスクリプションを登録してから、手動で更新する必要があります。グループが表示されても、URLが保存されただけでノードを取得できていない場合があります。vmess://またはvless://で始まるものは、通常、個別の共有リンクです。クリップボードや共有リンクからインポートしてください。サブスクリプションURL欄に入力するものではありません。逆に、サブスクリプションURLを手動設定のサーバー名に入力しても、接続可能なノードにはなりません。QRコードを読み取る場合も、何の情報が含まれているか先に確認してください。

配布元が提供しているのがV2Rayクライアントで読み込める設定か確認してください。アカウント管理ページや決済ページ、ブラウザーのセッションがないと開けないURLでは使えません。サブスクリプションの更新とノードへの接続は別の通信です。更新の成功はクライアントが一覧を取得できたことを示すだけで、ノードの接続にはサーバー、通信方式、セキュリティ設定も関係します。サブスクリプショングループには用途と配布元をメモし、最初は1件だけ選んでテストしてください。動作確認済みの設定も比較用に残しておきましょう。問題の切り分け中に古いグループを削除しないでください。更新によって項目が置き換わることがあり、一時的に手動変更した設定が保持されない場合もあります。

現状を記録してからTUNを有効にする

クライアントに通信を取り込ませる前に、通常なら直接アクセスできるサイトが開くか確認してください。使用中のネットワーク、ほかのプロキシアプリ、組織のVPN、独自のDNS設定も記録しておきます。公衆Wi-Fiにログインページがある場合は、先に通常の認証を済ませてください。プロキシ有効化後に、それまで開けていたサイトにも接続できなくなった場合、比較できる基準があると切り分けに役立ちます。デスクトップでは、クライアントに表示される待ち受けアドレス、ポート、プロトコルも確認してください。同じローカルポートでも、HTTPとSOCKSは用途が異なり、互換性はありません。

初期設定では通信を取り込む方法を1つだけ有効にしてください。システムプロキシは、その設定を参照するアプリに接続先を提供します。TUNは仮想インターフェースとルーティングを使ってより多くの通信を処理するため、必要な権限やDNSの挙動、ほかのネットワークツールとの競合など、確認事項が増えます。ブラウザーだけを試すなら、システムプロキシかアプリ独自のプロキシ設定を使いましょう。ノードとアプリが動作してから、システムプロキシを参照しないアプリへの対応を検討してください。問題が起きた場合も、ノードが最初から接続できていなかったのか、通信を取り込む範囲を変えた後に発生したのかを判別しやすくなります。

02 · デスクトップクライアント

Windows:v2rayNのインストールとシステムプロキシ・TUNの設定

デスクトップ版と従来のWPF版を選ぶ

Windowsの「設定 → システム → バージョン情報」でシステムの種類を確認し、Windowsのダウンロードページで対応するインストーラーを選びます。このサイトのダウンロードページにある2つのインストーラーは、どちらもx64向けです。デスクトップ版はクロスプラットフォームのUIを採用しており、初めて使う場合はこちらがおすすめです。従来の画面や古い手順書に慣れている場合、または既存の操作方法を維持したい場合はWPF版を選べます。両方を組み合わせて使うものではなく、初回設定時に同時起動することもおすすめしません。ポートが競合したり、一方のクライアントが終了時にもう一方の設定したシステムプロキシを解除したりするおそれがあります。

圧縮ファイルを入手した場合は、まずユーザーが書き込みできる、見つけやすい場所にすべて展開し、展開先から起動してください。圧縮ツールのプレビュー内から実行ファイルを起動したり、メインプログラムだけを取り出して実行したりしないでください。ダウンロードしたものがインストーラーなら、画面の案内に従ってインストールし、展開版の移動方法を適用しないでください。起動時に実行環境がないと表示された場合は、ダイアログに記載されたコンポーネントの種類、アーキテクチャ、対応バージョンを確認し、提供元から必要な環境を入手してください。セキュリティソフトにブロックされたり、組織のポリシーで制限されたりした場合は、詳細を確認し、保護機能を全体的に無効化しないでください。インストーラーの選び方はWindows版:デスクトップ版とWPF版のインストールメモも参考にしてください。

サブスクリプションを追加してコアの起動を確認する

サブスクリプショングループの設定から項目を追加し、URLとメモを入力して保存したら、そのグループを更新します。直接接続とプロキシ経由の更新を選べる場合、利用可能なプロキシがまだなければ、まず直接接続を試してください。配布元が既存のプロキシを必要としており、利用可能な設定がすでにある場合に限り、プロキシ経由の更新を試します。項目が表示されたら1つ選んでアクティブサーバーに設定し、コアの状態とログを確認してください。リストで選択されていても、コアが待ち受けに成功したとは限りません。古いクライアントや開発ツールが同じポートを使用している場合は特に注意が必要です。

個別のリンクしかない場合は、クリップボードからインポートできます。追加後、プロトコル、アドレス、ポート、通信方式、セキュリティ設定が配布元の説明と一致するか確認してください。クライアント側のローカル待ち受けポートを、リモートサーバーのポート欄に入力しないでください。デスクトップ版とWPF版ではメニューの位置が異なる場合があります。見つからないときは古い手順書の画像上の位置を当てにせず、「サブスクリプショングループ」「アクティブサーバー」「システムプロキシ」などの機能名で探してください。コア設定の生成に失敗した場合は、ノードを何度も切り替えるのではなく、ログにある最初の具体的なエラーを解決してください。

まずシステムプロキシを確認し、対応していないアプリは後から設定する

v2rayNのシステムプロキシを有効にしたら、Windowsの「設定 → ネットワークとインターネット → プロキシ」で実際の状態を確認します。次に、システムプロキシを参照し、プロキシ拡張機能で通信を横取りしていないブラウザーでテストしてください。システムプロキシが現在のクライアントを指していても、コアが待ち受けていなければ、ブラウザーは通常ローカル接続エラーになります。ブラウザーは使えるのにターミナルがつながらなくても、回線が不安定だとは限りません。ターミナルのツールが独自設定や環境変数を使っていたり、別のアカウントでサービスが動作していたりする場合があります。ブラウザーとターミナルを別々に確認する方法を参考に、それぞれの通信経路を確認してください。

システムプロキシを参照しないアプリも対象にする必要がある場合は、ほかのプロキシや仮想ネットワークツールを終了してから、TUNだけを試してください。クライアントの案内に従い、必要な権限やドライバーの状態を確認します。有効化の前後で、普段使うサイト、対象アプリ、ローカルネットワーク上の機器に接続できるか確認してください。有効化後に社内ネットワークや共有機器へ接続できなくなった場合は、元のモードに戻し、TUNが社内のネットワーク範囲、名前解決、デフォルトルートを取り込んでいないか確認します。GUIを管理者権限で起動すればあらゆるネットワークエラーが解決するわけではありません。ノードのハンドシェイク失敗やポート競合は、権限を上げても直りません。

03 · デスクトップクライアント

macOS:チップに合ったv2rayNを導入してネットワークサービスを確認

システム情報を見て適切なディスクイメージを選ぶ

Appleメニューから「このMacについて」を開きます。Appleチップ搭載と表示される場合はmacOSのダウンロードページでApple Silicon版を、Intelプロセッサと表示される場合はIntel版を選んでください。ターミナルのプロセス情報だけで判断しないでください。ターミナル自体が変換環境で動作していると、確認したいMac本体のアーキテクチャとは異なる結果が表示されることがあります。ディスクイメージを開いたら、同梱の案内に従ってインストールします。通常はアプリを「アプリケーション」フォルダにドラッグし、そこから起動します。マウントしたボリューム内のコピーを毎回開かないでください。

初回起動時に権限やセキュリティの警告が表示されたら、アプリ名、入手元、システム情報を確認してください。破損、マルウェア、組織による制限が示された場合は、表示内容に沿って原因を調べ、起動のためにシステム保護を全体的に無効化しないでください。更新後は、ダウンロードフォルダやディスクイメージ内に残っている古いコピーではなく、新しくインストールしたアプリを起動しているか確認します。アプリがクラッシュする場合は、まず画面を安定して開けるか確認してください。画面が起動しない段階では、ルーティングルールを変更しても解決しません。起動時の問題を切り分けるにはデスクトップ版の初回インストール設定チェックリストを参考にしてください。

サブスクリプションを追加してテスト範囲を絞る

サブスクリプション管理でグループを作成して更新し、サーバーを1つ選んで現在の設定にし、コアが起動しているか確認します。クリップボードから読み込む前に、コピーしたものが元のURLか確認してください。チャットアプリから説明文とリンクをまとめてコピーしていることがあります。両端の余分な空白だけを取り除き、URL内のパス、クエリパラメーター、エスケープ文字は編集しないでください。Webサイトにログインできるのにクライアントの更新が失敗する場合は、取得したURLがクライアント用のサブスクリプションURLか確認します。管理ページをブラウザーで開けても、同じURLでサブスクリプションAPIにアクセスできるとは限りません。

最初の確認ではこの設定グループだけを使い、別のPCのアプリデータ一式はまだ移行しないでください。古い設定には、すでに存在しないコアのパス、待ち受けポート、分割ルールのファイルが含まれることがあります。サブスクリプションとアプリ設定は分けて移行します。まず新しい端末にサブスクリプションを追加してノードが使えることを確認し、その後、必要なルールだけを個別に戻してください。変更前の値を記録しておけば、新しいルールで特定のドメインに問題が起きたとき、最初からインストールし直さずに、動作していた設定へ戻せます。

現在のネットワークサービス、アプリのプロキシ、TUNを区別する

システムプロキシを有効にしたら、「システム設定 → ネットワーク」で現在使用中のネットワークサービスを選び、詳細情報にあるプロキシの設定を開きます。OSのバージョンによって画面上の項目名は多少異なります。Wi-Fiと有線接続のどちらを使っているか、プロキシの種類、アドレス、ポートがクライアントと一致しているか確認してください。ネットワークサービスを切り替えた後も、改めて設定を確認します。有線接続で有効だった設定が、Wi-Fiでも意図どおりに通信を取り込むとは限りません。自動プロキシ設定スクリプトやほかの管理ツールによって、設定が変更されていないかも確認してください。

ターミナルでシステムが認識しているプロキシ設定を確認できます。以下のコマンドは状態を読み取るだけで、設定を変更しません。出力にある有効状態、プロキシホスト、ポートを画面の設定と照らし合わせてください。システム上で有効と表示されても、システム設定を参照しているアプリがあることを示すだけで、コマンドラインツールがその設定を利用するとは限りません。ブラウザーとターミナルの動作が異なる場合は、まずターミナル側のネットワーク設定を確認してください。アプリに個別のプロキシを指定している場合、その結果だけでシステムプロキシが機能しているか判断しないでください。

scutil --proxy

TUNを使う場合は、現在のバージョンで対応しているか確認し、クライアントの案内に従って必要な権限を設定してください。コアやノードを確認する前に、システムプロキシ、ルーティングルール、DNSを同時に変更しないでください。Wi-Fiへの切り替え後、スリープからの復帰後、ドックからLANケーブルを抜いた後に切断された場合は、まずシステムがネットワークに再接続したことを確認します。その後、「追加の通信取り込みを無効化する → コアを再確認する → TUNを再び有効にする」の順に切り分けてください。社内サイトやローカル機器だけに影響する場合は、動作が確認できている通信方法に戻し、社内ネットワークへのアクセスに必要なルートと名前解決を確認します。

04 · デスクトップクライアント

Linux:v2rayNをインストールしてデスクトッププロキシと仮想インターフェースを設定

ディストリビューションとCPUアーキテクチャを確認する

Linuxのダウンロードページからv2rayNを選びます。Debian、Ubuntuおよびその派生ディストリビューションでは通常deb、FedoraなどRPMを使うディストリビューションではrpmを選びます。パッケージ形式だけでなく、アーキテクチャも確認してください。コマンドの出力がx86_64ならx64、aarch64ならarm64です。システムによっては同じx64アーキテクチャをamd64と表示します。ディストリビューションがこれらのパッケージの対象でない場合、拡張子を変更したり強制インストールしたりして依存関係の問題を解決しようとせず、まず互換性を確認してください。

uname -m
cat /etc/os-release

デスクトップ環境のソフトウェアインストーラーで対応パッケージを開けます。コマンドラインを使う場合は、依存関係を解決できるディストリビューション標準のパッケージマネージャーで、ダウンロード先の実ファイルを指定してください。インストールに失敗したら、アーキテクチャが非対応なのか、依存パッケージが見つからないのか、ソフトウェアリポジトリに接続できないのかを確認します。システムライブラリに同じ名前のリンクを安易に作ったり、GUIを常に管理者アカウントで実行したりしないでください。別のアカウントに設定やキャッシュが保存され、一般ユーザーに戻したとき初回起動のように見えたり、権限の問題とクライアントの問題が混同したりするおそれがあります。

サブスクリプションを追加したら、まず1つのアプリで確認する

現在のデスクトップセッションを使う一般ユーザーでv2rayNを起動し、サブスクリプショングループを追加して更新します。アクティブサーバーを選び、コアが起動したら実際の待ち受けポートを記録してください。ブラウザーに独自のプロキシ設定がある場合は、まずそのブラウザーだけにプロキシを指定してテストできます。デスクトップ環境のシステムプロキシが使えない場合も、単独の比較テストになります。同じポートを古いプロセス、コンテナ、開発ツールが使用している場合は、待ち受けているプロセスを確認してから、古いプロセスを終了するか空いているポートに変更します。テスト対象アプリのポート設定も合わせて更新してください。

一般的なLinuxデスクトップでは、デスクトップのプロキシ設定とコマンドラインアプリで、確実に共有できる通信の取り込み方法があるとは限りません。デスクトップアプリはGNOMEやKDEのネットワークプロキシを使うこともあれば、独自に管理することもあります。ターミナルから起動したプログラムは、独自設定や環境変数に従います。一時的に確認する場合は、単発コマンドのオプションか、個別アプリの設定を使いましょう。環境全体の設定ファイルにすぐプロキシ変数を書き込まないでください。全体に設定を残すと、クライアントを終了した後も、新たに起動したパッケージマネージャー、ビルドプロセス、バックグラウンドタスクが停止済みのポートへ接続しようとすることがあります。

TUN、ルーティング、名前解決の違いを確認する

アプリ側のプロキシ設定を参照しない通信もクライアントに取り込む場合は、インストール済みバージョンがTUNに対応しているか、現在の環境で仮想インターフェースを作成できるか確認してください。デバイスが利用できない、セッションの権限が不足している、仮想マシンやコンテナに必要なネットワーク権限がない、といった制限があります。このようなエラーはインターフェースを作成できていないことを示しており、サブスクリプションを変更しても解決しません。まず通常のアプリプロキシが使えるか確認し、エラーとディストリビューションのドキュメントを照らし合わせてください。環境が他者に管理されている場合は、管理者に権限の範囲を確認し、すべてのユーザーにデバイスアクセスを許可しないでください。

有効化の前後で、現在のセッションに表示されるインターフェースとIPv4ルートを比較できます。以下のコマンドは読み取り専用です。デフォルトルートが変わらないからといってTUNが機能していないとは限りません。クライアントがポリシールーティングを使う場合もあります。出力とクライアントのログ、対象の通信がコアに届いているかをあわせて確認してください。リモート接続だけが管理手段の場合は、復旧手段を確保せずに通信の取り込み設定を変更しないでください。ルートを変えた後に接続できなくなるおそれがあります。

ip -brief address
ip -4 route show
ip -4 rule show

特定のドメインだけ失敗し、ほかの通信は正常な場合は、TUN使用時に限って起きるか確認し、アプリとシステムの名前解決に違いがないか調べます。ブラウザーが独自の暗号化DNSを使っている場合、システムの問い合わせ結果だけではブラウザーの挙動を判断できません。まずアプリのプロキシ設定に戻して比較し、リゾルバー、ルートテーブル、ファイアウォールを一度に変更しないでください。アプリの通信がコアに届いていないなら入口を確認し、コアに届いているのに出力先が違うなら分割ルールと名前解決を確認します。

05 · モバイルクライアント

Android:v2rayNGのインストール、サブスクリプション追加、VPNの許可

インストールするアーキテクチャとコアを確認する

Androidのダウンロードページから、まずv2rayNGを選びます。v2rayNGはXrayコアを使用します。新しいスマートフォンの多くはarm64に対応していますが、インストールできるかどうかは端末のOSが対応するアーキテクチャにも左右されます。CPUの製品情報だけで判断しないでください。アーキテクチャが分からない場合は汎用版を選びます。汎用版ならより幅広いアーキテクチャをカバーできますが、OSのバージョン要件、ストレージ不足、組織のポリシーなどの問題は解決しません。既存のV2Fly設定との互換性を保つ必要がある場合はv2flyNGを選べます。インストールや設定の追加手順は似ていますが、プロトコルと通信方式の対応状況は実際のコアの機能を確認してください。

インストール時に、現在のインストーラーを開いているアプリからのインストール許可を求められることがあります。ファイルの入手元を確認し、システム画面の案内に従って、今回使う入手元だけを許可してください。インストール後は許可を取り消せます。既存アプリとの競合が表示された場合、バックアップなしでアンインストールしないでください。サブスクリプションや個別設定を記録し、異なる配布元のビルドを上書きしようとしていないか確認します。アプリのデータを消去すると既存設定も削除されるため、最初に試すトラブル対処方法ではありません。

サブスクリプションを更新して現在の項目を確認する

クライアントのサブスクリプショングループ設定でURLとメモを追加し、一覧に戻って更新します。項目が表示されたら対象グループを開き、1つ選んで現在の設定にし、画面上の接続ボタンから起動してください。個別の共有リンクしかない場合は、クリップボードからインポートします。サブスクリプションURLは引き続きサブスクリプション設定で使います。スマートフォンではコピー時に案内文まで選択されることがあります。形式エラーが出たら、クリップボードにURLまたはリンクだけが入っているか確認してください。更新ボタンを何度も押しても、テキストの種類が自動で判別されるわけではありません。

最初は1つのアプリだけで確認します。個別のプロキシ設定がなく、ネットワーク権限にも特別な制限のないブラウザーがおすすめです。同じネットワークで以前開けたサイトにアクセスしてから、設定を使う必要のあるサイトを試してください。1つの項目だけ接続できない場合は、同じグループ内の動作確認済み項目と比較し、個別設定の期限切れをスマートフォンのインストール失敗と誤認しないようにします。更新後に選択中の項目が消えた場合は、グループが正しいか、サブスクリプションの内容が置き換わったか、新しい項目が選択されているか確認してください。

システムVPNの許可、アプリごとのプロキシ、バックグラウンド切断への対処

Androidでは通常、システムVPNインターフェースを通じて通信をクライアントに渡します。デスクトップ版の「システムプロキシに書き込む」手順は使えません。初回起動時にシステムのVPN接続要求が表示されたら、起動したばかりのクライアントからの要求であることを確認して許可します。ステータスバーにVPNアイコンが表示されても、システムとの通信経路が確立しただけで、リモートとのハンドシェイク成功を意味しません。ほかのVPNアプリが動作中だったり、システムで常時接続VPNが指定されていたりする場合は、どのアプリが通信を取り込んでいるか確認してください。仕事用プロファイルや管理対象端末の組織設定を無断で変更しないでください。

アプリごとのプロキシを有効にした場合、一覧の設定が「選択したアプリだけを対象にする」のか、「選択したアプリを対象外にする」のか確認してください。同じブラウザーにチェックを入れても、設定によって結果は正反対になります。特定のアプリがつながらない場合は、まず現在の通信対象に含まれているか確認し、その後ルーティングを調べます。テスト中に対象範囲を変更する場合は、元の設定を記録し、一度に1項目だけ変更して、クライアントの案内に従って再接続してから確認してください。古い接続の状態を新しいルールの結果と取り違えないようにします。

接続できるのに画面消灯後に切断される場合は、同じWi-Fiで画面点灯中と消灯後を比較し、システムがバックグラウンドプロセスを停止したり、バックグラウンド通信を制限したりしていないか確認します。必要な場合に限り、このクライアントのバッテリー設定を変更してください。モバイルデータに切り替えた場合だけ失敗するなら、アプリのモバイルデータ利用が制限されていないか、データセーバーが有効か、そのネットワークからサブスクリプションとノードに接続できるか確認します。バッテリー設定、アプリの対象範囲、DNSを同時に変更しないでください。接続が戻っても、原因となった設定を特定できなくなります。

06 · プラットフォーム共通の確認

ルーティングルールと接続確認:入口から出力先まで調べる

通信の入口、コア、接続先を個別に確認する

アクセスの問題は、3つに分けて考えます。アプリのリクエストがクライアントに渡っているか、コアが想定した出力先へ送っているか、接続先との通信が成功したか、です。システムプロキシ、アプリに直接設定するプロキシ、TUNは1つ目を担います。ルーティングルールは2つ目を決め、ノードの通信方式、認証、接続先からの応答などが3つ目に影響します。通信の取り込み設定を有効にしても、ルートが必ずプロキシを選ぶとは限りません。広範囲をプロキシに送るルーティングモードを選んでも、すべてのアプリがクライアントを経由するとは限りません。違いを整理するにはシステムプロキシとルーティングモードの比較を参考にしてください。

デスクトップクライアントがHTTPプロキシの待ち受けを提供している場合、コマンドラインツールでプロキシを指定して直接テストできます。以下では127.0.0.1:10809を例にしています。実行前に、画面に表示されたHTTP待ち受けアドレスとポートに置き換えてください。Windows PowerShellでcurlが別のコマンドに割り当てられている場合は、curl.exeを使います。この例では入口を明示しているため、「システムプロキシが設定されているか」の確認とは異なります。ローカルの待ち受けがリクエストを受け付けるか、その後どのようなエラーが発生するかを調べるのに適しています。応答が正常でも、リクエストが必ずリモートノードを経由したとは限りません。ルーティングログも確認してください。

curl -v --max-time 15 --noproxy "" --proxy http://127.0.0.1:10809 https://example.com/

ローカル接続が拒否された場合は、待ち受けアドレス、ポート、コアの状態を確認してください。ローカルプロキシが応答した後にタイムアウトした場合は、そのリクエストに適用された出力先とリモート接続の記録を確認します。接続先からアプリケーション層の応答があれば、エラーページが返った場合でも「接続先にまったく到達していない」状態とは異なります。Androidでは同じテストのためにターミナルアプリをインストールする必要はありません。VPNの対象範囲に入っていることが確実なアプリを選び、リクエストの時刻を記録してクライアントのログと照らし合わせてください。

ルールの適用順とタグを確認する

一般的なXrayおよびV2Flyのルーティング設定では、リストの上から順にルールを評価し、最初に一致したルールの出力先を使います。たとえば、指定したプライベートアドレスを直接接続させるには、それらにも一致しうる範囲の広いルールより前に配置します。以下は、対応するコアのrouting.rules配列に追加する1項目です。単独の設定ファイルではありません。既存の出力先にdirectタグがあり、直接接続に割り当てられていることが前提です。クライアントのGUIでルールを設定する場合は、画面に表示される出力先名が、実際に生成されるタグと対応しているか確認してください。

{
  "type": "field",
  "ip": ["10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"],
  "outboundTag": "direct"
}

このルールが対象にするのは、列挙したプライベートIPv4ネットワークだけです。汎用的なLAN検出の設定ではなく、IPv6も対象外です。アプリからドメイン名が渡された場合、ルーティング段階でルール照合に使えるIPアドレスが得られるとは限りません。コアのドメイン処理方法や、その時点の名前解決条件によって異なります。特定の社内ドメインを扱うには、現在のルール体系に合わせてドメイン条件を設定し、どのリゾルバーが使われるか確認してください。新しいルール1つのためにDNSの動作を全体的に変更するのは避けましょう。社内DNSに依存するほかのアプリに影響するおそれがあります。

簡単な記録を残して変更結果を確認する

変更前と変更後に、普段は直接接続するサイト、選択した出力先を通る必要がある宛先、既存のLANアクセスに依存する機器やサービスをそれぞれテストします。変更する項目は1つずつにしてください。たとえば、まずルールの順番だけを変更し、DNSは別に検討します。アプリ名、通信の取り込み方法、宛先にドメイン名とIPアドレスのどちらを使ったか、リクエスト時刻、ログ上の出力先を記録すると、「つながる/つながらない」だけより再現しやすくなります。速度測定ツールが確認する通信の段階はそれぞれ異なります。遅延が低くてもアプリの実際の動作確認にはなりません。1回のタイムアウトだけでノードが使えないとは判断できません。

ノードやルールを切り替えても同じアプリの状態が変わらない場合は、再利用中の接続を終了するかテストアプリを再起動し、新しいリクエストで確認してください。キャッシュからページを開けてもネットワークが復旧したとは限りません。長時間接続を使うアプリでは、再接続した時刻も確認します。期待どおりに動作したら、使えるルールを独立した設定として保存するか、変更内容を記録してください。後日サブスクリプションを更新したりコアを切り替えたりするときも、同じ宛先で再テストでき、以前の設定理由を推測し直さずに済みます。

07 · トラブル対処

よくある設定の問題:更新失敗、ハンドシェイクエラー、終了後の復旧

サブスクリプションの更新に失敗した?更新は成功したのに使える項目がない?

画面に表示されたのがリクエスト失敗、解析エラー、それとも更新完了後にグループが空だったのかを確認します。リクエストに失敗した場合は、基本ネットワーク、端末の日時、更新が直接接続かプロキシ経由かを確認してください。ローカルプロキシ経由に設定されていて、利用可能な設定がまだない場合、前提条件を満たせず停止することがあります。解析に失敗した場合は、取得内容がサブスクリプションAPIからの設定か、ログインページ、期限切れの通知、再認証を求める応答ではないか確認します。Webページが開けるだけでAPIにもアクセスできるとは限りません。証明書エラーを避けるために、セキュリティチェックを長期間無効にしないでください。

更新完了後に一覧が空の場合は、正しいグループを開いて名前検索を解除し、特定の条件に合うサーバーだけを表示する設定になっていないか確認してください。複数のサブスクリプションがある場合は、問題のグループだけを更新し、エラーの範囲を絞ります。更新後に以前の項目が消えた場合は、配布元がその項目を削除したか、グループの絞り込み条件が変わった可能性があります。対処方法はそれぞれ異なります。複数の配布元を管理するには、サブスクリプショングループとサーバーの絞り込み方法を参考に配布元ごとにグループを分けると、更新時に同名の項目を取り違えにくくなります。

タイムアウトやハンドシェイク失敗が起きたら、どう切り分ける?

ログにローカルポートの競合が明記されている場合は、クライアントの重複起動やポートの競合を先に解決してください。この段階では、コアがアプリのリクエストを受け付ける準備もできていない可能性があります。リモートとのハンドシェイク記録がある場合は、元の設定でプロトコル、通信方式、セキュリティの種類を確認します。ドメイン名や証明書に関するエラーが出た場合は、端末の日付とタイムゾーン、サーバー名の設定が配布元の説明と一致するか確認してください。証明書エラーを無視しても修復にはなりません。クライアントのコア切り替え機能を使った場合は、新しいコアが設定項目のフィールドと通信方式に対応しているかも確認してください。

タイムアウトだけでは原因を絞れません。リモートに到達できない、名前解決に失敗した、接続先が応答しないなど、複数の可能性があります。同じネットワークで動作確認済みの接続先を2つ試し、同じ設定を別の利用可能なネットワークでも確認してください。どの設定でも特定のアプリだけ失敗する場合は、アプリが利用している通信の入口とアプリ自身のネットワーク設定を優先して確認します。同じアプリで1つの項目だけ失敗する場合は、その項目のリモート側設定を確認してください。問い合わせ時には、最初に発生した具体的なエラー、問題の段階、実施した比較テストを添え、最後に表示された一般的なエラーで先行する原因を覆い隠さないでください。

クライアント終了後にネットワークにつながらない場合、元の状態に戻すには?

デスクトップでは、システムがまだローカルのプロキシポートを参照していないか確認します。コアが停止しているのに手動プロキシが残っていると、システム設定に従うアプリは待ち受け先を見つけられません。インストール前の記録をもとにシステム設定を元に戻してください。自動プロキシ設定スクリプトや管理ポリシーを使う端末では、元の値を勝手に削除しないでください。ブラウザーやターミナルの一部だけに影響する場合は、アプリ独自のプロキシ設定と、現在のターミナルセッションにプロキシ変数を設定していないかを確認します。新しいターミナルは正常で以前から開いているターミナルだけつながらない場合、その違いを記録してください。すぐにソフトウェアを再インストールする必要はありません。

TUNやAndroidのVPN設定が原因の場合は、クライアントまたはシステム画面から通常の方法で切断し、インターフェースと接続状態が戻るか確認してください。問題が続く場合は、有効化前に使っていたVPN、内部DNS、アプリごとの制限を見直し、1つずつ元に戻します。ネットワークの切り替え、古いプロセス、キャッシュが判断を難しくすることはありますが、最初からすべてのネットワーク設定をリセットしないでください。正常だったWi-Fi、組織のプロキシ、アクセスルールまで消えるおそれがあります。復旧後は、まず以前のネットワークで一般的なサイトにアクセスし、その後クライアントを再び有効にするか判断してください。