取得用戶端產生的 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 連接埠,即使該連接埠正在監聽,也無法完成預期的協定交握。以下兩個項目都只監聽本機迴圈位址,不會對區域網路開放。
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": {}}
]
}
- 這組出站設定用來測試直連與封鎖,不需要遠端帳號。測試前請確認允許預設直連,因為這裡將
direct排在第一位。 - 設定 VMess 等遠端出站時,伺服器位址、遠端連接埠和使用者參數屬於出站協定設定;這些不是應用程式代理設定中填寫的本機位址與連接埠。傳輸方式及適用的安全設定也必須與伺服器一致。
- 訂閱連結是用戶端取得設定資料的入口,不是核心出站的伺服器位址。更新訂閱或切換節點後,用戶端可能會重新產生執行設定;直接修改產生的檔案,變更不一定會保留。
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"
}
]
}
}
| 進入方式 | 核心取得的目標 | 預期出站 |
|---|---|---|
| SOCKS | example.org | 第一條:blocked |
| SOCKS | www.example.org | 第二條:direct |
| HTTP | example.org | 沒有符合規則:第一個出站 direct |
若交換兩條規則,原本的第二條就會先攔截所有 SOCKS 要求,精確網域規則便沒有機會符合。若只交換兩個出站、維持規則順序,已明確指定標籤的要求仍會走原本的路徑,但沒有符合規則的 HTTP 要求會改走新的第一個出站。排查流量誤分流時,請分別檢查這兩個陣列的順序,不要把預設出站誤當成最後一條路由規則。
dns:區分路由解析與應用程式解析
頂層的 dns 設定的是核心內建 DNS,不是作業系統的全域 DNS 設定。只新增 dns.servers,不會自動接管所有應用程式的查詢。若應用程式先解析網域,再只將目標 IP 傳給代理,路由就無法只憑這個 IP 還原原始網域;若沒有其他網域資訊,上述精確網域條件便不會符合。
{
"dns": {
"servers": ["localhost"]
}
}
這裡使用 localhost 呼叫本機解析功能,以沿用系統現有的解析設定。這不代表會在本機連接埠啟動 DNS 服務,也不會決定最後的連線使用哪個出站。若要確認網域規則,請先確認測試要求是將網域交給入站,還是已由應用程式先轉換成 IP。
AsIs:路由階段不會為了比對規則而主動解析網域。既有的 IP 目標仍可比對 IP 規則。IPIfNonMatch:網域目標在第一輪未符合規則時,可先解析,再嘗試比對 IP 規則。若前面的寬鬆規則已符合,不會因後面還有 IP 規則而再次解析。IPOnDemand:比對過程遇到需要 IP 的規則時,可視需要解析網域。調整策略前,請先確認規則確實需要比對目標位址,而非只比對入站標籤。
設定檔排錯:依序檢查啟動、入站、路由與出站
- 先確認實際載入的檔案。嚴格 JSON 必須使用雙引號,最後一個項目後不能加逗號。上方程式碼區塊分別展示不同的頂層欄位,不能直接將多個根物件串在一起。即使檔案是合法 JSON,若錯誤訊息指出特定欄位,仍須檢查欄位型別及核心是否支援。
- 確認核心與用戶端設定的界線。v2rayN 桌面版可前往「設定」→「參數設定」確認本機監聽設定,實際分類以目前版本為準。Android 版 v2rayNG 使用 Xray 核心,v2flyNG 使用 V2Fly 核心;基本欄位相似,不代表擴充欄位可以通用。Android 透過 VPN 接管流量的範圍,也不能依桌面系統代理設定推斷。
- 使用同一個測試應用程式,每次只修改一項。先透過正確的連接埠測試一般要求,再測試封鎖目標。若應用程式切換到 HTTP 代理後結果不同,先比對入站標籤;若同一入站下,網域與 IP 要求的結果不同,再確認應用程式傳給核心的是哪種目標格式。
- 最後檢查出站連線。符合預期標籤只代表路徑選擇正確,不表示一定能連上目標。直連失敗時,請檢查本機解析結果與目標是否可連線;遠端出站失敗時,再確認遠端連接埠、協定參數及傳輸設定。每次只修改一項,重新載入後重複相同測試,才能找出是哪項變更影響結果。