設定リファレンス · 上級ガイド

V2Ray詳細設定

まずクイックスタートガイドで初回のインポート、接続、動作確認を済ませてから、このガイドで個別の設定を確認してください。以下ではデスクトップ版の v2rayN を中心に解説し、Android 版については v2rayNG と v2flyNG の違いを別途記載します。

サブスクリプションと絞り込み通信の取り込みと名前解決アウトバウンドとコア

サブスクリプションのグループ分けとサーバーの絞り込み

更新対象を配信元ごとに分ける

サブスクリプションをグループ分けする主な目的は、サーバーを地域別に分類することではなく、更新対象を配信元ごとに分けることです。v2rayNのサブスクリプショングループ設定で項目を追加し、見分けやすい名前とサブスクリプションURLを入力して保存します。該当グループを選び、まずはそのグループだけを更新してください。名前には「ラボ・リモート接続」「個人用予備」など、配信元や用途を含めると便利です。同じ配信元から用途の異なる複数のサブスクリプションが提供される場合も、名前を分けましょう。グループ分けによって、トラブル時に再取得する配信元が明確になります。一方、サーバーの表示名は一覧で項目を見分けるためのものです。両者を混同しないでください。

更新後は、新しい項目がどのグループに追加されたかを確認し、プロトコルと通信方式が配信元の説明どおりか照合します。共有リンクやクリップボードから個別に追加した項目は、サブスクリプション更新の確認には使えません。接続できても、最新のサブスクリプション内容を取得できた証拠にはならないためです。手動追加した設定を一時的に残す場合は、専用の名前を付けてください。サブスクリプショングループ内の項目を手動で変更しても、更新時に配信元から項目やパラメーターが再配信される可能性があります。

確認できる名前を使って絞り込む

サーバーの絞り込み欄があるv2rayNでは、まず欄の説明を確認します。対象がサーバー名なら、条件にアドレスやアウトバウンドのタグ、ルーティング用ドメインを書いてはいけません。正規表現を使う欄だと明記されている場合は、^(办公|测试)-で「办公-」または「测试-」から始まる名前に一致させられます。保存して更新する前に、残したい名前と除外したい名前をそれぞれ一つずつ使って動作を確認してください。正規表現では丸括弧で候補をまとめ、縦線でいずれかに一致させます。名前に文字としてのピリオドが含まれる場合は、任意の1文字として扱われないよう\.と記述します。名前の付け方が安定している場合に限り、先頭・末尾のアンカーを使いましょう。

欄の名前だけで、一致した項目が必ず残るのか除外されるのかを判断しないでください。また、絞り込みが一覧表示だけに影響するとも限りません。一時的なグループを使って確認します。絞り込み前の代表的な項目を記録し、条件を設定して更新をやり直したうえで、項目がインポート時に除外されたのか、一覧で非表示になっただけなのかを確認してください。比較する際は同じグループ、同じ配信元を使います。そうしなければ、差が条件によるものか判断できません。配信元の名称変更、空白文字、大文字・小文字の違いで条件が一致しなくなることがあります。元に戻すときは、まず条件を消して該当グループだけを更新し、その後で絞り込み方を見直してください。

リクエスト失敗・解析失敗・絞り込み結果なしを区別する

更新ログでリクエスト段階にホスト名の解析失敗や接続タイムアウトが出た場合は、サブスクリプションのドメインを名前解決できるか、現在のネットワークから接続できるか、更新リクエストが直接接続か既存のプロキシ経由かを確認します。この段階では、まだサーバーの絞り込みに進んでいません。リクエスト完了後に解析エラーが表示された場合は、返された内容がクライアントで認識できるサブスクリプションか確認してください。ノード設定ではなく、ログインページやサービス案内が返されることもあります。解析できているのに目的の項目がない場合は、サーバー名、絞り込み条件、プロトコルの対応状況、別のグループが選択されていないかを確認します。

Androidでは、デスクトップ版と同じ機能名をメニューから探さないでください。v2rayNGまたはv2flyNGのサブスクリプション機能からインポートして更新し、グループ分けや絞り込みは各クライアントで実際に使える機能に合わせます。同等の欄がない場合は、元のサブスクリプションを保ち、配信元ごとに管理するほうが、デスクトップ版の正規表現をそのままモバイル版に当てはめるより予測しやすくなります。同じ配信元をデスクトップでは更新できてスマートフォンでは失敗する場合、まず同じネットワーク条件で再試行してください。両者の更新リクエストやプロトコル解析は別々に行われるため、一覧の項目数だけで原因を判断できません。

ルーティングルールの実践

