CONFIGURATION MANUAL

v2rayN 進階設定指南

依設定確認適用範圍,從連線結果確認生效位置。

本頁適合完成初次連線後查閱。首次安裝、匯入訂閱及確認連線,請先參閱入門指南;需要切換平台或重新安裝時,請到下載中心選擇適用的安裝套件。桌面版首推 v2rayN,以下圖形介面操作皆以此為例。文中的 JSON 依照 Xray 設定結構說明,請勿直接貼入其他核心的編輯器。

設定名稱可能因用戶端介面與核心而異。每次只修改一個層級,並在同一個應用程式、同一個目標上重新測試。先確認項目是否已匯入,再檢查流量是否進入預期的入口,最後核對解析結果與出站選擇。匯入清單為空、無法啟動等入門問題,也可先參閱v2rayN 新手常見十問。

訂閱群組與伺服器篩選

分清來源群組、介面搜尋與匯入篩選

訂閱群組會整理來源網址、更新選項及匯入後的伺服器項目。伺服器清單上方的搜尋只會縮小目前顯示範圍,不會清除訂閱快取;群組編輯中的篩選則可能在更新時略過不符合條件的項目。兩處輸入相同文字,顯示結果也可能不同。群組名稱只用來在用戶端辨識來源,不影響協定連線。命名時請清楚標示用途與來源關係,勿將網址中的存取參數放進名稱、截圖或故障紀錄。

在 v2rayN 的「訂閱群組」選單中開啟群組設定,新增來源並儲存,再回到主清單切換至該群組。從更新選單選擇目前的訂閱,不要一開始就更新所有訂閱。首次更新先保留原始項目,不設定篩選條件。更新完成後清除介面搜尋,確認群組內至少有一筆可正常使用的項目,再觀察該來源的備註命名規則。先建立完整基準,才能判斷後續項目減少是服務端調整、匯入失敗,還是本機篩選所致。

依完整備註設計篩選條件

篩選通常以伺服器備註為比對對象,不會比對位址欄位、協定屬性或自訂群組名稱。如果目前介面標示支援正規表示式,請先用一筆確實存在的備註測試,再套用到同類名稱。例如備註以「家用」開頭,後面接空白或連字號時,可使用下方的表示式;備註剛好是「家用」的項目也會保留。請將表示式直接貼入正規表示式欄位,不要加上程式語言中的斜線分隔符號。如果編輯欄只支援一般文字,請改用穩定的短詞,並逐筆確認結果。

^家用(?:[\s-]|$)

不要只憑選項名稱推測篩選方向。不同介面可能用比對結果來保留、排除,或僅供顯示。儲存前先查看欄位提示,更新後各找一筆應保留及應排除的備註交叉確認。全形括號、長破折號、前置空格與大小寫都會影響比對結果。若要接受多個命名前綴,請將候選詞放在同一組,只在群組外加上起始錨點。不要先寫過於寬鬆的表示式,再用許多例外補救;來源一旦更改命名,就很難判斷哪些項目被納入清單。

若篩選條件設在群組層級,修改後通常需要更新該群組,已匯入的清單不一定會立即重新計算。更新前請將原規則複製到本機紀錄,並記下目前使用的項目。有些來源在更新時會重建群組內的項目,舊項目的內部識別碼可能改變,原先的選取也可能失效。更新後請重新選取項目並測試連線。規則應依據來源維護的命名方式,不要仰賴更新後會消失的本機備註;需要自行維護的設定,應與自動更新的群組分開儲存。

依據紀錄檔排查清單為空

更新後清單為空,請先查看更新紀錄是否顯示已收到回應。要求逾時、網址失效與內容無法解析是不同問題:前兩者請檢查目前網路、更新方式及網址是否仍有效;無法解析則要確認來源回傳的是用戶端可辨識的訂閱格式,而非登入頁面或錯誤訊息。若解析成功卻沒有匯入項目,請清除群組層級的篩選並單獨重新整理,再確認是否切錯群組或仍有搜尋文字。不要將多個來源改成同一個網址測試,也不要把完整訂閱網址貼到公開紀錄中。

