V2Ray設定ファイルの構造を段階別に解説：inbounds・outbounds・routingの役割分担

まず設定ファイル内の通信経路を把握する

V2Rayの設定ファイルはJSONオブジェクトで、トップレベルの項目がログ、ドメイン解決、インバウンド、アウトバウンド、ルーティングを制御します。コアはファイルを上から1行ずつ実行するのではなく、起動時に設定全体を読み込み、待受ポート、アウトバウンド処理、ルーティングルールを構築します。設定を理解するときは、行番号ではなくデータの流れに沿って読みましょう。

アプリはまず本機のSOCKSまたはHTTPプロキシポートへリクエストを渡します。これは設定のinboundsに対応します。インバウンドが宛先アドレスを識別すると、接続はルーティングモジュールへ渡されます。routingはルールの順序に従ってアウトバウンドのタグを選択し、最終的にoutboundsでそのタグに対応する処理がリモート接続を確立するか、宛先へ直接アクセスします。dnsは解決が必要なドメインに結果を提供し、logはその過程の警告やエラーを記録します。

以下のサンプルでは、本機のSOCKSポート10808を使用し、VMessプロキシのアウトバウンドとfreedomによる直接接続のアウトバウンドを定義します。プライベートアドレスは直接接続、それ以外のTCP・UDP通信はプロキシへ送ります。例のドメインには予約済みのexample.comを使っていますが、構造を示すためだけのもので、実際に利用できるサーバー設定ではありません。

{
  "log": {
    "loglevel": "warning"
  },
  "dns": {
    "servers": [
      "localhost",
      "1.1.1.1"
    ]
  },
  "inbounds": [
    {
      "tag": "socks-in",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      },
      "sniffing": {
        "enabled": true,
        "destOverride": [
          "http",
          "tls"
        ]
      }
    }
  ],
  "outbounds": [
    {
      "tag": "proxy",
      "protocol": "vmess",
      "settings": {
        "vnext": [
          {
            "address": "server.example.com",
            "port": 443,
            "users": [
              {
                "id": "11111111-2222-4333-8444-555555555555",
                "security": "auto"
              }
            ]
          }
        ]
      },
      "streamSettings": {
        "network": "tcp",
        "security": "none"
      }
    },
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {}
    }
  ],
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "ip": [
          "geoip:private"
        ],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "network": "tcp,udp",
        "outboundTag": "proxy"
      }
    ]
  }
}

inbounds：通信をコアへ渡せる接続元を定義する

settingsとsniffingの役割

• tagはインバウンドの内部識別子で、ルーティングルールはinboundTagを使って通信元を区別できます。
• listen: 127.0.0.1は、現在の端末だけで使うローカルプロキシ入口に適しています。
• portが競合すると、通常は待受に失敗した、またはアドレスがすでに使用中であるというメッセージがログに表示されます。
• udp: trueは、SOCKSインバウンドでUDPリクエストを処理できることを示します。ただし、実際に転送できるかどうかはアウトバウンドのプロトコルとサーバー側の設定にも左右されます。

outbounds：通信がどこから出ていくかを定義する

プロトコルパラメータとトランスポートパラメータは別の層

VMessを例にすると、settings内のvnextはリモートサーバーとユーザーを記述し、streamSettingsは基盤となるネットワークとセキュリティ方式を記述します。サーバーポートが正しくてもトランスポート方式が一致しなければ、TCP接続が確立していてもプロトコルのハンドシェイクは失敗します。そのため、接続問題を切り分ける際はアドレス、ポート、ユーザー識別子だけを確認してはいけません。

routing：ルールに従ってインバウンド接続をアウトバウンドへ渡す

1. ルールのtypeがコアのサポート対象であることを確認し、一般的なフィールド一致ルールではfieldを使用します。
2. 条件がドメイン、IP、ポート、ネットワーク種別、インバウンドタグのどれに該当するかを確認します。
3. 上から順に、最初に一致する可能性のあるルールを探します。期待しているルールだけを見てはいけません。
4. outboundTagがoutbounds内のいずれかのtagと、大文字・小文字を含めて完全に一致しているか確認します。
5. 一時的にログレベルを上げてコアを再起動し、実際の宛先とエラーが発生した段階をログで確認します。