まず、通信がどの入口に届いたか確認する

ルーティングルールが処理するのは、すでにコアに届いた通信です。システムプロキシを有効にすると、その設定に従うアプリは通常ローカルプロキシにリクエストを渡せます。一方、明示的に直接接続するアプリ、独自のプロキシを使うアプリ、一部の接続を独自に処理するアプリは、同じ入口を通るとは限りません。確認にはローカルプロキシを明示的に指定できるアプリを使い、まずリクエストがクライアントに届いていることを確かめてからルールを変更します。該当するインバウンドリクエストがログにない場合、ドメインルールを追加したり順序を入れ替えたりしても、入口の問題を覆い隠すだけです。デスクトップではシステムプロキシとTUNを同時に有効にしていることがあります。最初のテストでは、要因を絞るためにどちらか一方だけを使ってください。

ドメイン名で照合できるかどうかは、入口が取得する接続先の情報にも左右されます。アプリがドメイン名をプロキシに渡す場合は、その名前でルールを照合できます。アプリが先に名前解決してIPアドレスだけを渡した場合、ルールにドメイン名があっても、コアが自動的に元の名前を復元するわけではありません。通信の種類、暗号化方式、クライアントの設定によっては、入口のスニッフィング機能でプロトコル上の接続先名を取得できる場合があります。同じサイトでもアプリによって適用されるルールが異なる場合は、ログで受け取った情報が名前かアドレスかを確認してから、IPアドレスのルールを追加するか検討してください。

具体的なルールを広範囲のルールより先に置く

Xrayのルーティングルール配列は上から順に評価され、一致したルールに対応するアウトバウンドが使われます。単一ルール内のドメインやポートなど異なる条件は、すべて満たす必要があります。同じドメイン配列に並ぶ候補は、いずれかに一致すれば対象です。以下はルーティングオブジェクトのみの例です。トップレベルのroutingフィールドに記述してください。参照する2つのタグは、トップレベルのoutboundsで定義済みである必要があります。1つ目のルールはテスト用の名前だけを除外し、2つ目は例示ドメインとそのサブドメインに一致します。ルールリソースファイルを使わないため、基本的な照合の問題とリソース読み込みの問題を切り分けられます。

{
  "domainStrategy": "AsIs",
  "rules": [
    {
      "type": "field",
      "domain": ["full:blocked.example.org"],
      "outboundTag": "blocked"
    },
    {
      "type": "field",
      "domain": ["domain:example.org"],
      "outboundTag": "direct"
    }
  ]
}

例の2つ目のルールを先に置くと、1つ目の名前も広いドメイン条件に一致し、除外ルールが適用されません。同様に、通常の通信をすべて終了させるフォールバックルールを先頭に置くと、個別ルールが評価されなくなります。クライアント内蔵のルーティングプリセットを使う場合は、まず編集可能な複製を作り、ルールの順序と最後に選ばれるアウトバウンドを確認してください。どのルールにも一致しない通信は、Xrayでは既定で先頭のアウトバウンドに送られます。GUIクライアントが生成設定にフォールバックルールを追加している場合もあるため、画面上のサーバー一覧の先頭だけで実際の出口を判断しないでください。

ドメインの振り分けとルールリソースを分けて確認する

AsIsは、ルーティングの照合に必要なドメインを追加で名前解決しません。IPIfNonMatchは、ドメイン名の段階で一致するルールがない場合に、名前解決したIPアドレスでアドレスルールを再照合する設定です。先に広いルールが接続に一致している場合、追加の名前解決は行われません。IPOnDemandでは、ルールの確認にアドレスが必要になった時点で名前解決できます。ルールの順序によって、問い合わせが発生するタイミングも変わります。これらの設定が決めるのは、ルーティングで照合に使う情報の取得方法です。アプリのDNSサーバーを指定するものではなく、最終的なアウトバウンドが同じ名前解決結果を使うとも限りません。

手書きルールからgeosite:やgeoip:による照合に切り替える場合は、コアが読み込むリソースファイルとカテゴリが存在するかも確認してください。カテゴリが利用できても、サイトの補助ドメインすべてが含まれるとは限りません。ページ本体、ログインサービス、静的リソースで異なるルールが適用されることもあります。検証では、一致するはずの接続と既定のアウトバウンドに進むはずの接続をそれぞれ選び、新しいセッションでログを確認します。すでに確立した接続は、ルールを編集しても出口が選び直されません。インバウンド、ルーティング、アウトバウンドの構成全体を確認するには、設定ファイルのJSON構造解説を参照してください。

DNS設定の最適化

