完全ガイド / 設定とトラブル対処

V2Rayクライアント完全ガイド

クライアント選びと最初の接続確認から始め、ルーティング、TUN、日常のメンテナンスへと進みます。各章では、変更する設定のレイヤーを説明したうえで、確認方法と元に戻す手順を紹介します。

まず接続を確立したい場合はクイックスタートガイドに沿って操作してください。設定項目の意味やプラットフォームごとの違いを確認したい場合、または問題の発生箇所を特定したい場合は、このガイドの該当章をご覧ください。

1. 基本概念:クライアント、コア、接続

設定は画面で管理し、通信はコアが処理

まず、クライアントとコアを分けて考えましょう。v2rayN、v2rayNG、v2flyNGは、設定の編集やインポート、起動・停止を行うGUIクライアントです。画面上の現在の設定、サブスクリプショングループ、ルールのプリセットは、最終的にコアが読み込める設定へ変換されます。コアはローカルの待ち受け、ルールの判定、外部への接続を担います。リストに項目が表示されていても、それは画面が読み込めたというだけです。コアがまだ起動していない、あるいは読み込み時に項目を拒否している可能性があります。「接続」を押しても反応がない場合は、まず起動エラーの有無を確認し、アプリ側の入口と接続先のどちらを調べるべきか判断してください。

V2Rayのエコシステムを理解するには、Project Vから始めるとよいでしょう。V2FlyはV2Rayのコミュニティ開発を引き継ぎ、Xray-coreは同じ技術的な流れから派生した後、それぞれ独自に発展しています。共通する設定概念もありますが、すべての項目が相互に使えるとは限りません。デスクトップではまずv2rayNを使い、設定内容に応じて利用可能なコアを選びます。Androidの2つのクライアントは異なるコアを使用するため、具体的な違いは次章で確認します。画面でインポートが成功しても、起動時にトランスポートやセキュリティの項目が未対応と表示される場合は、実際にどのコアが起動しているかを確認してください。製品名だけで対応機能を判断しないようにしましょう。

プロトコル、トランスポート、接続のセキュリティは別の項目

VMess、VLESS、Trojanは接続プロトコルを区別するもので、それぞれ設定項目や認証方式が異なります。トランスポートは、データを相手に届ける方法を示します。たとえば、ストリーム接続やWebSocketなどです。TLSは接続を保護する方式の一つです。REALITYはXrayで特定の構成に利用できる接続保護の仕組みであり、VLESSと同じ種類の設定項目ではありません。設定を確認するときは、アドレスとポート、プロトコル、トランスポート、セキュリティ方式の順に見てください。見慣れた略語が2つあるだけで、設定を相互に置き換えられると判断しないようにしましょう。

同じドメイン名が複数の項目に現れても、それぞれ役割が異なる場合があります。サーバーアドレスは接続先を特定するためのものです。TLSを有効にしている場合、サーバー名はハンドシェイクや証明書の照合に使われることがあります。アプリがアクセスする宛先ドメインは、ルーティングの判定に使われる場合があります。アクセス先のドメインをサーバーアドレスに入力したり、名前が一致しないからといってセキュリティ検証をむやみに変更したりしても、項目の誤りは解決しません。ハンドシェイクに失敗したら、エラー時の項目とメッセージを控え、信頼できる設定情報と一つずつ照合してください。「ドメイン名らしい」という理由だけで置き換えないようにしましょう。

通信がどこから入り、どこへ出るかを確認

クライアントがローカルで開く待ち受けポートを「インバウンド」と呼びます。コアから出た通信は、直接接続する場合もあれば、リモート経由で転送される場合もあり、これを「アウトバウンド」と呼びます。プロキシモードはアプリの通信をクライアントに取り込めるかを決め、ルールは取り込んだ後にどのアウトバウンドを選ぶかを決めます。ブラウザーでページを開けても、プロキシ経由とは限りません。コアのログに起動記録があっても、ブラウザーがそのインバウンドを使ったとは限りません。診断では、アプリ、入口、マッチしたルール、アウトバウンドの4段階に分け、それぞれの証拠を記録しましょう。プロキシを使っていないアプリを直そうとして、正常に読み込めるリモート設定まで誤って変更する事態を防げます。

サブスクリプションは複数の接続設定を配布する方法であり、別のプロトコルでも、接続先が現在利用可能であることの証明でもありません。更新で確認できるのは「データを取得して設定として読み込めるか」です。接続テストで確認できるのは「現在のアプリがこの設定でリクエストを完了できるか」です。最初からこの2つの結果を分けて記録してください。更新したグループと時刻、テストに使った設定とアプリ、クライアントが最初に表示したエラーを残します。ネットワークを変更したりソフトウェアを更新したりした後も、同じ記録があれば一時的な問題と実際の変化を区別しやすくなります。原因が分からない場合でも、利用できる状態へ戻す手がかりになります。

2. クライアント選び:プラットフォーム、アーキテクチャ、コア

デスクトップはOSとパッケージ形式から選ぶ

