V2Ray設定ガイド:インストールからルーティングまで

このページは、段階ごとに確認できる設定ガイドです。初めて接続する場合は、まずクイックスタートガイドに沿って設定をインポートし、プロキシモードを選んで接続を確認してください。完了したらこのページに戻り、それぞれの設定がどの通信に影響するかを確認しましょう。個別の問題がある場合は、該当する章へ直接進めます。

1. 基本概念:クライアント、コア、プロトコル

リクエストの流れからインバウンドとアウトバウンドを理解する

まず、1回のアクセスを3つの段階に分けて考えます。アプリがリクエストをローカルの入口に渡し、コアがルールに従って出口を選び、出口から接続先へつなぎます。ブラウザーでページが開いても、そのリクエストがどの出口を通ったかまでは分かりません。同様に、クライアントの画面が正常に表示されていても、コアが起動しているとは限らず、アプリからリクエストが渡っているとも限りません。問題が起きたら、設定を次々切り替えるより、最初の段階から順に確認するほうが効果的です。

インバウンドは、コアがリクエストを受け取る入口です。デスクトップアプリは、ローカルのHTTPプロキシやSOCKSプロキシを明示的に利用できます。システムプロキシは、システム設定を参照するアプリにプロキシのアドレスを知らせる機能です。アウトバウンドは、コアがリクエストを処理する方法で、プロキシ経由の転送、直接接続、通信の遮断などがあります。ルーティングルールはインバウンドの後に適用され、使用するアウトバウンドを決めます。そのため、ルーティングを変更しても、もともとクライアントを経由していないアプリが自動的に接続されるわけではありません。以降の章では、「リクエストが入っているか」と「どの経路で出ていくか」を個別に確認します。

VMessはプロトコル、伝送方式は別の設定

Project Vは、V2Rayのエコシステムを理解するうえでの背景です。V2FlyとXrayは関連するオープンソースのコアで、GUIクライアントは画面上のサブスクリプション項目やルーティング、プロキシ設定をコアの設定に変換します。メニュー名が似ていても、生成される設定が完全に同じとは限りません。同じ項目を読み込める2つのクライアントでも、選択したコアの両方で動作するとは限りません。設定をインポートできたという事実から分かるのは、クライアントが入力の一部を認識したことだけです。

VMessとVLESSは、プロキシ接続でデータをやり取りし、ユーザーを識別する方法を定めます。伝送方式は、TCPやWebSocketなどでデータを運ぶ方法です。TLSは通信の保護と接続先の認証に関係します。アドレス、ポート、プロトコル、伝送パス、サーバー名にはそれぞれ役割があります。ポートには接続できるのにセッションが失敗する場合は、これらの設定をまとめて確認しましょう。アドレスを名前解決できたことだけでプロトコルの互換性を判断したり、警告を消すために証明書の検証を無効にしたりしないでください。

共有リンク、サブスクリプション、完全な設定を区別する

共有リンクは通常、1つの接続先を記述しており、単発のインポートに適しています。サブスクリプションURLは、更新可能な項目一覧を指し、クライアントがグループ単位で取得します。完全な設定には、リスニングアドレス、ルーティング、ログ、DNSなどが含まれる場合もあります。この3つは互いに置き換えられません。リンクを受け取ったら、まず提供元がどの形式として案内しているかを確認し、適切なインポート方法を選びましょう。サブスクリプションURLにも共有リンクにも、アクセス用の認証情報が含まれる場合があります。問題を共有する際は、形式やエラー、再現手順だけを伝え、URLの内容は貼り付けないでください。

ドメイン名の名前解決が行われる場所は複数あります。アプリが先に解決する場合もあれば、コアがIPルールとの照合のために解決する場合もあります。また、一部のプロキシアウトバウンドでは、ドメイン名をリモート側に渡して処理できます。ログにIPアドレスしか出ていなくても、元のリクエストにドメイン名がなかったとは限りません。アプリが接続前にアドレスを取得していた可能性もあります。トラブル対処では、まずリクエスト経路を記録し、「どの段階までドメイン名を確認できるか」を考えます。それによって、ドメインルール、アドレスルール、アプリ側のDNS設定のどれを調べるべきかが分かります。

2. クライアント選び:v2rayN、v2rayNG、v2flyNG

デバイスに合わせてアプリを選び、設定に合わせてコアを選ぶ

デスクトップではv2rayNが第一候補です。デスクトップOS間で移行する場合は、利用するプラットフォームに対応したデスクトップ版を確認してください。従来の画面に慣れていてWindowsを使う場合は、WPF版のメニューや操作感と比較するとよいでしょう。AndroidではXrayコアを採用するv2rayNGが第一候補です。既存の設定がV2Fly環境向けに用意されている場合は、v2flyNGも候補になります。「どれが最も低遅延か」から選び始めるのは避けましょう。遅延はネットワークやサーバー、測定方法にも左右されるため、まず必要な機能が使えるかを確認します。

