Xray 設定檔結構解析：逐段了解 inbounds、outbounds 與 routing

設定物件與流量路徑

Xray 是處理連線的核心，v2rayN 則是用來管理節點、產生設定並啟動核心的桌面用戶端。節點分享連結通常只描述一個遠端連線；原生 JSON 則能同時設定本機監聽、多個出口、路由與 DNS。把分享連結存成 config.json，不會自動變成可供核心執行的設定檔。

上述流程是閱讀設定檔的主線。log 負責記錄狀態；需要解析網域名稱時，dns 會參與處理。兩者都不是每個請求必須依序經過的獨立轉送站。頂層物件在 JSON 中的排列順序，不會決定流量的處理順序。

• inbounds：流量從哪裡進入，以及使用哪種本機協定。
• outbounds：連線如何離開核心，例如直連、代理或封鎖。
• routing：依據目標與來源，選擇要使用的出站標籤。
• dns：設定內建 DNS；是否使用仍取決於相關的解析設定。

完整 JSON：本機入口與直連基礎設定

以下是一份用來理解結構的獨立設定。SOCKS 入口監聽 127.0.0.1:10808，HTTP 入口監聽 127.0.0.1:10809。此設定不含遠端代理節點：一般請求會直連，前往保留測試網域 blocked.test 的請求則會遭到封鎖。這份設定無法用來測試遠端代理是否可用。

{
  "log": {
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "tag": "socks-in",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    },
    {
      "tag": "http-in",
      "listen": "127.0.0.1",
      "port": 10809,
      "protocol": "http",
      "settings": {}
    }
  ],
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {
        "domainStrategy": "UseIP"
      }
    },
    {
      "tag": "block",
      "protocol": "blackhole",
      "settings": {}
    }
  ],
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": [
          "full:blocked.test"
        ],
        "outboundTag": "block"
      },
      {
        "type": "field",
        "ip": [
          "127.0.0.0/8",
          "10.0.0.0/8",
          "172.16.0.0/12",
          "192.168.0.0/16"
        ],
        "outboundTag": "direct"
      }
    ]
  },
  "dns": {
    "servers": [
      "localhost"
    ]
  }
}

此範例是嚴格格式的 JSON：鍵名與字串都使用雙引號、不含註解，且最後一個陣列項目後不加逗號。本文後續的欄位說明是用來解讀這份設定，不需要再逐段拼成另一份設定檔。

log：先確認錯誤發生在哪個環節

loglevel 用來設定錯誤記錄的詳細程度。常見值有 debug、info、warning、error 和 none。排除問題時，可以暫時將範例中的 warning 改成 info；完成後再改回來，避免保留過多連線細節。

本例未指定記錄檔路徑；透過命令列執行時，請先查看終端機輸出。若要自行加入 access 或 error，請選擇目前程序有權寫入的路徑，並留意相對路徑是以啟動工作目錄為基準。記錄中可能包含存取目標，分享排錯資訊前請先移除敏感內容。

• 尚未啟動就出現 JSON 解析錯誤：先檢查括號、逗號與欄位型別。
• 啟動時出現 address already in use：檢查本機連接埠，不要先修改遠端協定。
• 入口已接收請求，但接著發生連線逾時：再檢查實際使用的出站、解析結果與目標是否可連線。

inbounds：監聽位址、連接埠與入口標籤

每個入站物件都是一個接收流量的入口。listen 是綁定位址，port 是監聽連接埠，protocol 則決定應用程式要用哪種協定連線。tag 是設定檔內部的識別標籤，不是密碼，也不是要填入瀏覽器的主機名稱。

127.0.0.1 僅接受本機連線。改成 0.0.0.0 會擴大 IPv4 監聽範圍；其他裝置能否連線，還要視防火牆與網路環境而定。本例的 SOCKS 使用 noauth，因此不要為了嘗試在區域網路共用，就直接擴大監聽範圍。

• 瀏覽器讀取系統代理設定時，應將代理指向實際的 HTTP 入口，不要混用兩個連接埠。
• 本機連接埠不是遠端伺服器的連接埠；修改 10808 不會變更節點的伺服器端設定。
• udp: true 只會啟用 SOCKS 入站的 UDP 功能，不會讓 HTTP 入口自動承載一般 UDP 流量。

outbounds：出站協定與預設出站

outbounds 是可供路由選擇的出站陣列。本例中的 freedom 會直接連線至目標，blackhole 則會封鎖連線。這裡的 direct、block 都是自行定義的標籤；實際行為由 protocol 決定，而不是由標籤的英文名稱決定。