若同一來源只能匯入部分項目,請先查看紀錄中哪些類型遭略過,再分辨是格式不支援還是備註未符合條件。可暫時將篩選縮小到一筆已確認的備註,檢查問題是否隨規則改變。若停用篩選後項目恢復,但仍無法連線,請改查該項目的協定參數、目前選用的核心及連線紀錄,不要反覆修改篩選條件。確認此來源穩定後,再整理其他群組;如需分開更新並保留備用來源,請參閱多組訂閱管理。

路由規則實作

依連線進入核心時取得的位址進行比對

路由會決定連線符合哪條規則,以及比對成功後交由哪個出站處理。它不會直接替應用程式開啟代理,也無法讓尚未進入核心的要求符合規則。請先在 v2rayN 開啟路由設定,確認主畫面啟用的就是目前編輯的規則集,再調整規則順序。系統代理、應用程式個別設定的本機代理與 TUN,可能會將連線送往不同入口。排錯時請先固定一種入口,避免同時修改三種方式而讓結果看起來毫無規律。

先判斷核心收到的是網域名稱還是 IP 位址。應用程式將網域名稱交給本機代理時,可直接比對網域規則;若應用程式先自行解析再連線,入口可能只會收到目的位址。流量嗅探有時能從常見協定的交握中還原網域名稱,但前提是要求確實包含可辨識的資訊,無法取代所有應用程式傳遞網域名稱。若紀錄中只有位址,請先確認應用程式的代理設定與入口嗅探是否生效,再決定要讓應用程式傳遞網域名稱,或為受控位址補上網段規則。

將例外規則放在範圍較廣的規則之前

Xray 會依設定順序檢查路由規則,第一個符合的項目決定連線去向。若要讓特定維護網域直連、同一網域後綴的其他連線走代理,請先寫完整網域,再寫網域後綴。full: 只比對完整名稱,domain: 則比對指定網域及其子網域。要表達兩種優先順序,必須拆成兩條規則;同一條規則中的不同欄位通常必須同時符合,例如同時填入網域與連接埠,表示該網域上指定連接埠的連線,而非兩者任一符合即可。

以下是 Xray 設定中的 routing 片段,以保留網域 example.net 示範規則順序。請將片段合併至測試設定中的同名物件,不要覆蓋整套既有規則。兩個標籤都必須存在於該設定的 outbounds 中,且確實對應所需的連線去向。若介面使用其他標籤,請替換標籤,不要重複建立同名出站。保留網域中的範例主機不依賴公開服務;若要驗證比對結果,可換成自己能解析及存取的測試網域名稱。

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "domain": ["full:maintenance.example.net"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "domain": ["domain:example.net"],
        "outboundTag": "proxy"
      }
    ]
  }
}

觀察未符合規則時的處理方式

AsIs 不會為路由比對額外解析網域名稱;IPIfNonMatch 會在網域目標找不到符合的規則時進行解析,再嘗試比對位址規則;IPOnDemand 則會在比對過程遇到需要位址的規則時觸發解析。網域解析策略並非出站的最終解析策略。即使紀錄中已有解析結果,也不能據此判定連線最後是直連還是走代理。如果末尾有涵蓋所有流量的規則,第一次檢查可能就已符合,不要預期 IPIfNonMatch 會再為前面的位址規則重新嘗試。

先測試完整網域、相同後綴的另一台主機,以及規則範圍外的主機,再從紀錄核對入口與出站標籤。若沒有任何規則符合,Xray 預設會使用設定中的第一個出站,因此調整出站順序也可能改變規則外連線的去向。若紀錄只顯示使用第一個出站,請檢查是否漏寫比對條件,或修改了未啟用的規則集。也要重新建立連線:舊的長連線可能不會立即依新規則重建,沿用舊連線會造成驗證誤判。

遇到流量分流錯誤時,先匯出或抄下目前的規則順序,再暫時移除新加入的規則重新測試。確認問題出在規則後,先縮小到一個可控網域,再逐步擴大至網域後綴、網段或連接埠範圍。使用網域或位址資料檔時,若紀錄顯示資料集不存在,請修正引用或還原原本的資料檔來源,不要重寫整套路由。需要精確驗證要求路徑時,優先比對同一個要求的紀錄,不要用首頁顯示數據或一般連線感受取代單條規則的結果。