プラットフォーム、アプリ、インストールパッケージを選ぶ
プラットフォームクライアントダウンロード前の確認事項
Windowsv2rayN現在のパッケージはx64向けです。クロスプラットフォーム対応のデスクトップ版と従来のWPF版を区別してください。
macOSv2rayNApple Siliconではarm64、Intelではx64を選びます。
Androidv2rayNG、v2flyNGは代替候補対応するアプリのアーキテクチャを確認し、必要に応じてarm64または汎用パッケージを選びます。
Linuxv2rayNディストリビューションがdebとrpmのどちらに対応するかを確認してから、x64またはarm64を選びます。

デバイス名だけでアーキテクチャを判断しないでください。たとえば、デスクトップOSが64ビットと表示されていても、x64とは限らず、arm64の場合もあります。Windowsでは「設定 → システム → バージョン情報」でシステムの種類を確認できます。macOSでは「このMacについて」でチップまたはプロセッサを確認します。Linuxでは次のコマンドで、現在のシステムが報告するマシンアーキテクチャを確認できます。通常、x86_64はx64、aarch64はarm64に対応します。仮想マシンにアプリをインストールする場合は、仮想マシン内のOSとアーキテクチャを基準にしてください。

uname -m

互換性を3つの観点から確認する

1つ目は、アプリが提供元の形式をインポートできるか。2つ目は、選択したコアが項目で使われているプロトコルと伝送方式に対応しているか。3つ目は、必要なローカル接続方法とルーティング機能がアプリにあるかです。たとえば、システムプロキシを参照しないデスクトップアプリをプロキシ経由にしたい場合、同じサブスクリプションをインポートできる2つのクライアントであっても、ローカルプロキシの入口やTUNへの対応を優先して確認します。ブラウザーで特定のリソースにアクセスするだけなら、両方の接続方法を同時に有効にする必要はありません。

別のデバイスに移行する場合は、まず提供元が明確なサブスクリプションを再インポートし、必要なローカルルールだけを手動で作り直します。クライアント設定一式を別のOSにそのまま上書きしないでください。元のファイルには、旧システムのパス、アウトバウンド名、リスニングポート、起動時の自動接続設定などが含まれている可能性があります。2台のデバイスでサーバー項目を共有しても、ローカルネットワーク設定まで共通にする必要はありません。デスクトップのLANセグメントやプリンターのアドレス、モバイル端末でよく使う接続ネットワークは通常異なります。

実際の用途に合わせて最小限の動作を試す

クライアントのダウンロードページでデバイスに合ったパッケージを選びます。まず1つのアプリに、動作確認済みの設定を1つインポートし、起動できること、リクエストを受け取ること、期待した応答が得られることを確認してから、グループ全体を移行するか決めましょう。Androidクライアントを2つインストールしている場合は、切り替えて試す前に、先に使っていたクライアントの接続を切断してください。システムVPNの割り当て変更をアプリのクラッシュと誤認するのを防げます。デスクトップで2つの画面を比較する場合も、同じローカルリスニングポートを同時に使用しないでください。

提供元から複雑なコア設定だけを受け取った場合は、現在のクライアントのインポート方法に適した形式か、まず確認してください。共有リンクを認識できても、任意のJSONをインポートできるとは限りません。カスタム設定の読み込み機能があっても、コアを起動するだけで、一部の設定をクライアント側で管理しなくなることがあります。3つのクライアントの画面やエコシステムの違いは、クライアント選びの比較を参照してください。今すぐ使わない機能は、必要になったときに試せば十分です。

3. インストールと初回起動:まずローカル環境を確認

デスクトップ:まずクライアント単体で起動する

ダウンロードページに記載されたOS、アーキテクチャ、パッケージ形式に従ってインストールします。Windowsでは選択したデスクトップ版またはWPF版を起動してください。ランタイムに関する警告が表示された場合は、必要なフレームワーク名とアーキテクチャを記録し、適合するランタイムをインストールします。エラーメッセージを読まずに何度も再インストールしないでください。設定の保存時に権限不足と表示されたら、設定フォルダーへの書き込み権限や管理対象の場所に保存していないかを確認します。常に管理者として起動することを解決策にしないでください。

