適合已使用 v2rayN 匯入訂閱,並開始閱讀核心設定的使用者。本文以一份只有本機入口和兩個出站的 JSON,說明連接埠設定位置、規則如何指定出站,以及未符合規則時請求會走哪條路徑。範例不需要遠端節點,也不應直接取代日常使用的設定。
頂層結構:從入口追蹤請求到出口
閱讀設定時,先找出應用程式實際連線的位址和連接埠,而不是先看訂閱中的伺服器位址。應用程式將請求交給入站後,核心才會根據請求附帶的目標資訊比對路由。規則選定出站後,出站會決定直接連線至目標、經遠端代理轉送,或終止請求。
log是用來設定記錄等級等選項的物件。它可協助確認請求處理進度,但不會參與路由選擇。inbounds是陣列,每個元素描述一個接收入口,包括監聽位址、連接埠,以及應用程式要使用的協定。outbounds是陣列,每個元素定義一種出站行為;陣列的第一個項目也會作為沒有符合路由規則時的預設出站。routing是物件,其中的rules是有順序的陣列,透過outboundTag指定出站的tag。
最小化 JSON 範例:兩個本機入口與兩個出站
以下使用 V2Ray v4 格式的 JSON 欄位,並將 SOCKS 與 HTTP 入口分開,方便在應用程式中分別測試。範例連接埠僅供本文示範,不代表 v2rayN 的預設值;若連接埠已被使用,請同時修改設定檔和應用程式中的連接埠。
{
"log": { "loglevel": "warning" },
"inbounds": [
{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"tag": "local-socks",
"settings": { "auth": "noauth", "udp": false }
},
{
"listen": "127.0.0.1",
"port": 10809,
"protocol": "http",
"tag": "local-http",
"settings": {}
}
],
"outbounds": [
{ "protocol": "freedom", "tag": "direct", "settings": {} },
{ "protocol": "blackhole", "tag": "block", "settings": {} }
],
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"domain": ["full:example.org"],
"outboundTag": "block"
}
]
}
}
這份設定只有一條規則:核心收到的目標網域恰好是 example.org 時,選用 block;其他請求則使用第一個出站 direct。範例不包含 DNS 分流、遠端節點或流量嗅探。儲存為 JSON 時,陣列最後一個元素後不要加逗號,也不要在程式碼中插入說明註解。
inbounds 與 log:先確認應用程式已連上核心
listen 決定核心在哪個本機位址接收連線。此處使用迴路位址 127.0.0.1,僅供本機應用程式存取。不要只為了排查連線問題就改成 0.0.0.0:這會擴大入口的監聽範圍,而範例並未設定代理驗證。
- 確認入口協定。應用程式選用 HTTP 代理時,請填入
127.0.0.1:10809;選用 SOCKS5 時,請填入127.0.0.1:10808。本機入口使用 HTTP,不代表只能瀏覽 HTTP 網頁;支援 CONNECT 的應用程式也能透過此入口連線至 HTTPS 目標。範例中的 SOCKS 入口已停用 UDP。 - 確認測試用的應用程式是否遵循代理設定。系統代理只會提供入口給遵循該設定的應用程式,無法保證所有流量都會進入核心。測試時,建議優先使用可單獨指定代理的應用程式,避免將繞過代理的連線結果誤認為路由結果。
- 確認核心記錄。
warning適合日常記錄警告及更嚴重的問題。排查時可暫時改成debug,重新載入後再試一次,接著恢復原本的等級。若連接埠繫結失敗,應先排除監聽衝突;記錄中沒有請求資料,也不能單憑這點判定入站失敗,還須一併確認記錄等級和應用程式設定。
outbounds:協定決定行為,標籤供規則指定
freedom 會讓核心直接連線至目標,但仍受本機網路和解析結果影響。這並不是讓應用程式繞過本機代理:應用程式已將請求交給核心,只是核心沒有再把請求轉交給遠端代理。blackhole 則用來終止符合條件的流量;應用程式可能顯示連線中斷或請求失敗,不一定會出現明確的封鎖頁面。
protocol- 決定出站的實作方式。訂閱產生的遠端代理出站可能使用 VMess;遠端位址和協定參數屬於該出站,不是本機監聽參數。協定專用的
settings無法直接從freedom搬用。 tag- 這是設定檔內的參照名稱。
direct和block都不是協定關鍵字。若將block改名,必須同步修改引用它的outboundTag,並確保出站標籤不重複。 - 陣列順序
- 沒有任何規則符合時,請求會交給第一個出站。若將
blackhole移到本例的第一位,原本應直接連線的未符合請求也會遭到終止。
routing:依序比對,不按規則精確度排序
核心會由上而下檢查 routing.rules,採用第一條符合條件的規則。若同一條規則同時設定 inboundTag 和 domain,兩者都必須符合。舉例來說,若在範例規則中加入 "inboundTag": ["local-http"],從 SOCKS 入口進入的相同網域就不會符合該規則。
| 核心收到的目標 | 是否符合 | 範例出站 |
|---|---|---|
example.org | 符合完整網域 | block |
www.example.org | 不符合,子網域不等於完整網域 | direct |
example.com | 不符合 | direct |
| IP 位址字面值 | 不符合,範例不會還原目標網域 | direct |
結論:先確認核心收到的是網域還是 IP
使用 SOCKS 測試網域規則時,請在用戶端選擇會將目標網域傳給 SOCKS5 代理的選項。若應用程式已在本機解析,只提交 IP,請先調整測試入口,再修改規則。AsIs 不會為路由比對主動解析網域,也不會從 IP 反查原始網域。
若要涵蓋根網域和子網域,可改用 domain:example.org。如果前面已有涵蓋相同目標的廣泛規則,例如將該網域及所有子網域設為直連,後面的 full:example.org 封鎖規則就不會執行。若要保留這項例外,請將完整網域規則放在廣泛規則之前。
v2rayN 設定常見問題
為什麼手動修改 JSON 後,一切換節點設定就還原了?
先確認你編輯的是獨立設定檔,還是 v2rayN 產生的執行檔。產生的檔案可能在切換節點或重新啟動核心時重建。若要長期修改一般節點的路由,請使用用戶端的路由設定;若要單獨測試完整 JSON,請保留獨立副本,並交由對應的核心載入。
可以直接把這段 JSON 填入訂閱網址嗎?
不行。訂閱網址用來取得節點清單,本例則是供核心讀取的設定物件。請先確認目前使用的節點類型和核心,再決定要在 v2rayN 中調整路由,或獨立載入設定。不同核心的欄位名稱不能直接互換使用。
修改後兩個測試網域都無法連線,該先檢查什麼?
先確認核心是否成功載入,再使用相同的應用程式和代理入口測試 example.com。它應會使用 direct,但仍須確保本機能解析並連線至目標。確認這項對照測試後,再測試 example.org;兩個網頁都無法開啟,並不足以證明封鎖已生效。