設定ファイルリファレンス

V2Ray JSON設定ガイド

インストール、インポート、初回接続がまだの場合は、まずクイックスタートガイドを読み、GUIでの手順を確認してください。スイッチがどのフィールドを生成するのか知りたい場合や、接続がどの段階で失敗しているか調べたい場合は、このガイドに戻ってください。ここではローカルリスニング、直接接続、ブロックを例に、クライアントからコアに渡される設定を段階ごとに解説します。

JSONの構造:入口から出口まで

設定のルートはオブジェクトです。コアの起動時に読み込む接続ガイドのようなもので、クライアント画面の設定をそのまま写したものではありません。inbounds と outbounds は配列で、1つのプロセスに複数の入口と出口を登録できます。routing、dns、policy はそれぞれ役割の異なるオブジェクトです。クライアントに保存されたサブスクリプション名、画面表示の設定、過去の速度測定結果は、この設定ファイルには含まれません。設定をエクスポートする前に、クライアント設定、単一ノード、コアに渡す起動時の完全な設定ファイルのどれを出力するのか確認してください。

完全な基本設定と部分的なサンプルの違い

以下はローカルで使う完全な基本設定です。アプリからのSOCKSリクエストをループバックアドレスで受け取り、コアは freedom outboundで接続先へ直接アクセスします。リモートノードの設定ではないため、サーバーアドレスやアカウントは不要です。クライアントが対応するカスタム設定の読み込み機能を使ってコピーを読み込んでください。同じポートを使用中のプロセスがある場合は終了するか、コピー内のポートを空いている番号に変更し、テストアプリのプロキシアドレスも合わせて変更します。以降のコード例の多くは一部のフィールドだけを示しているため、このファイルの末尾に順番に貼り付けないでください。

{
  "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": {}
    }
  ]
}

確認したい点は3つあります。まず、port は数値、udp は真偽値です。見た目をそろえるために両方を引用符で囲んではいけません。次に、inboundとoutboundにはどちらも protocol と settings がありますが、settingsの解釈は各プロトコルによって異なります。SOCKS inboundの認証フィールドを直接接続用outboundに移すことはできません。最後に、tag は設定ファイル内の識別子です。名前は自由に決められますが、後から参照するときは完全に一致させる必要があります。direct を別の名前に変えても直接接続の動作は変わりませんが、古い名前を参照するルールは機能しなくなる可能性があります。

確認する順番とフィールドの並び順は別

トラブルシューティングでは、まず接続の流れを追います。アプリがリクエストをどのinboundに渡すのか、コアがどの接続先情報を得られるのか、ルールに従ってどのoutboundが選ばれるのか、そしてoutboundが自身のプロトコルと名前解決方法で次の接続を確立するのかを確認します。DNSがすべての接続の途中に必ず入るわけではありません。リクエストに最初からIPアドレスが含まれていれば、コアがDNS問い合わせを行わないことがあります。アプリがローカルで名前解決してからSOCKSに渡す場合、コアは元のドメイン名を認識できないこともあります。接続ポリシーは一部の段階での待機や統計を制御するもので、ルーティングは行いません。

ルートオブジェクトでは、通常フィールドの記述順を変えても意味は変わりません。たとえばログの設定をファイル末尾に移動しても、ログの対象となる接続は変わりません。一方、配列内の順序は結果に影響する場合があります。ルーティングルールは上から順に照合され、デフォルトoutboundはoutbounds配列の先頭項目になります。設定を統合するときは、オブジェクトと配列を分けて扱ってください。ルートに既存の outbounds がある場合は、その配列を編集し、同じ名前のキーを追加しないでください。多くのパーサーは重複キーをエラーにせず後の値を採用するため、起動後に元のoutboundが消えることがあります。

クライアントとコア、どちらを変更するか見極める