アプリの名前解決とコアの名前解決を分けて考える

ドメインへの接続に失敗しても、すぐにDNSサーバーを変更するのは避けてください。まず、その問い合わせをどこが行ったのか確認します。システムのリゾルバーを使うアプリ、ドメイン名をプロキシに渡してコアやアウトバウンドに名前解決を任せるアプリ、独自に暗号化DNSを送信するアプリがあります。クライアントのコアDNS設定が影響するのは、そのDNSモジュールに届く問い合わせだけです。アプリが独自に送るリクエストまで自動で書き換えることはできません。同じドメインをアプリとクライアントでテストする場合は、まずどの入口を使ったか記録してください。端末のターミナルでアドレスを取得できても、その端末が使った経路で名前解決できたことしか示しません。プロキシ内のDNSルールが機能した証拠にはなりません。

内部ドメインは、名前解決の境界を確認するのに適しています。組織内のネットワークでしか解決できないサービス名は、そのネットワークで指定されたDNSサーバーに送り、該当インターフェースから問い合わせられることを確認してください。内部ドメインをパブリックDNSに送ると、存在しないという応答が返るだけでなく、知る必要のないサービスに名前が送信されるおそれもあります。内部DNSが管理する名前と公開ドメインをそれぞれ選び、まず両方のDNSサーバーが個別に使えることを確認してから、ドメイン分類をコアの設定に追加します。2つのアドレスが異なるというだけでは、振り分けの正否を判断できません。

DNSサーバー・照合範囲・フォールバックを個別に設定する

ネイティブ設定のフラグメントに対応するXray設定では、トップレベルのdns内にあるserversでDNSサーバー候補を定義します。サーバーオブジェクトのdomainsで照合対象を指定します。これはDNSサーバーの選択に影響しますが、同じ名前のアウトバウンドに接続を自動転送するものではありません。以下のオブジェクトは照合とフォールバックの説明用です。コアで名前解決する例示ドメインは指定サーバーを優先し、それ以外の問い合わせにはシステムのリゾルバーを使います。skipFallbackを設定すると、例の専用サーバーは通常のフォールバック候補から外れます。ただし、そのドメインに一致したときにサーバーが優先されなくなるわけではありません。また、専用サーバーでの名前解決に失敗しても、他のサーバーに問い合わせないという意味ではありません。

{
  "servers": [
    {
      "address": "223.5.5.5",
      "domains": ["domain:example.org"],
      "skipFallback": true
    },
    "localhost"
  ],
  "queryStrategy": "UseIP"
}

UseIPは問い合わせを単一のアドレスファミリーに限定しません。UseIPv4またはUseIPv6は、内蔵DNSで使用するアドレスファミリーを制限する設定であり、OSのネットワーク設定を切り替えるものではありません。一部の接続だけが遅い、または失敗する場合は、IPv4とIPv6のレコードがそれぞれ存在するか、取得したアドレスに実際に接続できるかを調べます。現在のネットワークで特定のアドレスファミリーに到達できないことが分かった場合、一時的に問い合わせ範囲を限定すると原因を切り分けやすくなります。診断後は、1回の調査用変更をすべてのネットワークで使い続けず、実際の環境に合った設定に戻してください。

DNSサーバーに接続できない問題と、名前解決後の接続先に到達できない問題を区別する

ドメイン名で指定する暗号化DNSのエンドポイントを使う場合は、まずエンドポイント自体の名前解決方法を考えてください。まだ接続できていないエンドポイントに、そのエンドポイント経由で自分自身を名前解決させようとすると、依存関係が循環します。接続にプロキシが必要で、そのプロキシのホスト名も同じエンドポイントでしか解決できない場合も同様です。ネットワーク上で利用可能な、独立して到達できる初期の名前解決方法を用意し、エンドポイントのホスト名が正しいことを確認します。エラーログの順序も重要です。DNSエンドポイントへの接続失敗は、サービスのドメイン名が解決された後に接続がタイムアウトする問題とは異なります。

DNS方式を切り替えるときは、同時にDNSを処理する他の試験的な設定をいったん無効にします。新しいセッションで正常動作が分かっているドメインにアクセスし、システム、アプリ、コアが別々に結果をキャッシュしている可能性も考慮してください。一度成功しても、アプリが既存の接続を再利用しているだけかもしれません。検証には、問い合わせの確認と、その後の実際の通信を含めてください。ルールリソース、暗号化DNS、グループ別の名前解決を組み合わせて確認する場合は、V2Ray DNS振り分け設定を参照してください。まずこの章の基本的な比較を終えてから、複数のDNSサーバーを導入しましょう。