デスクトップにはv2rayNがおすすめです。まずダウンロードセンターでOSに合ったものを選び、デバイスのプロセッサアーキテクチャとパッケージ形式を照合してください。OS名で分かるのはダウンロード欄までで、その欄にあるすべての選択肢が使えるとは限りません。たとえばmacOSはApple SiliconとIntelでインストーラーが異なります。Linuxも、プロセッサアーキテクチャが合っていても、異なるパッケージ管理システム向けのパッケージを流用できるとは限りません。システム情報がはっきりしない場合は、設定画面に表示されている情報を控えてから確認してください。購入年やアプリストア上のデバイス名だけで判断しないようにしましょう。

プラットフォームクライアントパッケージの選び方
Windowsv2rayNダウンロード欄にはx64向けのデスクトップ版と従来のWPF版があります。まずOSを確認し、使う画面に合わせて選んでください。
macOSv2rayN「このMacについて」でチップまたはプロセッサを確認し、Apple SiliconまたはIntel向けを選びます。
Androidv2rayNGを推奨、v2flyNGは代替候補システムがarm64に対応していることを確認してから該当パッケージを選びます。アーキテクチャが不明な場合は、まず汎用版の説明を確認してください。
Linuxv2rayNx64またはarm64からアーキテクチャを選びます。debとrpmのどちらを使うかは、ディストリビューションのパッケージ管理方式で決まります。

Windowsの2つのインストール方法は、異なるプロキシプロトコルという意味ではありません。デスクトップ版はクロスプラットフォームの画面を、WPF版は従来のWindows向け画面を使用します。使い慣れたものがあればメニュー構成で選んでください。初めてインストールする場合は、片方だけでサブスクリプションの設定と接続確認を行えば十分です。比較のために両方を同時に起動する必要はありません。2つのインスタンスが同じローカルポートで待ち受けたり、それぞれがシステムプロキシを変更したりすることがあります。一方を終了したときに、もう一方が使用中の設定まで解除される場合もあります。OSに対応する入口がダウンロードセンターに見当たらない場合は、システム要件とダウンロードページのFAQを確認し、別OS向けパッケージで代用しないでください。

Androidは設定に必要なコアで選ぶ

Androidでは、まず使用する設定がどのコアを必要とするか確認します。v2rayNGはXrayコアを使用するため、まずはこちらを選びます。v2flyNGはV2Flyコアを使用し、V2Flyの設定を確認する必要がある場合の候補です。信頼できる設定の説明に、特定のコアだけが対応する項目が明記されている場合は、その要件を優先してください。「インポート成功」だけで互換性があるとは判断できません。一般的な設定なら、まず1つのクライアントだけをインストールして動作を確認します。比較が必要になったら、元のVPN接続を停止してから、もう一方で同じ接続先を再テストしてください。そうしないと、システムが新しいVPNに切り替わっただけなのに、両方のクライアントが通信を処理していると誤解するおそれがあります。

Android端末のプロセッサが64ビットコードを実行できても、現在のシステムがアプリに64ビット環境を提供しているとは限りません。「このパッケージは端末に対応していません」と表示された場合は、端末の仕様とインストール方法を確認してください。別の方法でスマートフォンに転送したパッケージなら、Android向けのインストーラーであることも確認します。汎用版を使えばアーキテクチャ選びの間違いを減らせますが、コアが変わるわけではなく、OSバージョンの要件を補えるわけでもありません。インストール済みアプリとの競合が表示されても、すぐにアンインストールせず、まず再インポートできる設定を保存し、2つのインストール元を確認してください。

互換性は3段階で確認する

1段階目ではシステムにインストールできるか、2段階目ではコアが現在の設定を読み込めるか、3段階目では目的のアプリが実際に接続できるかを確認します。失敗した段階によって対処は異なります。インストールの失敗ならOSとアーキテクチャ、読み込みの失敗なら項目とコア、アプリの失敗ならプロキシモード、名前解決、ルーティングを確認してください。別のデバイスに移行するときは、まず再取得できるサブスクリプションや単一の設定を移します。アプリのデータ一式を丸ごとコピーするのは避けましょう。通信を取り込む権限、ポートの割り当て、画面の項目はデバイスごとに異なる場合があります。最小限の設定から始めるほうが、後で古い設定による競合を特定するより効率的です。

クライアント選びの理由を記録する際、設定項目をすべて書き写す必要はありません。デバイスのアーキテクチャ、インストール方法、クライアント名、現在のコア、設定の入手元を残せば十分です。「Xray固有の項目を含む設定を読み込むため」など、別の選択肢を選ばなかった理由も一言添えると役立ちます。案内されたメニュー名が自分の画面と異なる場合は、まず記録と照合してください。画面上の名称だけが違うと分かったら、機能から該当項目を探します。特定のクライアントだけで問題が起きるか調べる際は、ネットワーク、接続先、設定を同じに保ち、クライアントだけを切り替えましょう。

3. インストール:実行権限と初回起動

デスクトップへのインストール後は、まず画面だけを起動

Windowsでは、ダウンロードセンターで選んだインストーラーを実行し、システムの案内に従ってインストールした後、スタートメニューから該当するv2rayNを起動します。初回利用時に、将来TUNを使う可能性があるという理由だけで、毎回管理者として起動する必要はありません。まず普段使っているアカウントでウィンドウやメニュー、設定が使えることを確認し、機能を使うときに求められる権限だけを付与してください。実行コンポーネントが不足していると表示されたら、コンポーネント名とインストール方法を正確に控え、ダウンロードの説明と照合します。名前が似ているファイルを不明な配布元から探して置き換えたり、起動できない問題をサブスクリプションURLのせいにしたりしないでください。