デスクトップクライアントには v2rayN をおすすめします。OSとプロセッサアーキテクチャに合ったパッケージをクライアントのダウンロードページから選んでください。Androidでは、必要なコアに応じてv2rayNGまたはv2flyNGを選びます。GUIクライアントの標準テンプレートは、ノード切り替え、サービス再起動、サブスクリプション更新の際に設定ファイルを再生成することがあります。一時ファイルを直接編集してその場で反映されても、変更が保存されたとは限りません。現在使っているのがGUI設定かカスタム設定かを確認し、その方法で保存した後、再度開くかエクスポートして反映を確かめてください。

変更前に、元の状態に戻せるコピーを保存し、クライアントが選択しているコアを記録してください。同じ名前のフィールドでも、コアや設定の種類によって利用できる項目が異なることがあります。別の環境からコピーした設定をテキストエディターで開けても、現在のコアが受け付けるとは限りません。正しいJSONでは二重引用符を使い、コメント、末尾のカンマ、単一引用符には頼らないでください。まず構文、次にフィールドの型とローカルリスニング、最後に実際のリクエストを確認します。これにより、ファイルを読み込めない、サービスが起動しない、接続動作が想定と異なる、といった問題を切り分けられます。

inbounds:リスニングアドレス、ポート、プロトコル

inboundは、コアが接続を受け付ける方法を定義するもので、リモートサーバーの場所を示すものではありません。inboundが使えるか判断するには、リスニングアドレス、ポート、プロトコルを確認する必要があります。クライアント画面に「接続済み」と表示されても、アプリ側との設定が一致しているとは限りません。アプリが古いプロキシポートを使っている場合や、HTTPプロキシのアドレスにSOCKSのハンドシェイクを送っている場合があります。まずOSからそのポートへ接続できるかを確認し、次にコアが想定どおりのプロキシリクエストを受け取っているかを見ます。

SOCKSとHTTPの入口をそれぞれ用意する

以下のスニペットは、基本設定の inbounds 配列と置き換えて使えます。2種類のプロキシに別々のポートを割り当てることで、アプリが実際にどちらの入口を使っているか確認しやすくなります。local-socks はSOCKS対応アプリ用、local-http はHTTPプロキシ対応アプリ用です。どちらも同じoutboundを使うことも、inboundのタグを使ってルーティングで別々に処理することもできます。ポート番号自体にプロトコルの意味はありません。ハンドシェイク形式を決めるのは protocol です。

{
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": false,
        "userLevel": 0
      }
    },
    {
      "tag": "local-http",
      "listen": "127.0.0.1",
      "port": 10809,
      "protocol": "http",
      "settings": {
        "userLevel": 0
      }
    }
  ]
}
フィールド役割確認する項目
listenリスニングをバインドするローカルアドレスを制限します。プロキシアドレスのホスト部分です。
portinboundのポートを指定します。アプリに設定したプロキシポートとポートの使用状況。
protocol入口で受け付けるプロキシのハンドシェイクを決めます。アプリ側で選択したプロキシの種類。
tagルーティングルールで通信元を識別するタグです。ルール内の inboundTag。

ループバックアドレス、アクセス範囲、アドレスファミリー

127.0.0.1 は、このマシンのIPv4ループバックアドレスです。サンプルでは認証を設定していませんが、他のデバイスが入口を直接使えないよう、リスニングをローカルに限定しています。同じマシン上のブラウザーを接続するために、すべてのネットワークインターフェースで待ち受ける設定に変更しないでください。アクセス範囲が広がるだけで、プロキシの種類を間違えた問題は解決しません。アプリが仮想マシンや別のネットワーク名前空間で動作している場合、その環境のループバックアドレスはホスト側とは別のものです。ホストのプロキシアドレスをそのまま使えるとは限りません。

ローカルアプリで localhost を指定すると、システムが先にIPv6ループバックアドレスを試すことがあります。サンプルはIPv4のみで待ち受けるため、フォールバックできないアプリではローカルでも接続できない場合があります。トラブルシューティングでは、まず 127.0.0.1 を明示して、名前解決とアドレスファミリーの選択を切り分けてください。そのうえで、別のアドレスで待ち受ける必要が本当にあるか判断します。起動時にポート使用中のエラーが出た場合は、まずどのプロセスがポートを使っているか確認し、リスニングアドレスの変更を常套手段にしないでください。クライアントが起動した古いプロセスが、別のアプリの接続を処理していることもあります。

