設定リファレンス / JSON

V2Ray設定ファイル:JSON項目リファレンス

接続の流れに沿って設定を確認します。アプリからどのinboundに入り、どのoutboundが選ばれ、名前解決やタイムアウトをどの設定が担うのかを整理します。

初めてのインストールやサブスクリプションのインポートには、まずクイックスタートガイドで接続を確認してください。このページでは設定を変更するときに項目を調べられます。ローカルの待受と直接接続の例を使い、コアの動作とクライアント側の通信制御を切り分けます。

JSON構造の概要

ルートオブジェクト、配列、プロトコル設定を区別する

一般的なV2Ray互換のJSON設定は、オブジェクトをルートにします。inboundsとoutboundsは配列です。1つの設定に複数の入口と出口を定義できるためです。routing、dns、policy、logは通常オブジェクトで、それぞれ転送先の選択、名前解決、接続ポリシー、ログを設定します。オブジェクトの中も階層ごとにデータ型を確認してください。たとえばrouting.rulesは配列ですが、policy.levelsはレベル番号をキーにするオブジェクトです。インデントは読みやすくするためのもので、隣り合う項目を同じ階層にまとめるものではありません。

settingsを見つけたら、まず同じ階層にあるprotocolを確認してください。この項目名は多くのinboundやoutboundで使われますが、共通のパラメーター一覧があるわけではありません。SOCKS inboundの認証設定をHTTP inboundに流用することはできず、outboundの接続先をinboundの待受アドレスで代用することもできません。設定を調べるときは、「1つ目のinboundの待受ポート」「2つ目のルールの宛先タグ」のように、項目の階層を含めて記録すると、どこを変更したか判断しやすくなります。

単独で起動できるローカル設定のベースライン

完全な設定例 · ループバックHTTP inboundと直接接続outbound
{
  "log": {
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "tag": "http-local",
      "listen": "127.0.0.1",
      "port": 10809,
      "protocol": "http",
      "settings": {}
    }
  ],
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {}
    }
  ]
}

この例は、対応する項目を備えたコアで読み込める、単一ファイルの設定ベースラインです。入口はローカルの127.0.0.1:10809だけで待ち受けます。プロキシを設定できるアプリは、このHTTPプロキシを明示的に指定して利用できます。outboundは1つだけで、追加のルールがない場合、コアに渡された通常のリクエストはデフォルトの出口から直接接続します。リモートサーバーの情報は含まず、システムプロキシを変更したり、仮想ネットワークインターフェースを自動作成したりするものではありません。デスクトップクライアントがこのポートを使用中の場合は、空いているポートに変更し、テストするアプリ側の設定も合わせて変更してください。

ベースラインが正常かどうかは、2段階で確認します。起動時に設定エラーが出ないことから分かるのは、コアが設定を受け入れ、待受を開始しようとしたことまでです。アプリ、inbound、outboundを通した接続を確認するには、宛先を指定したリクエストも送る必要があります。同じアプリから同じ宛先へ、まず直接アクセスし、次にプロキシを明示してアクセスしてください。直接接続が失敗する宛先では、ベースラインも失敗することがあります。それだけでinboundの設定ミスとは判断できません。テスト中にシステム全体のプロキシ設定を変更すると、他のアプリのリクエストが混ざるため避けてください。

単独ファイルと各節の設定例を組み合わせる方法

以下で「項目を置き換える」「ルートオブジェクトに追加する」と示した設定窓は、部分的な例です。外側の波括弧は設定の所属階層を示すもので、別ファイルとして起動する意味ではありません。ファイル末尾に2つ目のルートオブジェクトを貼り付けないでください。同名のルート項目がすでにある場合は、その項目を例で置き換えるか、用途に合わせて中身を統合します。routingを統合したらルールの順序を、inboundsを統合したらポートを再確認してください。エディターでエラー表示が出ないからといって、統合後の設定が実行時の要件を満たしているとは限りません。