macOSではチップに合ったインストールパッケージを選びます。初回起動時にセキュリティ警告が表示された場合は、配布元と警告の具体的な理由を確認し、システムが許可する方法で対処してください。セキュリティ保護全体を無効にしないでください。Linuxではディストリビューションに合ったパッケージ形式を選び、依存関係はシステムのパッケージマネージャーに処理させます。依存関係を満たせないという警告が表示されたら、まずディストリビューションとソフトウェアリポジトリの状態を確認してください。依存関係を無理に無視すると、原因を特定しにくい起動障害につながることがあります。

初回起動時は、OS起動時の自動接続、システムプロキシ、TUNを有効にしないでください。画面が開くこと、設定を保存できること、再起動後に設定を読み込めることを確認します。ウィンドウを閉じても通知領域にアイコンが残っている場合、プロセスは終了していない可能性があります。アップグレードや設定の置き換え前に、通知領域から終了し、プロセスの状態を確認してください。以前のインスタンスがポートを使用していると、新しいインスタンスは起動してもコアを開始できない場合があります。

Android:インストールの許可とVPNの許可を区別する

インストールパッケージが開けても、システムがVPN接続を許可しているとは限りません。クライアントを開いて初めて接続するとき、システムの許可ダイアログが表示される場合があります。内容を確認し、要求元が意図したアプリであることを確かめてください。同じユーザーまたはプロファイルでは、VPNサービスを1つだけ有効にできます。業務用プロファイル、ネットワーク保護機能、別のVPNサービスがすでに動作している場合は、組織のポリシーに従って停止できるかを確認してから接続してください。

一部のデバイスでは、アプリのバックグラウンド動作が制限されています。前景では正常に動作するのに画面ロック後に切断され、その現象が繰り返し再現する場合に限り、バッテリー最適化、バックグラウンド実行制限、システムのVPN状態を確認してください。1回失敗しただけで、すべての権限を許可しないでください。インストール自体に失敗した場合は、システムのメッセージから、アーキテクチャの問題、ストレージ不足、既存アプリとの署名不一致を切り分けます。アンインストールする前に、ローカルグループや手動で追加した項目を復元できるか確認してください。

元に戻せる初回起動の記録を残す

アプリのパッケージ形式、システムのアーキテクチャ、設定の保存場所、起動時にプロキシモードを無効にしていたかを記録します。そのうえで動作確認済みの項目を使って1回起動し、コアのログに設定の解析失敗、リソース不足、ポート競合がないか確認してください。画面のエラーとコアのログの両方に問題が出ることもあります。最初に記録された具体的なエラーを優先してください。後から接続タイムアウトだけが表示される場合は、実際の起動失敗の原因を見落としている可能性があります。ログを確認するときは、サーバー情報を含む内容をそのまま他人に送らないでください。

ポートが競合していても、必ず現在のポートを変更する必要があるとは限りません。まず、同じクライアントの別インスタンスが動作していないか確認してください。ローカルプロキシのポートを変更する必要がある場合は、そのポートを使うブラウザー、テストコマンド、システムプロキシの設定も合わせて更新します。コアがリッスンできていても、リモート接続が可能とは限りません。それぞれ個別に確認してください。ウィンドウがすぐに消える場合は、起動直後に終了する場合の確認リストを参照し、症状に応じて原因を絞り込みます。

4. サブスクリプションの追加:グループ追加、更新、項目の確認

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

提供元からサブスクリプションURLを受け取った場合は、サブスクリプショングループに登録してから更新します。vmess://またはvless://で始まる単一のリンクを受け取った場合は、クリップボードからのインポートやQRコード読み取りを使います。サブスクリプションURLは通常HTTPSですが、URLの先頭だけで判断しないでください。一般のダウンロードページもHTTPSを使うため、登録するとウェブページが返されるだけの場合があります。形式の違いについては、共有リンクとサブスクリプションURLの違いを参照してください。

一般的なサブスクリプションの応答は、リンク一覧のプレーンテキストか、その一覧をBase64エンコードしたテキストです。Base64はエンコード方式であり、暗号化ではありません。デコード後の内容も機密設定として扱ってください。提供元によっては別の形式を使うため、提供元の設定で現在のクライアントに適した形式を選ぶ必要があります。見慣れないサブスクリプションを第三者のオンライン変換サイトに送ったり、ログインページのURLをサブスクリプションURLの代わりに使ったりしないでください。URLにクエリパラメーターが含まれている場合は、削除や書き換えをせず、すべてコピーしてください。

v2rayNとAndroidクライアントの操作手順

v2rayNで「サブスクリプショングループ設定」を開いてグループを追加し、「備考」に分かりやすい名前を入力して、「オプションのアドレス(url)」にサブスクリプションURLを入力します。保存後、「現在のサブスクリプションを更新」または該当グループの更新項目を選びます。初回は新しいグループだけを更新すると、結果を確認しやすくなります。自動更新を有効にする前に、まず手動で動作を確認してください。自動更新の間隔は画面に表示された単位を確認し、提供元の更新案内に合わせて設定します。短い間隔で何度も更新する必要はありません。