UDP対応とドメイン名の識別は別の話

SOCKS inboundでUDPを許可しても、すべてのUDPデータグラムがコアに届くとは限りません。アプリがSOCKSのUDP転送に対応し、outboundもその通信を処理できる必要があります。通常のHTTPプロキシがシステムのUDP通信を代わりに処理することもありません。疎通確認では、まずTCPをテストしてください。具体的なアプリとUDPが必要なプロトコルを特定できてから、制御できる環境で個別に検証します。Webページが開いたとしても、アプリの音声通話、ゲーム、従来型のDNSリクエストが同じ経路を通ったとは判断できません。

一部のinboundは、後続の接続を確立する前に通信から接続先情報を識別できます。この設定は sniffing で見られます。アプリが直接渡さなかったドメイン名を補えることがありますが、すべてのIPアドレスから一意のWebサイトを特定できるわけではありません。識別できるかどうかは通信内容次第で、識別した名前で接続先を置き換えるかどうかは別の設定です。デバッグでは、まずドメイン名をプロキシに渡すアプリを使い、通常のドメインルールが機能することを確認してください。複数のオプションを同時に有効にして、どれが効いたのか分からなくならないようにしましょう。

outbounds:プロトコルとデフォルト動作

outboundは、コアがリクエストを受け取った後にどう処理するかを定義します。動作を確認しやすいoutboundは freedom と blackhole です。前者はコアを実行しているマシンから接続先へ直接接続し、後者は受け取った通信を破棄します。outboundの名前を direct や blocked にしても、その名前で機能が決まるわけではありません。動作を決めるのは protocol です。まず結果が明確に異なる2種類のoutboundでルーティングを確認してから、リモート側の設定が必要な接続を追加すると、ルーティングの問題とノードのハンドシェイクエラーを切り分けやすくなります。

2つのoutboundで動作を比較する

{
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {
        "domainStrategy": "AsIs"
      }
    },
    {
      "tag": "blocked",
      "protocol": "blackhole",
      "settings": {
        "response": {
          "type": "none"
        }
      }
    }
  ]
}

このコードは、基本設定の outbounds 配列と置き換えて使えます。直接接続が先頭にあるため、ルールに一致しない接続は直接接続されます。ブロック用outboundを配列に追加しただけでは、どのドメインも自動的に処理されません。ルールでリクエストを割り当てるか、デフォルトoutboundにする必要があります。response.type が none の場合、プロトコル応答は生成されません。アプリには、ブロック理由を説明するページではなく、接続の切断、読み込み失敗、再試行などが表示される場合があります。失敗しただけでブロックルールが機能したと判断せず、ログで選択されたoutboundを確認してください。

配列の先頭がデフォルトoutboundです。並べ替えると、ルールに記載していない多くのサービスの動作が変わる可能性があります。テスト中は明示的なデフォルトoutboundを残し、ルールはまず1つのテスト対象だけに適用してください。ブロック用outboundをデフォルトにする場合は、許可する接続先も別途設定します。配列の2番目が、先頭の失敗時に自動で使われるわけではありません。予備ノードやフェイルオーバーには明示的な選択方法が必要です。通常のoutbounds配列は、再試行の順番を表すものではありません。

プロトコル設定とトランスポート設定を分ける

リモート接続を行うoutboundには、通常 settings と streamSettings も含まれます。前者にはプロキシプロトコルで定義されたパラメーター、後者には通常、サーバーへの接続に使うトランスポートとセキュリティ層の設定が入ります。サーバーアドレス、ポート、プロトコル、認証情報はサーバー側の設定と一致させてください。トランスポートの種類、パス、ホスト名、セキュリティ層の要件もひとまとまりで確認します。プロトコル名が一致しているだけでは、設定の互換性は確認できません。同じドメインに複数のサービスが設定されている場合もあり、証明書の名前と実際の接続先アドレスが異なることもあります。