macOSではチップに合ったディスクイメージを使います。イメージを開いたら、ウィンドウの案内に従ってアプリケーションフォルダへ移動し、そこから起動してください。マウントしたウィンドウを常用する場所にしないようにしましょう。システムが起動をブロックした場合は、表示をよく読み、アーキテクチャ、配布元、管理ポリシーのどれが原因か確認してから、ダウンロード方法とデバイス要件を見直します。組織が管理するデバイスでは、管理ポリシーに従い、インストールのためだけにシステム全体の保護を弱めないでください。インストール後はアプリケーションフォルダ内のアプリを開いていることを確認します。更新後に古いディスクイメージ内のコピーを誤って起動し、設定が保存されないように見える事態を防げます。

Linuxでは、ディストリビューションに合ったdebまたはrpmをグラフィカルなソフトウェアインストーラーで開き、インストーラーに表示されるアーキテクチャと依存関係を確認します。依存関係が不足していると表示されたら、パッケージが現在のディストリビューションとアーキテクチャに対応していることを確認し、ディストリビューション標準のソフトウェアソースから依存関係を解決してください。インストール後は、アプリ一覧からv2rayNを起動します。リモート端末だけで使用し、GUIアプリを開けるデスクトップセッションがない場合、このガイドの画面操作は適用できません。ウィンドウを探すために異なる形式のパッケージを繰り返しインストールしたり、起動のためにシステムディレクトリを全ユーザーが書き込めるようにしたりしないでください。

Androidではインストール権限と接続許可を分けて考える

ブラウザーやファイル管理アプリから信頼できるインストーラーを開くと、そのアプリからのインストールを許可するようシステムに求められる場合があります。インストーラーを実際に開いたアプリだけに許可し、インストール後はシステム設定から一時的な権限を取り消せます。プロキシクライアントの初回起動と、VPNの初回接続は別の操作です。まず画面やサブスクリプションの入口、設定の保存を確認してから、システムのVPN許可を設定できます。許可していない場合もインポート済みの項目は表示されることがありますが、対象アプリの通信がVPNに取り込まれるわけではありません。組織管理の接続ポリシーが設定されているデバイスでは、置き換えが許可されるか確認し、管理ポリシーをそのまま解除しないでください。

初回インストールでは、以前のデバイスの設定一式をすぐに復元しないでください。自動接続や、ネットワークの入口を書き換える他のクライアントを停止し、新しいアプリを初期状態で単独起動します。設定画面を一度開いて閉じ、もう一度起動して、使用中のアカウントで通常の設定を保存できるか確認します。デスクトップでは、画面に表示されるローカル待ち受けの設定を記録しても構いませんが、ポートをLANに公開する必要はありません。再起動後に設定が古い値へ戻る場合は、別のアプリを開いていないか、異なるユーザーアカウントを使っていないか、データディレクトリへの書き込みに失敗していないか確認してください。まだサブスクリプションを追加していないため、原因を絞りやすい段階です。

初回起動の状態を基準として記録

基準状態とは速度測定の結果ではなく、現在のデバイスで繰り返し確認できる状態です。まず、いつものネットワーク設定で日常的に使うページを開き、クライアントがまだ通信を取り込んでいない状態を記録します。ウィンドウを閉じた後、システムプロキシやVPNの状態が変わっていないか確認してください。手動プロキシや常時接続VPNを以前から使っている場合は、後で元に戻せるよう設定を控えておきます。その後、次章で使う入手元の明確な設定を用意します。インポート後に問題が起きても前後を比較できます。インポート前からネットワークに問題がある場合は、新しい要因を増やさず、先に基本的な接続を解決してください。

4. サブスクリプションの追加:グループ、更新、適用

サブスクリプションURLと単一の設定を区別する

サブスクリプションURLは通常、複数の設定を取得するために使います。更新によってグループ内の項目が変わることがあります。単一の共有リンクやQRコードは通常、1つの接続設定を追加するもので、特定のグループを更新しても内容は変わりません。通常のWebページに見えるURLだからといって、そのままオンライン変換ツールに入力しないでください。URL全体にはアカウントを特定できる情報が含まれている場合があり、QRコードにもサーバーアドレスや認証情報が含まれることがあります。入手元と形式の説明を確認してから、クライアントの該当するインポート機能を使ってください。形式の確認のためにURL全体を公開検索欄やチャットグループへ貼り付けないようにしましょう。

v2rayNで「サブスクリプショングループ」からグループ設定を開き、新しいグループを作成します。区別しやすい名前と「任意アドレス(URL)」を入力して保存し、メイン画面に戻ってそのグループを選び、「現在のサブスクリプションを更新」を実行します。初回は1つのグループだけを更新すると、追加された項目をすぐに確認できます。保存しただけではURLが登録されるだけで、データの取得は始まりません。更新操作を行うとデータを取得し、設定として解析します。グループ内に手動で追加した重要な項目がある場合は、次の更新で取得データに上書きされたり削除されたりしないよう、別の場所に保管してください。