domainStrategyは、ルーティングのためにドメインを解決するタイミングを決める

dnsとlog：名前解決とトラブルシューティングを支援する

dnsは、コアが利用できるDNSサーバーと関連する解決戦略を定義します。サンプルではlocalhostと1.1.1.1を順に記載し、サーバーリストの構造を示しています。実際の設定では、ネットワーク環境とルーティングの目的に応じて解決方法を選び、問い合わせが想定したアウトバウンドで処理されるか確認してください。

アプリ自身の名前解決、OSによる名前解決、V2Ray内蔵DNSは明確に区別する必要があります。アプリが先にドメインを解決し、IPだけをSOCKSインバウンドへ渡した場合、コアは同じドメイン検索を再実行するとは限りません。sniffingを有効にするとドメインを復元できる場合がありますが、成功するかどうかはプロトコル通信から該当情報を抽出できるかに左右されます。ドメイン振り分けを調べるときは、まずコアが実際に受け取ったのがドメインかIPかを確認します。

loglevelは出力の詳細度を制御します。通常の運用ではwarningにすると警告とエラーを残せます。リクエストの経路を確認したい場合は、一時的にinfoまたはdebugへ変更します。詳細レベルでは記録量が増えるため、問題解決後も長期間そのままにするのは避けてください。

• 起動後も待受ポートがまったく開かない：まずJSON構文、項目の型、ポートの使用状況を確認します。
• ローカルポートには接続できるがリモート接続に失敗する：outboundsのサーバー、プロトコル、トランスポートパラメータを確認します。
• プロキシは使えるが振り分けが間違っている：routingの順序、宛先の形式、outboundTagを確認します。
• ドメインは失敗するがIPにはアクセスできる：DNS応答、解決経路、ドメイン戦略を確認します。
• UDPアプリだけが異常：インバウンドでUDPが許可されているか確認し、アウトバウンドとサーバー側のUDP対応も確認します。

クライアントで設定を生成して手動で切り分ける

v2rayN、v2rayNG、v2flyNGは、GUIで指定したサーバーとルーティングの項目に基づいてコア設定を生成します。サブスクリプションURLや共有リンクは主に、1台のサーバーに必要なプロトコルパラメータを提供します。クライアントはさらにローカルインバウンド、ログ、DNS、ルーティングの内容を追加するため、共有リンクの項目だけでは、最終的にコアへ渡される完全なJSONとは通常一致しません。

GUIクライアントを使う場合、実行時に生成されたファイルを長期的な設定元として直接編集するのはおすすめしません。クライアントがコアを再起動したり、サーバーを切り替えたり、設定を更新したりすると、生成ファイルが上書きされる可能性があります。より確実なのは、まず画面上で該当項目を変更し、ログまたは生成結果でフィールドを確認する方法です。独立した設定を管理する必要がある場合は、別ファイルとして管理し、変更のたびに構文チェックと起動テストを行ってください。

推奨する最小限の切り分け手順

1. まずJSONを解析できることを確認し、すべてのオブジェクト、配列、カンマ、引用符の位置が正しいか確認します。
2. コアを起動し、127.0.0.1:10808がすでに待ち受けているか確認します。
3. 一時的に、明確なプロキシアウトバウンドと直接接続アウトバウンドを1つずつだけ残し、変数を減らします。
4. routingルールを2つ使い、プライベートアドレスは直接接続、それ以外はプロキシになることを確認します。
5. 基本接続が確立したら、ドメインカテゴリ、ポート条件、追加のアウトバウンドを1つずつ加えます。
6. 一度に変更するのは関連する項目の1グループだけにし、再起動後すぐに該当するログを確認します。

V2Ray設定の要点は、各項目を接続経路に置き換えて理解することです。inboundsは受信、routingは選択、outboundsは送信、dnsはドメインの一致と接続に必要な解決結果の提供、logは各段階の診断情報を担います。問題が起きたら、この5つの境界に沿って範囲を少しずつ絞るほうが、プロトコル、ポート、DNS、ルーティングを同時に変更するより検証可能な結論に近づけます。