v2rayNGでは、メニューから「サブスクリプショングループ設定」または該当する項目を開き、グループを追加して保存した後、一覧に戻って更新します。v2flyNGも、先に配布元を保存してから内容を更新する手順です。メニュー名は現在の画面に従ってください。更新が終わったら追加したグループに切り替え、項目がそのグループに含まれていることを確認してから1つ選んで接続します。グループを更新しても、現在選択中の項目が切り替わるとは限らず、実行中の接続が再起動されるとも限りません。操作方法と形式の詳細は、サブスクリプションの追加と形式の解説を参照してください。

取得・解析・接続の3段階に分けて対処する

取得に失敗した場合は、HTTPステータスやドメインの名前解決エラーが表示されているかを確認します。認証に失敗する場合は、アクセス権やURLの変更について提供元に確認してください。タイムアウトの場合は、更新リクエストの通信経路と、プロキシ対象の通信経路を分けて考えます。デスクトップ版の設定によっては、現在のプロキシ経由でサブスクリプションを取得できます。現在の設定で接続できない場合は、既存のネットワークから直接アクセスできる更新用URLが提供元にあるか確認してください。エラーの種類を見ないまま、何度も再試行しないでください。

取得に成功しても一覧が空なら、返された内容がクライアント対応のリストなのか、ログインページ、案内ページ、別クライアント用の形式なのかを確認します。別のグループに切り替わっていないか、フィルターが有効になっていないかも確認してください。一覧は表示されるのに接続できない場合は次の段階に進み、実際に選択した項目、コアの対応状況、接続ログを確認します。更新後、項目名が同じなのに動作が変わった場合は、サーバーのアドレスや伝送設定が変更された可能性があります。名前だけを比べず、設定に変更があったか提供元に確認してください。

5. プロキシモード:アプリがクライアントに接続されているか確認する

システムプロキシが制御するのは接続の入口であり、アウトバウンドではない

v2rayNの「システムプロキシを自動設定」は通常、ローカルプロキシのアドレスをシステム設定に書き込み、その設定に従うソフトウェアに利用させます。「システムプロキシをクリア」はシステムプロキシの設定を解除する機能で、ローカルのリスニングを停止するものではありません。「システムプロキシを変更しない」は現在の値を積極的に変更しないという意味で、もともとプロキシが設定されていないことを保証するわけではありません。モードを切り替える前に、システムの設定画面を確認しておきましょう。特に組織によってプロキシが設定されたデバイスでは、既存の設定をクライアントの残留設定と誤認しないよう注意してください。

システム設定画面にプロキシアドレスが表示されていても、設定が書き込まれたことしか分かりません。ブラウザーが独自のプロキシを指定していたり、コマンドラインツールが環境変数を参照していたりする場合もあります。システム設定を参照せず、プロキシ設定画面もないアプリもあります。そのため、1回に1つのアプリだけを確認してください。アプリ内で手動設定する場合は、クライアントのリスニング設定に合うHTTPまたはSOCKSを選びます。アドレスとポートには実際の値を入力してください。リモートサーバーのポートをローカルポートに指定したり、サブスクリプションURLをプロキシアドレス欄に入力したりしないでください。

プロキシを明示してリクエストを比較する

以下ではcurlを使ってサンプルサイトにリクエストを送ります。1つ目はプロキシを明示的に使わず、2つ目はローカルのHTTPプロキシを明示的に使います。2つ目はクライアントのHTTPリスニングアドレスが127.0.0.1:10809であることを前提にしています。画面に別の値が表示されている場合は、先に置き換えてください。この比較はTUNを無効にした状態で行うのが適切です。有効のままだと、1つ目のリクエストもアプリ層のプロキシを使わずに仮想ネットワークインターフェースへ転送される可能性があります。Windowsのコマンド環境で同名のエイリアスがある場合は、curl.exeを明示的に実行してください。

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

2つ目のリクエストでローカルポートに接続できない場合は、コア、リスニングアドレス、ポートを確認します。証明書エラーが出たら、エラーを保存し、システム時刻、証明書の信頼状態、接続先の識別情報を確認してください。HTTPステータスが返れば、少なくとも応答を返せる場所まで到達したことは分かりますが、コアがプロキシアウトバウンドを選択したとは限りません。アウトバウンドを特定するには、同じ時刻のログと照らし合わせます。接続先がHEADに対応していない場合は、--headを外して通常のリクエストを送ってください。メソッドの制限を接続失敗と取り違えないようにします。