v2rayNGまたはv2flyNGでは、サイドバーやメニューのサブスクリプション管理を開き、新しいグループを作成してメモとURLを保存します。その後、設定一覧に戻り、サブスクリプションを更新します。メニュー名は画面によって異なる場合があります。単一の共有リンクは、追加メニューにあるクリップボードからのインポートまたはQRコードの読み取りを使います。読み取り後に表示されるプロトコルとグループを確認してから有効にしてください。クリップボードに複数行のテキストがある場合は、チャット履歴から一部を手作業で切り取るのではなく、配布元から完全なリンクをコピーし直してください。初回は1種類の入手元だけを追加し、同じ名前の項目が重なって選択しにくくなるのを避けましょう。

更新エラーは取得と解析に分けて確認

更新でデータを取得できない場合は、URLが期限切れでないか、コピー時に文字が欠けていないか、現在のネットワークからリクエストを送信できるか、デバイスの時刻が大きくずれていないか確認します。データを受信したのに項目が表示されない場合は、返された内容が設定データなのか、ログインページやエラーページなどの通常のWebページなのかを確認し、形式とコアの互換性を調べます。レスポンス本文をそのまま公開して質問しないでください。ログにタイムアウトが記録されている場合は、更新時の通信経路も確認します。直接接続で更新する場合と、現在のプロキシ経由で更新する場合は経路が異なります。後者には、すでに利用できる接続が必要です。古い接続しか使えない状態でプロキシ経由の更新を何度繰り返しても、接続の問題は解決しません。

一覧に項目が表示されたら、名前と入手元を確認できる設定を1つ選びます。デスクトップではアクティブな設定にし、Androidでは項目を選んでから接続を開始し、システムの案内に従って許可します。ログに項目の解析エラーやポート競合がないか確認し、必要に応じて既知の利用可能な設定と比較しながら、同じ一般的な接続先でテストします。サブスクリプションの更新が成功していても、接続先が停止していたり、セキュリティ設定が合わなかったりすれば、項目を利用できないことがあります。同じグループ内の信頼できる別の設定で再テストしてから、サブスクリプション全体を調べるか、その項目だけの問題として記録するか判断してください。

最初の接続成功後に自動更新を設定

まず手動で更新し、項目を1つ使って接続できることを確認してから、自動更新を有効にするか判断します。v2rayNのグループ設定で更新が許可されていることを確認し、配布元の実際の更新頻度に合わせて自動更新の間隔を設定してください。単位は分です。新しい項目を取得しても、希望どおりに別の項目へ切り替わるとは限りません。更新後にアクティブな設定を再確認してください。同じURLをほかのデバイスでも使っている場合、各デバイスの更新時刻や選択中の設定が異なることがあります。URLを変更した場合や更新がうまくいかない場合は、サブスクリプション更新のトラブル対処メモを参照し、取得・解析・選択のどの段階で問題が起きたか記録してください。

5. プロキシモード:入口と接続確認

デスクトップはシステムプロキシで基準を作る

v2rayNでアクティブな設定を選び、コアが起動していることを確認してから、システムプロキシのメニューを開き、「システムプロキシを自動設定」を選びます。これによりシステムプロキシがクライアントのローカル入口を参照するようになり、まずはシステムプロキシに従うブラウザーで確認できます。ブラウザーにプロキシを個別制御する拡張機能がある場合は、テスト時にシステム設定を上書きしていないか確認してください。専用のプロキシ設定を持つアプリも別途確認が必要です。システムプロキシを使ってもすべてのプログラムの通信が切り替わるわけではありません。すべてのリクエストがリモート経由になるわけでもなく、コアに入った後のアウトバウンドは現在のルーティングルールで決まります。

設定項目動作確認する点
システムプロキシを解除システムプロキシ設定を削除以前の手動プロキシは記録に従って復元してください。アプリ独自のプロキシ設定はこの操作の対象外です。
システムプロキシを自動設定システムプロキシをクライアントのローカル入口に設定システムに登録されたアドレスとポートが、実際の待ち受け設定と一致していることを確認します。
システムプロキシを変更しないクライアントによるシステムプロキシの書き換えを行わない以前のプロキシ設定が引き続き有効な場合があります。解除済みとは判断しないでください。

手動プロキシに対応する特定のツールだけでクライアントを使いたい場合、デバイス全体のシステム設定を変更する必要はありません。クライアントでローカル待ち受けの種類とポートを確認し、ツールのプロキシ設定に同じ種類を指定して、ローカルのループバックアドレスを入力します。リモートサーバーのポートをローカルプロキシ欄に入力したり、ローカルのHTTP入口をSOCKS入口として設定したりしないでください。ポート番号を入力できても、両側が同じプロトコルを使っているとは限りません。手動でのテストが終わったら、ツールの設定を解除してからクライアントを終了してください。停止したローカルアドレスに、後からツールが接続しようとするのを防げます。

Androidは接続前にVPNの状態を確認