厳密なJSON形式を保つと、異なるインポート方法による解釈の違いを減らせます。キーと文字列には半角の二重引用符を使い、数値のポート番号は引用符で囲みません。オブジェクトや配列の最後の項目にカンマを付けず、説明をコード内のコメントとして書かないでください。重複キーは特に見つけにくい問題です。パーサーによっては拒否されたり、後の値だけが残ったりするため、先に設定した値が無視されたように見えることがあります。UTF-8で保存し、実行用ファイルと編集途中の草稿は分けてください。クライアントが生成する設定は、次回の切り替え時に再生成されるのを防ぐため、クライアントの設定画面から変更するのが基本です。

inbounds(受信)

待受アドレス、ポート、プロトコルを一致させる

inboundは、コアがどのアドレスで接続を受け付け、アプリから届くデータをどのプロトコルで解釈するかを定義します。listenは実行中のデバイスにバインドするアドレスで、リモートサーバーのアドレスではありません。portはアプリが接続するローカルポートで、相手側サービスのポートではありません。ループバックアドレスを使えば、ローカルテストとLANからのアクセスを分けられます。どちらのアドレスも最終的に同じPCを指していても、ループバックで待ち受けるinboundがネットワークインターフェースのアドレス宛てのリクエストを受け付けることはありません。

アプリ側で選ぶプロキシの種類も一致させる必要があります。HTTPプロキシを選んだ場合はHTTP inbound、SOCKSプロキシを選んだ場合はSOCKS inboundに接続します。アドレスとポートが正しくてもプロトコルが異なると、ソケット接続までは成功し、その後のプロキシネゴシエーションで失敗することがあります。アプリが自動入力するlocalhostにも注意してください。IPv6ループバックを先に試す一方、設定がIPv4だけで待ち受けている場合は、アプリのアドレスを一時的に127.0.0.1にしてアドレスファミリーの違いを切り分けられます。

2つのinboundを別々に識別する

項目を置き換える · HTTPを残してSOCKS inboundを追加
{
  "inbounds": [
    {
      "tag": "socks-local",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": false
      }
    },
    {
      "tag": "http-local",
      "listen": "127.0.0.1",
      "port": 10809,
      "protocol": "http",
      "settings": {}
    }
  ]
}

2つのinboundを別々のポートに割り当て、プロトコルを比較しやすくした例です。tagは設定内で使う識別子で、アプリに入力するのはアドレスとポートです。タグは重複しない、安定した値にしてください。複数のアプリからのリクエストを分けてテストする場合は、それぞれ異なるinboundを使い、routing.rulesのinboundTagで区別します。アプリ名だけでルートを推測しないでください。inbound名とoutbound名を同じにする必要はありません。名前を意図的に分けておくと、ログに記録された接続の入口と出口をすぐに判別できます。

例では、SOCKS inboundを認証なしに設定し、ローカルからの接続だけを受け付けます。SOCKSのUDP転送は無効にしているため、まず通常のWebアクセスなどTCP通信を確認するのに適しています。テストするアプリが主にUDPを使う場合、SOCKS経由のTCPテストに成功しても利用できるとは限りません。アプリが該当するプロキシ転送に対応しているか、inboundが許可しているか、後続のoutboundがその通信を運べるかも確認してください。接続を観察するためだけに待受範囲を広げないでください。ローカルでの確認に、他のデバイスからプロキシへ接続できる設定は必要ありません。

接続が失敗した段階からinboundの問題を切り分ける

コアの起動時にバインドエラーが出た場合は、まず待受アドレスがこのデバイスに割り当てられているか確認し、次に古いプロセス、クライアント内蔵のinbound、別のプログラムがポートを使用していないか調べます。ポートを変更するときは、設定ファイルだけでなく、ブラウザーの手動プロキシ、システムプロキシの設定、テストコマンドの参照先も確認してください。新旧の設定が食い違っていると、リクエストが拒否されるのではなく、テストプログラムがまだ稼働中の別プロキシに接続して、変更がまったく反映されていないように見えることがあります。

ポートには接続できるのに、ログに想定したinboundタグが出ない場合は、アプリ独自のプロキシ設定が使われていないか、宛先の除外設定がないか、以前の接続が再利用されていないかを優先して確認します。inboundタグが確認できてから、outboundやドメインの照合を調べてください。また、inboundに届いた宛先がドメイン名なのか、アプリがすでに名前解決したIPアドレスなのかも区別します。アプリが先に名前解決していると、ドメインルールの照合に必要な情報がないことがあります。必ずしも待受プロトコルの問題ではありません。まず入力条件を変えずに、アプリが実際にどの形式の宛先を送っているか記録し、それから後続のルールを変更してください。