DNS 設定最佳化

判斷是哪一層正在執行解析

瀏覽器、作業系統、代理核心與代理遠端都可能執行網域解析。載入同一個頁面的不同資源時,也可能混用多種路徑。系統查詢工具只能反映它實際使用的解析器,不代表瀏覽器或核心會得到相同結果。請先在相同網路中選一個穩定的公開網域,以及一個自己有權使用的內部網域,分別記錄系統結果與核心紀錄。若系統查得到,但代理應用程式失敗,請先檢查應用程式交給代理的是網域名稱還是位址,不要直接更換系統解析器。

在 v2rayN 的參數設定中確認目前實際使用的核心,再開啟相應的 DNS 設定。原生設定、自訂設定與用戶端產生的設定,入口各不相同;修改一般設定後,若目前執行的是獨立自訂設定,變更未必會合併進去。儲存後請檢查生效中的設定,必要時重新載入核心。比對紀錄時,記下查詢網域、回傳位址類型、是否逾時,以及要求最後使用的出站。如此才能分辨是查不到位址、位址無法連線,還是查詢流量走錯出站。

限定專用解析器處理的網域範圍

內部服務通常需要由內網解析器回傳專用位址,但不必讓所有網域都走相同的查詢路徑。以下 Xray 片段僅供已有本機 DNS 服務的測試環境使用:本機 5353 連接埠負責解析 lab.example.net 及其子網域,其他查詢則交由系統解析器。此範例不是開放監聽設定,無法直接啟動服務。使用前請確認測試解析器已在回環位址的對應連接埠監聽;系統解析器也不能透過另一項設定反向依賴這套 Xray DNS,否則會造成遞迴。

{
  "dns": {
    "servers": [
      {
        "address": "127.0.0.1",
        "port": 5353,
        "domains": ["domain:lab.example.net"],
        "skipFallback": true
      },
      "localhost"
    ],
    "disableFallbackIfMatch": true
  }
}

skipFallback 表示此服務不參與一般回退;disableFallbackIfMatch 表示符合專用範圍時,不再改用一般回退。如此一來,內部網域查詢失敗時就能直接發現問題,不會因另一個解析器回傳不同答案而誤連。若確認獨立網路路徑確實需要備援,請為同一範圍新增一個能解析相同內部紀錄的解析器,而不是取消限制。另請注意,內建 DNS 只會處理確實交給它的查詢;只新增這段設定,不會自動讓所有系統要求或應用程式內建解析改道。

若上游使用網域名稱形式的加密 DNS 端點,用戶端必須先知道如何解析並連線至該端點。不要讓這次初始解析又指向尚未建立連線的同一個上游。若解析流量經由代理,也要確認代理伺服器本身的網域名稱能否先獨立解析。請將這兩項依賴分別記錄,再安排專用及一般解析器。否則紀錄中可能只有連續逾時,表面看似上游服務無法連線,實際上連線根本尚未離開本機。排查時可暫時切回已知可用的解析方案,確認代理連線正常後再恢復加密上游。

分別驗證位址族、快取與連線

確認網路的位址族路徑後,再調整查詢策略。應用程式可能同時取得 IPv4 與 IPv6 位址,但兩個位址都能查到,不代表兩條路徑都可連線。若首次開啟需要等待很久,先從紀錄判斷哪類查詢已完成、哪條連線逾時,再依應用程式需求選擇策略;不要一開始就全域捨棄某一類位址。忘記清除快取也會讓變更看似無效。請先結束測試應用程式或清除其 DNS 快取,視需要更新系統快取,再建立新連線;不要把舊頁面仍能載入當作證據。

