01 基本
基本概念:アプリ、入口、コア、アウトバウンド
まずリクエストの経路を整理する
Webページへのリクエストは通常、ブラウザーから始まります。デスクトップでは、ブラウザーがシステムプロキシを使う場合、リクエストはまずクライアントのローカル待ち受けに送られます。使わない場合は、ブラウザーが宛先へ直接接続することもあります。リクエストが待ち受けに届いて初めて、コアが宛先を読み取り、ルーティングルールに照合してアウトバウンドを選べます。プロキシのアウトバウンドなら、コアがリモートサーバーに接続し、対応するプロトコルでリクエストを転送します。直接接続のアウトバウンドなら、コアが宛先へ直接接続します。ブロックのアウトバウンドなら、リクエストは端末上で遮断されます。ブラウザーが接続するローカルの入口と、コアが接続するリモート側の入口は別のアドレスであり、使われるプロトコルも異なる場合があります。
トラブルシューティングでは、この経路のどこで止まるかを確認します。設定画面が開いても、グラフィカルインターフェースが動いているだけで、コアが起動しているとは限りません。ローカルポートが待ち受け中でも、リモートとのハンドシェイクが成功したとは限りません。コアが接続成功を報告しても、Webページから利用できる内容が返ってくるとは限りません。反対に、ページが表示されてもプロキシ接続の証拠にはなりません。直接接続されている可能性や、キャッシュが表示されている可能性があります。確認時は「プロセスの起動」「リクエストの受信」「アウトバウンドの選択」「宛先からの応答」を分けて記録し、失敗した段階に関係する設定だけを変更します。
クライアントは設定を管理し、コアは接続を処理する
Project Vはこの種のツールを理解するうえでのエコシステムの背景にあたり、V2FlyとXrayは関連するコアプロジェクトです。ここでいうクライアントとは、ノードの保存やサブスクリプションの管理、現在の選択内容に基づく実行設定の生成、コアの起動・停止やシステムネットワークへの接続を担うグラフィカルインターフェースです。コアは待ち受け、転送、プロトコル処理、ルーティングを担当します。画面にノードが表示されても、現在のコアがそのノードのプロトコル、トランスポート、セキュリティ設定の組み合わせに対応しているとは限りません。インポートは正常でも起動時にエラーが出る場合は、まず実行に使われているコアを確認し、ログから未対応の項目、リソース不足、接続段階の失敗のどれかを特定します。
ノードにはリモートサーバーへの接続方法が記録されています。プロトコルは通信する双方がリクエストをどう解釈するかを定め、トランスポートはデータの運び方を定めます。セキュリティ設定には認証や暗号化などの要件が含まれます。この3層の設定は互いに代用できません。同じサーバーアドレスでも、ポートやトランスポート経路、サービス名が異なることがあります。ノード名に特定のプロトコル名が含まれていても、実際の設定内容は判断できません。正しい設定は、サービスの管理者が提供するノードまたはサブスクリプションを使ってください。認証エラーが出ても、証明書の検証を無効にして見かけ上つながる状態にするのは避けてください。
サブスクリプション、ルーティング、名前解決の役割
サブスクリプションはノード情報を取得するためのものです。更新してもすべてのノードがテストされるわけではなく、現在選択中のノードがまだ使えると証明されるわけでもありません。ルーティングは宛先ドメイン、宛先アドレス、インバウンドのタグなどの条件に基づき、どのアウトバウンドから送信するかを決めます。DNSによる名前解決はドメイン名からアドレスを調べる処理で、ルーティングの照合結果にも影響することがあります。アプリによってはドメイン名をそのまま送信し、別のアプリでは先に名前解決してからアドレスを入口へ渡します。後者の場合、コアが元のドメイン名を認識できないことがあります。同じサイトでもアプリによってルーティング結果が異なる場合は、まずアプリからコアへ何が渡されているかを確認してください。
まず、どの層が変わったのかを確認します。サブスクリプション一覧が変わっても、選択中のノードが変わったとは限りません。選択中のノードが変わっても、アプリの通信がプロキシに入ったとは限りません。
作業を始める前に、アクセス権のある、応答を判別しやすいテストページを用意し、現在のネットワークでの結果を記録します。以後も同じ宛先を使って比較し、異なるサイトの読み込み速度を比べないでください。特に、遅延の数値を通信経路そのものと混同しないようにしましょう。ローカルポートの応答時間、ノードのテスト所要時間、Webページ全体の読み込み時間は、それぞれ異なる段階を測定しています。リクエストを個別の段階に分けて確認できれば、クライアントの選択、ルーティングルール、障害時の切り戻しを検証するための基準が整います。
02 選定
クライアントの選び方:プラットフォーム、アーキテクチャ、コア
まずOSで候補を絞る
デスクトップではv2rayNが第一候補です。WindowsではDesktop版と従来のWPF版を比較できますが、まず違うのは画面の構成です。画面の違いだけからノードのプロトコル対応を判断しないでください。macOSとLinuxでもv2rayNデスクトップ版を使い、チップやディストリビューションに合ったパッケージを選びます。AndroidではXrayコアを採用するv2rayNGが第一候補です。V2Flyコアが必要だと明確に分かっている場合は、v2flyNGを検討してください。安定性を比べるためにAndroidクライアントを同時に起動するのは避けましょう。どちらもシステムのVPN接続を使うため、切り替えるときは先に片方を停止してから、もう片方を起動します。
| プラットフォーム | クライアント | ダウンロードページの選択肢 | 選択前の確認事項 |
|---|---|---|---|
| Windows | v2rayN | Desktop、WPF | CPUアーキテクチャとアプリの動作要件 |
| macOS | v2rayN | Apple Silicon、Intel | システム情報に表示されるチップまたはプロセッサ |
| Android | v2rayNG、v2flyNG | arm64、ユニバーサル版 | アプリのアーキテクチャとノードのコア要件 |
| Linux | v2rayN | deb、rpm。x64とarm64をそれぞれ提供 | ディストリビューションのパッケージ形式とCPUアーキテクチャ |
クライアントのダウンロードページを開き、プラットフォームを選んでからシステム情報と照らし合わせます。Windowsでは「設定」の「バージョン情報」にあるシステムの種類を確認してください。「64ビット」だからといって、必ずx64とは限りません。64ビットの端末でもARMアーキテクチャの場合があります。macOSでは「このMacについて」を開き、AppleシリコンかIntelプロセッサかを確認します。発売年から推測しないでください。Linuxでは次のコマンドでマシンのアーキテクチャを確認し、ディストリビューションで一般的なパッケージ形式と合わせて選びます。通常、x86_64はx64、aarch64はarm64に対応します。ユーザー空間とハードウェアのアーキテクチャが異なる場合は、パッケージマネージャーが認識する対象アーキテクチャも確認してください。
uname -m
cat /etc/os-release
設定をそのまま使えるかも確認する
最近のAndroid端末は通常arm64を選びますが、チップの性能とシステムがインストールを許可するアプリのアーキテクチャは、必ずしも一致しません。判断できない場合は、ダウンロードページからユニバーサル版を選べます。「ユニバーサル」は複数のアーキテクチャ向けのネイティブライブラリを含むという意味で、対応プロトコルが増えるわけではありません。同名アプリがすでにインストールされていて新しい版を入れられない場合は、まずアーキテクチャ、システム要件、アプリの署名の不一致を切り分けます。すぐにアンインストールしないでください。ローカルのサブスクリプション、手動追加したノード、アプリ別ルーティングのリストをバックアップしてから作業し、インストールの問題と一緒に接続に必要な設定まで失わないようにします。
クライアントを選ぶ前に、現在の要件を確認可能な項目として書き出します。サービスが提供するプロトコルとトランスポート、特定のコアが必要か、ブラウザーだけをプロキシに通すのか、システムプロキシに対応していないアプリも含めるのか、アプリごとに通信を振り分ける必要があるかを整理してください。デスクトップ版を画面の好みだけで選ぶなら、どちらも同じノードを使って最小限のテストを行えます。ノードの説明で特定のコアが指定されている場合、名前が似ている別のものに置き換えるだけでは解決しません。インポート時にエラーがなくても、ノードの起動と実際のサービスへのアクセスを別々に確認してください。
移行時は用途を特定できる設定だけを引き継ぐ
サブスクリプションリンクと手動ノードは、クライアントが対応する方法で個別にインポートできます。プロキシポート、DNS設定、ルールデータベース、アプリ一覧は、それぞれ別に確認してください。デスクトップとモバイルではシステムへの接続方法が異なるため、設定ディレクトリ全体を別のプラットフォームへ移すのは通常適切ではありません。両方で同じノード名が表示されても、選択中のノード、トランスポートのオプション、ルーティング方針が一致するか確認します。旧クライアントが使えるうちに新クライアントの基本動作を検証してから、旧設定を停止してください。比較のために、2つのプログラムで同じローカル待ち受けポートを共有するのは避けましょう。
最初からすべての機能を設定する必要はありません。元に戻せる最小限の環境を用意します。プラットフォームに合ったクライアント、利用できると確認済みのノード、テスト対象を1つ用意してください。複数の端末で使う場合は、システムへの接続方法を1台ずつ確認し、同じノードでの結果を記録します。そうすれば端末の違いとサーバー側の問題を切り分けられます。ある端末で失敗しても、別の端末で有効になっているプロキシや異なるアプリ設定に判断を惑わされません。
03 導入
インストールと初回起動:まずローカルの待ち受けを確認
配布パッケージに合わせて実行環境を準備する
Windowsではダウンロードページから必要なバージョンのv2rayNを選びます。インストーラーは画面の案内に従って実行します。圧縮形式のパッケージを入手した場合は、書き込み可能な固定の場所にパッケージ全体を展開してから起動してください。圧縮ファイルのプレビュー内でダブルクリックしてはいけません。メインプログラムだけをコピーするのも避けてください。コア、ルール用リソース、付属ファイルは元の相対位置を保つ必要がある場合があります。起動直後に終了する場合は、システムの通知とアプリのログを確認し、そのパッケージで明示されている実行コンポーネントを補います。ディレクトリへのアクセスが制限されている場合は、まず通常のユーザーが書き込める場所で確認します。プログラム全体を常に管理者権限で実行するのは、ディレクトリ権限の調査方法として第一選択ではありません。
macOSではチップに合ったディスクイメージをマウントし、アプリを「アプリケーション」へコピーしてから起動します。システムのセキュリティ機能にブロックされた場合は、端末のセキュリティポリシーに従って入手元を確認してください。確認できない場合はインストールを中止し、システム全体の保護を緩めないでください。Linuxではディストリビューションのパッケージマネージャーを使って対応するパッケージをインストールし、依存関係とインストール状態の管理を任せます。依存関係が不足している場合は、エラーに記載されたパッケージ名を確認し、異なる形式のインストールパッケージで上書きしないでください。Androidでは、インストールパッケージを実際に開く入手元に限り、必要に応じてインストール権限を許可します。初回起動ではメイン画面が正常に表示されるか確認し、接続を有効にするときにシステムネットワークの許可を確認します。
既定値を決めつけず、実際の状態からポートを確認する
初回起動ではシステムプロキシを変更せず、TUNも有効にしません。デスクトップ版v2rayNの設定で、ローカル待ち受けまたは混合待ち受けのポートを確認し、ログに記録された実際の待ち受けアドレスと照合します。一般的なガイドに出てくる2つのポートは、バージョンや待ち受けモードが異なる場合があります。現在、独立したHTTP待ち受けが必ずあるとは限りません。端末上のアプリだけで使うなら、待ち受けはループバックアドレスにしてください。LAN接続を有効にすると接続可能な範囲が変わりますが、端末内で接続できない問題を解決するために必須ではありません。画面のポート欄に値が表示されていても、起動ログやシステムの情報で設定が有効になったことを確認します。
WindowsではPowerShellを使い、ループバックアドレスまたはワイルドカードアドレスで待ち受け中のポートを確認できます。次のコマンドは情報を読み取るだけで、ポートを変更しません。結果にあるプロセスIDからタスクマネージャーでプロセスを確認できます。ワイルドカードアドレスが、クライアントが使おうとしているポートを占有している場合もあります。何も表示されない場合は、まずコアが動作しているか確認してから起動エラーを調べてください。ローカルポートにリモートノードのポートを安易に設定しないでください。同じポートが別のインスタンスに使用されている場合は、重複して実行中のクライアントを正常に終了するか、一方に別のポートを割り当て、それに依存するアプリ側の設定も変更します。
Get-NetTCPConnection -State Listen |
Where-Object { $_.LocalAddress -in '127.0.0.1','::1','0.0.0.0','::' } |
Select-Object LocalAddress,LocalPort,OwningProcess
起動と終了を確認し、クリーンな基準状態を作る
起動と終了をそれぞれ一度試し、タスクトレイのプログラムが動作し続けていないか確認します。メインウィンドウを閉じても画面が隠れるだけで、コアの待ち受けが続く場合があります。ポートを解放するにはクライアントの停止または終了操作を使い、その後もう一度確認してください。初回起動時に以前インストールした別のインスタンスが入口を占有していたら、まずそのプロセスがタスクに使われているか調べます。ポート番号だけを見て、見覚えのないプロセスを終了しないでください。詳しい調査方法はローカルポートの競合を解消する方法を、デスクトップ版の画面を見ながら設定する場合はv2rayNのインストール・設定ガイドを参照してください。
インストールしたからといって、すぐにシステム起動時の自動実行を有効にする必要はありません。クライアントがデータを保持する方法、実際の待ち受けポート、停止方法を記録し、ノードをインポートしたら手動で接続と終了を一度行います。システムに古いプロキシアドレスが残っている可能性があれば、元の値を記録してください。組織が管理している設定をクライアントの残存設定と誤認して削除しないようにします。正常に終了したあと、システムネットワークが有効化前の状態に戻ることを確認してから、自動起動を設定してください。Androidでは、システムのネットワーク接続を使用中の別アプリがないか記録し、次章のテスト前に競合するアプリを終了します。
04 設定の取得元
サブスクリプションとノードの追加:更新してから使用するノードを選ぶ
サブスクリプションURL、単一ノードの共有リンク、実行設定を区別する
サブスクリプションはクライアントがアクセスするURLで、対応する応答形式はクライアントによって異なります。単一ノードの共有リンクには、通常1つの接続方法が記述されています。コアの完全な設定には、独立したインバウンド、複数のアウトバウンド、ルーティングルールが含まれる場合があり、通常のサブスクリプションURLとして入力できるとは限りません。インポート前に提供元の説明を確認してください。サブスクリプションURLではなくアカウント用のWebページをクライアントに貼り付けると、ログインページが取得されることがあります。ブラウザーでURLを開けることだけを根拠に内容が正しいと判断せず、不明なオンライン変換ツールに貼り付けて試すのも避けてください。URLのクエリパラメーターやパスにアクセス用の認証情報が含まれる場合があるため、パスワードと同様に管理します。
v2rayNでは、サブスクリプショングループの管理画面からグループを新規作成し、識別しやすい名前とサブスクリプションURLを入力して保存します。グループを選択したら、現在のサブスクリプションを更新します。グループ名はローカルで使うメモであり、サブスクリプションの応答形式には影響しません。v2rayNGでは、メニューからサブスクリプショングループの設定を開き、グループとURLを追加してノード一覧へ戻り、サブスクリプションを更新します。v2flyNGもアプリ内のサブスクリプショングループから取得元を管理しますが、両者が同じノード形式をすべて認識するとは限りません。メニュー名は画面のバージョンによって異なる場合があります。保存した取得元があること、取得処理を実行したこと、一覧に項目が追加または更新されたことを確認してください。
リクエスト、名前解決、選択の3段階で確認する
更新後は、グループ内に項目があるかを確認してから、選択中のノードを確認します。新しいノードが表示されても、クライアントがそれに切り替わったとは限りません。更新で既存の項目が置き換わり、以前選択していたノードが無効になることもあります。まず提供元が明示していて、必要な設定が揃ったノードを1つ選んでテストします。共有リンクが1つだけの場合は、クライアントが対応するクリップボードからのインポート機能で適切なグループに追加できます。先にサブスクリプションを作る必要はありません。手動で管理する項目は自動更新の項目と分けましょう。更新時に手動修正が保持されると誤解しやすくなります。
更新に失敗したら、まず失敗の種類を確認します。リクエストがタイムアウトする場合は、現在のネットワークと更新に使う経路を確認します。アクセス拒否の応答がある場合は、URLの期限切れや権限の変更を確認します。解析エラーが表示される場合は、ログインページやエラーページが返ってきたか、サブスクリプションの形式にクライアントが対応していない可能性があります。既存のノードで接続できても更新に失敗するなら、プロキシ経由の通信経路は少なくとも一部動作していますが、それだけでサブスクリプションサービスが正常とは判断できません。逆に、更新が成功しても、確認できるのはサブスクリプションのエンドポイントが応答したことだけです。一覧内のすべてのノードが接続できるという意味ではありません。
最後に使えたノードは残しておきましょう。古いノードが使えず、更新にもそのノードが必要な場合に限り、更新経路が循環依存になっていないか個別に確認します。調査の代わりに一覧を何度も空にするのは避けてください。
手動変更が上書きされないよう更新方法を決める
クライアントにプロキシ経由とプロキシを通さない更新の選択肢がある場合は、サブスクリプションURLへどちらの経路でアクセスできるかを判断します。古いノードが使えず、サブスクリプションへのリクエストがそのノード経由のままなら、現在のネットワークからエンドポイントへアクセスできることを確認したうえで、プロキシを通さない更新を試せます。逆に、直接アクセスできなくても既存ノードが使える場合は、プロキシ経由の更新を試します。証明書エラーが出たらシステム時刻と証明書の信頼状態を確認し、ドメイン名の解決に失敗したら現在の名前解決環境を確認してください。証明書エラーを無視して続行してはいけません。自動更新の間隔はサービス管理者が示す更新頻度に合わせます。手動更新と自動更新が同時に動く場合は、どちらが一覧を上書きしたのか確認できるよう、実行時刻を記録します。
更新後は、グループ、選択中のノード、実際のアクセス結果を照合します。ノードのメモを見て手動選択する場合でも、異なる項目が同じ名前を持つことがあるため、メモだけを識別情報にしないでください。プロトコルの種類、選択したグループ、機密情報を含まないノードのメモは記録できますが、共有ログにノードやサブスクリプションの内容全体を載せないでください。自動更新、システムDNSの異常、更新経路の詳しい対処方法はサブスクリプションの更新失敗と自動更新の設定を参照してください。この段階ではまだルーティングを変更せず、次章で1つの入口から選択中のノードを検証します。
05 通信の入口
システムプロキシ、全般ルール、直接接続の違い
システムプロキシは、どのリクエストがコアに届くかを決める
デスクトップ版v2rayNの「システムプロキシを設定」は、アプリが参照できるプロキシ設定をシステムに書き込む操作です。この設定に従うブラウザーやアプリだけが、リクエストをローカルの入口へ送れる可能性があります。すべてのプログラムがシステム設定に従うわけではありません。コマンドラインプログラムによっては環境変数だけを参照し、アプリ独自のプロキシ設定を保存する場合もあります。ブラウザーが組織のポリシーや拡張機能に制御されていることもあります。システムプロキシを有効にしているのに特定のアプリだけ失敗する場合は、そのアプリがプロキシに接続しているか、接続方式が正しいかを確認してください。すぐにコア全体のアウトバウンドルールを変更しないでください。
「システムプロキシをクリア」はシステムレベルのプロキシ設定を取り消す、または整理する操作です。既存の設定が変更されるかどうかはクライアントとシステムの動作によります。コアの停止とは別であり、アプリに手動で設定したローカルポートの使用も止まりません。システムプロキシの選択肢に「システムプロキシを変更しない」がある場合は、クライアントがこの設定を自動で変更しないという意味です。直接接続へ自動的に戻すという意味ではありません。システムプロキシを手動変更したことがある端末では、切り替え前後にシステム設定を開き、プロキシアドレスと例外リストを自分で確認してください。特に組織のネットワークでは、管理ポリシーで設定されたプロキシを誤って削除しないようにします。
全般とルール分割は、コアに入った後の接続先を表す
一般に全般プロキシとは、コアに入った通信のうち、より具体的な条件に先に処理されなかったものをプロキシのアウトバウンドへ送る設定です。端末上のすべての接続が取り込まれるという意味ではありません。「中国のルールを迂回する」といった設定は、通常、ルールデータベースのドメインやアドレスの集合に基づいて一部を直接接続するものです。サーバーの実際の地理的位置を測定したり、ページの内容を分析したりするものではありません。直接接続のポリシーは、コアに入った後で一致したリクエストを端末から宛先へ直接送る設定です。それでもローカルの入口とコアを経由する場合があります。問題がシステムの入口にあるのかルーティングにあるのかを判断するには、まずコアがリクエストを認識できるかを確認し、次にどのアウトバウンドが選ばれたかを調べます。2つの設定の組み合わせはシステムプロキシとルーティングモードの比較を参照してください。
明示的なプロキシテストなら、システム設定が反映されているかに左右されない
デスクトップでSOCKSのローカル待ち受けが127.0.0.1:10808であることを確認できたら、次のコマンドでこの入口だけを検証できます。ここではサンプル用に予約されたパブリックドメインを使用し、アカウントは不要です。現在のネットワークやルールで比較対象として適切でない場合は、用意しておいたテスト対象に置き換えてください。Windows PowerShellでは、エイリアスの呼び出しを避けるため、コマンド名をcurl.exeにできます。ポートが異なる場合は、ログに表示された実際のSOCKSポートに置き換えます。HTTP待ち受けだけが有効な場合は、SOCKSのオプションにそのポートを指定しないでください。
curl --socks5-hostname 127.0.0.1:10808 --connect-timeout 10 --max-time 20 --head https://example.com/
このオプションを使うと、curlは実行ホスト上で宛先の名前解決を先に行わず、ドメイン名をSOCKSの入口へ渡します。応答があれば、その入口から宛先へのリクエストに結果が返ったことだけが分かります。実際にリモートノードを経由したかどうかを確認するには、アウトバウンドの記録も確認してください。ローカルアドレスへの接続が拒否された場合は、まずポートとコアのプロセスを確認します。ローカル接続後にタイムアウトするなら、アウトバウンド、リモートとのハンドシェイク、宛先からの応答を調べます。サイトによってはレスポンスヘッダーだけを取得するリクエストを拒否することがあるため、通常の読み込みでも比較してください。アプリケーション層の応答コードを、コアの起動失敗として記録しないでください。
AndroidではシステムのVPN許可を使うため、デスクトップの「システムプロキシを設定」という手順をそのまま当てはめないでください。まず一般的なアプリを1つ使って検証し、アプリ別ルーティングの除外対象になっていないことを確認してから、コアが選んだアウトバウンドを確認します。デスクトップでも考え方は同じです。この章では入口、ノード、テスト対象を固定し、再現可能な検証を行います。ルールの変更は次章で行います。最初からブラウザー、ノード、全般モードを同時に切り替えると、たまたま復旧しても、どの変更が効いたのか分からなくなります。
06 アウトバウンド方針
ルーティングとDNS:照合の順序を確認する
照合条件を明確にしてからアウトバウンドのタグを指定する
一般的なコアのルーティングでは、ルールを順番に確認し、最初に条件が一致したルールでアウトバウンドが決まります。まず遮断したい例外や必ず直接接続する例外を挙げ、次に範囲の広い条件を並べ、最後にデフォルトのルールを置きます。1つのルールにドメイン条件とアドレス条件を同時に設定しても、どちらか一方に一致すればよいという意味にはなりません。「指定したドメイン集合またはアドレス集合を直接接続する」には、ルールを2つに分けます。direct、proxy、blockは設定内で定めるアウトバウンドのタグであり、名前を付けただけでアウトバウンドが作成されるわけではありません。ルールをインポートする前に、現在の設定で各タグがどのアウトバウンドを指すか確認してください。
以下はコア設定のrouting部分です。既存のインバウンドとアウトバウンドを含むコア設定に統合してください。3つのアウトバウンドタグがすでにあり、対応する集合がルールデータベースに含まれていることが前提です。v2rayNやAndroidクライアントに共通してインポートできるファイルではありません。グラフィカルインターフェースで編集する場合は、各項目をルーティングルールの編集画面に個別に入力します。この例の最後のルールはTCPとUDPだけに一致し、一般的なプロキシ通信のデフォルトとして機能します。デフォルトアウトバウンドを使う設定では、最初に指定されているアウトバウンドが想定どおりか確認してください。ルールに一致しない通信が自動的に直接接続されるとは限りません。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"domain": ["geosite:category-ads-all"],
"outboundTag": "block"
},
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
},
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
},
{
"type": "field",
"network": "tcp,udp",
"outboundTag": "proxy"
}
]
}
}
名前解決が必要なアドレスルールより先に、デフォルトルールを適用しない
geosite:cnはルールデータベース内のドメイン集合に一致し、geoip:privateはプライベートネットワークなどの用途として登録されたアドレス範囲に一致します。ドメイン名を含まないリクエストは、通常、最初の2つのドメインルールに一致しません。ドメイン名でアクセスするプライベートサービスも、プライベートアドレスで直接アクセスする場合と同じではありません。IPIfNonMatchを使う場合、ドメイン名のリクエストがルールに一致しなかったとき、コアは名前解決後のアドレスで再照合することがあります。上記の広範なネットワークルールは名前解決より先にドメイン名のリクエストを処理するため、この例では3つ目のルールは主にアドレスで直接届いたリクエストに使われます。未知のドメインがすべて先にアドレス分類されると考えないでください。名前解決後のアドレスも判定に使うには、現在のコアの仕様に基づいてIPOnDemandを検討するか、先に一致する広範なルールを外し、デフォルトアウトバウンドを明示します。変更後は、名前解決の負荷と実際の一致回数も確認してください。
実際の名前解決経路に沿ってDNSを調べる
まず、宛先の名前をどこで解決しているか確認します。アプリ独自のリゾルバー、システムリゾルバー、コアのDNS機能、リモート側のアウトバウンドのどれでしょうか。ブラウザーで暗号化DNSを有効にしても、システムの名前解決方法が変わるとは限りません。コアにDNSを設定していても、受信するすべてのリクエストにドメイン名が含まれるとは限りません。DNSを変更したあと一部のアプリだけ挙動が変わる場合は、先にアプリ側で名前解決されているか確認し、同じ入口からドメイン名とアドレスを使ったリクエストを比較します。証明書検証が必要なサイトをアドレスで直接開いて同等のテストにしないでください。ドメイン名とアドレスでは、TLSの識別情報や表示されるサイトが異なる場合があります。必要なら自分が管理するテスト用ドメインを使い、機密性の高い社内ドメインを関係のないリゾルバーへ送らないでください。
リソースを更新したら、ファイルの日付だけでなく、対象の集合が存在するか、含まれる項目が変わったかを確認します。同じ集合名でも、データベースの提供元によって対象範囲が異なる場合があります。機密情報を含まないサンプルを少なくとも3つ記録してください。想定どおり直接接続する宛先、プロキシを通す宛先、遮断する宛先です。ルールを変更したら、新しいリクエストを1つずつ送信し、利用可能なログで宛先とアウトバウンドを照合します。一致情報が確認できない場合は、まず隔離した環境で具体的なルールを1つ追加し、順序を検証してください。ルールデータベースの更新方法と照合の書き方はGeoIP・GeoSiteルールデータベースを参照してください。
07 システムへの接続
TUNによる通信の取り込み:システムプロキシで足りない場合に使う
不足しているのが入口かプロキシ機能かを見極める
TUNは仮想ネットワークインターフェースを使い、システムのルーティングで取り込まれた通信を受け取ります。通常のシステムプロキシでは対応できないアプリに適しています。変更されるのは通信の入口であり、その後の転送、DNS、アウトバウンド方針は引き続き適用されます。ブラウザーから明示的なプロキシ接続ができない場合は、まずローカル待ち受け、ノード、アウトバウンドを修正してください。TUNを有効にしても、使えないノードは復旧しません。反対に、ブラウザーからシステムプロキシを使える一方、対象アプリがプロキシ設定をまったく参照しない場合は、現在の基準設定を保ったまま、TUNでそのアプリの通信を取り込めるか検証するのが適切です。
デスクトップでは、現在のプラットフォームと画面が対応するv2rayNのTUN機能を確認します。有効にする前に、使えるノードが選択されていること、システムプロキシの元の値、現在のネットワーク、ローカルの業務システムへアクセスできるかを記録してください。入口が重ならないよう、初回検証では自分で設定したアプリ独自のプロキシを無効にし、直前にクライアントが書き込んだシステムプロキシ設定も元に戻します。組織のポリシーで管理されているネットワークは、無断で変更しないでください。次にTUNを有効にし、インターフェースの作成やルーティングの変更に必要な権限を、システムの案内に従って許可します。システムが権限を拒否した場合は、ログから失敗した操作を確認してください。普段使うアカウントの権限を拡大することを標準の対処にしないでください。
パブリックネットワーク、プライベートネットワーク、名前解決を比較する
まず一般的なWebリクエストを送信し、次にTUNが必要なアプリを試し、最後に自分が管理する機器など、アクセスが許可されたLAN内のリソースを試します。インターネットには接続できるのにLANへアクセスできない場合、広範な除外ルールをすぐ追加せず、宛先アドレスの範囲、システムのルート優先順位、クライアントに対応する直接接続ルールがあるかを確認してください。コア内でプライベートアドレスを直接接続することと、システム側でプライベート通信を仮想インターフェースに取り込まないことは別の方法です。前者ではコアが通信を認識しますが、後者は入口に届く前に迂回します。名前でアクセスするプライベートサービスでは、DNSクエリが正しいローカルリゾルバーへ届いているかも確認してください。
TUNを有効にした途端、すべてのリクエストが止まった場合は、まずTUNを無効にして元の基準設定を再テストします。復旧する場合は、仮想インターフェース、デフォルトルート、リモートノードへの通信が誤って仮想インターフェースへ戻されていないか、ノードのドメイン名の名前解決がまだ確立していないプロキシに依存していないかを重点的に確認します。一部のページは開くのにアプリのログインやメディアの読み込みで止まる場合は、通常のWebアクセス、対象アプリの接続、依存するDNSまたはUDP通信に分けてテストしてください。UDPをエンドツーエンドで処理できるかは、転送の実装、リモートサービス、アウトバウンドのプロトコル設定にも左右されます。仮想インターフェースが作成されたことだけで判断しないでください。
Androidではシステムの許可と対象アプリを先に確認する
v2rayNGまたはv2flyNGで接続を有効にすると、Androidはシステムのネットワークトンネルを作成する許可を求めます。失敗した場合は、まず許可が完了しているか、同種のサービスがシステム上ですでに常駐していないか、別のアプリの接続を停止し忘れていないかを確認します。特定のアプリだけつながらない場合は、クライアントのアプリ別プロキシが有効か、一覧が対象アプリを含める設定か除外する設定かを確認してください。アプリをバックグラウンドで動作させていた場合は、ルールの切り替え後に接続し直してから確認します。以前の接続を使って新しいルールを判断しないでください。モバイルデータ通信とWi-Fiの両方を試せますが、ノードとテスト対象は変えないでください。そうすれば、システムによる通信の取り込みとネットワークごとの到達性の違いを区別できます。
TUNを無効にした後、仮想インターフェースが解除されたか確認し、同じアプリで元のネットワークを再テストできるよう、明確な終了手順を決めておきます。通常のプロキシで接続できてTUNだけ失敗する場合、サブスクリプションを作り直す必要はありません。
TUNが安定してから、システム起動時に有効にするか検討してください。有線からWi-Fi、Wi-Fiからモバイルデータ通信への切り替え、またはスリープからの復帰のたびに、同じテスト対象を使って一時的な再接続と継続的な障害を見分けます。失敗が続く場合は、発生時のネットワークの種類、クライアントログ、アプリ別ルーティングの状態を保存してから終了し、通信を復旧させます。通信の取り込みを有効にした場合だけ問題が起きるなら、明示的なプロキシに戻して基本的な接続経路を保てます。既存のルーティング、ノード、サブスクリプションまで変更する必要はありません。
08 メンテナンス
日常のメンテナンス:段階的なトラブルシューティングと安全な切り戻し
変更は個別に取り消せる単位に分ける
クライアント、コア、ルールデータベース、サブスクリプション内のノードは、別々の変更対象です。クライアントの更新で画面や設定生成の方法が変わることがあります。コアの更新で設定項目の互換性が変わり、ルールデータベースの更新で分類が変わり、サブスクリプションの更新でリモート側のパラメーターが置き換わることもあります。1回のメンテナンスで4種類すべてを更新してから接続をテストしないでください。どの層を変更したか、選択中のノード、ローカル待ち受けポートを記録し、変更直後に入口、アウトバウンド、宛先を照合します。いずれかに異常があれば、直前に行った取り消し可能な変更だけを戻し、同じ宛先で再テストしてください。
バックアップには、まずクライアントが明示的に提供しているエクスポートまたはバックアップ機能を使います。データディレクトリを直接バックアップする必要がある場合は、実際の保存場所を確認してから正常に終了し、コピー中に設定が書き換わらないようにしてください。バックアップにもサブスクリプションと同様に認証情報が含まれることがあるため、公開された場所へアップロードしないでください。復元前に、現在の状態も別途記録しておきます。設定形式が変わった後は、古いディレクトリを新しいバージョンがすべて正しく読み込めるとは限りません。まず必要なノードをインポートして基本的なアクセスを復旧し、次に独自のルーティング、ローカルポート、アプリ別リストを戻します。復元後はシステムの入口も確認してください。システムプロキシやネットワーク許可がクライアントのバックアップに含まれない場合があります。
障害の発生箇所に合わせて次の確認を決める
- コアが起動しない。まず最初に記録された起動エラーを読み、依存関係、ファイルパス、待ち受けの競合、設定の解析を確認します。最後に表示される一般的な失敗メッセージだけを優先して見ないでください。ポートを開けない場合は、使用中のプロセスを確認します。設定構文のエラーなら、直前に編集した箇所を戻します。
- コアは起動しているが、該当するリクエストがない。明示的なプロキシリクエストを比較用に送ります。明示的なテストは成功するのに通常のアプリの記録がない場合は、システムプロキシ、アプリ独自のプロキシ設定、アプリ別ルーティングの一覧を確認してください。現在のログレベルでアクセス記録を確認できない場合、「ログがない」ことを「コアに通信が届いていない」証拠と決めつけないでください。
- リクエストを受信したが、リモートとのハンドシェイクに失敗する。選択中のノード、システム時刻、サーバー名、トランスポートのオプションを確認し、同じネットワーク上で別の既知の利用可能なノードでも同じ問題が起きるかを調べます。ノードが1つだけ失敗する場合は、まずそのノードを調べます。複数のノードが同じ時間帯に失敗するなら、共通して使っているネットワークと名前解決を確認してください。
- ハンドシェイクは正常だが、一部の宛先だけ失敗する。ルーティングの順序、名前解決、宛先からの応答を確認します。宛先から拒否などのアプリケーション層エラーが返ってきた場合、通信は少なくとも応答できる相手まで到達しています。想定したサービスからの応答かどうかは、アウトバウンドの記録と合わせて判断してください。
エラーを記録するときは、発生時刻、ネットワークの種類、操作手順、エラーの分類、アウトバウンドのタグを残します。スクリーンショットを共有する場合は、サブスクリプションURL、アカウント情報、プライベートドメイン、接続パラメーターを隠してください。設定全体を公開しないでください。再現テストが終わったら、一時的に上げたログレベルを元に戻し、アクセス先が継続して記録されないようにします。不規則なタイムアウトが起きる場合は、初回接続だけが遅いのか、連続したリクエストが遅くなるのか、ネットワーク切り替え後に古い接続が復旧しないのかを切り分けます。最初の比較ではテストツールと宛先を1つずつに絞り、異なるクライアントの遅延スコアをそのまま比較しないでください。
復旧はシステムの入口から始め、次にクライアント設定を戻す
通常のネットワークへ戻すときは、まずTUNを停止するかモバイル端末の接続を切り、次にクライアントが変更したシステムプロキシを確認し、最後にアプリへ手動入力したプロキシアドレスを戻します。デスクトップのウィンドウを閉じても終了したとは限りません。プロセスを終了しても、OS側の設定が消去されたとは限りません。元のプロキシ設定を保持していた端末では、すべてを直接接続にするのではなく、元の値に戻してください。通常の通信が復旧したことを確認してから、元の基準設定でクライアントを再び有効にします。アカウントの許可、ノードの設定、インストール環境に関する問題は、よくある質問の該当カテゴリから確認できます。すべての設定を繰り返し消去する必要はありません。
ネットワークが復旧したら、障害前の変更、切り戻し地点、検証結果をまとめてメンテナンス記録に残します。たとえば「古いルールに戻すと、同じ宛先が再び直接接続になった」と書き、「現在は使える」とだけ記録しないようにします。共通する要因までしか特定できていない場合も、未解決の可能性を記録してください。推測を確認済みの原因として次の担当者に伝えずに済みます。再現でき、個別に切り戻せて、再検証できる記録は、一度復旧したという記録より役に立ちます。
09 応用
応用への道筋:ルールの検証、複数端末の比較、移行
最小限のルール検証から始める
応用設定はルールを増やすことからではなく、各ルールがなぜ必要か説明できる状態から始めます。自分で管理している宛先、またはテストの許可を得た宛先を選び、普段使う設定とは分けた検証用ルールを作ります。ノード、ネットワーク、入口を固定し、具体的な条件を1つと既知のデフォルトアウトバウンドを設定して、一致する場合と一致しない場合をそれぞれ確認します。その後、ドメインのサフィックス、アドレス範囲、ルールデータベースの集合へ条件を段階的に広げます。拡張後に動作が変わったら、直前の具体的なルールと比較して、対象範囲、優先順位、コアへ渡されたアドレスの形式のどれが変わったかを確認してください。
各サンプルについて、リクエストの形式、想定するアウトバウンド、実際のアウトバウンド、応答結果を記録します。ルールへの一致とサービスの成功は別々に検証してください。直接接続ルールに一致しても、宛先から拒否されることがあります。プロキシルールに一致しても、リモートとのハンドシェイクに失敗する場合があります。ブロックルールを検証するには、もともとアクセスできると分かっている宛先を使わなければ比較になりません。テスト中にブラウザーのキャッシュや既存の長時間接続を新しいリクエストの代わりに使わないでください。設定を変更したら、コアに反映されたことを確認してから、新しい接続が発生するリクエストを送信します。一致したルールを観察できない場合は、読み込み速度からルーティングを推測せず、一時的にルールの数を減らしてください。
複数端末の比較ではプラットフォームの違いを保つ
同じサブスクリプションをデスクトップとAndroidの両方にインポートできても、実際に適用される設定が同じとは限りません。まずデスクトップでは明示的なローカル入口から宛先へリクエストを送り、モバイル端末ではアプリ別リストに確実に含まれるアプリを選んで同じ宛先へアクセスします。両方で同じノードを使っていることを確認してください。各端末のルーティング機能、システムの仮想インターフェースを使うか、名前解決をどこで行うか、想定する直接接続の範囲を記録します。一方が定義済みルールのみ対応し、もう一方が細かいルールを設定できる場合は、項目をそのままコピーすることにこだわらず、用途と意図を引き継ぎます。項目に関係する基本概念はプロトコル・コア・ルーティング用語を参照してください。
移行は、サブスクリプション、選択中のノード、ローカルの入口、独自のルーティング、自動化設定の順に戻します。デスクトップで使っているループバックポートをモバイル端末のアプリに設定したり、一方のデフォルト設定がもう一方の全般モードと同じだと思い込んだりしないでください。同じ用途について、許容できる失敗の範囲を明記します。たとえば、特定のサイトだけプロキシ経由にし、LAN内のリソースは直接接続する、といった内容です。別の端末での検証には、どのルールにも一致しない宛先、明示的に直接接続する宛先、通常のプロキシ接続先を含めてください。想定するアウトバウンドを記録していなければ、「両方でページが開く」だけでは移行完了の確認になりません。
回帰テスト用のサンプルを保ち、独自設定の範囲を限定する
よく使うテストケースとして、通常のプロキシ接続、直接接続する宛先、遮断する宛先、サブスクリプションの更新、終了後に通常のネットワークが復旧することの5つを用意できます。変更するたびに影響を受けるケースを記録し、新しい設定を使う前にすべてテストします。業務環境で特別な名前解決が必要なら、Wi-Fi、モバイルネットワーク、組織のネットワークごとに記録してください。特定の環境だけで成立する結果を、標準の方針として扱わないためです。障害の比較では読み取り専用の確認を優先し、必要な証拠が得られる最小限のログレベルを使って、確認後は元の設定に戻します。
長期的に保守できる設定では、入口の取得元、ルールに一致したアウトバウンド、名前解決の担当、直前の利用可能な状態へ戻す方法を説明できます。
グラフィカルインターフェースで明確な要件を表現できない場合に限り、クライアントとコアが実際に対応している独自設定の方法を検討してください。クライアントが一時的な実行ファイルを再生成する場合、そこを直接編集すると次回起動時に上書きされることがあります。保守可能な設定はサポートされている場所に保存し、独自設定なしで起動できる基準状態も残してください。用途、比較用のテストケース、切り戻し方法のないルールは、普段使う設定に追加しないでください。これでインストール、サブスクリプション、システムの入口、ルーティング、通信の取り込みを、それぞれ独立して検証できる状態になります。新しい問題が起きたら該当する章に戻ればよく、インストール全体をやり直す必要はありません。