サブスクリプションをインポートしたら、まずサブスクリプションのインポートガイドを参考に、クライアントが認識したプロトコルとトランスポートを確認してください。複数ノードの見慣れたフィールドをつなぎ合わせないようにしましょう。現在のコアが特定のオプションに対応しているか判断するには、XrayとV2Flyコアの違いも参考になります。GUIでコアを切り替えた後は、実際の接続を再起動して起動情報を確認してください。ドロップダウンの表示名を変えただけでは、プロセスが切り替わったとは限りません。

接続先アドレスとサーバーアドレスを区別する

アプリがリクエストする接続先は、アクセスしようとしているサービスです。一方、リモートoutboundのサーバーアドレスは、コアが最初に接続する別の接続先です。どちらもドメイン名を使うことがありますが、同じ名前解決ではありません。たとえば直接接続用outboundの AsIs は、接続時の処理に向けてアドレスの形式を維持する設定であり、内蔵DNSにすべての接続先を解決させる指定ではありません。リモートoutboundでは、ローカルマシンからサーバーに接続できるか、リモート側から最終的な接続先にアクセスできるかをそれぞれ確認します。Webサイトを読み込めないからといってサーバーアドレスの間違いとは限りません。outboundが選択されたログがあっても、接続先からデータが返ったとは限りません。

タイムアウトが発生したら、「どのoutboundが選ばれたか」「outboundの接続先」「接続が止まった段階」を記録してください。基本設定の直接接続でも失敗する場合は、ローカルネットワークと接続先サービスを確認します。特定のリモートoutboundだけ失敗する場合は、トランスポートとハンドシェイクを確認してください。v2rayNのノードタイムアウト確認手順を参考にするときは、同じ接続先を繰り返しテストします。毎回接続先、コア、ノードを同時に変えると、原因を特定できません。

routing:照合順序と接続先情報

ルーティングルールは「このリクエストを、定義済みのどのoutboundに渡すか」を決めるもので、リクエストのプロキシプロトコルを変更するものではありません。ルールは順番に確認され、最初に条件を満たしたルールが適用されます。同じ種類の後続ルールで再判定されることはありません。特定の例外は、範囲の広いルールより前に配置してください。すべてのリクエストに一致するルールを先頭に置くと、詳細なドメインリストを追加しても機能しません。未一致の場合も結果がないわけではなく、outbounds配列の先頭項目に戻るため、デフォルトoutboundを明確にしておきます。

単独で動作を確認できるルールを書く

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

direct と blocked が定義済みで、local-socks inboundを残した設定に、このスニペットを追加します。1つ目のルールは、このinboundから届いたリクエストであり、接続先ドメインが example.org と完全一致することを条件にします。2つ目は、このinboundからの残りの通信を対象にします。HTTP inboundが別にある場合、2つのルールの送信元条件に一致しないため、デフォルトoutboundに進みます。2つのルールを逆にすると、SOCKS inboundからのリクエストはすべて2つ目の広い条件に先に一致し、完全一致ルールが実行されません。

1つのルール内では、異なるフィールドの条件はすべて満たす必要があります。同じフィールドに複数の候補値がある場合は、いずれかに一致すればよい条件です。たとえば network を追加してTCPに限定すると、ネットワークの種類も条件に加わります。「この入口から来た、またはTCPを使用する」という意味ではありません。複数の状況のどれかに一致させる場合は、通常、同じoutboundを参照するルールを状況ごとに分けて書きます。ファイルを短くするために独立したルールを無理に統合すると、マッチ範囲が和集合ではなく積集合になる可能性があります。

ドメイン名で照合するか、アドレスで照合するか

full: はドメイン名の完全一致で、サブドメインには一致しません。ルートドメインとその下位ドメインを両方対象にするには、通常 domain: を使い、似た名前でも一致してはいけない境界の例をテストしてください。接頭辞のない文字列は想定以上に広く一致するため、特定のドメインだけを許可する用途には向きません。正規表現も必要な場合に限って使い、似た名前まで含める広いパターンは避けてください。IPルールには数値アドレスやネットワーク範囲を指定し、ドメイン名で代用しないでください。ドメインセットやアドレスセットを参照する場合は、現在のコアが該当リソースを参照でき、必要な分類が実際に含まれていることを確認してください。

