V2Ray 設定檔 JSON 結構解析:逐段看懂 inbounds、outbounds、routing

逐一解析 V2Ray 設定檔中的 log、inbounds、outbounds、routing 與 dns,說明 tag 關聯、規則比對順序及常見欄位寫法,搭配片段範例快速理解。

本文速覽

取得用戶端產生的 JSON 後,先分清哪一段負責接收要求、哪一段選擇路徑,以及哪一段建立連線。本文以本機 SOCKS 和 HTTP 入站為例,說明標籤如何串起規則,並區分路由階段解析、出站解析與應用程式自行解析。範例連接埠僅供說明,並非用戶端預設值。

log:日誌與設定檔骨架

頂層是一個 JSON 物件。本文範例中的 log、routing、dns 都是物件;inbounds 和 outbounds 則是陣列,即使只有一個項目,也要保留方括號。頂層鍵的排列順序不會決定要求的路徑,但陣列中的順序可能有影響:規則會依序比對,若沒有符合的規則,通常會交由第一個出站處理。

應用程式要求本機入站規則比對選擇出站目標連線
{
  "log": {
    "loglevel": "warning"
  }
}

這只是日誌片段。排查問題時,可暫時將 loglevel 改為 info,重新載入設定後,讓同一個應用程式重現一次問題;記錄足夠後,再改回 warning。access 和 error 可指定對應日誌的輸出檔案,但設定檔能讀取,不代表日誌目錄可寫入。若問題發生在啟動階段,請先查看用戶端或啟動程序的提示,不要只等存取日誌出現。分享日誌前,請遮蔽訂閱網址、認證欄位及不宜公開的連線記錄。

inbounds:監聽位址、本機連接埠與標籤

入站的 listen 和 port 用來指定監聽位址與連接埠,protocol 則決定應用程式必須使用哪種代理協定;settings 的內容則由該協定解讀。若把應用程式的 HTTP 代理設定填到 SOCKS 連接埠,即使該連接埠正在監聽,也無法完成預期的協定交握。以下兩個項目都只監聽本機迴圈位址,不會對區域網路開放。

10808
範例 SOCKS 監聽連接埠
10809
範例 HTTP 監聽連接埠

SOCKS 入站

listen
127.0.0.1
port
10808
protocol
socks
tag
local-socks

在應用程式的 SOCKS 代理設定中填入此連接埠。

HTTP 入站

listen
127.0.0.1
port
10809
protocol
http
tag
local-http

在應用程式的 HTTP 代理設定中填入此連接埠。

先確認監聽狀態,再調整路由

若連線到本機連接埠時就遭到拒絕,請先確認核心已啟動、連接埠未被其他程序占用,且應用程式填寫的位址與實際監聽位址一致。要求尚未進入核心,提高路由規則優先順序也不會生效。

outbounds:出站協定與預設路徑

出站的 protocol 決定如何處理已接收的目標連線。freedom 用於直連,blackhole 用於封鎖。tag 是設定檔中的參照名稱,不是協定名稱:將標籤命名為 direct 並不會自動啟用直連,真正決定行為的是同一項中的 protocol。

{
  "outbounds": [
    {"tag": "direct", "protocol": "freedom", "settings": {}},
    {"tag": "blocked", "protocol": "blackhole", "settings": {}}
  ]
}

routing:標籤關聯與比對順序

routing.rules 會由上而下逐條檢查,第一條符合的規則就會決定流向。規則中的 inboundTag 是入站標籤陣列,outboundTag 則是單一出站標籤字串。若同時指定多個比對欄位,要求必須符合所有欄位。以下第一條規則只會封鎖從 SOCKS 入站進入、且目標網域恰好是 example.org 的要求;第二條則讓其他 SOCKS 要求直連。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "inboundTag": ["local-socks"],
        "domain": ["full:example.org"],
        "outboundTag": "blocked"
      },
      {
        "type": "field",
        "inboundTag": ["local-socks"],
        "outboundTag": "direct"
      }
    ]
  }
}
進入方式核心取得的目標預期出站
SOCKSexample.org第一條:blocked
SOCKSwww.example.org第二條:direct
HTTPexample.org沒有符合規則:第一個出站 direct

若交換兩條規則,原本的第二條就會先攔截所有 SOCKS 要求,精確網域規則便沒有機會符合。若只交換兩個出站、維持規則順序,已明確指定標籤的要求仍會走原本的路徑,但沒有符合規則的 HTTP 要求會改走新的第一個出站。排查流量誤分流時,請分別檢查這兩個陣列的順序,不要把預設出站誤當成最後一條路由規則。

dns:區分路由解析與應用程式解析

頂層的 dns 設定的是核心內建 DNS,不是作業系統的全域 DNS 設定。只新增 dns.servers,不會自動接管所有應用程式的查詢。若應用程式先解析網域,再只將目標 IP 傳給代理,路由就無法只憑這個 IP 還原原始網域;若沒有其他網域資訊,上述精確網域條件便不會符合。

{
  "dns": {
    "servers": ["localhost"]
  }
}

這裡使用 localhost 呼叫本機解析功能,以沿用系統現有的解析設定。這不代表會在本機連接埠啟動 DNS 服務,也不會決定最後的連線使用哪個出站。若要確認網域規則,請先確認測試要求是將網域交給入站,還是已由應用程式先轉換成 IP。

設定檔排錯:依序檢查啟動、入站、路由與出站

  1. 先確認實際載入的檔案。嚴格 JSON 必須使用雙引號,最後一個項目後不能加逗號。上方程式碼區塊分別展示不同的頂層欄位,不能直接將多個根物件串在一起。即使檔案是合法 JSON,若錯誤訊息指出特定欄位,仍須檢查欄位型別及核心是否支援。
  2. 確認核心與用戶端設定的界線。v2rayN 桌面版可前往「設定」→「參數設定」確認本機監聽設定,實際分類以目前版本為準。Android 版 v2rayNG 使用 Xray 核心,v2flyNG 使用 V2Fly 核心;基本欄位相似,不代表擴充欄位可以通用。Android 透過 VPN 接管流量的範圍,也不能依桌面系統代理設定推斷。
  3. 使用同一個測試應用程式,每次只修改一項。先透過正確的連接埠測試一般要求,再測試封鎖目標。若應用程式切換到 HTTP 代理後結果不同,先比對入站標籤;若同一入站下,網域與 IP 要求的結果不同,再確認應用程式傳給核心的是哪種目標格式。
  4. 最後檢查出站連線。符合預期標籤只代表路徑選擇正確,不表示一定能連上目標。直連失敗時,請檢查本機解析結果與目標是否可連線;遠端出站失敗時,再確認遠端連接埠、協定參數及傳輸設定。每次只修改一項,重新載入後重複相同測試,才能找出是哪項變更影響結果。
下載用戶端依平台選擇 v2rayN / v2rayNG