Androidでは、使用する設定を選び、「接続」をタップするのが一般的です。システムから初めてVPN接続を求められたら、ユーザーの確認が必要です。確認ダイアログへの同意は、システムが通信を取り込む経路を作ることへの許可にすぎず、リモートとのハンドシェイク成功を意味しません。別のVPNや仕事用の接続設定が有効な場合は、システムの接続状態と管理上の要件を確認してください。通常の利用では、複数のクライアントを同時に比較せず、1つずつテストします。アプリごとのプロキシ設定がある場合、失敗するアプリが対象外になっている可能性もあります。まず同じブラウザーで基準となる接続を確認し、その後、対象アプリが除外リストに入っていないか調べましょう。

同じ接続先で3段階の経路を確認

検証ではネットワークと接続先を固定し、次の3点を順に確認します。クライアントのプロセスが正常に待ち受けているか、アプリがリクエストした時刻にログへ該当する接続が記録されるか、最後にアプリが期待する結果を受け取れるかです。ブラウザーのキャッシュにある古い画面を接続の証拠にしないよう、ページを開き直してリクエストを発生させてください。ページが開いてもログにリクエストがなければ、アプリがその入口を使っていない可能性があります。インバウンドの記録があるのにアウトバウンドがタイムアウトする場合は、ルールと実際の接続を確認します。特定のサイトで一度成功しただけで、すべてのアプリやトランスポートが正常だとは判断できません。

ブラウザーは使えるのに更新ツールが開けない場合は、ツールがシステムプロキシに対応しているか、独自の設定があるか、現在の方式では取り込めない通信を追加で使っているか確認します。システムにローカルプロキシが設定されているのに、コアがポート競合を報告する場合は、同種のクライアントを終了するか、ポートの使用元を確認してから変更を検討してください。変更後は、手動で設定したアプリも確認します。システムプロキシが新しいポートを使っているのに、個別のツールだけ古いポートのままになることがあります。原因を切り分けるため、入口は一度に1つだけ変更してください。ノード、ルーティング、ポートを一度に変更すると、症状の変化を原因に結び付けられません。

テストを終える前に、作業時の状態を記録してから入口を元に戻します。デスクトップでテスト前に直接接続していた場合は、今回設定したシステムプロキシを解除し、アプリ終了後も通常のページにアクセスできることを確認してください。以前から組織や個人の手動プロキシを使っていた場合は、準備段階の記録に従って戻します。解除するだけでは以前の値に戻りません。Androidではアプリの接続を停止してから、システムのVPN状態を確認してください。常時接続や、VPNを経由しない通信の制限にも注意が必要です。停止後にすべての通信ができなくなった場合は、設定を再インポートするのではなく、このレイヤーを確認します。入口の切り替えを個別に検証しておけば、次章のルーティングテストに通信の取り込み範囲が影響するのを防げます。

6. ルーティング:条件、順序、DNS

ルーティングはクライアントに入ったリクエストの出口を選ぶ

始める前に、検証済みのルーティングプリセットを残し、コピーを作って試してください。プリセット名は選択の目印にはなりますが、ルールの確認に代わるものではありません。同じ「バイパス」という名前でも、設定ごとにルール一覧が異なる場合があります。リクエストを判定するときは、まずアプリがドメイン名とIPアドレスのどちらを入口に渡したかを確認します。次にルールの条件と順序を見て、最後にアウトバウンドのラベルを確認します。ルールがドメイン名を条件にしているのにアプリがIPアドレスを渡している場合は、現在の入口でコアが宛先情報を復元できるかを最初に確認してください。似たドメイン名を適当に追加して解決しようとしないでください。

ルールはドメイン名やアドレス範囲などの条件に一致させられます。複数の条件を組み合わせた場合、すべてを満たす必要があることもあります。ルールは順番に評価されるため、広い条件を個別ルールより先に置くと、後の例外が使われない場合があります。設定を変更するときは、具体的なルールを広いルールより前に置き、デフォルトの出口も別に設定してください。サイトを追加したら、そのサイトに加えて、別の出口を使うはずの既存の接続先と、個別指定していない一般的な接続先も確認します。追加したサイトだけをテストしても、今回の変更でデフォルト経路が変わっていないかは分かりません。

コアのJSON例:LANは直接接続、デフォルトはアウトバウンドへ

以下はXrayまたはV2Flyのカスタム設定に組み込める、トップレベルのrouting断片です。起動できる設定全体ではありません。既存の設定に、タグがdirectの直接接続用アウトバウンドと、タグがproxyのプロキシ用アウトバウンドが定義され、既存のインバウンドが維持されている必要があります。タグが異なる場合は、実際のタグを使ってください。GUIクライアントのルールエディターを使う場合は、条件と宛先アウトバウンドを照らし合わせて入力し、JSON全体をドメイン名の欄に貼り付けないでください。まずコピーした設定で検証し、その後、通常使う設定に適用します。

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "ip": ["10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "network": "tcp,udp",
        "outboundTag": "proxy"
      }
    ]
  }
}