routing.domainStrategy は、ルーティング照合のためにドメイン名を追加でアドレス解決するかどうかを決めます。AsIs は現在得られている接続先情報だけを使うため、IPルールに一致させるための名前解決は行いません。IPIfNonMatch は既存のルールに一致しない場合にアドレスを追加で確認します。ただし、先に広いドメインルールに一致していると、IPルールは適用されないままです。IPOnDemand は、IP条件を調べる段階で名前解決を開始することがあります。これらのモードを性能設定として選ぶのではなく、ドメインで分類したいのか、解決後のアドレスで分類する必要があるのかを先に決めてください。

ルールに一致しないケースのテストも重要

ルールの順序を変更した後は、ブロックされるべきホスト、無関係で直接接続されるべきホスト、ルール名に似ているが対象外のサブドメインを、少なくとも1つずつテストしてください。アプリが先にドメインをIPアドレスに解決してからプロキシへ渡している場合、追加の識別情報がなければ完全一致のドメインルールには一致しません。ブラウザーが既存の接続を再利用したり、ページ内のスクリプトが複数のホストにリクエストを送ったりすることにも注意してください。ページ全体の読み込み結果を見るより、単独のリクエストを基準にする方が結果を解釈しやすくなります。

想定どおりのoutboundが選択されているのに失敗する場合は、そのルーティングルールを変更せず、outbound、DNS、接続先サービスを調べてください。outboundタグの誤記がある場合は、outboundの定義とルールを確認します。誤記に合わせるためだけに、同じoutboundを配列に追加しないでください。長期運用する設定では、先頭に少数の具体的な例外を置き、その後は役割ごとにルールをまとめ、最後にデフォルトの経路を明示します。変更のたびに、影響を受ける接続先と影響を受けない接続先を説明できるようにしてください。

V2Ray DNS設定:誰がどこで名前解決するのか

ドメイン名の解決に失敗したら、まず誰がDNS問い合わせを行っているか確認します。ブラウザーやOSがプロキシ接続前に名前解決することもあれば、ルーティング照合やoutboundの接続時にコアの内蔵リゾルバーを使うこともあります。最後の名前解決をリモート側が行う場合もあります。設定内の dns オブジェクトは、コア自身の名前解決設定を表すものです。OSのDNSを自動的に置き換えたり、すべてのアプリに内蔵の名前解決機能を無効化させたりするわけではありません。ここだけを変更してもクライアントのログに問い合わせが出ない場合、テストリクエストがこの段階まで届いていない可能性があります。

固定マッピングでコアの名前解決経路を確認する

以下はローカルでの検証用で、汎用的なインターネット接続設定ではありません。127.0.0.1 にバインドしたローカルHTTPサービスを用意します。プロキシinboundとは別のポートを使い、たとえば 8000 にします。構造の説明にある完全な基本設定をベースに、ルートオブジェクトへこの dns を追加し、outbounds を置き換えてください。SOCKS経由で demo.test をそのままコアに渡し、http://demo.test:8000/ にアクセスします。サービスがこのホスト名を受け付けるか、少なくともログにリクエストを記録する必要があります。この例では、テスト用に予約されたドメイン名をループバックに割り当てるため、外部のDNSサーバーに名前解決を依頼する必要はありません。

{
  "dns": {
    "hosts": {
      "demo.test": "127.0.0.1"
    },
    "servers": ["localhost"]
  },
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {
        "domainStrategy": "UseIP"
      }
    }
  ]
}

hosts はコアのリゾルバーに設定する静的マッピングです。servers 内の localhost は、問い合わせが必要な名前をローカルシステムの名前解決機能で処理することを示し、ループバックアドレスで待ち受けるDNSサーバーが必要という意味ではありません。ここでは直接接続用outboundに UseIP を指定し、先にドメイン名をアドレスに解決することで、前段の静的マッピングを確認できるようにしています。テストアプリが先に自分で名前解決すると、ドメインが存在しないというエラーになる場合があります。コアに渡された時点ですでにIPアドレスになっている場合、接続に成功しても静的マッピングを検証したことにはなりません。