還原時請恢復原有的伺服器順序、網域範圍與查詢策略,不要只改回某個位址。若只有啟用 TUN 後才失敗,請檢查虛擬網卡接管的 DNS 範圍;若回傳的是明確的合成位址,請參閱FakeDNS章節,確認它與分流的關係。延遲問題也可能出在節點或線路層,請參考網速慢的分層排查,使用相同目標區分查詢等待與建立連線後的傳輸耗時。

TUN 模式

先建立系統代理基準

系統代理仰賴應用程式讀取代理設定。TUN 則會啟動虛擬網卡,將符合系統路由條件的封包交給接管元件。虛擬網卡存在,不代表所有流量都會經過它:作業系統的路由優先順序、排除網段、其他虛擬介面,以及應用程式綁定的實體網卡,都可能改變流量路徑。啟用前,請先用 v2rayN 在系統代理模式下測試一個瀏覽器,再選一個有權存取的內部服務作為對照。記錄兩個目標在原有網路中的解析結果與連線狀態,之後才能判斷是哪條路徑改變。

準備測試時,先停用其他會修改系統路由或 DNS 的用戶端;受機關或公司管理的網路,請依管理政策操作,不要更改組織下發的設定。首次測試不要同時更換節點、路由規則、DNS 與 TUN 參數。優先將系統代理恢復原狀,避免同一個應用程式一邊明確連至本機代理,一邊又受虛擬網卡規則影響。若必須保留其他網卡,至少記錄其啟用狀態與用途,方便關閉 TUN 後重新測試是否恢復原有路徑。

啟用網卡並檢查接管範圍

在 v2rayN 中先選擇可正常運作的伺服器並確認目前的路由方案,再從主畫面啟用 TUN 模式。建立網卡或修改系統路由需要系統授權,請依用戶端與作業系統實際提示操作。若出現啟動警告,先查看用戶端紀錄,確認是否已建立介面及寫入路由,不要反覆點擊開關。實際負責接管的元件可能與伺服器使用的核心不同;成功儲存一處 Xray 設定,不代表接管元件也接受相同的入口、DNS 或排除範圍。排查時請分別檢視各元件的紀錄。

使用下表中的唯讀命令檢視系統路由。命令只能輔助比對,無法取代紀錄。啟用前後各檢查一次,重點確認代理伺服器位址、內部服務位址及一般目標分別經由哪張介面處理。實作方式也可能透過更細的前綴或策略路由拆分接管範圍,因此不能只看預設路由那一行就判定是否已接管。

系統檢視命令優先檢查項目
Windowsroute print介面清單、作用中路由與度量值。
macOSnetstat -rn目的網段、下一個躍點與介面名稱。
Linuxip route show table all、ip rule show策略規則引用的路由表及對應介面。

接管後若所有目標都逾時,請先檢查代理伺服器本身的連線是否被送回虛擬網卡。需要避開時,應使用接管元件提供的出站介面綁定或排除功能,讓伺服器連線仍經由實際網路介面建立。若伺服器使用網域名稱,固定排除某個當下的位址未必長期有效。若只有區域網路服務無法連線,請檢查相關網段是否誤走虛擬網卡,並針對確實需要存取的網段調整;不要一次略過所有私有位址,也不要把所有內部連線都改交代理。

分別排查 DNS、UDP 與 MTU

已知位址可連線但網域名稱失敗時,先檢查接管元件是否將查詢交給預期的解析器。一般網頁正常但即時應用程式失敗時,再檢查應用程式使用的傳輸類型、入口是否收到對應封包,以及所選出站是否支援該傳輸。只有小型要求可通、大量傳輸時中斷,才將 MTU 列入可能原因。請比較關閉 TUN 前後的結果、記下原始值,並在明確的測試路徑上分次調整,每次都重新連線。僅憑測速結果波動,不足以判定是 MTU 問題。

結束測試時先關閉 TUN,再檢查介面與路由是否恢復基準狀態,並確認系統代理是否需要依原用途還原。若內部網域仍無法正常解析,請檢查系統目前的 DNS 設定與相關程序是否仍在執行,不要任意刪除不熟悉的介面或路由。電腦從休眠恢復或切換無線網路後,也應重新測試,因為介面與下一個躍點可能已改變。更多狀況對照請參閱TUN 虛擬網卡設定說明。