outbounds(送信)

先頭がデフォルトの出口、タグはルールから参照する

inboundがリクエストを受け取った後、コアはどの経路で宛先に接続するかを決めます。outboundsの各項目では、protocolが実際の動作を定義し、tagはルールから参照する識別子です。タグをdirectにしても、どのプロトコルでも直接接続になるわけではありません。blockedと名付けても、自動的に通信を遮断するわけではありません。routingルールに一致しない通常のリクエストでは、配列の先頭の項目がデフォルトの出口になります。2つの項目を並べても、同時に接続を試したり、失敗時に自動で切り替えたりはしません。

このページのローカルテストでは、サーバーを必要としない直接接続をデフォルトの出口にするのが適しています。ただし、実際の利用でもどんな場合にもそのまま使える設定ではありません。ルールに含まれない宛先を直接接続してよいか確認してから、デフォルトの出口を決めてください。分類ルールの漏れを調べるには、独立したテスト設定で拒否outboundをデフォルトにし、既知の宛先だけを明示的に許可する方法があります。これは未照合のリクエストを確認するためのもので、複数アプリが利用中の設定をそのまま置き換える用途には適しません。

直接接続と拒否の最小構成

項目を置き換える · 直接接続をデフォルトにし、ルール用の拒否outboundを追加
{
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {}
    },
    {
      "tag": "blocked",
      "protocol": "blackhole",
      "settings": {
        "response": {
          "type": "none"
        }
      }
    }
  ]
}

freedomは宛先に直接接続します。実際に使われるローカルネットワークや名前解決の動作は、実行環境とoutboundの設定によって異なります。リクエストがプロキシinboundを通ったからといって、リモートのプロキシサーバーへ転送するわけではありません。blackholeは宛先に接続しません。この例では応答タイプをnoneに設定しているため、アプリ側では接続が切断されたり、一般的なプロキシエラーが表示されたりすることがあります。遮断理由を説明するページが返るわけではありません。明示的な拒否と宛先側の障害を見分けるには、選択されたoutboundと宛先サービスのアクセスログも確認し、アプリのエラーダイアログだけで判断しないでください。

この例の2つ目の項目は、routingルールに追加されるまで通常のリクエストを処理しません。配列の順序を保ったまま適用範囲の狭いルールを追加し、拒否動作を確認できます。テストに失敗したら、まず前のルールが追加したルールに先行して一致していないか確認してください。outboundの名前を変える場合は、元のタグを参照しているすべてのルールも更新し、大文字と小文字が一致しているか確認します。存在しないoutboundタグは利用可能な代替経路ではありません。ファイルの読み込みに成功しても、リクエストが必ず先頭の項目へ戻るとは限りません。

リモート接続はサービス側の設定と項目ごとに照合する

リモートoutboundを設定するときは、プロキシプロトコル、通信を運ぶトランスポート方式、通信を保護するセキュリティ層を分けて考えてください。これらは関連しますが、互いに代用できません。同じプロキシプロトコルでも異なるトランスポート方式を使えるため、アドレスとポートが同じだけでは双方の設定が一致しているとは限りません。共有リンクをインポートした後は、クライアントで変換後のプロトコル、トランスポート、セキュリティ設定を確認し、提供元の説明と照合してください。コアの系統が異なると、一部の項目や値に互換性がないことがあります。別の設定例から数行だけ抜き出して継ぎ足さないでください。

リモート設定を変更するときは、動作確認済みのローカルinboundを残し、テストアプリと宛先を固定して、一度に1つの条件だけ変えてください。inboundのログが出た後にリモート接続がタイムアウトする場合は、リモートアドレスを名前解決できるか、ポートに接続できるか、接続確立とハンドシェイクのどちらで失敗したかを順番に確認します。このページの直接接続ベースラインで同じ宛先にアクセスできても、確認できるのはローカルから宛先への直接経路だけです。リモートサービスの設定が正しいことの証明にはなりません。プロトコル項目の意味はプロキシプロトコルの比較を参考にし、実際の設定に戻って差分を確認してください。