同じ名前の2つのポリシーを1つのスイッチと見なさない

routingオブジェクトの domainStrategy は、照合段階で接続先情報を追加取得する方法を制御します。outbound設定にある同名フィールドは、そのoutboundが接続前にドメイン名をどう処理するかを制御します。outbound側の設定だけ変更しても、先に一致しなかったルーティングルールが再評価されることはありません。逆に、ルーティング照合のためにIPアドレスを取得しても、後続の接続で必ずそのアドレスが使われるとは限らず、outboundの実装と設定によって異なります。切り分けでは一度に1つの層だけを変更し、outbound名と最終的な接続先を確認してください。2つの設定変更を同じスイッチの結果だと誤認しないようにしましょう。

特定のDNSサーバーを使う場合は、ドメイン別の問い合わせやフォールバックを設定する前に、現在のネットワークからコアがそのサーバーへ接続できることを確認してください。ドメイン名に基づいてサーバーを指定するのは問い合わせ先を選ぶ設定であり、アプリの接続に使うoutboundを指定するものではありません。両者は別のルールに影響されることがあります。DNSサーバーをドメイン名で指定する場合は、そのサーバー自身の名前を最初にどう解決するかも考慮してください。まだ接続できていない同じサーバーにその名前解決を依存させると、循環が発生し、多くのドメインが同時にタイムアウトすることがあります。

エラーの種類から次の確認項目を判断する

ドメインが存在しないエラーとリクエストのタイムアウトは別の問題です。前者は解釈可能な否定応答を受け取ったことを示し、ドメイン名の誤り、内部ドメインを知らないDNSサーバーへの問い合わせ、呼び出されていない静的マッピングなどが原因として考えられます。後者は待機中に有効な応答を得られなかった状態です。名前解決の経路、ネットワークの到達性、サーバーの応答を確認してください。アドレスを取得できても接続できない場合は、IPv4とIPv6のどちらが返されたのか、そのアドレスにネットワークからアクセスできるか、ルールによって別のoutboundに切り替わっていないかも調べます。

テスト結果が安定しない場合は、アプリのキャッシュ、システムキャッシュ、コアのキャッシュ、すでに確立されている接続を分けて考えてください。ページを閉じてもブラウザーが接続を保持していることがあります。コアの設定を変更しても、アプリのドメイン名キャッシュが消えるとは限りません。更新回数で判断せず、新しい独立したリクエストで再テストし、接続先と結果を明確に記録してください。システムプロキシが関係する場合は、接続後にインターネットへアクセスできない場合の確認リストを参考に、まず入口の問題を切り分けてからDNSの範囲を絞ります。

policy:ハンドシェイク、アイドル、統計

policyはアクセスするドメインやノードを選択する設定ではなく、システムファイアウォールでもありません。policy.levels は、コアが識別するユーザーレベルごとの接続設定を定義します。policy.system にはシステム全体の統計設定が含まれます。ここでいうレベルはOSアカウントの権限ではなく、サブスクリプションのプランとも関係ありません。inboundやプロトコルのユーザー設定で使用するレベルを選び、policyブロックでそのレベルの動作を指定します。特定のレベルが反映されない場合は、まず接続に使われているinboundとプロトコルがそのレベルを実際に適用しているか確認してください。

テスト用inboundに明確な待機時間を設定する

{
  "policy": {
    "levels": {
      "0": {
        "handshake": 8,
        "connIdle": 300,
        "uplinkOnly": 5,
        "downlinkOnly": 5
      }
    },
    "system": {
      "statsInboundUplink": true,
      "statsInboundDownlink": true
    }
  },
  "stats": {}
}

この2つのトップレベルフィールドを設定に追加し、前述の userLevel: 0 を設定したSOCKS inboundでテストします。levels のキーは文字列形式のレベル番号で、時間の値は数値、単位は秒です。ここに示す数値は説明用の例であり、すべてのネットワークに適した推奨値ではありません。実際に制御される範囲はプロトコルの実装によって異なります。また、コアのinbound処理で接続が中断されたのか、リモートサービス、アプリ、ネットワーク機器が先に切断したのかを区別してください。