FakeDNS

追蹤合成位址與原始網域的對應

FakeDNS 回傳的是合成位址,而非目標伺服器的真實位址。元件會在回覆要求端位址的同時,儲存位址與網域名稱之間的對應。應用程式接著連線至該位址時,接管入口必須收到連線,並從同一組對應中找回網域名稱。還原網域後,才能依網域選擇路由,再由對應的出站連線至實際目標。這種方式常用於應用程式先解析再傳送封包的情境。它改變的是網域名稱的保留與還原方式,不是加速所有解析要求,也不保證每個應用程式都經過相同入口。

先在關閉 FakeDNS 的情況下讓 TUN 正常運作,確認一般解析、入口接管與網域規則都能各自正常使用。接著確認實際回覆 DNS 的元件與實際接收封包的元件是否共用同一組對應資料。若用戶端由其他元件負責接管,請依該元件的設定格式確認支援範圍,不能直接把 Xray 欄位貼進它的編輯器。若模擬環境只能檢視一個元件的紀錄,至少要從要求端記下回傳位址,並從入口確認後續連線是否送回預期的程序。

讓位址池、DNS 分派與入口設定相互配合

以下三部分是 Xray 專用的設定片段,用來設定測試位址池,並只對 lab.example.net 範圍啟用合成解析。合併時請保留其他解析器與既有路由規則,並先確認位址池不會與實際網路、其他虛擬網卡或企業測試網段重疊。範例網段僅供測試,不代表適用於所有正式環境。位址池容量也不是同時連線數上限,而是影響可儲存的網域對應數量。位址池已滿或程序重新啟動時,如果應用程式仍快取舊的合成位址,就可能出現舊頁面與新查詢結果不一致的情況。

{
  "fakedns": [
    {
      "ipPool": "198.18.0.0/15",
      "poolSize": 4096
    }
  ],
  "dns": {
    "servers": [
      {
        "address": "fakedns",
        "domains": ["domain:lab.example.net"],
        "skipFallback": true
      },
      "localhost"
    ],
    "disableFallbackIfMatch": true
  }
}

接收合成位址連線的 Xray 入站,需要相應的嗅探設定。請將下列欄位合併至實驗用入站物件中,不要新增另一個入站,也不是全域開關。若該入站原本還有其他嗅探類型,請合併而非覆蓋。此實驗需要還原實際目標網域名稱以建立連線,因此範例不使用僅供選路的 routeOnly。啟用後,請確認位址池流量確實抵達這個入站;只看到 DNS 回傳合成位址,無法證明連線已進入此路徑。

{
  "sniffing": {
    "enabled": true,
    "destOverride": ["fakedns"]
  }
}

出站連線需要連至真實目標時,不應再向相同的合成範圍查詢並取得池內位址。測試時請確認實際連線使用的解析路徑會回傳真實結果,例如由代理遠端解析目標,或由直連出站使用可回傳真實紀錄的解析路徑。代理伺服器本身的網域名稱也不應納入合成範圍。內部檔案服務、裝置探索,以及依賴真實位址進行存取控制的應用程式,宜保留原本的解析路徑;確認不受影響後,再考慮擴大測試範圍。

從三個觀察點判斷故障位置

第一個觀察點是查詢是否取得位址池中的位址。沒有合成結果,可能是應用程式繞過接管解析入口,也可能是測試網域未符合範圍。第二個觀察點是連線是否進入對應入口。若查詢結果位於位址池中,但入口沒有紀錄,請檢查路由是否將該位址池導向實際接管介面。第三個觀察點是選路紀錄能否關聯還原後的網域名稱。若入口收到位址卻未還原網域,請先排除快取中的舊位址、對應已過期,或回覆 DNS 的程序與接收連線的程序並非同一個,再調整網域規則。

還原時,必須同時移除合成 DNS 分派與依賴合成位址池的接管設定。恢復一般解析後,請讓測試應用程式重新查詢,必要時清除系統快取並關閉仍持有舊連線的程序,再測試相同網域。若只關閉位址還原,但仍回傳合成結果,要求可能會依一般位址規則送往無關介面。若只修改 DNS 卻沿用舊快取,也會出現相同現象。確認取得一般位址且要求回到原有路徑,才算完成還原,不應只看某項設定已顯示關閉。