モバイルでの接続と切断後の復元

Androidクライアントは、システムのVPNサービスを通してアプリの通信を受け取ることがよくあります。アプリ一覧で対象範囲を制限する場合は、現在のモードが選択したアプリだけを対象にするのか、選択したアプリを除外するのかを確認してください。この2つは逆の動作です。ブラウザーは使えるのに他のアプリが使えない場合は、まずそのアプリが接続対象になっているかを確認し、その後コアのルールを調べます。通知領域にVPNの状態が表示されていても、特定の接続先にアクセスできるかまでは判断できません。

テストが終わったら、元のネットワーク設定に戻してください。デスクトップでは、まず予定していた方法でクライアントが書き込んだシステムプロキシを解除し、クライアントを終了します。その後、システムプロキシのアドレスが停止済みのローカルポートを指したままになっていないか確認します。元の環境で組織指定のプロキシを使っていた場合は、管理者の案内に従って設定を復元してください。モバイルでは切断後に同じアプリでテスト先へ再アクセスし、常時接続VPNやVPN未接続時の通信ブロックが有効のままかを確認します。管理対象の環境では組織のポリシーに従ってください。

ローカルプロキシのリスニング先は、通常ループバックアドレスに制限します。LANからのアクセスを許可する設定は別のもので、他のデバイスからそのポートへ接続できるようにします。システムプロキシを参照しないアプリの問題を解決する方法ではありません。特に公共ネットワークでは、試行錯誤のためにリスニング範囲を広げないでください。アプリ、システムプロキシ、コアの3つの層について、それぞれ独立して確認できる手順を用意しておきます。

6. ルーティング:ルールの順序、ドメインの照合、デフォルトの出口

対象を3種類に分けてからルールを設定する

まず、直接接続する対象、プロキシ経由を許可する対象、遮断する対象を決めます。よくある設定方法は、ローカルサービスや直接接続を許可するLANセグメントを先に置き、続けて個別のドメイン例外を指定し、最後にどのルールにも一致しない通信の行き先を明示することです。多くのコアはリスト順に確認し、最初に条件を満たしたルールを適用します。範囲の広いルールを先に置くと、範囲の狭いルールに到達できなくなります。特に遮断ルールは順序が重要で、該当するリクエストが後続の例外ルールに進めるかどうかを左右します。

ルールに記述するアウトバウンドのタグは、現在の設定に実際に定義されているタグと一致させてください。画面に「直接接続」と表示されていても、エクスポートされるタグがdirectとは限りません。同様に、説明用の静的表示であるfinal → proxyを、そのままJSONに転記しないでください。デフォルトのアウトバウンド項目や記述方法はコアによって異なります。GUIではルールグループのデフォルト出口を確認し、コア設定を読む場合は、どのルールにも一致しない接続がどう処理されるかを確かめます。

ドメイン条件とIP条件を区別する

domain:はドメイン名とそのサブドメインの照合に使えます。単一のドメインだけに限定する場合はfull:を使います。geosite:はドメインのリスト、geoip:はIPアドレスのリストを使います。これらの項目を使うには、コアが対応するリソースを読み込めること、リストに対象名が含まれていることが必要です。安定して利用できる単一のLANでは、既知のネットワーク範囲を明示したほうが、リスト全体を使うより検証しやすい場合があります。ドメイン照合は正常なのにIPルールが一致しない場合は、照合のためのドメイン解決が現在のポリシーで許可されているか確認してください。

IPIfNonMatchは、ドメイン名に一致するルールがない場合、後続の照合で解決済みのアドレスを使えるようにします。アプリ全体に適用するDNS設定ではなく、すでにIPアドレスが渡されたリクエストを信頼できるドメイン名に戻す機能でもありません。以下はV2Ray系コアのルーティングオブジェクトの例で、起動用ファイル全体ではありません。互換性のある設定のroutingフィールドに統合する前に、directとproxyが定義済みであることを確認し、例示のドメインとネットワーク範囲を、確認済みのテスト対象に置き換えてください。

{
  "domainStrategy": "IPIfNonMatch",
  "rules": [
    {
      "type": "field",
      "ip": ["127.0.0.0/8", "::1/128", "192.168.1.0/24"],
      "outboundTag": "direct"
    },
    {
      "type": "field",
      "domain": ["full:example.com"],
      "outboundTag": "proxy"
    }
  ]
}

ページが開くかだけでなく、ルールへの一致を確認する

