V2Ray JSON 設定檔結構解析:inbounds、outbounds 與 routing 說明

逐段解析 V2Ray JSON 設定:log、inbounds 本機監聽、outbounds 出站、freedom/blackhole 與 routing 規則比對順序,附可對照的範例。

本文重點

適合已使用 v2rayN 匯入訂閱,並開始閱讀核心設定的使用者。本文以一份只有本機入口和兩個出站的 JSON,說明連接埠設定位置、規則如何指定出站,以及未符合規則時請求會走哪條路徑。範例不需要遠端節點,也不應直接取代日常使用的設定。

頂層結構:從入口追蹤請求到出口

應用程式請求本機入站規則比對指定出站

閱讀設定時,先找出應用程式實際連線的位址和連接埠,而不是先看訂閱中的伺服器位址。應用程式將請求交給入站後,核心才會根據請求附帶的目標資訊比對路由。規則選定出站後,出站會決定直接連線至目標、經遠端代理轉送,或終止請求。

最小化 JSON 範例:兩個本機入口與兩個出站

以下使用 V2Ray v4 格式的 JSON 欄位,並將 SOCKS 與 HTTP 入口分開,方便在應用程式中分別測試。範例連接埠僅供本文示範,不代表 v2rayN 的預設值;若連接埠已被使用,請同時修改設定檔和應用程式中的連接埠。

10808
範例 SOCKS 監聽連接埠
10809
範例 HTTP 監聽連接埠
2
範例出站數量
{
  "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:這會擴大入口的監聽範圍,而範例並未設定代理驗證。

  1. 確認入口協定。應用程式選用 HTTP 代理時,請填入 127.0.0.1:10809;選用 SOCKS5 時,請填入 127.0.0.1:10808。本機入口使用 HTTP,不代表只能瀏覽 HTTP 網頁;支援 CONNECT 的應用程式也能透過此入口連線至 HTTPS 目標。範例中的 SOCKS 入口已停用 UDP。
  2. 確認測試用的應用程式是否遵循代理設定。系統代理只會提供入口給遵循該設定的應用程式,無法保證所有流量都會進入核心。測試時,建議優先使用可單獨指定代理的應用程式,避免將繞過代理的連線結果誤認為路由結果。
  3. 確認核心記錄。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;兩個網頁都無法開啟,並不足以證明封鎖已生效。

下載 v2rayN