フィールド対象となる段階確認できる現象
handshake対応プロトコルの初期ハンドシェイク。接続後、ハンドシェイクが完了しない。
connIdle接続後、一定時間データの送受信がない。通信中は正常だが、長時間アイドル状態が続くと切断される。
uplinkOnly下りの通信終了後、上りを継続できる時間。クライアントから接続先への送信だけが残っている。
downlinkOnly上りの通信終了後、下りを継続できる時間。送信終了後も、残りの応答を待ち続ける。

接続段階から時間設定の変更要否を判断する

ハンドシェイクの時間が短すぎると、低速な接続でネゴシエーションが終わる前に切断されることがあります。ただし、時間を延ばしても、ポートの誤り、接続先による拒否、プロトコル設定の不一致は直りません。アイドル時間は接続全体の寿命ではありません。定期的にデータが流れるセッションでは、「開始から何秒経ったか」でアイドル閾値に達したかを判断できません。検証する場合は最後のデータ送受信時刻を記録し、設定した間隔に近い時点で終了するか観察します。アプリやサーバー側のアイドルタイムアウトとも比較してください。

一方向の猶予時間をアップロードやダウンロードの速度制限と誤解しがちです。実際は、一方の通信が終了した後、反対方向のデータ処理をどれだけ継続できるかを設定します。たとえばテストプログラムがリクエスト送信後に送信側を閉じても、サーバーが最後の応答を準備するのに時間がかかることがあります。待機時間が短いと、応答の最後まで受け取れない場合があります。しかしテストプログラムが接続全体を閉じてしまえば、時間を延ばしてもアプリがデータを再度読み込むわけではありません。一度に1つのフィールドだけを変更し、切断を再現できるリクエストでテストしてください。

統計の設定、読み取り方法、対象範囲

stats は統計機能を有効にし、policy.system の2つのスイッチはinboundの上り・下りの通信量を集計できるようにします。この例には外部から統計を読み取るインターフェースがなく、クライアント画面にグラフが自動表示されるわけでもありません。GUIクライアントがこのデータを表示するか、読み取り方法やリセットのタイミングは、クライアントへの統合方法によります。ユーザー単位の統計には別途レベル設定が必要で、プロトコルがユーザーを識別できる必要があります。認証なしのinboundの合計通信量を、各ローカルアプリの使用量に分けることはできません。

トラブルシューティングでは、同じ基準で比較してください。累計値と通信速度は異なり、inboundとoutboundの通信量も必ずしも一致しません。プロセス再起動前後の値は連続した測定値ではありません。クライアントが設定を切り替えた際、新しいプロセスを起動することもあります。特定のテストがinboundに届いたかだけを確認したい場合は、その接続のタグとログを優先してください。デバッグのために詳細な統計やアクセス記録を有効にした場合は、終了後に通常の設定へ戻します。カウンターを読むためだけにネットワーク上でリスニングを追加しないでください。

設定の検証とトラブルシューティング

効果的なトラブルシューティングは、疑わしいスイッチをすべて初期化することではありません。まず現象を保ったまま、変更範囲を絞って比較します。使用中のコア、起動時に読み込まれた設定、プロキシの入口、再現に使う接続先を記録してください。クライアントやプロセスが複数ある場合は、どのプロセスのログなのかも確認します。「設定を読み込める、ポートに接続できる、リクエストがコアに届く、想定どおりのoutboundが選ばれる、接続先が応答する」の順に検証してください。前の段階が成立していない場合、後の段階の異常に見えるデータが今回のテストに関係しているとは限りません。

まず設定の読み込みエラー、次にリスニングの失敗を調べる