テスト対象を3つ用意します。直接接続するLAN内のリソース、プロキシルールに一致するテスト用ドメイン、これらのルールに該当しない一般的な接続先です。それぞれについて、どのインバウンドから入り、実際にどのアウトバウンドを使ったかを記録してください。ページが正常に見えてもログ上の経路が想定と異なるなら、ルールの確認が必要です。ブラウザーが既存の接続を再利用する場合があるため、ルール変更後は新しい接続を作成してテストしてください。ページ内の画像やAPIは別のドメインを使うこともあります。メイン文書のログだけで、すべてのリクエストの経路を判断しないでください。

特定の接続先だけに問題がある場合は、まずドメイン名とIPアドレスのどちらが渡されているかを確認し、その後、先に書かれたルールに一致していないかを調べます。範囲が最小のルールを1つ変更して再テストし、ネットワーク全体を一時的に対象にしないでください。ドメインリストを追加した後にコアが起動しなくなった場合は、まず以前のルールに戻し、リスト名、リソースの配置、読み込みエラーを確認します。完全な設定でDNSとアウトバウンドをどう組み合わせるかは、V2Ray JSON設定の構造を参照してください。

クライアントは、コアの起動時に実際の設定ファイルを生成することがよくあります。生成ファイルを直接編集すると次回の起動時に上書きされる可能性があるため、まずGUIでルールを保存し、エクスポートした内容を確認してください。カスタム設定が必要な場合は、使える状態のコピーを別に保存し、コアが読み込めるかどうかとルールが想定どおりかどうかを分けて検証します。新しいルールを有効にする前に、ローカル管理画面へアクセスする手段を確保してください。

7. TUNモード:接続対象、DNS、LAN内の例外

接続対象を広げる必要がある場合に限り有効にする

アプリがシステムプロキシを参照する場合は、まずシステムプロキシまたはアプリ内プロキシを使います。TUNは、アプリ層のプロキシ設定に従わないIP通信を受け取る必要がある場合に適しています。仮想ネットワークインターフェースとシステムルートを通して通信をコアに渡すため、ブラウザーのプロキシ設定を変更するよりも影響範囲が広くなります。どの種類の通信を取り込めるかは、システムルート、権限、現在のコア、アプリの動作によって異なります。スイッチを有効にしても、すべてのプロトコル、デバイス検出、LANサービスが自動的に使えるようになるわけではありません。

有効にする前に、現在の設定で接続できることを確認します。ローカルリスニングが使えること、選択したアウトバウンドで接続できること、基本的なルーティングが想定どおり動作することが必要です。現在のシステムプロキシ、ネットワークインターフェース、DNS設定を記録しておきます。仮想ネットワークインターフェースやルートの変更に制限がある管理対象デバイスでは、先に許可を得てください。この起動時だけ管理者権限が必要な場合は、アプリの案内に従います。起動に失敗したからといって、セキュリティ設定を何度も切り替えたり、失敗した状態のままOS起動時に自動有効化したりしないでください。

接続対象を最小限にしてから、直接接続と終了を確認する

v2rayNのTUN関連設定で、選択したコアと現在のプラットフォームがこの機能に対応しているか確認します。初回テストでは、手順書や画面の説明に従い、比較用に有効にしていたシステムプロキシを無効にします。また、同種の接続ツールが別に動作している場合は終了し、複数の通信経路が同時に変わらないようにしてください。TUNを有効にしたら、クライアントがインターフェースの作成成功を報告しているかを確認し、次にシステムプロキシを使わないアプリでテストします。まず既知のテスト対象に接続し、そのリクエストがログに記録されることを確認してください。

次に、もともと直接接続する必要があるリソースをテストします。たとえば、自分で管理するLAN内の管理画面や共有サービスです。システムルートからの除外と、コアでの直接接続は同じではありません。除外では通信が仮想インターフェースに入りませんが、コアでの直接接続では、いったんコアに入り、そのコアが接続を確立します。ブロードキャスト、マルチキャスト、特定のネットワークインターフェースに依存するアプリは、システムの従来の経路に残す必要がある場合があります。リソースが実際に使うネットワーク範囲を確認し、現在のプラットフォームが対応する除外方法を選んでください。他人のプライベートIPアドレス一覧をそのまま転記しないでください。

IPアドレスに接続できても、ドメイン名とDNSが正常とは限らない

TUNでは、IPアドレスに接続できても、アプリがドメイン名を解決できないことがあります。有効化する前後で同じドメイン名の名前解決結果を比較し、クライアントのDNS取り込み設定が変更されていないか確認してください。アプリによっては独自の暗号化DNSを使うため、システムの検索結果だけではアプリの状態を判断できません。DNSを変更する前に、クエリが届いていないのか、別のリゾルバーが使われているのか、それとも名前解決後の接続に失敗しているのかを切り分けます。前者なら取り込み範囲を確認し、後者ならルーティングやアウトバウンドを調べてください。