routing(ルール)

専用ルールを先に、汎用ルールを後に書く

routing.rulesは配列の順に評価されます。次のような項目ルールでは、先に一致したルールで指定されたoutboundが選ばれ、その後のルールは詳細さに関係なく評価されません。たとえば、あるネットワーク範囲を対象とする直接接続ルールの後に、その範囲内の特定デバイスを拒否するルールを置いても、後者は通常実行されません。例外が必要な場合は、より狭い範囲のルールを広いルールより前に置いてください。デバッグ時は最後に編集したルールだけを見るのではなく、リストの先頭から最初に一致する可能性のあるルールを探します。

1つの項目ルールにinboundTagとipの両方を設定した場合、この例ではinboundと宛先アドレスの両条件が成立する必要があります。個々の項目にある配列には、複数の候補値を指定できます。「指定したinboundからの通信、または指定したネットワーク範囲宛ての通信」を意図する場合は、通常、同じoutboundを選ぶルールを2つに分けて記述します。2つの書き方を取り違えると、例にある宛先だけは一致するのに、別のアプリやアドレスではデフォルトの出口が使われる、といったことが起こります。

ローカルリクエストでルールの順序と適用範囲を確認する

ルートオブジェクトに追加 · 2つのinbound・outboundの例と組み合わせてテスト
{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "inboundTag": ["socks-local"],
        "ip": ["127.0.0.1/32"],
        "outboundTag": "blocked"
      },
      {
        "type": "field",
        "ip": ["127.0.0.0/8"],
        "outboundTag": "direct"
      }
    ]
  }
}

直接接続できるローカルHTTPテストサービスを用意し、宛先には127.0.0.1とサービス側のポートを指定します。プロキシの待受ポートを宛先にしないでください。SOCKS inboundから入った接続は最初のルールに一致し、拒否outboundへ進みます。HTTP inboundから同じ宛先へ接続すると最初のルールには一致せず、次のルールに進みます。2つのルールの順序を入れ替えて新しい接続を作ると、広い範囲を指定するアドレスルールがinboundの例外より先に適用されることを確認できます。ここでIPアドレスを直接指定するのは、名前解決の違いをroutingのテストに持ち込まないためです。

実際の設定では、一致したルール、ルールに一致しない場合のデフォルトoutbound、選択したoutboundで接続に失敗した場合を区別してください。明示的なフォールバックルールがなくても、先頭のoutboundには引き続き役割があります。適用範囲の広いフォールバックルールを追加すると、その後のルールが到達不能になることがあります。ログに想定したoutboundが記録されているのに接続に失敗する場合は、routingの順序を何度も変更するのではなく、そのoutboundと宛先サービスを調べてください。既存ルールに例外を追加するときは、新しいルールの対象だけでなく、影響を受けないはずの宛先も比較用にテストすると安心です。

ドメインルールとアドレスルールでは照合対象が異なる

完全一致にはfull:example.testを使えます。ドメインとそのサブドメインを対象にするにはdomain:example.testを使います。文字列の部分一致に頼るより、明示的なプレフィックスを使うほうが設定を確認しやすくなります。geosite:cnのような指定は、ドメインデータ内の分類を参照します。コアが該当するリソースを読み込める必要があり、実際の照合結果は読み込まれたデータによって決まります。位置情報を判定するものではなく、サービスに関連するすべてのドメインを網羅する保証もありません。ドメインリストの照合結果は、実際のリクエスト先も確認してください。

AsIsはroutingの照合のためにドメインを追加で名前解決しません。一方、IPIfNonMatchは最初の照合で一致しなかった場合に、名前解決したアドレスで再度照合できます。後者を使う前に、名前解決による遅延、取得したアドレスと実際の接続先との関係、既存のフォールバックルールが最初の照合ですでに一致していないかを確認してください。どちらの方式でも、アプリが送信した任意のIPアドレスを自動的にドメイン名へ戻すことはできません。ドメインルールをテストするには、まずアプリから宛先ドメインがinboundに渡されることを確認し、想定した照合経路に進むか観察してください。

dns(名前解決)

まず、誰がDNS問い合わせを送っているか確認する