多組訂閱管理

依更新來源與使用用途分開管理

管理多個來源時,先依更新關係拆分,再依用途選擇。兩個網址來自同一服務,也可能共用更新限制;備註相同的兩個項目,也可能屬於不同帳號或採用不同傳輸參數。不要只為了讓清單整齊,就把所有項目合併到同一個可批次更新的群組。建議使用能辨識來源且不會暴露帳號資訊的群組名稱,並在本機記錄用途、更新方式與可聯絡的管理管道。是否屬於備用來源,應依實際依賴關係判斷,不要只看備註標示的地區或顯示順序。

在群組設定中逐一新增網址,並分別更新各群組。確認匯入結果後,在主清單選取該群組中的項目,檢查連線紀錄,再處理下一個群組。若介面提供加入批次更新的選項,請等手動測試通過後再啟用;只偶爾使用或由人工維護的群組,則可繼續單獨更新。沒有更新網址的手動項目應放在獨立群組。伺服器清單中的手動編輯不一定能保留到下次更新;重要的獨立測試設定應另外儲存,並註明與來源內容不同的原因。

安排彼此獨立的更新路徑

訂閱更新是獨立要求,與項目能否成功連線是兩回事。若用戶端允許選擇透過目前代理或直接更新,請逐一確認各來源可用的路徑。特別留意更新依賴目前節點,而目前節點又必須先更新才能恢復的循環依賴。請保留一條已驗證的存取路徑,或在不使用代理也能存取該來源的環境中測試。更新失敗時,不要立刻刪除本機仍可使用的項目;先確認錯誤是無法建立連線、權限失效、來源限流,還是回應格式改變。

需要定期更新時,請先依來源允許的頻率設定。不同群組可以錯開更新時間,或由使用者手動更新。批次更新失敗時,請改為逐一測試群組,並記錄失敗的群組及當時使用的網路路徑。請分清程式啟動時的自動更新與使用者手動更新,以免查看紀錄時誤讀另一項工作的結果。某個群組回傳空結果,不代表其他群組也需要重建。請先確認該群組的來源內容與篩選條件,再決定是否繼續更新其他群組,縮小一次批次更新可能造成的變動範圍。

來源更新可能會更換連接埠、協定參數及備註,不只是新增項目。名稱相同不代表設定沒有變;名稱不同也不一定代表是兩條獨立線路。若要去重,請在本機比對協定、伺服器位址、連接埠、傳輸設定與用途,並先在單一群組中處理,避免跨群組刪除後失去備用入口。即使兩個群組最後連到同一服務,續期與更新機制也可能不同;保留來源區分,通常比只留一個顯示名稱更有價值。

將切換與還原設計成可重複測試的流程

更新前記下目前的群組、使用中的項目與路由方案。完成後先確認熟悉的項目仍在,再明確選取要繼續使用的項目,並重新建立一次測試連線。若備用群組可用而主要群組失敗,請在相同目標與相同路由設定下測試兩個群組,不要同時變更網路模式。連線成功但速度不同,只能表示本次測試路徑有差異。需要比較時,請區分建立連線與傳輸資料的階段,並在相同條件下重複測試,不要因單次清單排序就永久刪除來源。

遷移或還原前,請依用戶端提供的方式備份設定並限制存取權限。備份可能包含訂閱網址、帳號識別資訊及伺服器連線參數,不要傳到共用聊天室或放在公開目錄。還原時先恢復出問題的群組,保留其他群組原狀,再確認是否要退出原本的自動更新排程。若只能還原整個資料庫,請先保留目前副本,避免覆蓋還原點之後調整的路由與 DNS 設定。最後核對實際連線使用的項目是否與紀錄一致,不要只看已選取的群組標籤。

自訂出站

分清出站物件與規則引用