TUNモードと通信の取り込み

システムプロキシと仮想インターフェースを比較する

システムプロキシは通常、アプリがプロキシ設定に従う必要があります。TUNは仮想ネットワークインターフェースとシステムルートを使い、条件に合う通信を取り込みコンポーネントに送ります。TUNを有効にしても、すべての通信が同じ出口に送られるわけではありません。どの宛先アドレスが仮想インターフェースを通るか、どのアプリを除外するか、取り込み後にルーティングルールで直接接続へ送るかは、それぞれ別の判断です。トラブル時は、「アプリがどの種類の接続を開始したか」「どの入口を通る想定か」「実際にどの出口が使われたか」を整理してください。「有効にしたらつながらない」とだけ記録するより、インターフェース、システムルート、コアのどのログを調べるべきか判断しやすくなります。

デスクトップでは、まずv2rayNで通常のシステムプロキシまたはアプリに明示的にプロキシを設定する方法で、動作確認済みの接続を確立します。その後、TUNを個別に試し、インターフェースの作成やルート変更に関するシステムの許可表示を確認してください。Android版のv2rayNGとv2flyNGは、通常、システムのVPNサービスを使って通信を取り込みます。システムの許可、対象アプリの範囲、他のVPNサービスとの併用可否は、使用するクライアントと端末に表示される状態を確認してください。デスクトップのTUN設定とは画面も仕組みも異なるため、デスクトップでの権限操作をそのままスマートフォンに当てはめないでください。

取り込み方式入口が成立する条件最初に確認する項目
デスクトップのシステムプロキシアプリがシステムプロキシに従う、またはローカルプロキシを設定しているアプリがローカルの待ち受けアドレスにリクエストを送っているか
デスクトップのTUN仮想インターフェースが作成され、システムルートがそのインターフェースを指している取り込みコンポーネントが起動しているか、テスト対象が該当ルートを通るか
AndroidのVPNサービスシステムの許可があり、アプリが通信の取り込み対象に含まれている接続状態と、アプリの対象・除外リスト

出口への再流入を防いでからローカルネットワークを確認する

インターフェースを作成するのは最初の一歩です。クライアント自身がリモートサーバーに接続する通信は、実ネットワークインターフェースから送信できなければなりません。その通信が既定ルートによって同じ仮想インターフェースに再び送られると、ループが発生することがあります。TUNを無効にすれば接続できるのに、有効にすると以前使えていたサーバーともハンドシェイクできない場合に起こりがちな症状です。まず取り込みコンポーネントで出口への迂回やインターフェースのバインドが適切に行われているか確認し、他の仮想ネットワークツールとのルート競合も調べます。最初からシステムルートを手動で削除するのは避けてください。クライアントのTUNを無効にしても問題が続く場合は、システム画面でインターフェースの状態を確認してから、その端末の管理ルールに従って設定を復元します。

有効にした後、プリンター、共有フォルダー、組織内サービスだけに接続できない場合は、宛先アドレスへのルーティングと名前の検出を分けて確認してください。サービスの既知のアドレスには接続できるのに、デバイス名では失敗する場合、名前解決または検出の通信が適切なネットワークに届いていない可能性があります。どちらも失敗する場合に、ローカルサブネットが取り込み対象になっているかを優先して確認します。ネットワークを切り替えるとローカルアドレス範囲や既定のインターフェースが変わるため、除外設定は現在の環境に合わせてください。出所の分からないルートをそのままコピーしないでください。組織のデバイスを扱う場合は、変更前に、その種類の通信をアプリに取り込ませてよいか管理ポリシーを確認します。

プロトコルとネットワーク環境ごとに確認する

通常のWebページが開けても、その接続経路が使えることしか分かりません。すべてのUDPアプリや長時間接続が使えるとは限りません。Webページは正常でも通話アプリが失敗する場合は、アプリが実際にUDPを使用しているか、入口、選択したアウトバウンド、接続先がすべてその通信に対応しているか確認してください。接続確立後に長時間停止する場合は、パケットサイズやネットワークの変化などを調べます。ハンドシェイクやルートを確認せずに、根拠なくインターフェースのMTUを下げないでください。変更は1回につき1項目にし、起動ログと再現可能なテスト手順を残すと、複数の要因を行き来して推測するのを防げます。