ルートオブジェクトのdns設定はコアの名前解決処理に関するもので、OSのDNS設定と同じではありません。また、アプリが独自に行うすべての問い合わせを制御するものでもありません。アプリはドメインを先に名前解決してからアドレスをプロキシに渡すことも、プロキシリクエスト内にドメイン名を保持することもできます。アプリ独自の名前解決設定がある場合もあります。設定項目が有効かどうかを判断する前に、リクエストの宛先がどの形式か、コアのroutingやoutboundが内蔵リゾルバーを使うかを確認してください。ブラウザーにドメイン名が表示されていても、同じ文字列がコアに渡されているとは限りません。

routingでの名前解決と、outboundでの名前解決も分けて考えてください。前者は宛先がアドレスルールに一致するか判断するため、後者は実際に接続を確立するために使われます。routingでアドレスが見つかっても、すべてのプロトコル、outbound、アプリが同じ名前解決結果を使うとは限りません。経路ごとに別のキャッシュが使われたり、アドレスファミリーの選択によって異なる結果になったりする場合があります。トラブル対処では「ドメインを名前解決できる」ことと「現在の接続がそのアドレスを使っている」ことを同一視せず、必要なら宛先とoutbound双方の観測結果を記録してください。

静的マッピングで内蔵名前解決の経路を確認する

関連する変更 · dnsを追加し、ベースラインのoutboundsを置き換える
{
  "dns": {
    "hosts": {
      "example.test": "127.0.0.1"
    },
    "servers": ["localhost"]
  },
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {
        "domainStrategy": "UseIP"
      }
    }
  ]
}

単一inboundのベースラインにこのdnsオブジェクトを追加し、既存のoutboundを置き換えます。直接接続outboundではUseIPを使い、ドメイン名のまま渡されたテスト宛先を内蔵の名前解決でアドレスに変換します。hostsはテスト用の名前をループバックアドレスに割り当てます。OSのホスト名マッピングは変更しません。serversのlocalhostはローカルの名前解決機能を使う指定であり、ループバックアドレス上に問い合わせ可能なサービスがあるという意味ではありません。テスト名には予約済みのドメインを使います。起動したローカルテストサービスへプロキシ経由で接続し、公開サイトとして扱わないでください。

この例は元のベースラインでテストしてください。前の章の設定を使い、blockedを参照するルールが残っている状態で上書きすると、参照先のoutboundがなくなります。アプリがテスト名をプロキシ対象から除外したり、独自のリゾルバーで先に問い合わせようとしたりすると、静的マッピングはコアを通りません。反対に、直接接続outboundのデフォルトのドメイン処理に戻すと、同じ名前をOSが解決しようとすることがあります。outboundの名前解決方式だけが異なる2つの設定を比較し、毎回新しい接続を作れば、内蔵マッピングとOSの名前解決結果を切り分けられます。

DNS上流の振り分け、アドレスファミリー、キャッシュ

ドメインごとに異なる上流を使う場合は、使用するコアがserversのオブジェクト項目に対応しているか確認してください。たとえばaddressで名前解決先を指定し、domainsで照合範囲を設定します。専用の上流を記述しただけで、他のサーバーが一切使われなくなるとは限りません。候補の順序、失敗時のフォールバック、結果のフィルタリングに関するコアの仕様を確認してください。HTTPSベースの名前解決先を使う場合は、その接続先自体をどのように名前解決して接続するかも確認が必要です。接続先のドメインを取得するために、その接続先自身への問い合わせが必要なら、安定した起動経路を確保できません。

IPアドレスなら接続できるのにドメイン名では接続できない場合は、まず実際に問い合わせを行う層をテストし、結果にどのアドレスファミリーが含まれるかを調べます。IPv4のみ、またはIPv6のみを使う設定では、一部の宛先に適切なアドレスがないことがあります。切り分けには使えますが、あらゆるネットワーク問題に対する汎用的な修正ではありません。設定変更後は、アプリの名前解決キャッシュ、システムキャッシュ、既存の接続がそれぞれ異なるタイミングで更新される点にも注意してください。古い接続を閉じ、宛先を明確にした新しいテストを行い、どの層が古いアドレスを返しているか確認してから、該当するキャッシュを消去するか判断します。

policy(接続ポリシー)

レベル別のポリシーは接続動作を制御し、転送先は選ばない

