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

透過精簡設定範例,逐一說明 log、inbounds、outbounds、routing、dns 各欄位的用途,帶你看懂用戶端匯出的完整設定。

本文重點

取得 v2rayN 匯出的核心設定後,先找出本機監聽連接埠,再依規則中的標籤確認實際出站。本篇以同時包含直連與拒絕的範例,說明如何判讀預設出站、區分 DNS 與路由問題,以及判斷該調整用戶端設定或檢查核心記錄。

V2Ray JSON 範例:先看連線流程

先把設定想成一條連線路徑。inbounds 定義核心從哪裡接收連線,routing 決定連線交給哪個出站,outbounds 則定義接手後如何處理。log 和 dns 是輔助設定,並非每條連線都會依序經過的兩個節點。

應用程式請求本機入站路由比對出站處理

以下採用 V2Fly V2Ray 傳統 JSON 格式。範例不需要遠端帳號,也不依賴規則資料檔。應用程式必須主動連線至本機 SOCKS 入口,流量才會走這條路徑;啟動核心本身不會變更系統代理設定。範例連接埠僅供教學使用,並非 v2rayN 的預設值。

{
  "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"},
    {"tag": "reject", "protocol": "blackhole"}
  ],
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "inboundTag": ["local-socks"],
        "domain": ["full:example.org"],
        "outboundTag": "reject"
      }
    ]
  },
  "dns": {
    "servers": ["localhost"]
  }
}
10808
範例 SOCKS 監聽連接埠
2
出站:直連與拒絕
1
明確指定的路由規則

用戶端儲存的應用程式設定、訂閱內容,以及核心啟動時讀取的 JSON,屬於不同層次的資料。若 v2rayN 切換目前使用的設定後重新產生核心檔案,手動修改可能會被覆蓋。請比對實際載入的設定,不要只靠檔名判斷哪份 JSON 正在生效。

inbounds 與 outbounds:確認監聽位址和出站協定

應用程式無法連線時,先確認入口設定。範例只監聽 IPv4 迴路位址 127.0.0.1;應用程式應選擇 SOCKS5,而非將同一個連接埠設為 HTTP 代理。noauth 表示此入口不需要 SOCKS 驗證,不適合直接開放給區域網路使用。udp: false 則代表無法用此範例測試 SOCKS UDP 轉送。

應用程式端:SOCKS 入站

listen
127.0.0.1
port
10808
protocol
socks
tag
local-socks

應用程式連線的是監聽位址與連接埠,不是入站標籤。

核心端:直連出站

protocol
freedom
tag
direct
陣列位置
outbounds 第一項

標籤是供參照的名稱,真正決定處理方式的是協定及其設定。

如果實際匯出的設定中有 vmess 或 vless 出站,請分開確認應用程式連線的本機連接埠,以及出站設定中的遠端伺服器連接埠。settings 的內容會依協定而異;streamSettings 則用來描述傳輸與安全設定。連線至遠端時,這些設定必須符合對端要求;不能只替換某個出站的協定欄位,卻沿用另一個出站的設定結構。V2Fly 和 Xray 支援的欄位與值也可能不同,請依實際執行的核心及版本確認。

routing:依序比對,未命中時使用預設出站

對於範例中的一般出站規則,核心會依陣列順序逐條檢查,第一條符合的規則就會決定流量去向。同一條規則中的 inboundTag 和 domain 必須同時符合;outboundTag 則是比對成功後執行的動作。full:example.org 只會比對該網域本身,不包含子網域。

核心收到的目標範例結果判斷依據
example.orgreject從指定的入站進入,且完整網域符合。
www.example.orgdirect子網域不符合完整網域比對,會回到第一個出站。
應用程式預先解析出的目標 IPdirect範例未啟用嗅探,因此只有目標 IP 時不會符合這條網域規則。

規則未生效?先確認核心收到的是網域還是 IP

測試網域規則時,請讓應用程式以網域名稱提交 SOCKS 請求。若應用程式已先完成解析,只將 IP 傳給核心,請先調整測試方式,不要直接放寬分流規則。

閱讀含有多條規則的設定時,除了檢查標籤拼字,也要確認前面的寬鬆規則是否已攔截請求。例如,若前面有一條只限制 inboundTag 的規則,就會先接管該入口的連線,後面的網域規則便沒有機會比對。沒有任何規則符合時,本例會使用 outbounds 的第一項;若把拒絕出站移到第一項,未符合規則的連線也會遭到拒絕。

dns:分清本機解析、路由解析與出站解析

dns.servers 設定的是核心內建 DNS 模組使用的解析來源。此處的 localhost 表示使用本機系統的解析機制,不是要求在迴路位址另外啟動 DNS 服務,也不會自動接管應用程式的 DNS。是否會使用這個模組,需搭配核心的路由與出站設定判斷。

排查時請固定使用同一個應用程式、同一個入口和同一個測試網域。先確認失敗發生在解析階段,還是選定出站後才發生。若記錄顯示請求已進入 reject,應回頭檢查路由規則,而不是繼續更換解析器。反過來說,能連上某個 IP 不代表網域解析正常,也不代表使用該網域連線時能通過 TLS 驗證。

log 與設定排查:從啟動錯誤到規則比對

範例將 log.loglevel 設為 warning,適合先查看警告和錯誤,但不要期待它會顯示每條連線的路由細節。需要更多線索時,可在測試副本中暫時調整為 info,重現問題後再恢復。核心記錄可能包含目標網域、位址和連線時間;對外分享前請刪除敏感資訊,也不要附上訂閱網址或帳號欄位。

  1. 核心啟動失敗:先檢查標準 JSON 語法。物件鍵和值都要使用雙引號,最後一項後面不能多加逗號。接著確認核心是否支援該協定、傳輸方式和欄位;JSON 解析器能讀取,不代表核心就能載入。
  2. 核心已啟動,但連線遭拒:確認實際的監聽位址、連接埠和代理類型。若記錄指出位址已被占用,先確認是否有 v2rayN 目前執行中的核心程序或其他應用程式占用了範例連接埠。修改連接埠時,核心和測試應用程式都要一併更新。
  3. 應用程式走錯出口:確認應用程式確實使用這個 SOCKS 入口,再逐條檢查 rules,比對入站標籤、目標格式與出站標籤。檢查未符合規則的請求時,直接查看出站陣列的第一項。
  4. 設定儲存後又恢復原狀:先確認修改的是用戶端的持續性設定,還是啟動時產生的暫存檔。常用的分流規則建議在用戶端的路由設定中管理;測試 JSON 請另存副本,每次只修改一處,再查看記錄確認變化。
下載v2rayN平台與安裝檔選擇