少なくとも、TUNを有効にした状態でのアクセス、無効に戻した後の復旧、別のネットワークに切り替えた後の再アクセスを確認してください。最初の2つで取り込みと復帰の両方を検証でき、最後のテストで古いインターフェースが参照されたままになっていないか確認できます。端末で別のネットワーク取り込みツールも動いている場合は、設定の重複を解消してから再試行してください。併用が必要な場合は、各ツールの取り込み範囲を管理者に確認します。いったん基本状態に戻してからFakeDNSだけを有効にすると、問題が仮想インターフェース自体にあるのか、名前のマッピングにあるのか切り分けやすくなります。

FakeDNSとドメイン名のマッピング

合成アドレスが有効な範囲を理解する

FakeDNSは、ドメイン名と合成アドレスの対応関係を保持します。アプリが名前を問い合わせると合成アドレスが返され、そのアドレスに接続します。通信が再びマッピングを参照できるコアに届いて初めて、コアは接続先の名前を復元し、ルーティングやアウトバウンド処理に使えます。合成アドレスは接続先サーバーが実際にそのアドレス上にあることを示すものではなく、別の端末でそのまま使える名前解決結果でもありません。アプリが取り込みを経由せずにそのアドレスへ接続すると、ドメイン名を復元できません。そのため、通常のDNSサーバーが返す最終的な接続先アドレスではなく、取り込み経路の中で使うアドレス上の目印として扱ってください。

この仕組みは、入口が接続先アドレスしか認識できない一方で、設定ではドメイン名ごとに通信を振り分けたい場合に役立ちます。通常のシステムプロキシでアプリがドメイン名を渡しているなら、まず既存のドメインルールを確認してください。対象プログラムが他の経路でも使える実アドレスを必要とする場合や、取り込み対象外のサービスに問い合わせ結果を渡す場合は、その名前を実際のDNSで解決する設定を残します。FakeDNSを使っても、暗号化DNSの問い合わせがすべて自動的にコアのDNS問い合わせに変わるわけではありません。アプリが独自にDNSサービスを使う場合は、まず問い合わせがクライアントで設定したDNSの入口を通っているか確認してください。

アドレスプール・DNSの入口・通信の入口をそれぞれ確認する

Xrayのネイティブ設定でFakeDNSを確認する場合は、3か所を個別に調べます。トップレベルのfakednsでアドレスプールを定義し、dns.serversの選択で内蔵DNSのどの問い合わせにFakeDNSを使うか決めます。後続の通信を受け取る入口では、マッピングからドメイン名を復元できる必要があります。ネイティブの入口設定を使う場合は通常、その入口でsniffingが有効か、destOverrideにfakednsが含まれるかを確認します。GUIクライアントがこれらのフィールドを生成することもあります。実際の起動設定とログで確認し、設定スイッチが1つあるだけで3か所すべてが整っていると判断しないでください。

以下はアドレスプールの断片であり、これだけでFakeDNSが有効になるわけではありません。ipPoolは合成アドレスの範囲を決め、poolSizeはプール内に保持できるマッピング数を制限します。ネットワーク帯域の設定ではありません。例のネットワーク範囲が、ローカルの検証環境や別の通信取り込みツールですでに使われていることがあります。適用前に既存のルートを確認してください。2つのツールが同じ範囲を使うと、一方のプログラムが取得したアドレスを別のインターフェースが誤って受け取る場合があります。DNSの上流サーバーを変えるだけでは、このルート競合は解消しません。

{
  "fakedns": [
    {
      "ipPool": "198.18.0.0/15",
      "poolSize": 65535
    }
  ]
}

問い合わせ・通信の再取り込み・マッピングの3段階で調べる

1段階目は問い合わせです。テストしたドメインから実アドレスが返った場合、まずFakeDNSを使うべき名前か確認します。その後、クライアントのDNS選択、アプリのキャッシュ、独自DNSサービスへの切り替えを調べてください。2段階目は通信の再取り込みです。合成アドレスを取得できたのにアプリの接続が取り込みログにない場合は、アプリの対象・除外範囲と、そのアドレスが属するネットワークのルートを確認します。3段階目はマッピングです。接続がコアに届いているのにログでドメイン名が復元されない場合は、入口がマッピングに対応しているか、問い合わせと接続が同じインスタンスで処理されたかを確認してください。2つのツールを別々に使うより、同じプログラムで問い合わせから接続まで行うほうが、状況を照合しやすくなります。

コアを再起動した後も、アプリが再起動前のアドレスを保持していることがあります。その場合、現在のコアには対応するマッピングがありません。また、プール内のマッピングが利用中に置き換わることもあり、アプリのキャッシュ時間とコアの動作が同期していないと起こりやすくなります。まず新しいセッションを作り、アプリに名前を再問い合わせさせてから、復旧するか確認してください。特定の種類の内部サービスや古いアプリで繰り返し発生する場合は、その名前を実際のDNSで解決するように戻し、ドメイン名とIPアドレスの両方で接続を比較します。アドレスプール、ドメインルール、既定のアウトバウンドを同時に変更すると、復旧しても原因を特定できません。