コアがファイルを読み込めない場合は、起動ログで最初に出た関連エラーを確認してください。行番号が表示された場合は、その行だけでなく、直前の項目の末尾にあるカンマや外側の括弧も確認します。パーサーが報告するのは通常、最初に読み進められなくなった文字であり、元のミスの位置とは限りません。JSONとして解析できることが示すのは構文の完全性だけです。プロトコルの対応状況、ポートの使用可否、参照タグの正しさまでは保証しません。設定を切り替えた直後にクライアントが切断状態へ戻る場合、サブスクリプションの更新や速度測定を試す前に、起動エラーを確認してください。

起動に成功しても、同じ名前のプロセスがあるかだけで判断しないでください。プロセスが実際にバインドしているアドレスとポートを調べ、テストリクエストで指定した値と比較します。接続拒否が出る場合は、リスニングしていない、プロキシアドレスが違う、アドレスファミリーが異なる、プロセスの起動・終了のタイミングが合わない、といった原因をまず確認してください。ローカルポートには接続できてもプロキシのハンドシェイクに失敗する場合は、そのポートでSOCKSとHTTPのどちらが動作しているか調べます。他のプログラムがポートを使用していると、クライアント画面の設定が正しく見えていても、誰が接続を処理しているのか分かりません。起動ログと実際のリクエストで確認してください。

1つのリクエストで再現し、原因を絞り込む

curlがインストールされていれば、コマンドラインから以下のリクエストを実行して、基本設定全体を検証できます。socks5h はドメイン名をSOCKSプロキシに渡す指定です。--noproxy "" は、環境変数などのプロキシ例外によって明示的なプロキシを回避しないようにします。example.org をブロック用outboundへ割り当てるルーティング例では、1つ目のリクエストは失敗するはずです。2つ目は、このドメインルールに一致しない場合の比較用ですが、ローカルネットワークから接続先サービスにアクセスできる必要があります。3つ目はDNSのローカルマッピングを試すもので、先にローカルサービスを用意し、そのセクションの設定を読み込んでください。3つのリクエストが同じ設定で成功する必要はありません。

curl --noproxy "" --proxy socks5h://127.0.0.1:10808 --max-time 15 https://example.org/
curl --noproxy "" --proxy socks5h://127.0.0.1:10808 --max-time 15 https://example.com/
curl --noproxy "" --proxy socks5h://127.0.0.1:10808 --max-time 15 http://demo.test:8000/

単独のリクエストは成功するのにブラウザーでは動作しない場合は、ブラウザー独自のプロキシモード、接続の再利用、名前解決設定、システムプロキシの例外を調べてください。どちらも失敗する場合は、まずログで今回のテストに対応するinboundタグとoutboundの経路を確認します。リクエストがログにないからといって、コアに届いていないとは限りません。現在のログレベルやクライアントの表示範囲では、アクセスの詳細が記録されない場合があります。基本設定の loglevel を一時的に info に変更して再試行し、必要に応じてクライアントからコアのアクセスログを確認した後、普段使うレベルに戻してください。

再テストでき、元に戻せる変更にする

複雑な問題では、入口1つと直接接続用outbound1つだけを含むコピーから始めます。まずアプリがローカルプロキシ経由で接続先にアクセスできることを確認します。次に結果を区別するルーティングルールを追加し、必要に応じて名前解決や接続ポリシーを組み込み、最後にリモートoutboundを検証します。変更のたびに同じプロトコル、ポート、接続先を使って再テストし、変更の影響を受けないはずのリクエストも1つ残してください。新しいエラーが発生したら、直前の変更だけを戻して復旧するか確認します。こうすれば、たまたま接続できたという結果ではなく、原因を特定する手がかりが得られます。

記録項目は入口、接続先、outbound、段階、結果の5つにまとめられます。問題を他の人に説明する場合は、エラーの種類、関連するタグ、必要なフィールド構造だけを残し、エクスポートした設定全体は貼り付けないでください。サブスクリプションURL、アカウント情報、内部アドレス、詳細なアクセス記録は削除します。設定例を編集した場合は、どの名前がテスト用なのかも明記してください。リモートトランスポートで発生したエラーはノードタイムアウトの確認手順を続けて参照してください。入口や接続モードの初期設定であれば、クイックスタートガイドに戻る方が早く解決できます。