V2Ray 設定檔結構逐段解析：inbounds、outbounds 與 routing 的職責分工

先建立設定檔的流量路徑

V2Ray 設定檔是一個 JSON 物件，頂層欄位分別控制日誌、網域解析、入站、出站與路由。核心並不是按照檔案由上而下逐行執行，而是在啟動時讀取完整設定，建立監聽連接埠、出站處理器與路由規則。理解設定時應依資料流閱讀，而非按照文字行號閱讀。

應用程式首先將請求交給本機的 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，用於說明伺服器清單結構。實際設定應依網路環境與路由目標選擇解析方式，並注意查詢是否會由預期的出站處理。

需要特別區分應用程式自己的解析、作業系統解析與 V2Ray 內建 DNS。若應用程式先解析網域，只將 IP 交給 SOCKS 入站，核心未必會重新執行相同的網域查詢；啟用 sniffing 後可能還原網域，但能否成功取決於協定流量中是否能擷取相應資訊。排查網域分流時，應先確認核心實際收到的是網域還是 IP。

loglevel 控制輸出的詳細程度。日常執行使用 warning 可保留警告與錯誤；需要觀察請求路徑時，可以暫時改為 info 或 debug。詳細層級會產生更多記錄，問題解決後不宜長期保留。

• 啟動後完全沒有監聽連接埠：先檢查 JSON 語法、欄位類型與連接埠占用情況。
• 本機連接埠可連線但遠端失敗：核對 outbounds 的伺服器、協定與傳輸參數。
• 代理可用但分流錯誤：檢查 routing 順序、目標形式與 outboundTag。
• 網域連線失敗但 IP 可存取：檢查 DNS 回應、解析路徑與網域策略。
• 只有 UDP 應用程式異常：確認入站允許 UDP，並核對出站與伺服器端的 UDP 能力。

從用戶端產生設定到手動排查

v2rayN、v2rayNG 與 v2flyNG 會根據圖形介面中的伺服器與路由選項產生核心設定。訂閱位址或分享連結主要提供單一伺服器所需的協定參數，用戶端還會補充本機入站、日誌、DNS 與路由內容。因此，分享連結中的欄位集合通常不等於最後交給核心的完整 JSON。

使用圖形用戶端時，不建議直接將執行期間產生的檔案當作長期設定來源來修改。用戶端重新啟動核心、切換伺服器或更新設定後，產生的檔案可能會被覆寫。較穩妥的做法是先在介面中修改對應選項，再透過日誌或產生結果核對欄位。若必須維護獨立設定，則應將其作為單獨檔案管理，並在每次修改後執行語法檢查與啟動測試。

建議採用的最小排查順序

1. 先確認 JSON 可以解析，所有物件、陣列、逗號與引號的位置都正確。
2. 啟動核心並檢查 127.0.0.1:10808 是否已開始監聽。
3. 暫時保留一個明確的代理出站與一個直連出站，減少變數數量。
4. 使用兩條 routing 規則驗證私有位址直連，其餘流量走代理。
5. 確認基礎連線成立後，再逐項加入網域類別、連接埠條件與更多出站。
6. 每次只修改一組相關欄位，重新啟動後立即讀取對應日誌。

讀懂 V2Ray 設定的關鍵，是將欄位還原為連線路徑：inbounds 負責接收，routing 負責選擇，outbounds 負責傳送，dns 為網域比對與連線提供解析結果，log 則為每個階段提供診斷線索。遇到問題時，依這五個邊界逐段縮小範圍，比同時修改協定、連接埠、DNS 與路由更容易得到可驗證的結論。