この例では、指定したプライベートIPアドレス範囲へのリクエストを直接接続し、最後のルールで、それ以外のルーティング対象となるTCPとUDPを処理します。見落としやすい点として、IPIfNonMatchはルールに一致しなかった場合にのみ、IPアドレスによる照合のためにドメイン名の解決を試みます。その前に有効な広範囲のフォールバックルールが一致する場合があります。したがって、この例を「プライベートアドレスに解決されるドメインはすべて必ず直接接続される」と解釈できません。明確なLAN内ドメインがある場合は、フォールバックより前に専用ルールを追加してください。ドメイン名の解決結果からアドレスを照合する必要がある場合は、追加の問い合わせや解決経路が発生するIPOnDemandの影響を検討します。

DNS問い合わせと最終的なアクセスを分けて確認

ルーティングでは宛先を特定する必要がありますが、DNS問い合わせにも名前解決サービスへ向かう経路があります。サイトへの通信がプロキシ経由でも、名前解決のリクエストが同じ経路を通るとは限りません。ブラウザー独自の暗号化DNS、システムのDNS設定、クライアント内蔵のDNSが使われている場合があります。設定を変更する前に、実際に有効な方式を記録し、どの範囲の名前解決をコアに処理させるか決めてください。直接接続する宛先とプロキシ経由の宛先を1つずつテストし、ログに記録された宛先名、マッチしたルール、出口を確認します。必要に応じてDNS問い合わせの経路と漏えい対策の設定に沿って名前解決の経路を調べてください。

ルール変更後にLAN内のサービスだけ使えなくなった場合は、正しいと分かっているLAN内アドレスでテストし、次に元のドメイン名でテストしてください。結果が異なる場合は、名前解決やドメイン照合を個別に確認する必要があります。すべての宛先で失敗した場合は、保存しておいたプリセットに戻して再読み込みし、基準状態に復帰できることを確認します。その後、存在しないアウトバウンドのタグを参照していないか、必要な既存の例外ルールを上書きしていないか調べてください。何十件ものルールを一度に設定するより、条件を追加するたびに結果を確認し、実際に使われた順序を残すほうが確実です。クライアントの更新後も、この一覧を使ってルールの動作が変わったか確認できます。

7. TUNモード:通信の取り込み範囲と元に戻す方法

問題が本当に入口にあるか見極める

TUNは仮想ネットワークインターフェースやシステムの仕組みを使い、ルーティング対象の通信を受け取ります。デスクトップアプリごとにシステムプロキシへの対応が必要なわけではありません。同じ設定でシステムプロキシ経由の接続を確認済みなのに、対象アプリがその入口を使わない場合は、次の手段として適しています。通常のブラウザーですでにハンドシェイクに失敗する場合や、コアが起動しない場合、TUNを有効にしてもリモート側の設定問題は直りません。どのアプリを新たに取り込みたいのか、従来のモードと比べてどのような変化を期待するのかを明確にし、範囲が広がることを安定性の向上と取り違えないようにしましょう。

通信を取り込む範囲が広がっても、すべての通信が同じアウトバウンドを通るとは限りません。システムルート、クライアントのTUN設定、LANの除外設定、アプリ独自の名前解決方法が影響します。デスクトップでは専用コンポーネントの有効化やシステム権限が必要な場合があります。Androidで一般的なのはシステムのVPN経路です。デスクトップ画面の項目をそのままスマートフォンに当てはめないでください。LAN共有へのアクセスが必須な環境や、デバイスに別の仮想インターフェースがある環境では、事前に復元可能なテスト手順を用意します。現在のネットワークに依存するリモートセッション中は、切り替え後に端末へアクセスできなくなるおそれがあるため、安易に通信の取り込み方式を変更しないでください。

クリーンな基準状態からv2rayNのTUNを起動

まずデスクトップでシステムプロキシ経由の接続が正常に再現できることを確認し、元のシステムプロキシの状態、現在のルーティング、アクティブな設定を記録します。その後、システムプロキシによる通信の取り込みを停止し、同じアクティブな設定を維持します。システムルートを変更する別のプロキシクライアントも停止してください。v2rayNの画面にあるTUNスイッチを探し、案内に従って必要な権限を設定します。現在の画面に項目がない場合や起動に失敗する場合は、ログに表示されたコンポーネントとエラーを確認します。別のOSのスクリーンショットを見て、スイッチのパラメーターをそのまま設定しないでください。最初の検証ではTUNだけを確認し、リモートDNSの追加やルーティングルールの変更を同時に行わないようにします。

有効にしたら、一般的なWebページ、システムプロキシを使わなかったアプリ、直接接続を維持するLAN内のリソースの順にテストします。各テストの前にリクエストを発生させ、アプリが操作された時刻にインバウンドやルール一致がログに記録されるか確認してください。一般的なWebページだけ開けても、もともとの問題は解決していません。対象アプリが使えるようになってLAN内のリソースにアクセスできなくなった場合は、LANルートと除外範囲を確認します。正常に使えても、TUNの停止後にシステム全体で問題が起きた場合は、デフォルトルート、元のプロキシ、DNSが復元されているかを調べ、残っている設定を記録してください。長期的な対処として、単に停止と再起動を繰り返さないでください。

DNS、仮想アドレス、トランスポートの問題を分けて判断