出站物件定義核心如何處理連線。標籤只是供規則引用的名稱,真正決定動作的是 protocol 及其設定。例如標籤叫做 direct,不代表自動直連;設定中還必須為它指定相應的直連協定。新增出站前,先列出入口、規則、目標,以及未符合規則時的預設路徑。若只需調整現有流量的去向,請先重用既有出站;只有處理方式確實不同時才新增物件,避免在多處重複維護相同參數。

一般圖形介面設定由用戶端產生,直接編輯執行目錄中的暫存檔案,可能在切換伺服器或重新啟動時被覆蓋。在 v2rayN 使用自訂設定入口時,請先選擇與設定格式相符的核心,匯入完整的測試檔案,並在執行前確認用戶端是否要求另外設定監聽連接埠及管理選項。完整的自訂設定不等於在目前訂閱項目上追加出站;原有路由、探測與 DNS 設定不一定會自動合併。操作前請保留原方案,測試時只啟用一組監聽。

先透過回環入口驗證直連與阻斷

以下是完整的最小化 Xray 測試設定,使用僅供本機存取的 SOCKS 入口驗證標籤比對。它不依賴遠端代理,也不會修改系統代理。測試前請結束已佔用該連接埠的程序,或替實驗設定選擇未使用的本機連接埠,並同步修改要求命令。先阻斷一個完整網域,其餘要求則經由第一個出站直連;這有助於分辨是路由比對錯誤,還是遠端線路問題。此範例是隔離測試檔案,請勿覆蓋目前使用的設定。

{
  "log": {
    "access": "access.log",
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "tag": "local-test",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": false
      }
    }
  ],
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {}
    },
    {
      "tag": "block",
      "protocol": "blackhole",
      "settings": {}
    }
  ],
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "inboundTag": ["local-test"],
        "domain": ["full:example.org"],
        "outboundTag": "block"
      }
    ]
  }
}

如果本機已有可從命令列執行的 Xray,可在可寫入紀錄的測試目錄中將此設定儲存為 config.json,執行下方第一個命令確認能否載入,再執行第二個命令啟動。另開一個終端機執行兩個要求;若終端機將 curl 對應為其他命令,請明確呼叫實際的 curl 執行檔。--socks5-hostname 會將網域名稱交給入口,避免先解析成位址後無法符合完整網域規則。直連要求仍取決於本機能否存取目標,不保證遠端一定會回應。

xray run -test -config config.json
xray run -config config.json

curl --max-time 10 --socks5-hostname 127.0.0.1:10808 https://example.org/
curl --max-time 10 --socks5-hostname 127.0.0.1:10808 https://example.net/

第一個要求應交由 block 處理,第二個應選用 direct。實際顯示的要求錯誤訊息可能因作業系統與工具而異。兩個要求都失敗時,先確認程式是否已監聽該連接埠、存取紀錄是否已記錄入口,再檢查出站標籤與系統網路。若兩個要求都成功,請先確認要求沒有因環境中的 NO_PROXY 設定而繞過代理,並確認執行的確實是這份設定。驗證期間只保留必要紀錄,記下入口、目標與出站,避免長期保存完整存取紀錄。

新增正式出站前先檢查依賴與還原方式

新增已獲授權的遠端出站時,標籤必須唯一,協定參數則應依伺服器實際設定提供。先讓一條範圍明確的測試規則引用該標籤,不要立刻更改第一個出站。確認伺服器網域名稱的解析方式、介面是否可存取,以及伺服器本身的連線是否被虛擬網卡送回。若在同一份設定中組合多個出站,也要確認每條連線所依賴的前置出站都可用,不能讓兩條線路互相依賴。能啟動只代表設定已載入,不保證遠端交握及最終存取一定成功。

刪除出站前,先移除或修改所有引用它的規則,再刪除物件並重新載入。若更改了出站順序,請重新測試未符合規則的要求。實驗結束後停止測試程序,恢復一般用戶端設定,確認預期的程序正在監聽本機連接埠,再視需要恢復系統代理或 TUN。日後排錯仍應從一個入口、一條規則與一個已知目標開始;確認單一路徑可以重現後,再將訂閱、解析與接管納入完整連線流程。