有効にした後、ほとんどの接続がタイムアウトする場合は、クライアント自身のアウトバウンド接続が仮想インターフェースに再び送られていないか確認します。ループを防ぐ方法は実装によって異なり、インターフェースのバインドやルートからの除外などがあります。別のプラットフォームの設定値をそのまま流用しないでください。大きなリクエストだけが停止し、小さなリクエストが正常な場合は、MTUや経路上の制限を検討します。同じテストを繰り返し、元の値と戻し方を記録してください。たまたま遅かったリクエストをすぐにMTUの問題と決めつけないでください。

最後にTUNを無効にし、システムプロキシの状態、デフォルトのネットワーク、LAN内のリソースへの接続を再確認します。画面上では無効になっているのにシステムルートが戻らない場合は、アプリを通常の方法で終了してから、OSの手順で残っているインターフェースやルートを確認してください。用途の分からない仮想インターフェースをむやみに削除しないでください。AndroidクライアントのVPNサービスも通信を取り込みますが、デスクトップ版TUNのメニューや設定値をそのまま適用できるわけではありません。モバイルでは、システムの許可、対象アプリの範囲、VPNの状態を優先して確認してください。

8. 日常のメンテナンス:更新、バックアップ、段階的なトラブル対処

更新は項目ごとに行う

クライアント、コア、ルールリソース、サブスクリプションはいずれも更新できますが、更新する理由は異なります。クライアントの変更は画面や設定の移行に影響し、コアの変更は設定値の互換性に影響することがあります。ルールリソースの変更ではリストの対象範囲が変わり、サブスクリプションの変更ではサーバー項目が直接変わります。すべてを一度に更新してからテストすると、問題が起きた際にどの層の変更が原因かをすぐに判断できません。更新前に配布元と対応範囲を確認し、更新後は更新前と同じ最小限のテストを行ってください。

バックアップ時には、少なくとも現在のクライアント、コアの選択、リスニングポート、手動で作成したグループ、ルーティングの順序、TUNの例外設定を記録します。エクスポートファイルにはサブスクリプションURLやアカウント情報が含まれる場合があります。管理された場所に保存し、公開グループに送ったり共有プロジェクトに直接追加したりしないでください。提供元から再取得できる項目は、認証情報を複製せず、復元手順だけを記録しておくこともできます。別のデバイスに移行する前に、バックアップ形式が適しているか確認してください。すべてのエクスポートを異なるOSやバージョンにそのまま復元できるわけではありません。

症状に合わせて最初の確認項目を選ぶ

よくある問題の確認手順
症状最初に確認次に行うこと
画面が起動直後に終了するシステムのアーキテクチャ、ランタイムの警告、フォルダーの権限アプリのエラーログと、セキュリティソフトがブロックした理由を確認します。
サブスクリプションの更新に失敗するグループのURL、認証状態、更新時に使われるネットワーク経路リクエストの失敗と、取得した内容の解析失敗を切り分けます。
接続後、特定のアプリだけ使えないシステムプロキシへの対応、アプリ独自のプロキシ設定、通信の取り込み範囲そのアプリのリクエストがクライアントに入っているか確認します。
特定の接続先だけ異常がある接続先のドメイン名とアドレス、ルールの順序実際のアウトバウンドと、同じ時間帯のログを比較します。
終了後もインターネットに接続できないシステムプロキシ、仮想インターフェース、システムVPNの状態元の設定に戻し、動作確認済みの接続先で確認します。

トラブル対処の記録には「いつ始まったか」「何を変更したか」「どのアプリに影響したか」を書き、「つながらない」だけで済ませないでください。Wi-Fiでは失敗しモバイルネットワークでは正常な場合は、同じアプリと同じ接続先で比較し、両方のテストで同じグループを使ったかも記録します。ネットワークを切り替えても既存の接続に以前の状態が残ることがあるため、新しい接続を作成して比較してください。一部のページだけ開ける場合は、システム時刻や証明書のエラーも確認し、すぐにサーバー側の障害と決めつけないでください。

再現に必要な範囲だけログを残す

再現する前に時刻を記録し、原因の特定に十分なログレベルを短時間だけ有効にします。1回再現させたら通常のログレベルに戻してください。サポートを依頼する場合は、最初のエラーを含む前後の少数のログと、テスト時の症状、設定の違いを共有します。アカウント識別子、アドレスのパラメーター、無関係なアクセス情報は削除してください。「タイムアウト」というログ1行だけでは、ローカルリスニング、リモート接続、接続先の応答遅延を区別できません。リクエストが取り込まれたか、正しいアウトバウンドが選ばれたかと合わせて確認すると役立ちます。