複数サブスクリプションの管理と更新順序

配信元の変更と現在の接続を分けて考える

単一サブスクリプションのトラブルシューティングでは個々のインポートを調べますが、複数サブスクリプションの管理では、それぞれを独立して更新できるかが重要です。配信元ごとに分かりやすいグループを作り、現在使用中、一時テスト用、予備用を区別しましょう。更新前に、使用中の項目が属するグループ、実際に使っているプロトコルと通信方式を記録します。その後、対象グループだけを更新し、その項目が残っているか、配信元が別の設定に差し替えていないか確認してください。表示名が同じでも、サーバーアドレス、通信パラメーター、認証設定が変わっていないとは限りません。使用中の接続に依存する作業をしている間は、メインの配信元を更新する前に予備の配信元を確認してください。

サーバーの表示名が同じでも、重複項目として削除すべきとは限りません。配信元が異なれば、同じ名前を使っていてもおかしくありません。アドレスが同じ場合でも、必要な権限や通信要件が異なることがあります。配信元を比較するときは、まずグループを確認し、必要なプロトコルと通信設定をローカルで照合してください。名前だけを見て統合しないでください。選択ミスを減らすには、サブスクリプションから生成された項目を一括編集するより、グループ名や一覧表示を調整します。次回の更新で変更が上書きされる可能性があり、項目の配信元も分かりにくくなるためです。

自動更新を設定する前に、更新経路を確認する

サブスクリプションの更新リクエストと、サーバーを経由する通常の通信は別のものです。配信元が特定のネットワークからのリクエストを求める場合は、ドメインの名前解決と接続経路、更新時にクライアントが現在のプロキシを使うかを確認してください。よくある循環依存は、既存の項目がすべて無効になったら新しい項目を更新で取得する必要があるのに、更新自体もその古い項目に依存しているケースです。失敗中の経路で何度も更新するのではなく、サブスクリプション取得用に、独立した許可済みの接続経路を確保します。まず1つのグループを手動で更新して動作を確認し、その後でクライアントの自動更新を有効にしてください。

配信元ごとにリクエスト頻度の制限がある場合、自動更新の間隔は各配信元の要件に合わせて設定します。1つのグループが失敗したからといって、すべてのグループを連続して更新しないでください。また、自動更新を有効にしても、障害が復旧するわけではありません。スリープからの復帰後、ネットワークの切り替え中、プロキシの起動前に自動実行されれば、その失敗は手動更新の成功と矛盾しません。トラブルの記録には、リクエスト時のネットワーク、利用可能なプロキシの有無、ログが止まった段階を含めてください。同じ条件で再現できれば、環境の変化かサブスクリプション自体の変更かを判断できます。

更新後の問題は影響範囲に応じて対処する

項目が消えた場合は、まず対象グループと絞り込み状態を確認し、内容の取得と解析が成功したかログを調べます。同じグループ内の複数項目が同時に変わったなら、配信元の変更か絞り込み条件の強化が考えられます。1項目だけ消えた場合は、配信元がその項目の提供を終了したか個別に確認してください。更新が完了したのにクライアントが古いサーバーへ接続する場合は、すでに確立済みの接続を再利用しているのか、新しい接続でも古い設定が使われているのかを区別します。テスト接続を終了し、使用する項目を選び直して接続するほうが、一覧の選択表示だけを見るより確実です。

配信元を切り替える際は、短期間の復旧用として旧グループを残します。ただし確認中に状態が変わらないよう、旧グループの定期更新は停止してください。新しいグループはインポートと接続を確認し、同じ通信テストでルーティングと名前解決に影響がないか調べます。配信元を使わなくなったら、定期更新を停止し、その配信元に依存する使用中の項目や予備設定がないか確認してからグループを削除してください。グループ削除時に所属サーバーも削除するかどうかはクライアントによって異なります。確認画面をよく読み、一覧のグループ名だけが消えると思い込まないでください。

端末間で設定を移行する場合は、まず移行先クライアントが同種のサブスクリプションに対応しているか確認し、配信元ごとにインポートして検証します。グループ名、更新時に使うプロキシ、自動更新の設定、使用中の項目は、通常サブスクリプションの配信内容には含まれません。端末を替えた後、それぞれ個別に確認してください。バックアップはアクセス制限のあるローカル環境に保存でき、サブスクリプションURLを公開の共同編集ドキュメントに貼り付ける必要はありません。初期設定画面やシステムプロキシに慣れていない場合は、まずクイックスタートで1つのグループから接続し、その後この章に戻って複数配信元の更新を設定すると、復旧地点が明確になります。