新增遠端代理出站時，協定、伺服器位址、連接埠、身分參數與傳輸設定都必須彼此相符。不能只把 freedom 改成 vless，就以為已經設定好節點。TLS 或 REALITY 相關欄位屬於相應的傳輸安全設定，不應隨意加入 SOCKS 入站的 settings。

routing：規則順序、標籤引用與解析策略

routing.rules 會依陣列順序比對，第一條符合的規則決定出站。本例第一條規則會將完整網域 blocked.test 導向 block；第二條則將列出的 IPv4 網段導向 direct。這些網段僅供示範，並非完整的特殊用途位址清單，也不含 IPv6。

1. 請求進入後，核心會取得入口標籤、目標網域或 IP、連接埠等可用資訊。
2. 從第一條規則開始依序檢查；同一條規則中的不同條件類別通常必須同時符合。
3. 同類清單中的候選項目通常採「符合任一項即可」的方式判斷，例如符合 ip 陣列中的任一網段。
4. 找到符合的規則後，使用其 outboundTag；若沒有符合項目，則使用預設出站。

full: 表示比對完整網域；domain: 用於比對網域及其子網域。若要限制特定入口，可在規則中加入 inboundTag 陣列。引用的標籤必須與對應物件的 tag 完全一致；入口與出口標籤各有用途，不能將 socks-in 當成出站標籤引用。

範例使用 AsIs，因此以網域形式提交的請求不會只為了符合第二條 IP 規則而進行解析。不過，本例的預設出站仍是直連，所以看到請求直連，不能據此推斷它符合了私有網段規則。排查規則時，應查看實際符合的規則與出站，而不只是確認網頁最後能否開啟。

dns：釐清路由解析與連線解析

設定 dns 不代表所有應用程式的 DNS 查詢都會交由 Xray 處理。應用程式可能先自行解析，再將 IP 傳給代理；也可能把網域交給 SOCKS 或 HTTP 入口。路由能取得哪些資訊，首先取決於入口實際收到的內容。

本例的 dns.servers 使用特殊值 localhost，表示透過本機系統解析器進行解析，而不是指定一台在本機執行的 DNS 伺服器。這也不會建立 UDP 53 監聽連接埠。若要提供 DNS 服務給應用程式使用，必須另外設計接收 DNS 請求的入口與處理路徑。

• routing.domainStrategy：決定路由比對階段是否需要將網域解析為 IP。
• freedom.settings.domainStrategy：決定直連出站如何處理目標網域。
• dns.servers：提供內建 DNS 使用的解析來源，實際呼叫時機則由相關功能決定。

本例在 freedom 出站設定 UseIP，讓直連出站透過內建 DNS 解析流程處理網域。這與路由的 AsIs 並不衝突：前者是在出站準備連線時生效，後者則限制規則比對階段。即使出站之後取得 IP，也不會自動重新執行已完成的路由選擇。

驗證與排錯：從設定檢查到實際連線

先使用核心內建的檢查命令驗證設定，再啟動監聽，最後讓應用程式連線。以下命令請在能找到 xray 執行檔的終端機中執行；若執行檔不在命令搜尋路徑中，請改用實際路徑。先查看版本與說明，即可確認目前的執行檔支援哪些參數。

xray version
xray run -help
xray run -test -config ./config.json
xray run -config ./config.json

設定檢查通過，只代表核心接受這份設定，不表示遠端服務可連線，也不表示應用程式已使用代理。若要進行可重複的本機測試，可先在另一個終端機啟動測試服務，再分別透過兩個入口存取：

python -m http.server 8000 --bind 127.0.0.1

curl --noproxy "" --proxy socks5h://127.0.0.1:10808 http://127.0.0.1:8000/
curl --noproxy "" --proxy http://127.0.0.1:10809 http://127.0.0.1:8000/

測試前，本機必須已安裝 Python 和 curl。回應內容來自本機測試目錄，驗證的是「應用程式連上入口、路由選擇、直連出站」這段流程。--noproxy "" 可避免既有的略過代理設定跳過本次入口測試。測試完成後請停止暫時啟動的服務，不要把終端機顯示的目錄清單當成代理節點的測速結果。

完成基礎設定驗證後，再新增遠端代理出站，並為其設定明確的路由。每次只修改一個部分，並保留上一份可正常運作的設定。發生問題時，才能將排查範圍縮小到入口、規則、解析或遠端連線，而不必在多項無關設定間反覆切換。