policyは接続のタイムアウト、バッファー、統計など、コアの処理方法を定義します。ドメインを異なるoutboundに振り分ける設定ではありません。policy.levelsは、"0"のように文字列形式のレベル番号をオブジェクトのキーとして使います。接続に適用するレベルは、該当するプロトコルとinbound側のユーザーレベル設定によって決まります。新しいレベルを設定ファイルに定義しても、リクエストが自動的にそのレベルへ移るわけではありません。パラメーターを調べる前に、使用中のプロトコルがどのようにレベルを選ぶか確認し、デフォルトレベルと明示的に割り当てたレベルを分けてテストしてください。

ポリシー設定は、前段の設定ミスを覆い隠す目的で使われがちです。inboundのポートに接続できない、リモートのトランスポート設定が一致しない、DNS問い合わせが想定外の経路を通るといった問題は、タイムアウトを延ばしても直りません。クライアントにエラーが表示されるまでの時間が延びるだけの場合があります。まず最小構成で接続経路を確認し、どのアプリのどんな動作を変えたいのかを明確にしてからポリシーを調整してください。リクエストがない状態が続いたときに切断する動作と、データが流れているのに転送が遅い状態は、同じタイムアウト設定では説明できません。

ハンドシェイク、アイドル状態、片方向終了を区別する

ルートオブジェクトに追加 · レベル0で接続時間の例を確認(単位:秒)
{
  "policy": {
    "levels": {
      "0": {
        "handshake": 8,
        "connIdle": 180,
        "uplinkOnly": 4,
        "downlinkOnly": 12
      }
    }
  }
}

handshakeは、対応プロトコルで初期ハンドシェイクを待つ時間を制限します。すべてのネットワーク処理に共通する接続タイムアウトではなく、リモートアプリケーション側のタイムアウトを上書きするものでもありません。connIdleは接続がアイドル状態にある時間を対象とし、接続開始からの最大稼働時間ではありません。この例の値は、それぞれのタイマーが測る対象の違いを示すもので、どのクライアントのデフォルト値でもありません。アプリ側のタイムアウトがより短い場合は、アプリが先にリクエストを終了することがあります。

uplinkOnlyは下り方向が終了した後、上り方向だけになった状態をどれだけ維持するかを表します。downlinkOnlyは下り方向だけになった状態を表します。アップロードやダウンロードの速度上限ではありません。片方向が終了した後に残りの方向をすぐ切断すると、受信途中の応答が途切れることがあります。長く維持しすぎると、不要になった接続がリソースを占有し続けます。この設定をテストするには、読み書きの終了動作を確認できるアプリを選んでください。通常の短いリクエストが成功しても、長時間接続や片方向終了の動作を検証したことにはなりません。

ユーザーレベル、システム統計、クライアント画面を区別する

policy.systemはコアのシステム全体に適用するポリシーです。一部の実装では、ここでinboundまたはoutboundの通信量カウントを有効にできます。ユーザーごとのカウントは該当レベルの設定です。カウントが行われること、クライアントから読み取れること、画面上の統計として表示されることは、それぞれ別の条件です。対応する統計モジュールや読み取り機能が有効かどうかも確認してください。ポリシー項目を追加しただけで画面にデータが表示されるとは限りません。統計を確認するために管理インターフェースを他のデバイスへ公開しないでください。

ポリシーを調整するときは、アプリ、inbound、outbound、宛先を固定して、確認するレベルのパラメーターだけを置き換えた比較用設定を用意します。接続を作り直してテストしてください。エラーがリクエスト開始時、アイドル状態からの再開時、一部の応答を受信した後のどの段階で起きたか記録し、どのタイマーに関係するか判断します。特定のアプリだけで問題が起き、同じinboundとoutboundを使う他のアプリが動作する場合は、そのアプリ独自の再試行や接続プールの設定も確認してください。再現性のある違いを確認してから変更を残し、ほかの実験用パラメーターはベースラインに戻します。複数のタイムアウトを同時に変えると、次の変更時に原因を特定しにくくなります。

クライアント設定と適用範囲

サブスクリプション、個別の共有設定、コアの設定ファイルを区別する