独自のアウトバウンドとタグの関連付け

小さな設定でタグのつながりを確認する

アウトバウンドは接続をどこで処理するかを定義し、ルーティングはいつそこへ送るかを定義します。アウトバウンドのtagは設定内で参照する名前であり、ルールからoutboundTagで指定します。クライアント一覧に表示されるサーバー名とは別物です。既存の設定にアウトバウンドを追加する前に、使用中のタグを一覧にし、重複しない名前を選び、ルールに一致しない通信をどの出口に送るか決めてください。アウトバウンドの名前だけを変更してルール側の参照を直さない場合や、新しい出口を誤って配列の先頭に置いた場合、実際の振り分けが変わることがあります。

以下は単独で実行できるXrayの最小設定です。ローカルSOCKSインバウンド、直接接続、拒否アウトバウンドの関係を確認できます。待ち受け範囲はローカル端末だけで、サブスクリプションやリモートアカウントは必要ありません。起動前に、使用するポートが実行中のクライアントに使われていないことを確認してください。ポートを変更する場合は、テストアプリのプロキシポートも合わせて変更します。この例ではシステムプロキシもTUNも有効にしていないため、明示的にこの待ち受けポートを指定していないアプリの通信は取り込みません。このテストで待ち受けアドレスを他の端末に公開する設定に変更しないでください。

{
  "log": {
    "loglevel": "info"
  },
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": false
      }
    }
  ],
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom"
    },
    {
      "tag": "blocked",
      "protocol": "blackhole"
    }
  ],
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["full:example.org"],
        "outboundTag": "blocked"
      }
    ]
  }
}

インターネット接続だけでなく、ルールの一致も確認する

テストアプリでは、プロキシ側の名前解決に対応するSOCKSモードなどを選び、ドメイン名をSOCKSプロキシに渡してください。まず例にある完全なドメイン名へアクセスし、次に別の利用可能な公開ドメインへアクセスします。前者は拒否アウトバウンドに送られ、後者はルールに一致しないため、先頭の直接接続アウトバウンドが使われます。テストプログラムがローカルで名前解決し、アドレスだけを入口に渡した場合、この例では完全なドメイン名に基づく照合は行われません。拒否アウトバウンドの確認では、ログで選択されたタグを確認してください。ブラウザーのエラーだけでは判断できません。名前解決失敗、プロキシの未起動、テストアプリが別のポートを使っている場合も、ページが開かないためです。

実際の設定にプロキシアウトバウンドを追加する際は、プロトコルのパラメーター、通信層の設定、サーバーと合意したセキュリティ設定をあわせて確認します。共有リンクに含まれるのは、接続に必要なパラメーターだけの場合があります。アプリ全体のインバウンド、ルーティング、DNS設定の代わりにはなりません。追加するアウトバウンドは、まず専用のテストルール1つに限定し、起動、ルールとの一致、接続をそれぞれ確認してから範囲を広げてください。プロトコルが異なるアウトバウンドオブジェクトは、protocolフィールドだけを書き換えて流用できません。設定の構造はプロトコルごとに異なるため、使用するコアの定義に従ってください。

クライアントの生成ファイルと手動設定を区別する

GUIクライアントは、サーバーの切り替え、ルーティングの変更、再接続などの際に設定を生成し直すことがあります。一時的に生成されたファイルを直接編集すると、一度は起動できても次回の更新で変更が上書きされる可能性があります。ネイティブ設定を長期利用する場合は、まずクライアントに対応するカスタム設定の入口があるか確認し、独立した元ファイルと最後に動作した設定のコピーを保存してください。例の配列を使用中のサブスクリプション設定にそのまま置き換えることはできません。既存のローカルインバウンド、既定のアウトバウンド、クライアントの通信取り込みに必要なタグが失われるおそれがあります。使用するコアと実行方式に合わせて統合してください。

デバッグ手順は次の順に固定できます。設定を読み込めること、インバウンドのバインドに成功すること、テストリクエストがインバウンドに届くこと、ルールが想定どおりのタグに一致すること、アウトバウンドが接続を完了すること。最初の段階で失敗した場合は、エラーが示すフィールドと括弧の階層を確認します。最後の段階だけ失敗する場合に、選択したアウトバウンドのネットワークやサーバーパラメーターを調べてください。テスト終了後はログレベルを適切に下げ、接続先を含む詳細ログを長期間残さないようにします。診断内容を共有する際は、サーバー識別情報、認証パラメーター、非公開の名前を削除し、フィールドの構造と再現に必要な情報だけを残してください。