設定を戻した後も確認が必要です。すべての設定を消去するのではなく、直近の変更、たとえば以前のルールグループに戻します。再読み込み後、元と同じ3つのテスト対象を使い、直接接続、プロキシ経由、デフォルト経路をそれぞれ確認してください。クライアントのファイルだけ戻してTUNやシステムプロキシを解除していない場合、通信は新しい設定のまま流れる可能性があります。復元後は、アプリを再起動しても正常に動作するか確認し、変更を戻すことで実際に問題を説明できたか記録してください。

繰り返し実行できる手順をチェックリストにします。更新前に設定を復元できることを確認し、更新後は接続テストと終了テストを1回ずつ行い、不要な手動項目や古いグループを定期的に削除してください。インストールやパッケージ選びに関する問題は、ダウンロードページのシステム要件とよくある質問を参照します。以前のデバイスでのインストール経験を、現在のプラットフォームの案内の代わりにしないでください。

9. 応用へのステップ:設定の読み解き、比較テスト、引き継ぎ

エクスポートした設定を読み、手書きが必要か判断する

まず、自分で動作確認した設定をエクスポートします。inboundsからテスト対象のアプリが実際に使う入口を探し、リスニングアドレス、ポート、タグを記録してください。outboundsでは、各タグの動作を確認します。最後にroutingを読み、インバウンドとアウトバウンドの対応関係を確認します。続けてdnsとlogを見れば、それぞれがどの段階に影響するか分かります。ファイルの先頭から設定値を順番に覚えるより、この手順のほうが理解しやすくなります。エクスポート内容にはアカウント情報が含まれる場合があります。確認用のコピーは共有サンプルと分けて保管してください。

次に、クライアントの画面で設定を1つだけ変更し、もう一度エクスポートします。2つのファイルを比較し、その変更によって実際にどの項目が変わったかを調べてください。画面上の1つのスイッチが、インバウンドの変更とシステム設定の変更を同時に引き起こす場合もあれば、コア設定ファイルに直接反映されない場合もあります。たとえば、クライアントがシステムプロキシを書き込むかどうかは、コア設定のルーティング部分を読むだけでは判断できません。逆に、設定ファイルにインバウンドが定義されていても、現在のアプリがそれを利用しているとは限りません。

設定の検証を再現可能なテストにする

各テストで、予想する結果、反例、停止条件を明記します。たとえば、完全一致のドメイン照合を検証するなら、対象ドメインと、一致しない一般的な接続先について、どの出口を使うか事前に記録します。設定を変更したら新しい接続を作成し、ログを確認してからルールを戻し、再テストしてください。結果が変わらない場合は、上位の条件によってリクエストが処理されていないか、もともと2つの経路が同じアウトバウンドを使っていないかを調べます。反例まで説明できるほうが、1回アクセスに成功したことを示すだけより有用です。

複数のデバイスに広げる場合、共通にするのはルールの意図であり、設定ファイル全体ではありません。デスクトップでは固定のリスニングポートが使えても、モバイルではシステムVPNの接続範囲が重要になります。サブスクリプションを共有していても、すべてのデバイスで同じDNSやLAN内の例外を使う必要はありません。デバイスの種類ごとに、少数の専用テストを用意してください。新しいデバイスでは最小限の設定をインポートし、基本の通信経路が正しいことを確認してから、必要なルールだけを移行します。高度な設定を一度にすべて適用しないでください。

他の人が理解でき、自分でも復元できる記録を残す

設定を引き継ぐ際は、どのアプリがクライアントを経由するか、アクセス可能にしておくLANサービスは何か、デフォルトの出口はどれか、サブスクリプションを誰が更新するかを、一般的な言葉で説明します。添付資料には、機密情報を削除した設定の一部、比較に使うテスト対象、復元手順を含められます。例を示す場合は実際のアカウント情報を含めず、アドレスには明確なサンプル用ドメインを使ってください。引き継ぐ人がスイッチの位置を画像どおりにまねるだけでなく、想定される動作を判断できるようにします。

応用とは、機能を一つずつすべて有効にすることではありません。リクエストが取り込まれていないのか、誤った経路に振り分けられているのか、アウトバウンド自体が使えないのかを判断できれば、日常的な問題の多くは解決できます。説明できないスイッチを積み重ねるより、小さく明確なルールセットを保つほうが確実です。定期的にインストール、サブスクリプションの更新、接続、終了の最短手順を再確認し、記録が現在の画面と一致しているか確かめてください。基本手順をやり直す必要がある場合は、クイックスタートガイドに戻ります。