コア設定・フィールドリファレンス
V2Ray設定ファイルリファレンス
JSONの階層に沿ってinbounds、outbounds、ルーティング、DNS、接続ポリシーを確認し、最小構成の設定例で各項目の連携を把握します。
初めてサブスクリプションをインポートしたり、システムプロキシを設定したりする場合は、まずクイックスタートガイドをご覧ください。操作の手順はガイドで、ここではコアが実際に読み込むフィールドを解説します。ポート、outboundタグ、名前解決の結果が合わない場合は、目次から該当する項目に移動できます。
01 設定の階層
V2Ray設定ファイルのJSON構造
クライアントの保存設定とコア設定は別物
デスクトップではv2rayN、Androidでは用途に合ったコアに応じてv2rayNGまたはv2flyNGを使います。クライアントのダウンロードページをご覧ください。GUIを使う場合、サブスクリプションURL、選択中の項目、システムプロキシ、画面の設定は通常クライアントが管理します。クライアントは選択中の項目と全体設定をもとに、コア設定を生成または読み込みます。画面に表示される項目名がJSON内のタグと一致するとは限らず、クライアントのデータファイルをそのままコアに読み込ませられるとも限りません。フィールドを照合する前に、実行中のコアと、実際に読み込ませている設定ファイルを確認してください。
普段の接続でJSON全体を手書きする必要はほとんどありません。GUIでは必要な動作を設定できないと分かった場合や、原因を切り分ける場合に限り、独立した設定ファイルをコピーして編集する方法がおすすめです。クライアントが生成したファイルを直接編集すると、再接続、項目の切り替え、サブスクリプションの更新時に変更が上書きされることがあります。逆に、読み込まれていないコピーを編集しても接続には反映されません。変更の反映はファイルの保存時刻だけで判断せず、起動結果やリスニング状態、outboundなど、確認できる動作をチェックしてください。
ルートオブジェクト、オブジェクト配列、プロトコルパラメーター
ルートは1つのオブジェクトです。1つのプロセスに複数の入口と出口を設けられるため、inboundsとoutboundsはそれぞれ配列で表し、配列の各要素が具体的な受信または送信オブジェクトになります。ルーティング、名前解決、ポリシー、ログには、それぞれ独立したルートレベルのオブジェクトがあります。誤った階層に置いたフィールドは、JSONとして正しくてもコアに使われないことがあります。たとえば、リスニングポートはinboundオブジェクトの属性で、認証方式はSOCKS inboundのsettingsオブジェクトに記述します。設定画面で同じ場所に見つかるからといって、同じ階層に書かないでください。
{
"log": { "loglevel": "warning" },
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth", "udp": false }
}
],
"outbounds": [
{ "tag": "direct", "protocol": "freedom", "settings": {} }
]
}
この完全な最小構成は、ローカルのSOCKSリクエストを受け付け、宛先へ直接接続します。リモートサービスは不要です。ルーティングルールがないため、振り分けられなかったリクエストは配列の先頭にあるoutboundへ渡されます。JSONの記述順には2種類あります。同じオブジェクト内でlogとinboundsのどちらを先に書いても動作は変わりませんが、配列には順序が関係する場合があり、特にデフォルトoutboundの位置とルールの並び順は重要です。設定をコピーするときは外側の構造を保ち、必要な項目を該当する配列に追加してください。ルートオブジェクトを2つ丸ごと連結してはいけません。
| フィールド | 型 | 役割 |
|---|---|---|
inbounds | オブジェクトの配列 | 接続を受け付け、入口に名前を付ける |
outbounds | オブジェクトの配列 | 接続先への処理または破棄動作を定義する |
routing | オブジェクト | 使用するoutboundを選択し、内部にルール配列を持つ |
dns | オブジェクト | コアが行うドメイン名の名前解決を設定する |
policy | オブジェクト | 接続の制限時間と統計機能を設定する |
log | オブジェクト | ログレベルと出力を制御する |
まず構文を確認し、次にフィールド間の関係を確認
標準JSONとして保存するときは、キー名と文字列を半角の二重引用符で囲み、コメントや末尾のカンマを付けないでください。ポートは数値、認証方式は文字列、スイッチは引用符なしのtrueまたはfalseで記述します。同じオブジェクト内で同じキーを重複させないでください。読み込み側によっては最後の値が採用され、設定を追加したつもりが既存のルールを丸ごと上書きすることがあります。エラー位置が次の行を指している場合も、直前の項目のカンマ漏れや、配列を早く閉じすぎていないか確認してください。
構文チェックに通るのは、ファイルを構造化データとして読み込めるという意味にすぎません。続けて、プロトコルとsettingsの組み合わせ、ルールが参照するタグの存在、設定内で参照したファイルが実行環境から読み取れることの3点を確認します。その後に、ポートを確保できるか、接続先に到達できるかといった実行時の問題を調べます。未知のフィールドに対する扱いはコアによって異なり、明確なエラーが出ないこともあります。この記事では複数のコアに共通する基本構造を解説します。特定のコア向けの拡張フィールドは、実際に設定を読み込むコアの対応状況を確認してください。
02 接続を受け付ける
inbounds:リッスンアドレス、ポート、受信プロトコル
リッスンアドレスで接続可能な範囲が決まる
ローカルで使う場合は、入口を同じネットワーク内の他の機器に公開しないよう、listenに127.0.0.1を明示してください。アプリが接続するのはコアを実行している端末です。スマートフォンでこのアドレスを指定すると、デスクトップPCではなくスマートフォン自身を指します。このIPv4ループバックアドレスだけでリッスンしている場合、IPv6のループバックアドレスでアクセスしても同じリスナーには接続できません。クライアント画面のプロキシアドレスを調べる際は、localhostの名前解決を別の変数にしないよう、まず明示的なアドレスを使ってください。
portはコアが実際に接続を待ち受けるローカルポートであり、サブスクリプション内のサーバーポートではありません。リッスンアドレスとポートの組み合わせはOSのバインド規則に従います。すでに別のプロセスが使用していると、新しいinboundの起動に失敗することがあります。また、すべてのIPv4インターフェースでリッスンする設定は、特定のアドレスでのリッスンと競合する場合があります。ポートを変更する場合は、アプリやシステムプロキシに設定したポートも変更してください。片方だけを変えると、クライアントは正常に動作しているように見えても、アプリは古い入口に接続し続けたり、古いポートを使う別のプログラムに誤接続したりすることがあります。
{
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": false
}
}
]
}
ルーティングより先にプロトコルが一致している必要がある
この例ではSOCKS inboundを使うため、アプリ側でSOCKS5プロキシを選択してください。ブラウザーがWebページを要求するからといって、プロキシとのハンドシェイクにHTTPを使うわけではありません。HTTPプロキシしか設定できないアプリでは、専用のHTTP inboundまたはクライアントが生成する適切な入口を使い、実際の設定に合わせてポートを指定してください。SOCKSポートにHTTPプロキシのリクエストを送ると、ポートには接続できても、コアはinboundプロトコルに従ってリクエストの宛先を読み取れません。そのため、後続のルーティングルールにも到達しません。ポートの疎通確認だけで、ルーティング段階まで処理されたと判断しないでください。
authがnoauthの場合、アカウント認証は不要です。この例のようにループバックアドレスに限定したテストに適しています。udpがfalseの場合、この入口はSOCKSのUDP転送を提供しません。有効にしても、アプリがSOCKS5のUDP ASSOCIATEに対応し、後続のoutboundもそのトラフィックを処理できる必要があります。Webページが開けても、リアルタイム通信などUDPに依存するアプリが同じ入口を使えるとは限りません。問題のあるアプリ、プロキシプロトコル、実際の通信方式をそれぞれ確認してください。
入口タグ、宛先アドレス、スニッフィングは別の設定
tagは入口に名前を付けるフィールドです。ルーティングではinboundTagを使い、どのリスナーから来たリクエストかを判別できます。たとえば、2つのローカル入口に別々の名前を付ければ、テスト用アプリのルールだけをテスト用入口に適用し、普段使う入口には影響させずに済みます。アプリのプロキシプロトコルを変えてもinboundタグは変わりません。名前を変更した場合は、ルーティング側の参照も合わせて変更してください。2つの入口で動作が異なるときは、まずアプリがどちらのポートに接続しているかを確認し、関連するルール条件にもう一方の入口名が書かれていないか照合します。
ドメイン名がinboundリクエストと一緒に届くとは限りません。アプリがドメイン名をコアに渡すこともあれば、ローカルで先に名前解決し、IPアドレスだけを渡すこともあります。sniffingを有効にすると、HTTPリクエストのホスト名や一部のTLSハンドシェイクに含まれるサーバー名など、対応する通信からコアがドメイン名を識別できる場合があります。ただし、すべての接続を識別できるわけではなく、アプリの通信を復号する機能でもありません。設定によっては、識別結果をルーティングに使うだけの場合と、実際の宛先を書き換える場合も区別されます。動作を確認するには、まずドメイン名を明示的に渡せるアプリで試し、基本的な振り分けができてからスニッフィングを検討してください。
03 接続を開始する
outbounds:送信プロトコル、タグ、デフォルトの出口
タグは参照用の名前、動作を決めるのはプロトコル
outboundsはリクエストをどの処理先に渡すかを定義します。ある項目にdirectと名前を付けるのは人が読みやすくするためで、実際に直接接続するのはfreedomです。同様に、遮断用の項目は通常blockと名付け、実際の処理にはblackholeを使います。名前を付けただけではoutboundの動作は変わりません。設定をコピーする際にルーティングルールだけをコピーし、同名のoutboundをコピーし忘れると、参照先が不足します。逆に遮断用outboundを定義しても、ルールから選択されなければ、特定のリクエストが自動的に遮断されることはありません。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {
"response": { "type": "none" }
}
}
]
}
このようにデフォルトの出口を別途指定しない一般的な設定では、どのルールにも一致しないリクエストは配列の先頭にあるoutboundへ送られます。遮断用outboundを先頭に移すと、ルールを1つも変えなくても、ルールに一致しないすべての通信の結果が変わります。デフォルト項目と明示的なフォールバックルールは別物です。前者はどのルールにも一致しない場合に使われますが、後者を広い条件で書くと、後続のより具体的なルールを先に捕捉してしまうことがあります。設定を確認するときは、未分類の宛先をどの出口に通したいかを決めたうえで、配列の先頭に任せるか、末尾に汎用ルールを明示するかを選んでください。
リモートサービスの設定はプロトコルとトランスポートの2層
リモート向けoutboundには通常、プロトコル設定と接続設定の両方が関わります。protocolでコアが使うプロトコルを選び、settingsにそのプロトコルに応じたリモートアドレス、サーバーポート、認証情報を記述します。streamSettingsでは接続に使うトランスポートとセキュリティ層を設定します。どちらもリモート側の設定と一致させる必要があります。別の項目からトランスポート設定だけを移すと、プロトコル上の認証情報は正しくても、パスやハンドシェイク条件が合わないことがあります。原因を調べるときはフィールドの階層ごとに照合し、ハンドシェイク失敗をすべてサブスクリプション更新の問題と決めつけないでください。
「アドレス」に見えるフィールドが複数ある場合は、それぞれがどの段階で使われるかを確認してください。リモート接続には接続先アドレスが必要です。セキュリティハンドシェイクでサーバー名が別途必要になる場合や、トランスポートごとに専用のパスやホスト名が必要な場合もあります。同じ値を使うサービスもありますが、相互に置き換えられる同義フィールドではありません。接続先ドメインをIPアドレスに変えても、ほかの名前まで変更すべきとは限りません。ノード単体の設定が共有リンクでどう渡されるかは、共有リンクとサブスクリプションURLの違いをご覧ください。リンク全体をJSONのアドレスフィールドに貼り付けないでください。
「ルールに一致した」と「outboundが接続できた」を区別する
ルーティングで一致したのは処理先が選択されたということであり、接続が確立できる保証ではありません。直接接続に失敗した場合は、ローカルで宛先を名前解決できるか、宛先までのネットワーク経路があるか、接続先ポートが利用可能かを確認します。リモート向けoutboundが失敗する場合は、リモートアドレスに接続できるか、プロトコルのハンドシェイクを完了できるかを切り分けたうえで、すべての宛先で失敗するのか、特定の宛先だけ失敗するのかを確認してください。遮断はリクエストを転送しないための意図的な処理です。例のnoneは説明ページを表示しないので、アプリに接続失敗と表示されても不思議ではありません。
「別のノードを選んだのに直接接続のように見える」場合も、Webページが開くかどうかだけで判断しないでください。同じページが直接接続でもリモート転送でも読み込まれることがあります。また、既存の長時間接続は切り替え後もしばらく残る場合があります。新しいリクエストが指定したinboundに入ったことを確認し、ログや比較テストでoutboundの選択を調べるのが確実です。両方のoutboundで失敗する場合は、最小構成で直接接続用outboundだけを残してみてください。アプリからローカル入口までの区間と、リモートサービスに依存する経路を切り分けて確認できます。
04 ルールで振り分ける
routing:ルールの順序、宛先の種類、outboundの参照
上から順に確認し、最初に一致したルールで処理する
routing.rulesは順番に処理するリストであり、候補ルールを採点する一覧ではありません。条件の広いルールを先に書くと、後にある具体的な条件が使われないことがあります。たとえば、テスト用入口からのすべてのリクエストを直接接続するルールの後に、同じ入口から特定ドメインへの通信を遮断するルールを書くと、前のルールが先に一致し、ドメインのルールまで到達しません。この問題を調べるときは、期待するルールだけを見るのではなく、先頭から順に「この条件にすでに一致していないか」を確認してください。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-socks"],
"domain": ["full:example.org"],
"outboundTag": "block"
},
{
"type": "field",
"inboundTag": ["local-socks"],
"outboundTag": "direct"
}
]
}
}
1つ目のルールでは、リクエストがlocal-socksから来ていることと、宛先の完全一致ドメインがexample.orgであることの両方を条件にしています。異なる条件フィールドはすべて満たす必要があります。一方、同じリスト内の候補は通常いずれか1つが一致すればよく、たとえばドメインリストにあるパターンのどれかが一致すれば対象になります。「ドメイン条件または宛先IP範囲に一致」のような動作にする場合は、通常はルールを2つに分けます。domainとipを同じオブジェクトに書けば「OR」になるとは限りません。複数ルールを統合した結果、かえって一致しにくくなるのはこのためです。
ドメインルールはWebページのパスには一致しない
完全一致のドメインにはfull:、そのドメインとサブドメインにはdomain:を使います。前者はサブドメインを含まず、後者もURL全体から任意の部分文字列を検索するものではありません。設定にはホスト名を記述し、URLのスキーム、パス、クエリパラメーター、ページ内アンカーは含めません。Webページへのアクセスで、別ドメインへリダイレクトされたり、さらに別のドメインから静的ファイルが読み込まれたりすることがあります。ページの一部が表示されても、すべてのリクエストが同じルールに一致したとは限りません。テストではまずホスト名を1つに絞り、失敗しているのがメインのドキュメントか後続リソースかを確認してください。
IPルールは宛先アドレスに一致し、単一のアドレスまたはCIDR形式のネットワーク範囲を指定できます。ポート条件は接続先ポートを対象とし、ローカルのSOCKSリッスンポートではありません。アプリがIPアドレスを渡す場合、コアが通信から利用可能なドメイン名を識別できない限り、通常はドメイン項目に一致しません。逆にアプリがドメイン名を渡す場合、ルーティング段階でIPルール用に名前解決するかどうかは、ルーティング側のdomainStrategyによります。ルーティングで一致するアドレスが見つからないことと、outboundが名前解決を終えたあと接続に失敗したことを混同しないでください。
ドメイン変換ポリシーとルールデータベース
ルーティングのAsIsは、IPルールに一致させるための追加の名前解決を行いません。IPIfNonMatchは最初の検索で一致しなかった場合に名前解決して再検索します。そのため、最初に一致する広範なフォールバックルールがあると、名前解決の機会がなくなることがあります。IPOnDemandでは、IP条件との照合に必要なときにルーティングが名前解決を実行できます。まず、ドメイン名から得られるアドレスを使って本当に照合する必要があるかを確認してから、方式を選んでください。ホスト名だけで振り分ける場合は、余分な問い合わせとその失敗要因を増やす必要はありません。
geosite:とgeoip:は、実際に読み込まれているリソースファイルと分類名に依存します。同じ分類名でも内容は固定ではなく、特定のドメインやネットワーク範囲が含まれるかどうかは、使用中のリソースによります。リソースが見つからない、分類が存在しないというエラーと、正常に読み込まれたリソースに特定のアドレスが登録されていない状態は、別の問題です。まず明確なドメイン名や、含まれていると分かっている小さなネットワーク範囲でルールの動作を確認してから、分類を使ってください。同じテストで失敗すれば、問題をルールデータベースや更新結果に絞り込めます。
05 ドメイン名を解決する
dns:組み込みリゾルバー、静的マッピング、問い合わせ元
まず、どこで名前解決されているかを確認する
アプリが自分でドメイン名を解決してからIPアドレスをinboundに渡す場合もあれば、プロキシリクエストの一部としてドメイン名をコアに渡す場合もあります。後者でも、コアが名前解決をリモート側に任せたり、ルーティングの照合や直接接続の際に自ら解決したりすることがあります。トップレベルのdns設定が制御するのは、コアのリゾルバーを使う問い合わせです。アプリやOSが行うすべての問い合わせを自動的に引き受けるわけではありません。ブラウザーが独自の名前解決方式を使うと、OSの問い合わせツールとブラウザーの結果が異なる場合もあります。どちらも、それだけではコアがどの設定を使ったかを証明できません。
まず接続ごとに経路を整理します。アプリが渡した宛先はドメイン名かIPアドレスか、ルーティングがIP条件との照合のために名前解決するか、最後にoutboundが自分で名前解決するか、宛先をリモート側に渡すかを確認してください。複数の段階で同じドメイン名を問い合わせる場合も、どの段階でも問い合わせない場合もあります。たとえば、アプリがIPアドレスをコアに渡し、直接接続のoutboundがそのアドレスに接続するだけなら、元のドメイン名への静的マッピングを追加しても通常は結果が変わりません。マッピングを確認するには、リクエストでドメイン名を維持し、選択したoutboundが実際にコアのリゾルバーを使う必要があります。
{
"dns": {
"hosts": {
"sample.test": "127.0.0.1"
},
"servers": ["localhost"]
},
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": { "domainStrategy": "UseIP" }
}
]
}
hosts、servers、outboundのdomainStrategyを理解する
この例のhostsはテスト用ドメインをループバックアドレスに割り当てます。このDNS設定を使うコアにのみ適用されます。servers内のlocalhostはローカルシステムの名前解決機能を使うという意味で、ループバックアドレス上にDNSサーバーを立ち上げるという意味ではありません。DNSサーバーとして文字列のアドレス127.0.0.1を指定するのは、この特別な値を使うのとは別の設定です。指定したアドレスとポートで応答するサービスが実際に必要になります。静的マッピングが返すのはアドレスだけで、アプリのプロトコルハンドシェイクを代行したり、対象ドメインの証明書を提供したりはしません。
freedom.settings.domainStrategyは、直接接続outboundがドメイン名の宛先をどう扱うかを制御します。routing.domainStrategyとは役割が異なります。この例ではUseIPを指定し、直接接続outboundが名前解決してから接続を試みます。ルーティングのポリシーだけを変更しても、最終的な接続でどのアドレスが使われたかは分かりません。動作確認では、ループバックアドレスで待ち受けることが分かっているローカルHTTPサービスを用意し、ドメイン名を渡せるSOCKSアプリから、テスト用ドメインとサービスの実際のポートにアクセスします。リクエストのホスト名でサイトを振り分けるサービスの場合は、そのテスト用ホスト名を受け付けるかも確認してください。
上流の設定にはシンプルなサーバー項目を使えます。コアによっては、オブジェクトを使って特定のドメイン範囲をサーバーごとに割り当てることもできます。ドメインごとに上流を振り分ける場合、優先的にどの項目が使われるかと、失敗時にフォールバックするかどうかは別の問題です。空の応答、問い合わせのタイムアウト、想定外のアドレスが返るケースも区別してください。複数の問い合わせ方式を一度に有効にすると、症状からは結果に異常があることしか分からず、どの上流が原因か判断しにくくなります。まず動作が分かっている名前解決経路を1つだけ残し、ドメイン範囲やフォールバック条件を順に追加して確認すると、原因を特定しやすくなります。
アドレスファミリー、キャッシュ、FakeDNS
同じドメイン名にIPv4とIPv6のアドレスがあり、現在のネットワークが両方のアドレスファミリーに接続できるとは限りません。まず名前解決結果と実際の接続先アドレスを照合し、問い合わせやoutboundで使用するアドレスの種類を制限する必要があるか判断してください。一方の問い合わせ結果を抑制しても、そのアドレスファミリー自体の接続性は改善しません。静的レコードを変更しても、アプリ、OS、コア、上流のいずれかにキャッシュされた古いアドレスが表示されることがあります。確認には新しい接続を使い、どの層のキャッシュを更新したかを明確にしてください。Webページを何度も再読み込みするだけでは不十分です。
FakeDNSが返すのは、プロキシ処理で識別するための仮想アドレスです。同じ経路上のコアが対応するドメイン名を復元する必要があり、実アドレスのキャッシュを汎用的に置き換えるものではありません。アプリが仮想アドレスを取得したあとコアを経由しなくなった場合や、アドレスとの対応情報が失われた場合、後続の接続で元のドメイン名を使うのは困難になります。通常のSOCKS設定例でFakeDNSを有効にする必要はありません。透過プロキシでアドレスがどのように引き渡されるかを調べる場合は、FakeDNSの仕組みと利用ケースをご覧ください。まず通常の名前解決を確認しておけば、仮想アドレスを使う段階を比較しながら調べられます。
06 接続を管理する
policy:接続タイムアウト、ユーザーレベル、統計スイッチ
レベルはポリシー参照用であり、権限の順序ではない
policy.levelsは、ユーザーレベルに一連のパラメーターを割り当てます。JSONオブジェクトのレベルキーは"0"のような文字列ですが、プロトコル設定でユーザーレベルを指定するフィールドには通常、数値を記述します。レベルはプラン名ではなく、数字が大きいほど権限が高いという意味でもありません。どの接続にどのレベルが適用されるかは、該当するinboundプロトコルとユーザーレベルのフィールドによって決まります。最初の調査ではデフォルトレベルから確認してください。実際にはどこからも参照されていない新しいレベルをpolicyに追加し、ポリシーが反映されないと思い込まないようにしましょう。
{
"policy": {
"levels": {
"0": {
"handshake": 8,
"connIdle": 300,
"uplinkOnly": 3,
"downlinkOnly": 10
}
},
"system": {
"statsInboundUplink": true,
"statsInboundDownlink": true
}
},
"stats": {}
}
これはルートオブジェクトに追加する設定断片であり、単独で起動する設定ファイルではありません。値はフィールドの意味を示すためのもので、すべてのネットワークに共通する推奨値ではありません。ポリシーはルーティングのoutbound選択を代行せず、inboundのリッスン範囲も変更しません。入口への接続拒否や特定項目の接続失敗が起きたら、まず問題が発生した段階を確認してください。ハンドシェイクが始まっていない場合、セッションタイムアウトを追加しても手がかりになりません。逆に、毎回ハンドシェイクは完了し、接続が一定時間アイドルになった後だけ切断される場合は、ポリシー設定との比較が有効です。
4種類のタイムアウトが制限する段階
handshakeの単位は秒で、inboundプロトコルのハンドシェイク完了を待つ時間です。すべてのネットワーク処理に共通するタイマーではありません。ブラウザーが最初のデータを待つ時間とも、リモートサービスとの接続確立にかかる上限とも異なります。この項目を調べる際は、クライアントがポートに接続したあとハンドシェイクを送信し終えないケースと、ハンドシェイク完了後に相手からデータが返らないケースを区別してください。アプリ画面の「接続タイムアウト」という表示だけでは、inboundのハンドシェイク時間を変更すべきか、さらに後段の接続パラメーターを変更すべきか判断できません。
connIdleが測るのは接続のデータ通信がない時間であり、接続開始からの固定寿命ではありません。データを継続的に送受信している接続が、この秒数に達しただけでアイドル扱いになるわけではありません。uplinkOnlyとdownlinkOnlyは、一方が終了したあとにもう一方が通信を続ける段階に適用されます。上りだけ、または下りだけが残った場合に、それぞれ使われます。アプリが送信方向を早く閉じるか、長い応答を引き続き受信する必要があるかを確認してから、該当する制限時間が適切か判断してください。
アイドル時間を短くすると、長時間使われていない接続を早く解放できますが、たまにしかデータが流れないセッションで再接続が必要になることがあります。時間を長くすると、一時的に不要な接続がより長く残ります。切断周期が設定値に近くても、アプリ、リモート側、中継ネットワーク機器にも独自のタイムアウトがあるため、手がかりの1つにすぎません。継続的に通信している場合、完全なアイドル状態、一方向の通信が終了した場合の3つに分けて確認してください。ほかの設定を保ったまま、現象に関係する項目だけを変更すれば、コアのポリシーと経路上の別の機器のどちらが先に接続を終了したか判断しやすくなります。
統計スイッチだけでは画面にレポートは表示されない
この例ではトップレベルのstatsで統計機能を有効にし、policy.systemの2つのスイッチでinboundごとの上りと下りを記録します。識別が必要なinboundには、変更しないタグを設定してください。タグを変更した場合は、読み取り側でも新しい名前を参照する必要があります。ユーザー単位の統計に関するスイッチもありますが、ユーザーと関連付けられるかはプロトコルが提供するユーザー識別情報によります。システムレベルのinboundカウントを、個々のアプリやサブスクリプション項目の使用量と同一視しないでください。2台の機器が同じリスナーを使う場合、その入口のカウントには両方からのリクエストが含まれることがあります。
統計スイッチは、コアに関連する指標を記録させる設定です。数値を確認できるかどうかは、クライアントが統計情報の読み取りに対応しているか、どの実行インスタンスから読み取るかによります。読み取り手段がなければ、スイッチを有効にしても設定ファイルにレポートが書き出されることはありません。再起動後も、旧プロセスのカウントが新しいプロセスに自動的に引き継がれるわけではありません。確認するときは、単一の入口から識別しやすい量の通信を流し、同じインスタンスのカウント変化を見てください。カウント確認のために管理インターフェースを他の機器へ公開するのは避けましょう。
07 設定を組み合わせて確認する
設定例:ローカルSOCKS、直接接続、単一ドメインの遮断
テスト専用の設定で試す
以下の設定にはリモートoutboundがなく、サブスクリプションやアカウントも必要ありません。ローカルからのみアクセスできるSOCKS inboundと、完全一致ドメインを遮断するルールを1つ設定し、それ以外のリクエストは配列先頭の直接接続に渡します。直接接続outboundは組み込みリゾルバーにドメイン名の解決を依頼し、リゾルバーはローカルシステムを使って結果を取得します。この構成では、ルールデータベース、スニッフィング、リモート接続を意図的に使っていません。アプリのプロキシ種類を正しく選ぶだけで、inbound、宛先の形式、outboundの参照に絞って最初のテストができます。サブスクリプションを通常どおりインポートする場合は、サブスクリプションのインポートガイドをご覧ください。
開始前に、現在使えているクライアント設定を残し、カスタム設定を読み込めるテスト環境で専用ファイルを選択してください。実行中のコアがこの形式の完全なJSONを読み込めることと、例のポートをクライアントがすでに使っていないことを確認します。ポートを変更する場合は、例のinboundポートとテストアプリのプロキシポートを両方置き換えてください。ドメイン一致条件にポートを書いてはいけません。テスト対象は1つのアプリのプロキシ設定だけにし、端末全体の通信を対象にする必要はありません。テスト後はそのアプリの設定を戻すだけで済み、観測したリクエストの発生元も特定しやすくなります。
{
"log": {
"loglevel": "warning"
},
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": false
}
}
],
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {
"domainStrategy": "UseIP"
}
},
{
"tag": "block",
"protocol": "blackhole",
"settings": {
"response": { "type": "none" }
}
}
],
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-socks"],
"domain": ["full:example.org"],
"outboundTag": "block"
}
]
},
"dns": {
"servers": ["localhost"]
},
"policy": {
"levels": {
"0": { "connIdle": 300 }
}
}
}
Webページが開くかだけでなく、確認できる動作を基準にする
まず起動に成功しているか確認してください。設定の読み込みやポートのリッスンに失敗しているなら、ブラウザーで何度も試す必要はありません。起動後、テストアプリでSOCKS5を明示的に設定し、アドレスとポートにはローカルのリッスン値を指定します。ドメイン名をプロキシ経由で送る方式を選んでください。ローカルから直接接続できることを確認済みのテスト用ホストにアクセスしたあと、別の接続でexample.orgにアクセスします。前者は直接接続、後者は遮断されるのが想定結果です。前者が成功するかはローカル環境と接続先に到達できるかによります。もともと接続できない宛先を、成功確認用に使わないでください。
遮断の確認には比較対象が必要です。唯一のルールを一時的に外し、rulesを空の配列にして再読み込みし、テスト対象のドメインに元々アクセスできることを確認します。その後ルールを戻し、新しいリクエストを送ってください。ルールがあるときは失敗し、外すと成功した場合に初めて、そのルールが結果に関係していると判断できます。どちらの状態でも失敗するなら、遮断に成功した証拠にはなりません。どちらの状態でも成功する場合は、リクエストがこの入口を通っていない、アプリが先にドメイン名をIPアドレスへ変換した、または設定変更前の接続を使っている可能性を優先して調べてください。
逆方向からの確認も行います。同じ入口から、遮断対象とは異なる、接続できることが分かっているホストにアクセスし、ルールの削除と復元がそのホストに同じ影響を与えないことを確認してください。こうすることで、「ローカルプロキシの設定ミスですべてのリクエストが失敗した」場合と、「ルールが1つの宛先だけを遮断した」場合を区別できます。宛先とinboundを同時に記録できるログも役立ちますが、記録形式はコアやクライアントによって異なります。重要なのは、現在の新しいリクエスト、宛先の形式、選択されたoutboundを照合することです。ログの文面を解説記事のスクリーンショットと一字一句同じにする必要はありません。
設定を拡張するときは、切り戻せる基準構成を残す
リモートoutboundを追加する場合は、まず現在の直接接続outboundを先頭に残し、遮断ルールも維持したまま、新しいoutboundだけを後ろに追加します。次に、接続先が分かっている宛先に限るルールを追加し、新しいoutboundを指定します。読み込みに成功したら、従来の宛先と新しい宛先をそれぞれ確認してください。従来の動作が変わっていなければ、今回の追加でデフォルト経路を誤って変更していないことが分かります。この例を普段使うクライアント設定に反映する場合、既存のoutbound配列やDNSオブジェクトを丸ごと置き換えないでください。項目ごとに統合し、参照関係を確認します。特に、新しく付けたタグが既存オブジェクトの名前と重複していないことを確認してください。
08 トラブルシューティングとメンテナンス
V2Ray設定のトラブルシューティング:読み込みから宛先接続まで段階的に確認
起動できない場合:読み込み、検証、バインドのどこで失敗したかを切り分ける
まったく起動できない場合は、最初のエラーを記録してください。構文エラーの位置が表示されたら、括弧やカンマ、コピーした全角記号を確認します。フィールド型やプロトコル名のエラーなら、フィールドの階層と選択中のコアを確認してください。アドレスをバインドできないエラーなら、ローカルインターフェースとポートの使用状況を調べます。3種類のエラーでは対処方法が異なります。クライアントに概要だけの起動失敗が表示される場合は、クライアントのコアログで最初に失敗した箇所を探してください。その後に続く接続エラーは、入口が起動していないために発生している可能性があります。最初のエラーと同列に扱う必要はありません。
同じファイルが別の環境では読み込める場合、まず同じ形式の設定を比較しているか確認してください。一方のクライアントでは項目としてインポートし、もう一方ではJSON全体を直接読み込んでいる可能性があります。ルールデータベースのパス、ログの保存先、ポートの使用可否も実行環境によって異なります。相対パスの基準位置は設定ファイルのあるディレクトリとは限りません。ファイルマネージャーで2つのファイルが同じ場所にあるように見えても、読み込み可能とは限りません。まず外部リソースを参照しない設定で起動を確認し、その後ファイル参照を1つずつ戻してください。すべてのパスを新しいディレクトリにまとめてコピーするより、違いを特定しやすくなります。
起動するのに期待どおり動かない場合:最初に期待から外れた段階を探す
| 症状 | まず確認する項目 | 次に行うこと |
|---|---|---|
| アプリがローカルプロキシに接続できない | リッスンアドレスとポート | プロセスの起動とアドレスファミリーの一致を確認 |
| ハンドシェイクに失敗する | アプリのプロキシプロトコル | inboundのプロトコルと認証方式を確認 |
| 意図しないoutboundに一致する | 宛先の形式とルールの順序 | inboundの条件、タグ、デフォルト項目を確認 |
| outboundは正しいが接続できない | 名前解決とoutboundの接続処理 | アドレスに到達できない状態とリモートのハンドシェイク失敗を区別 |
| アイドル状態になった後だけ切断する | 接続段階と継続時間 | アプリ、ポリシー、リモート側のタイムアウトを比較 |
「すべてのアプリが使えない」と「1つのアプリだけ使えない」を区別するのは有効です。リクエストが一切inboundに届かない場合は、システムプロキシやテストアプリ独自の設定を優先して確認してください。システムプロキシを参照しないアプリもあります。1つのアプリだけ失敗する場合は、プロキシにドメイン名を渡しているか、別の通信方式を使っていないか、既存の接続を再利用していないかを確認します。ドメインルールを検証するために、端末のプロキシモード、アプリの名前解決方式、コアのルーティングポリシーを同時に切り替えないでください。元に戻して正常になっても、どの変更が効いたのか分からなくなります。
入口にリクエストが届き、ルールも想定したoutboundを選んでいるなら、次に確認するのはルーティングの並べ替えではありません。直接接続とリモート接続の両方を使い、ローカルの名前解決、リモートアドレスへの到達、outboundのハンドシェイク中断、宛先サービスへの接続のどこで失敗しているかをそれぞれ調べてください。ある宛先に接続できても、他の宛先にも接続できるとは限りません。比較ではテストアプリと宛先を同じに保ち、設定を1つ変更したら新しいリクエストを送ります。断続的な障害では、発生前後の時刻と、ネットワーク切り替えやスリープを経たかを記録すると、設定の問題と一時的な経路変動を切り分けやすくなります。
一時的なログと小さな変更で調査の手がかりを残す
{
"log": {
"loglevel": "info"
}
}
手がかりが必要な場合は、設定断片のloglevelを既存のlogオブジェクトに統合し、短時間だけログの詳細度を上げます。クライアントがログの表示先やフィルタリングを別に制御することもあります。画面にログが表示されないからといって、コアがリクエストを受け取っていないとは限りません。操作を1つだけ再現して時刻を記録し、想定したインスタンスのログに記録されているか確認してください。調査後は通常のログレベルに戻します。診断情報を共有する前に、サブスクリプションURL、認証情報、個人と関連付けられる宛先の記録を削除し、設定全体をそのまま転送しないでください。
日常のメンテナンス用に、用途の異なるコピーを2つ残しておくと便利です。1つは起動できることを確認済みの最小構成、もう1つは直近で動作確認した実際の設定です。クライアントの更新やコアの切り替え後は、まず普段使う設定で決まったinboundとルーティングのテストを行い、新機能はその後に有効にしてください。問題が再発したら、最小構成で基本的な設定が動作するか確認し、DNS、ルーティング、リモートoutboundを元の設定から順に追加します。最後に、クライアントが生成する項目、外部リソースに由来する項目、手動で管理する項目を記録しておきます。次回の上書きや移行時に、どの設定を残すべきか判断しやすくなります。