TUN使用時にはDNSリクエストの経路が変わることがあります。既知のLAN内アドレスに接続できるか、対応するLAN内の名前を解決できるかを比較してください。アドレスには接続できるのに名前を解決できない場合は、クライアントを再インストールせず、まずDNSの選択と対象範囲を確認します。FakeDNSが有効な場合、返されるアドレスはドメイン名に割り当てられたコア内部の仮想IPであることがあります。その後の接続が、設計どおり、この対応関係を復元できる入口に戻らなければ、ルールは復元した宛先を判定できません。次の情報としてFakeDNSの仕組みと利用場面を参照してください。基準状態を確立するまでは有効にする必要はありません。

あるアプリでWebページは開けても、音声通話やリアルタイム接続が失敗する場合、実際の通信種類がWebページのテストと異なる可能性があります。同じネットワークでTUNを無効にして比較し、対象アプリ固有の問題ではないことを確認してから、現在のアウトバウンドとルールが必要なトランスポートに対応しているか調べます。「Webページが開ける」だけですべての通信種類が通るとは判断しないでください。反対に、TUNを有効にした途端にあらゆるリクエストが失敗した場合は、まずTUNを停止し、元のシステムプロキシ設定に戻して基準状態を確認します。2回目に再有効化するときは、権限やルートの競合など、1つの原因だけを調べます。結果を変えた設定を特定できるまで、確認対象を増やさないようにしましょう。

8. 日常のメンテナンス:更新、バックアップ、確認

サブスクリプションの更新とソフトウェアの更新を分ける

サブスクリプションを更新すると接続項目が変わります。ソフトウェアやコアを更新すると、設定の解析、画面、実行時の動作が変わることがあります。同じ日に両方の更新がある場合は、まず片方だけ実施して検証し、それからもう片方を更新します。日常的なサブスクリプションの確認頻度は配布元の更新状況に合わせ、短すぎる自動更新間隔は避けてください。グループを更新したら、アクティブな設定が残っているか、同じ名前の項目が増えていないか確認し、接続先を固定してテストします。更新前は使えたのに後から問題が起きた場合は、別に保存しておいた設定と比較してください。削除して再インポートするより、項目の変化なのか一時的なネットワークの不調なのかを判断しやすくなります。

クライアントを更新する前に、使用中のインストール方法とコアを記録し、サブスクリプショングループ、よく使うルーティング、ローカルポート、DNSの選択、通信の取り込み設定を保存します。更新内容に設定の移行が含まれる場合は、バックアップを利用できる環境で読み込めるか確認してください。更新後はコアやルーティングを切り替えず、以前と同じ通信の取り込みモードで起動し、一般的な接続先とローカルのリソースを1つずつ確認します。新しい画面でデフォルト設定が変わっていたら、実際の設定項目を記録し、古いスクリーンショットから推測しないでください。元に戻す必要がある場合は、更新後に新しく作られた必要な記録を残し、可能な限り更新前のバックアップを復元します。移行済みのデータを古いプログラムへそのまま読み込ませないでください。

復元したい内容に合わせてバックアップを選ぶ

サブスクリプションURLは変化する項目一覧の再構築に、単一項目のエクスポートは現在使える接続設定の保存に、クライアントのバックアップは同種のデバイス間でのグループや一部設定の移行に適しています。それぞれ保存される内容は異なります。サブスクリプションURLに手動のルーティングは含まれません。単一の共有設定に全体設定が含まれることも通常ありません。バックアップにもシステム権限やOS側の状態が保存されない場合があります。デバイスを移行する前に複数デバイス間の設定同期メモを確認し、必要なものをそれぞれ保存してください。QRコード1つでデバイス全体のネットワーク設定を保存できるとは考えないでください。

バックアップについて、保存場所、開き方、アクセスできる人を把握してください。設定ファイルにはアカウント識別情報やサブスクリプションURL全体が含まれる場合があります。公開共有の保存先にそのまま置いたり、公開の問い合わせに圧縮ファイル全体を添付したりしないでください。移行では、まずクライアントが対応するインポート・エクスポート機能を使います。インポート後は必要なグループとルールだけを復元し、ローカルポート、デバイスの権限、通信の取り込みを一つずつ設定してください。新しいデバイスで一通りの動作確認が終わるまで、古いデバイスの設定は変更しないでください。項目をインポートできてもルーティング設定が認識されない場合は、設定全体を上書きするより、必要なルールだけを手動で作り直すほうが差分を確認しやすくなります。

トラブル記録には役立つ情報だけを残す

断続的な問題が起きたら、発生時刻、現在のネットワーク、アクティブな設定の自分用の名前、TUNの状態、失敗したアプリを記録し、その時間帯に最初に現れたエラーを確認します。デバイスがスリープから復帰した後にだけ失敗する場合は、「復帰前は正常、復帰後に異常」と明記してから、ネットワークが切り替わったか、ローカルの待ち受けが復旧したかを調べます。特定のネットワークだけで失敗する場合は、利用できるネットワークに戻して再テストし、すぐにサブスクリプションの期限切れと判断しないでください。他の人に相談するときは、エラーの種類と必要な状況だけを残し、URL全体、QRコード、認証情報、個人を特定できるアクセス記録を削除します。