デスクトップではv2rayN、Androidでは使用するコアに応じてv2rayNGまたはv2flyNGを選べます。インストール先はインストールファイルのページをご覧ください。クライアントが管理する接続情報の形式は、コアが実行時に使う設定とは異なります。サブスクリプションURLは通常、複数の接続情報を取得するために使います。共有設定1件は1つの接続を表し、コアの設定ファイル全体にはinbound、outbound、名前解決、routingをまとめて定義できます。ある形式のデータを正しくインポートできても、別の形式のデータを同じ場所に貼り付けられるとは限りません。

サブスクリプションを利用中で接続情報を1つ追加したいだけなら、クライアントの接続情報管理や更新機能を使ってください。このページにあるルート項目を変更する場合は、クライアントに対応する設定項目があるか、該当形式のカスタム設定をインポートできるか確認します。インポート先の種類が分からないときは、まずサブスクリプションのインポートと共有形式の解説を確認してください。クライアントの内部ファイルには、画面の設定や接続情報のインデックスが含まれることがあります。これを編集することはコアのJSONを変更することとは異なります。クライアントのデータファイルをコア設定として扱うと、起動時に失敗することがよくあります。

同じ設定項目でも、通信の取り込み方は同じとは限らない

プラットフォーム クライアント 設定の検証で優先して確認すること
Windows v2rayN システムプロキシが現在のinboundを指しているか、テストアプリがシステム設定に従うか。
macOS v2rayN 現在使っているネットワークサービスで該当するプロキシが有効か。比較時は同じネットワークサービスを使う。
Android v2rayNG / v2flyNG 接続の許可と対象アプリにテストアプリが含まれているか、インポート形式がコアに対応しているか。
Linux v2rayN デスクトップのプロキシ設定とプロセス単位の設定が一致しているか、ターミナルツールに別の環境設定がないか。

システムプロキシは通常、アプリがシステム設定を読み取り、それに従うことで機能します。JSONを保存しただけでは動作は変わりません。デスクトップで特定のinboundをテストする場合は、すべての通信制御を同時に有効にせず、まずアプリに手動でプロキシを指定してください。手動指定では使えるのにシステムプロキシに戻すと失敗する場合は、アプリがシステム設定をどう読み取るか、例外が適用されているか、クライアントがどのポートを設定したかを確認します。この状況でoutboundのプロトコルを変更しても、通常は不確定要素が増えるだけです。

TUNモードは仮想ネットワークインターフェース経由で通信を受け取り、ルーティング範囲、対象アプリ、システム権限などの条件に左右されます。SOCKS inboundのプロトコル名をTUNに変える機能ではなく、すべてのアプリ制限を回避するワンクリックの代替手段でもありません。Androidではシステムの許可とクライアント設定の両方を確認してください。デスクトップで動作した単一ポートのテスト用ファイルが、モバイル端末の通信も同じように制御できるとは限りません。プラットフォーム間で設定を移すときは、プロトコルに関する部分を再利用したうえで、各プラットフォームが通信をコアへ渡す仕組みを個別に検証します。

実際に読み込まれた設定とコアを確認する

クライアントのGUI設定から、起動時や接続情報の切り替え時に実行用設定が生成されることがあります。実行ディレクトリ内の一時ファイルを手動で編集しても、次回起動時に正常な設定で上書きされる場合があります。変更を維持するには、クライアントが対応する設定項目か、サポート対象の独立した設定ファイルを使ってください。変更が現在のインスタンスに反映されたか確認するには、判別しやすいローカルのテストポートに変更し、接続を再起動した後、アプリから新しいポートへ明示的にアクセスして旧ポートと比較します。画面に「保存済み」と表示されたことだけでは、コアがファイルを再読み込みした証拠になりません。

クライアントによって、選択されるコアが同じ拡張項目を異なる方法で解釈したり、対応範囲が異なったりする場合があります。設定を移行するときは、まずルート項目とプロトコルの基本的な互換性を確認し、その後にオプション機能を1つずつ戻してください。特定の設定を追加したときだけエラーになる場合は、起動できていた設定を残し、失敗した項目の完全なパスを記録します。他の人に相談するときは、関係する構造とエラー周辺だけを抜き出し、サブスクリプションURL、認証情報、不要なネットワーク情報を削除してください。設定ファイル全体を共有するより、再現条件を伝えるほうが役立ちます。