複数コアの切り替えと互換性

必要なプロトコルに合わせてコアを選ぶ

クライアントは設定の管理、接続の起動、ログの表示を担当し、コアは設定を解釈して通信を処理します。デスクトップではv2rayNを主に使います。クライアントのダウンロードページでOSとアーキテクチャに合った項目を選んでください。Windowsデスクトップ版と従来のWPF版の違いは画面の実装であり、選択肢だけから使用中のコアを判断することはできません。AndroidではXrayを採用するv2rayNGを主に使い、V2Flyコアが必要な場合はv2flyNGを検討してください。Android版アプリの同じ画面に、どの環境にも使える共通のコア切り替えボタンがあると考えないでください。

Project VはV2Rayのエコシステムを理解する出発点です。V2FlyはV2Rayプロジェクトを引き継いでおり、Xrayにも技術的な共通点がありますが、設定モデルは常に同じように発展してきたわけではありません。プロトコル名が同じでも、相互に置き換えられるとは限りません。サーバーが求める通信方式、セキュリティパラメーター、クライアントの対応状況をすべて満たす必要があります。たとえばサーバーがREALITYを明示的に要求する場合は、その方式に実際に対応するコアと設定方法を選んでください。サーバーアドレスとポートが同じだからといって、移行できるわけではありません。プロトコル選定の違いは、4種類のプロキシプロトコルの特徴と用途比較を参照してください。

移行時に引き継げる設定を層ごとに確認する

切り替え前に、使用中のプロトコル、通信方式、取り込みモード、実際に機能しているルーティングとDNSの動作を記録します。v2rayNでは、画面に表示される項目の種類とコア設定に応じて、対応する組み合わせを選択してください。特定の項目ごとにコアを指定できるかは、クライアントが現在使っている設定形式によります。新しい組み合わせはテスト項目で確認し、普段使う唯一の設定を直接変更しないでください。起動後はログで実際に起動したコアと、設定が正しく解析されたかを確認します。画面で選べる項目が実際の実行設定に反映されない場合は、別の種類のインバウンドや設定形式にしか適用されない項目か確認してください。

移行では、同じ用語を見て同じ設定だと思い込むのがよくあるミスです。複数のコアにルーティング、DNS、スニッフィング機能があっても、パラメーター名、選択できる値、リソース分類は異なる場合があります。まず「通信の取り込み」「通信のアウトバウンド」「振り分けルール」「DNSポリシー」の4層に分けて最小構成を作ります。入口を1つ、接続先を1つにして接続できることを確かめてから、ルールやDNSを一つずつ戻してください。別のコアのネイティブ設定を全体ごと貼り付けたり、起動させるために認識されないフィールドをすべて削除したりしないでください。既存のアウトバウンド動作を支えているフィールドを削除すると、気づかないうちに既定の経路へ切り替わることがあります。

再現可能なテストで確認し、元に戻せる状態を保つ

検証では、次の3点を確認します。クライアントが想定したコアを起動したか、テスト接続がどのアウトバウンドを通ったか、アプリが受け取った名前解決結果または実際の接続状況が想定どおりか。まず1つのアプリと既知の接続先で動作を確認し、その後、特定のルールに一致する通信と既定の経路に進む通信をテストします。UDPの取り込みや内部サービスの処理が必要な場合は、通常の接続が成功してから追加で確認してください。Webページ1つであらゆる通信を検証することはできません。結果を比較するときは、ネットワーク、端末、テストアプリをできるだけ同じにし、ネットワークの変動を切り替えの影響と誤認しないようにします。

失敗した場合は段階ごとに対処します。コアが起動しない場合は、インストールファイルとプロセッサーのアーキテクチャを確認してから初期化エラーを読みます。起動するのにハンドシェイクが失敗する場合は、プロトコルと通信パラメーターがサーバーの要件に合っているか確認します。接続は成功するのに振り分けが想定外の場合は、ルーティングとDNSの章に戻って原因を調べてください。実行環境の準備ができていない場合は、ダウンロードページのシステム要件とよくある質問を確認できます。元に戻すときは、以前の項目、ルーティング設定、通信の取り込み方式を復元し、新しいセッションで確認してください。コア名だけを戻しても不十分です。検証が終わるまでは、正常に動作していた設定の組み合わせ全体を残しておきましょう。