よく使うデバイスは、短時間の確認を定期的に行います。設定を読み込めるか、通常の接続先が想定した出口を通るか、ローカルのリソースに引き続きアクセスできるか、通信の取り込みを停止した後に元のネットワークへ戻れるかを確認します。パソコンからほかのデバイスへプロキシを共有する予定がある場合は、本当に必要か確認し、ローカルループバックの待ち受けとLAN向けの待ち受けを区別して、信頼できないネットワークに公開しないでください。確認項目はv2rayNのLAN内プロキシ共有設定を参照してください。共有を停止したら、待ち受けが解除されたことも確認します。普段この機能を使わない場合は無効のままにしておくと、ポートの問題を調べる際に考慮する入口を減らせます。

9. 応用編:条件を1つずつ変えて検証

スイッチを何度も切り替えるより比較テストを使う

応用的な検証は、再現できる問題から始めます。「このデバイス、このネットワーク、この入口で、同じ接続先にアクセスする」という基準を明確にし、クライアント、コア、ルール、DNS、通信の取り込みモードのいずれか1つだけを変更します。ブラウザーでは使えるのに特定のツールでは使えない場合、まず入口だけを切り替え、ルーティングやサブスクリプションを同時に変えないでください。どちらの入口でも失敗するなら、同じアプリを使ったままアクティブな設定だけを切り替えて比較します。失敗が再現できない場合、最後に操作したスイッチのおかげで成功したと決めつけないでください。操作の前後で同じ観察結果を記録すれば、次に進むべきか元に戻すべきか判断できます。

問題は「期待、実際、証拠、次の手順」の形で記録できます。たとえば「LAN内ツールからローカルリソースへ直接接続できると期待したが、TUNを有効にするとタイムアウトした。LAN内アドレスには接続できるがドメイン名で失敗するため、次はその名前をどのDNSが解決しているか確認する」という形です。クライアントがツールからのリクエストを一度も受け取っていない場合は、ルールを分析する前に入口と通信の取り込み範囲を確認します。この形式で記録する際、ログに見えないことを、発生していない証拠としないでください。ログレベルや記録範囲が不十分な場合があります。一時的に記録レベルを上げてテストし、終了後に通常の設定へ戻してください。

自分の環境を基準に起動と接続のエラーを読み解く

デスクトップでバインドに失敗した場合は、まず設定画面にあるローカル待ち受けの種類を確認し、対応するポートが実際に存在するか調べます。WindowsではPowerShellから、次の読み取り専用コマンドを実行すると、待ち受け中のローカルTCPアドレス、ポート、プロセスIDを一覧表示できます。タスクマネージャーの「詳細」タブでプロセスIDを照合し、現在のクライアントのコンポーネントか、別のプログラムかを確認してください。このコマンドはプロキシプロトコルを検証するものでも、リモートへの接続を試すものでもありません。サブスクリプションの品質判断には使えません。バインドするアドレスを確認する際は、ローカルループバックアドレスと全インターフェース向けのアドレスを区別してください。後者は既存の共有設定も踏まえて判断します。

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

待ち受けは正常なのにコアが外部接続のタイムアウトを報告する場合は、宛先を名前解決できないのか、接続が確立していないのか、ハンドシェイク後に失敗したのかを分けて考えます。設定項目が認識されないエラーは読み込み段階で起きることが多く、証明書名の不一致は該当するセキュリティハンドシェイクの段階で発生します。リモート側が返すアプリケーションエラーは、接続後の別レイヤーです。ログの表現が似ていても、発生時点と照らし合わせてください。名前の不一致を隠すためにセキュリティ検証を無効にしないでください。特定のネットワークだけで問題が起きるなら、利用できると分かっているネットワークで同じ設定を再テストします。複数の設定が同じ段階で失敗する場合は、ローカル環境で共通する条件を確認してください。

次に行うテストを目的に合わせて選ぶ

第1段階ではドメインルールを1つだけ変更します。保存したルーティング設定のコピーに、直接接続したいテスト先を1つ追加し、その接続先と別の一般的な接続先の経路を確認してから、新しいルールを削除して再テストします。第2段階でDNSを調べます。ルーティングを固定したまま、直接接続先とプロキシ接続先それぞれの名前解決とアウトバウンドの結果を確認してください。第3段階では通信の取り込みを検証します。同じアプリを明確に対応する入口でテストし、次にシステムプロキシまたはTUNと比較して、最小限の再現手順を残します。各段階の前に期待する結果と復元方法を書き留めてください。前の段階の結果を説明できないまま次の設定を変更して、問題を覆い隠さないようにしましょう。

日常的にサブスクリプション、システムプロキシ、少数のルーティングルールだけを使うなら、この3点を説明できれば十分です。プロキシに従わないアプリへの対応が必要になったらTUNを確認します。デバイスの移行やカスタムコア設定が必要になったときに、コアの違い、設定項目、アウトバウンドのタグを見直してください。インストール、アーキテクチャ、デバイス要件で行き詰まったらダウンロードセンターとダウンロードに関するFAQを確認します。基本の接続を最初からやり直す場合はクイックスタートガイドに沿って再現してください。トラブルシューティングを終えたら、最後に使えた状態と再現可能な確認手順を残しましょう。すべての応用設定を有効にするより役立ちます。