設定の検証とログによるトラブル対処

解析、待受、転送の3段階で検証する

起動直後に終了する場合は、まず実際に使われているコアが設定ファイルを解析できるか確認します。エラー位置を手掛かりに、直前のカンマ、引用符、括弧を見直し、項目のデータ型と、正しいインポート方法で読み込まれたファイルかを確認してください。構文が正しいことは、オブジェクトを読み取れたという意味であり、項目が有効だという意味ではありません。最初に明確に示されたエラーから確認し、修正後に再起動します。括弧の位置が1か所ずれただけで後続の複数行がエラーになることがあります。派生したエラーを個別に直すと、もともと正しい内容まで壊すおそれがあります。

解析に成功したら、ログにアドレスのバインド失敗やポート使用中の記録がないか確認し、宛先を固定して指定したinboundへ接続できるかテストします。以下の例では、ローカルの127.0.0.1:8000でHTTPテストサービスが利用できることを前提とします。第1章のベースラインを使い、拒否ルールを含む実験用設定は使いません。1つ目のコマンドはプロキシを経由せず、2つ目はHTTPプロキシを明示し、今回のリクエストではプロキシの例外設定を解除します。Windowsでコマンド名がシェルのエイリアスと重なる場合は、curl.exeと指定してください。

比較テスト · 直接アクセスしてからローカルHTTP inbound経由でアクセス
curl --noproxy "*" --max-time 5 http://127.0.0.1:8000/
curl --noproxy "" --proxy http://127.0.0.1:10809 --max-time 5 http://127.0.0.1:8000/

2回のテストでは同じ宛先とパスを使い、2回目のプロキシポートが設定と一致していることを確認してください。1つ目は成功し、2つ目でプロキシに接続できない場合は待受を調べます。プロキシには接続できるのにエラーが返る場合は、想定外のoutboundが選ばれていないか、宛先が接続を拒否していないかを確認します。両方が成功しても、正常と確認できたのはこのローカルHTTP経路だけです。他の宛先、別のプロトコル、システムによる通信制御まで正常とは限りません。inbound、routing、リモートoutboundを1つずつ追加し、差が出た段階の入力と出力から調べてください。

ログの段階から障害範囲を絞り込む

ログは、再現可能な操作と合わせて確認してください。操作時刻を記録し、関係のないテストウィンドウを閉じてから、新しいリクエストを1つ送ります。その時間帯のinbound、宛先、outbound、失敗理由を確認します。デフォルトのベースラインではwarningを使うため、転送に成功しても詳しい記録が出ないことがあります。より詳しい情報が必要なら、一時的にログレベルを上げ、クライアントのアクセス記録やログ表示機能を利用してください。コアによって出力内容は異なります。完全に同じ文面のエラーを探すのではなく、接続がどの段階で起きたかを判断材料にします。

正しいoutboundが選ばれているのにリモートのハンドシェイクが失敗する場合は、サービス側が要求するトランスポートとセキュリティの設定を確認し、デバイスの時刻やローカルの信頼済み証明書の状態にも注意してください。ドメイン名を使ったリクエストだけが失敗する場合は、名前解決の章に戻り、どのコンポーネントが問い合わせているか確認します。しばらくアイドル状態が続いた後にだけ切断する場合は、接続ポリシーの章でタイマーの動作を照合してください。詳しい例はv2rayNのログとエラーの調べ方を、クライアントの選び方や接続失敗時の基本的な確認手順はV2Ray初心者によくある10の質問をご覧ください。

テスト後は変更を元に戻し、再現できる記録を残す

検証が終わったら、一時的に設定したシステムプロキシやアプリのプロキシを元に戻し、使わなくなったテスト用inboundを停止して、ログレベルを通常の設定に戻します。最終版と直前のベースラインを並べて保存し、変更した項目のパス、検証に使った宛先とinbound、想定したoutboundを記録してください。次に接続の問題が起きたときは同じテストを再実行し、問題のある項目だけを戻せます。設定項目の背景は目次から該当する節を確認してください。用語がどの階層を指すか分からない場合はV2Ray用語集を参照してください。

クライアントをダウンロードする