官方手冊 / 設定與規則

Shadowrocket 規則與設定完整指南

從設定檔結構到首條命中規則,查閱語法、策略、解析行為與驗證方法。

本頁供系統性查閱,不取代首次連線流程。若尚未匯入伺服器資訊,請先依照快速入門教學完成 Subscribe 匯入、選擇伺服器與連線驗證,再回到本頁調整分流。教學協助建立連線,本頁則說明設定的寫法與判斷修改是否生效的方法。

以下內容假設你已有自己的訂閱或伺服器資訊。訂閱連結請向你的服務商取得;本站不提供、不販售、不推薦節點或訂閱。用戶端一次買斷不等於線路方案,應用程式的取得費用與線路使用費是兩回事。

取得方式分為兩種:iPhone / iPad 版在 App Store 一次性付費 $2.99,系統需求以 App Store 頁面標示為準;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費。各平台的取得入口請見下載頁,電腦與 Android 等平台的安裝檔由本站 /dl/ 提供。

01 設定檔結構與修改範圍

Shadowrocket 設定檔描述連線進入用戶端後應如何處理,不等同於伺服器憑證清單。透過 Subscribe 匯入的內容通常負責管理伺服器項目,Config 選取的檔案則負責規則與相關設定;兩者可以分開更新。若出現「訂閱更新成功,但連線目的地沒有改變」,應先檢查目前使用的設定,而不是反覆匯入同一份訂閱。伺服器資訊決定可連線至何處,規則決定哪些請求採用哪種策略。

以區段標題組織設定

設定檔以方括號標示區段,例如 [General] 與 [Rule]。General 中常見的設定採用鍵值格式,Rule 中通常每行一條規則,並以英文逗號分隔。區段標題不是一般註解,遺漏標題可能導致後續內容歸入錯誤區段。中文逗號、全形等號,以及從富文字複製而來的特殊空格,都可能讓看似正確的內容無法如預期解析。

[General]
bypass-system = true
dns-server = system

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
FINAL,PROXY

這是結構範例,並非適用於所有網路的完整設定。bypass-system 會影響系統流量的繞過行為,dns-server = system 則表示使用系統提供的解析器。這些設定不會替你補上伺服器資訊,也不保證所有連線都會進入 Rule。閱讀設定時,應先確認流量入口與繞過條件,再查看規則清單,不要只看最後幾行策略。

四個常見區段各自負責什麼

區段主要用途檢查重點
[General]一般網路與解析設定DNS 來源,以及繞過條件是否符合目前網路
[Rule]比對請求並選擇策略規則順序、目標欄位與 FINAL
[Host]提供指定主機名稱的本機解析對應位址是否仍有效,以及是否覆蓋正常解析
[URL Rewrite]依 URL 表達式執行重寫或重新導向表達式範圍、目標位址與可見條件

未使用某項功能時,不必為了讓設定看起來完整而加入相應區段。尤其不要複製來源不明的 Host 與重寫項目:一筆過期對應可能繞過正常解析,範圍過大的重寫也可能改變登入或跳轉行為。設定越短不一定越好,但每一項都應說得出用途、影響範圍與還原方式。

編輯、儲存與啟用是三個步驟

在 Config 中找到實際使用的設定,先儲存副本並取一個能區分用途的名稱,再進入編輯。儲存文字後檢查錯誤提示,返回設定清單確認選取狀態。編輯未啟用的副本不會改變目前的分流;啟用另一份遠端設定也不會自動合併先前的本機修改。需要重新建立連線的設定,應先中斷連線再重新連線,並以新請求驗證。

遠端設定還有更新覆蓋的問題。若直接修改會在重新整理時被取代的檔案,下次更新可能會遺失自訂規則。請先確認該檔案的更新方式,再決定使用獨立的本機副本,或採用應用程式支援的保留機制。不要同時維護多份名稱相似、內容不同的作用中候選檔案;排錯時記下「檔案名稱、選取狀態、修改內容」,比只記得最近編輯過哪一份更可靠。

不同平台與版本的設定入口可能略有差異,本文說明的是設定語意,並非逐像素的介面指南。若目前的用戶端無法辨識某個欄位,請撤回該項並核對應用程式內的提示,不要靠連續新增參數來消除錯誤。初次操作可回到教學中的設定與驗證步驟,也可依問題現象在常見問答中查找。

02 比對順序、覆蓋關係與 FINAL

理解分流最重要的原則是:在請求進入設定規則處理的前提下,Rule 通常會由上而下依序檢查,第一條符合的規則便決定該請求採用的策略。用戶端不會彙整所有比對結果,再挑出「看起來最精確」的一條。因此,規則內容與排列位置同樣重要;把精確例外放在寬泛規則下方,往往就等於沒有設定這項例外。

先列例外,再列範圍較大的規則

[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,ads,REJECT
FINAL,PROXY

在這組範例中,login.example.com 會先符合第一行並採用 DIRECT;其他屬於 example.com 的網域才有機會符合第二行。若將前兩行對調,登入網域也會先符合後綴規則,後面的 DOMAIN 就無法改變該請求的處理結果。不要誤以為 DOMAIN 天生優先於 DOMAIN-SUFFIX;此處的優先順序由排列位置決定。

第三行也呈現另一種覆蓋關係:若某個 example.com 子網域同時含有 ads,第二行已先符合,後面的關鍵字拒絕規則便不會執行。應先釐清實際需求:整個網域族都走 PROXY,還是含有廣告關鍵字的網域必須優先拒絕?規則順序沒有脫離目標的標準答案,但必須能說明每個交集中的請求應套用哪一行。

FINAL 是兜底規則,不是強制覆蓋

FINAL,PROXY 表示前面的規則都未決定去向時,採用 PROXY。它不帶網域條件,也不會修正前面寫錯的項目。若將 FINAL 放在規則清單中段,後續原本可以比對的規則就失去處理一般請求的機會。一般設定應將它放在 Rule 末尾,並保留一條明確的兜底規則,避免重複的 FINAL 造成閱讀混淆。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

這裡先檢查網域,再檢查目的位址在地理資料庫中的分類,剩餘請求才採用兜底策略。即使某個網域解析到被 GEOIP 分類為 CN 的位址,只要前面的後綴規則先符合,仍會走 PROXY。反之,若無法取得網域資訊,該網域規則可能無法比對,就需要繼續檢查位址規則。驗證結果前,應先確認當時可供比對的是主機名稱還是位址。

規則順序與繞過條件是兩回事

「由上而下」描述的是流量進入這份規則清單後的處理方式,不代表清單能覆蓋所有系統路由、一般繞過設定與既有連線。若流量已在更早的處理階段被繞過,調整 Rule 中的行序也無法讓它重新納入。排查區域網路連線時,尤其要區分 General 的繞過設定、系統本身的路由,以及 Rule 中的 DIRECT;三者表面上可能相似,但發生的階段不同。

同樣地,切換規則後,既有的長連線可能仍沿用原本的連線路徑。瀏覽器重用連線、應用程式在背景維持連線,以及網域解析快取,都可能讓「只重新整理一次」不足以證明新規則失效。應先建立新的目標連線,必要時結束目標應用程式後再試,並對照記錄中的目的網域、命中規則與策略。只憑頁面是否開啟來判斷優先順序,會把伺服器狀態與規則問題混為一談。

用反例檢驗優先順序

每新增一條例外,至少準備兩個測試目標:一個應符合新規則,另一個與它相近但不應符合。例如修改 login.example.com 後,也要測試 api.example.com;新增位址網段後,再測試一個網段以外的位址。如此能同時發現「規則未生效」與「規則範圍過大」兩類錯誤,比只確認一次連線成功更有判斷力。

03 網域、位址與請求特徵規則

規則類型決定要比對請求中的哪一部分。網域類規則比對主機名稱,位址類規則比對目的 IP,USER-AGENT 則比對可取得的請求識別資訊。它們代表不同資訊,不能任意互換。選擇類型時,先確認需求是限制完整網域、整個網域族、一段網路,還是某類可識別的請求,再決定使用哪種語法。

DOMAIN 與 DOMAIN-SUFFIX

DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.net,DIRECT

DOMAIN 適合設定精確例外,比對 api.example.com 這個主機名稱,不會自動涵蓋 img.api.example.com。DOMAIN-SUFFIX 用於比對網域後綴,example.net 本身及其子網域都在預期範圍內,而 notexample.net 並不是 example.net 的子網域。網域欄位不要加入通訊協定標頭、路徑、連接埠或結尾斜線;這些內容不屬於網域比對欄位。

若要區分同一網站的登入、圖片與 API 服務,應先從實際請求確認對應的主機名稱,不要假設它們都使用主站網域。現代應用程式可能採用獨立的資源網域,同一個頁面也可能建立多條連線。主頁面符合某條規則,只能說明該連線的結果,不代表所有資源都採用相同策略。

DOMAIN-KEYWORD 的比對範圍較廣

DOMAIN-KEYWORD,ads,REJECT

這條規則用來說明網域含有關鍵字時的比對方式,並非通用的封鎖建議。ads 只是一段字元,可能出現在不應拒絕的網域中。關鍵字規則通常比後綴規則更難限定範圍,啟用前應檢查可能誤判的項目。若已知道要處理的完整網域或穩定後綴,優先採用更明確的類型,有助於降低維護成本。

IP-CIDR、IP-CIDR6 與 GEOIP

IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
IP-CIDR6,fc00::/7,DIRECT,no-resolve
GEOIP,CN,DIRECT

IP-CIDR 以 IPv4 位址與前綴長度描述網段,IP-CIDR6 則處理 IPv6。前綴不是連接埠號碼,也不是可任意省略的備註;網段設定過大,可能一併涵蓋無關的目的位址。範例中的私有位址與 IPv6 本機位址範圍僅供說明用途;是否直連仍需考量系統路由與所在網路,不要因此認定所有內部位址都能連線。

no-resolve 表示不會只為了這條位址規則主動解析網域;若請求本身已有目的 IP,仍可進行比對。這不代表關閉整個用戶端的 DNS,也不表示任何網域請求都會自動符合私有網段。GEOIP 則依賴位址資料庫分類,不代表網頁內容類別、企業註冊地或使用者所在區域;資料庫差異與位址配置變動都可能影響結果。

USER-AGENT 與可見資訊的限制

USER-AGENT,ExampleApp*,DIRECT

USER-AGENT 用來比對可取得的 User-Agent 識別資訊;範例中的 ExampleApp 是虛構的測試名稱,星號表示通配比對意圖。這不是依系統應用程式套件名稱比對的規則,也無法保證識別所有加密請求。若連線階段無法取得對應的請求標頭,這條規則就沒有可靠的比對對象;不能因為應用程式名稱與範例相近,就認定它的所有連線都會符合規則。

類型比對對象常見錯誤寫法
DOMAIN完整主機名稱填入完整 URL
DOMAIN-SUFFIX網域及其子網域誤以為可比對任意結尾
DOMAIN-KEYWORD網域中的字元片段低估誤比對範圍
IP-CIDR / IP-CIDR6目的位址網段把位址範圍當成網域範圍
GEOIP目的位址的資料庫分類依網頁內容類別推斷結果
USER-AGENT可取得的請求識別資訊誤以為是通用的依應用程式分流
FINAL前面規則未命中的請求放在清單中段

若兩種規則類型都能滿足需求,優先選擇語意最清楚、依賴條件最少的類型。網域例外通常使用 DOMAIN,整個網域族使用 DOMAIN-SUFFIX,明確的內部位址範圍則使用 CIDR。只有確實需要廣泛涵蓋時才考慮關鍵字;每條寬泛規則都應搭配一個不應符合的反例,避免錯誤隨著清單增加而被掩蓋。

04 PROXY、DIRECT、REJECT 與 Global Routing

規則回答「哪些請求符合條件」,策略回答「符合後如何處理」。本頁使用的 PROXY、DIRECT、REJECT 是三種基本策略關鍵字,在設定中維持英文大寫。它們與介面中的 Config、Proxy、Direct 不在同一層級:前者出現在規則動作位置,後者則是 Global Routing 的運作模式。混淆這兩個層級,是「規則已設定,卻沒有依規則運作」的常見原因。

三種基本策略的意義

PROXY 會讓符合規則的連線採用代理路徑;實際使用哪一台伺服器或相關策略選項,應配合 Home 中的選取項目與目前設定確認。設定 PROXY 不代表已經有可用伺服器,也不保證驗證、傳輸與目標連線都會成功。選錯伺服器、憑證過期或目標無法連線時,規則仍可能正確命中,但後續連線會失敗。

DIRECT 表示直接連線至目標,不經由選取的代理伺服器。它仍取決於本機網路、DNS、系統路由與目標服務狀態,並非「排除所有網路問題」。例如存取內部管理頁面時,即使策略已設為 DIRECT,裝置若未連上對應的區域網路,仍無法建立連線。排錯時應分開驗證「已選擇直連」與「直連確實可達」。

REJECT 用於拒絕符合規則的連線。預期結果是請求失敗或資源無法載入,而不是自動切換到另一條可用路徑。應用程式可能不斷重試遭拒的請求,留下額外記錄;也可能因基礎 API 被拒絕而無法正常運作。遇到這些情況時,先找出被拒絕的目標,不要因為主頁面無法開啟就直接認定伺服器失效。

Global Routing 的三種模式

介面用語中文說明適用的檢查方式
Config設定:依目前設定執行分流檢查 Rule、優先順序與兜底規則
Proxy代理:以代理模式處理接管的流量暫時排除規則差異
Direct直連:以直連模式處理接管的流量比較本機網路的存取結果

日常驗證自訂規則時應選擇 Config。Proxy 可用來比對「代理路徑本身是否正常」,Direct 則可用來比對「本機網路是否可達」,但兩者都不能證明某條 Rule 已生效。此處說明的模式也不代表能接管所有系統流量;系統繞過、應用程式行為與既有連線仍須分別考量。

[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN,printer.example.net,DIRECT
DOMAIN,metrics.example.org,REJECT
FINAL,PROXY

以相同目標進行受控比對

若某個目標在 Proxy 模式下可以存取,在 Config 下卻失敗,應檢查 Config 中是否有 DIRECT、REJECT 或更早的規則先行命中,而非立刻更換伺服器。若 Proxy 與 Config 都失敗,再檢查代理路徑、解析狀況與目標狀態。若 Direct 成功而 Proxy 失敗,則應進一步檢查所選伺服器及其連線至目標的狀況,不要因此推斷所有規則都有問題。

比對測試應盡量維持目標、網路與伺服器選擇一致,每次只變更一個條件。若同時頻繁切換網路、模式與節點,就無法判斷結果原因。也要區分頁面首次載入與後續資源請求:一個網頁可能同時出現 PROXY、DIRECT 與 REJECT 記錄,不能拿其中任意一筆代表整個網頁的處理方式。

協定參數與分流策略各自負責不同層面

Shadowsocks、VMess、VLESS、Trojan 等協定決定代理連線如何建立,Rule 則決定哪些請求交由代理路徑處理。將 DOMAIN-SUFFIX 改成 DOMAIN 無法修正伺服器密碼錯誤;調整傳輸參數也不會自動修正範圍過大的拒絕規則。若要核對協定欄位,可閱讀協定與常見參數說明,再回到本頁檢查請求的處理路徑。

On Demand 負責依條件觸發連線,應與 Global Routing 選擇的分流模式分開理解。自動連線不代表一定採用 Config,手動連線也不表示規則遭到忽略。切換模式後,請回到目前的連線狀態與設定選取畫面再次確認,避免把自動連線行為誤當成規則選擇結果。

05 DNS、Host 與位址規則的相互影響

網域規則與位址規則依賴不同資訊,因此 DNS 經常是排查分流問題的關鍵。網域解析會將主機名稱轉換為位址,Rule 再依當時可取得的資訊判斷策略;實際處理方式還會受到快取、連線方式與用戶端設定影響。不要把「解析到某個位址」直接等同於「採用某個出口」,解析路徑與實際連線路徑需要分開確認。

先記錄目前狀態,再調整解析來源

[General]
dns-server = system

這行表示使用系統解析器,適合作為理解欄位的起點,而非通用的最佳設定。系統解析器由目前的網路與系統設定提供,切換 Wi-Fi 或行動網路後,實際環境可能改變。若目標只能在特定網路中解析,例如內部主機名稱,任意改用其他解析來源反而可能導致失效。修改前應記錄目標網域、原解析結果與網路條件。

排查解析問題時,先確認錯誤發生在解析之前,還是連線之後。沒有取得位址、取得位址但連線逾時,以及建立連線後發生憑證錯誤,是不同層面的問題。只有第一種情況適合優先檢查解析路徑;其他情況還涉及位址可達性、目標服務、時間設定與交握條件。若不看錯誤階段就接連更換 DNS,容易掩蓋真正原因。

Host 對應只會改變解析結果

[Host]
portal.example.com = 192.0.2.10
test.example.net = 198.51.100.20

Host 區段可為指定主機名稱設定本機對應。上方位址屬於文件範例保留範圍,不能用於實際存取。Host 不會替伺服器產生憑證,也不會讓原本無法連線的位址變得可達;即使網域解析到指定 IP,伺服器端仍須正確處理該主機名稱。不要把 Host 當成解決各種網頁錯誤的快速開關。

設定實際對應前,應先確認目標位址穩定,且由你有權管理的服務提供。許多網站採用動態位址、區域調度或多位址備援;若將一次查詢得到的 IP 固定下來,可能暫時有效,之後卻失效。網路改變後,這條對應仍會持續覆蓋正常解析,因此每筆 Host 都應有明確用途,並在不需要時刪除。

位址規則為何有時不會命中

[Rule]
DOMAIN,portal.example.com,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
IP-CIDR6,fc00::/7,DIRECT,no-resolve
FINAL,PROXY

第一行直接依主機名稱決定策略,不必依賴後面的位址範圍來表達相同意圖。後兩行只涵蓋特定網段,也不會為了比對而主動解析網域。若希望某個明確的內部網域一律直連,通常應明確寫出網域規則,而不是假設它總會解析到某個私有網段,再依賴位址規則間接命中。

同一網域可能同時回傳 IPv4 與 IPv6 位址。只設定 IPv4 網段,不能據此推斷 IPv6 連線也會符合該規則;只檢查一次解析結果,也不代表所有請求都使用相同位址。若出現「有時正常、有時不同」的情況,應記錄當次實際目的位址與位址類型,再比對規則範圍,而不是不斷新增重複的網域項目。

快取、GEOIP 與觀察誤差

DNS 快取可能來自用戶端、系統或目標應用程式,既有連線也可能繼續使用舊位址。修改 Host 或解析設定後,先建立新連線,再觀察是否使用新的解析結果;必要時依應用程式提供的方式清除相關快取。不要為了驗證單一網域就重設所有網路設定,以免引入過多變因,也難以確認是哪項修改發揮作用。

GEOIP 使用目的位址的資料庫分類,並非判斷網域歸屬的權威依據。內容傳遞服務與位址重新分配都可能讓實際分類與直覺不同。若某項服務必須採用固定策略,應在 GEOIP 規則前方加入明確的網域例外;不要為了單一目標更動整段地理分流。若對位址分類有疑問,最後應依據當次目的 IP 與首條命中記錄核實。

06 URL Rewrite 的用途與安全界線

URL Rewrite 處理可識別的 URL 表達式與替換關係,Rule 則決定連線應採用哪種策略。兩者可以出現在同一份設定中,但不能互相取代。若要讓某個網域走代理,應設定分流規則;若要將明確的舊網址重新導向至新網址,才考慮使用重寫。把所有存取失敗都交給 URL Rewrite 處理,會讓原本單純的連線問題變成更難追查的跳轉問題。

先看懂一條最簡單的重新導向規則

[URL Rewrite]
^http://example\.com/(.*)$ https://example.com/$1 302

這條範例描述從指定 HTTP 位址重新導向至 HTTPS 位址。左側是正規表示式,中間是替換目標,末尾的 302 表示暫時重新導向。開頭的脫字符號表示從字串起始處比對,結尾的美元符號表示比對至字串結尾,反斜線則讓網域中的句點依一般句點處理;擷取群組中的內容會透過替換目標中的 $1 參照。

這只是語法說明,不要求實際存取範例網域,也不表示任何網站都適合由用戶端強制改寫。實際部署前,應確認目標服務支援新網址、路徑語意一致,並檢查查詢參數、登入回呼與資源參照是否仍然正確。重寫可以改變請求目標,但不能保證新目標提供相同內容或權限行為。

表達式範圍必須說得清楚

若網域中的句點未跳脫,在正規表示式中通常會代表任意單一字元,可能擴大比對範圍。省略起始或結尾限制,也可能讓表達式在非預期位置符合。不要把一般網域後綴比對的直覺套用到正規表示式:DOMAIN-SUFFIX 與正規表示式的語意不同,前者的網域邊界不會自動套用到後者。

逐步縮小比對範圍,比寫一條涵蓋所有網址的表達式更容易驗證。先針對完整主機名稱與明確路徑測試,再考慮加入擷取群組。每新增一種通配範圍,都應準備一個不應被改寫的網址作為反例。若無法說明某個括號或跳脫字元的用途,就應暫停部署,避免在使用中的設定上反覆試錯。

分清重新導向與透明改寫

帶有 302 的重新導向會讓支援此行為的用戶端繼續請求目標位址,後續請求仍須經過解析、連線與規則處理。這不會讓原連線悄悄轉成另一條線路。若目標位址再次符合另一條重新導向規則,就可能產生連續跳轉;兩條方向相反的規則更可能形成循環,導致頁面無法完成載入。

排查循環時,先停用新加入的重寫,確認原本的存取是否恢復,再檢查從來源位址到目標位址的完整路徑。瀏覽器快取與網站本身的重新導向也可能造成影響,因此應以新請求核對,而不是只看網址列最後停在哪裡。永久重新導向更需謹慎;測試期間應避免快取結果干擾判斷。

HTTPS 不會自動顯示完整路徑

一般加密連線不會因設定中出現 URL Rewrite,就自動讓用戶端取得所有請求路徑與標頭。網域層級的連線資訊與完整 URL 並不相同。某些 HTTPS 重寫功能需要額外的解密條件與憑證信任設定;本頁不要求為了分流啟用這些功能,也不建議為修正一條網域規則而擴大解密範圍。

若目前的目標是「指定網域直連或代理」,應回到 Rule,而不是新增憑證相關設定。若確實因授權測試而需要這些功能,也應限制主機範圍,了解應用程式憑證固定與敏感工作階段的影響,並保留還原方式。不能把「重寫未觸發」直接歸因於表達式錯誤,也要先確認用戶端是否能取得足夠的請求資訊。

維護遠端設定時,應特別留意新增的重寫區段。規則更新不只會改變代理去向,也可能變更存取網址。更新後若出現登入返回異常、連結跳轉不同或資源網址遭替換,應比對 URL Rewrite 與 Host 的差異,而不只是檢查 Rule。只保留確實需要的功能,能讓後續排錯更容易界定範圍。

07 常見規則寫法與組合方式

組合規則時,先用一句話說明目標,再拆成精確例外、較廣泛的規則集合與兜底規則。以下範例彼此獨立,用來說明排列方式,不提供任何線路資訊。實際使用前,請將範例主機名稱換成已確認的目標,並保留原設定以供比較。不要因為程式碼簡短,就省略驗證或直接覆蓋目前使用的檔案。

指定網域走代理,其餘直連

[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.net,PROXY
FINAL,DIRECT

這組規則代表明確的允許清單:只有精確指定的 API 網域與網域族採用 PROXY,其餘請求則走 DIRECT。適用於目標範圍已知且能持續維護的情況。若應用程式還依賴其他資源網域,這些連線會落到 FINAL,DIRECT;因此若 API 可用,但圖片或登入失敗,應先查看是否遺漏網域,而不是重複新增現有項目。

維護這類設定時,應記錄服務依賴關係,不要只看瀏覽器網址列。登入授權、靜態資源與檔案上傳可能使用不同主機名稱。新增網域時仍應採用最小必要範圍,確認確實屬於同一服務流程,再決定使用 DOMAIN 或 DOMAIN-SUFFIX。未經觀察就加入範圍過大的關鍵字,可能改變其他應用程式的連線去向。

局部直連,其餘走代理

[Rule]
DOMAIN,router.example.net,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

這裡先保留明確主機名稱的直連例外,再處理私有位址與 GEOIP 分類,最後以代理作為兜底。這組範例與前一組的主要差異不在行數,而在「未列出的目標」採用不同策略。評估設定前,必須先查看 FINAL,因為兜底規則決定新增服務、未知網域與未命中位址的預設行為。

這組規則也無法完整涵蓋所有區域網路。不同網路可能採用其他私有位址範圍,IPv6 也需要另外考量;系統與 General 的繞過行為也可能先行處理。若要存取內部服務,應依實際位址與主機名稱補上規則,不要照抄未經核對的網段清單,就認定區域網路問題已經解決。

後綴規則中的精確例外

[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN,metrics.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY

先列出登入與統計 API 的例外,再為其餘網域族設定統一策略。這裡的 REJECT 只用來示範例外的位置,不表示實際服務可以安全地拒絕這個 API。實際服務可能將統計、初始化與必要功能放在同一個主機名稱下;拒絕整個主機名稱可能造成連帶影響,應先確認它的用途,再決定是否保留。

若同一網域下的不同路徑需要不同處理,DOMAIN 無法區分路徑,重複新增相同網域也不會改變這一點。此時應重新評估是否真的需要依路徑處理,而不是在網域欄位中加入斜線。分流規則與 URL Rewrite 的能力範圍不同,不能靠拼接語法將一種規則變成另一種。

合併設定時保留明確的判斷順序

合併兩份規則清單,不是將兩個檔案直接前後串接。先移除重複的區段標題與中途出現的 FINAL,再依序重新檢查業務例外、網域集合、位址範圍與兜底規則。完全相同的重複行通常只會增加閱讀負擔;相同條件卻對應不同策略則是實際衝突:前面的規則會生效,後面的項目可能讓維護者產生錯誤預期。

訂閱分組與規則分流也應分開管理。訂閱名稱變更不應讓你無法說明連線去向;刪除某份訂閱前,則要確認目前選取的代理仍然有效。若要整理不同來源的項目,可參閱多份訂閱的分組、更新與重複項目清理;整理完伺服器清單後,再另外驗證規則是否仍指向預期路徑。

建議每次只新增一組組合目標,例如先完成內部位址直連,再處理特定網域代理,最後才加入拒絕例外。每個步驟都記錄一個成功範例與一個反例。即使設定不長,也能清楚說明每條規則的用途;發生異常時,可以快速撤回最近新增的規則,而不必重建整份清單。

08 規則驗證、故障定位與維護流程

驗證分流不是只看網頁能否開啟,而是要串起請求目標、命中規則、採用策略與最終連線結果。網頁成功可能是因為快取,失敗可能來自伺服器或目標服務;兩者都無法單獨證明規則正確。排錯應從最容易核對的目前狀態開始,沿著連線處理流程逐層縮小範圍,避免同時修改多個互不相關的設定。

第一步:固定目前的測試條件

記錄目前的網路、選取的伺服器、Global Routing 模式與 Config 檔案名稱。確認開關已連線,且目前使用 Config,再選一個你能清楚說明預期去向的目標。暫時不要切換多台伺服器或重新匯入訂閱;若測試條件一直變動,就無法判斷下一次成功是來自規則調整還是網路恢復。

檢查設定是否已儲存並啟用,以及遠端更新是否覆蓋本機修改。若要測試新規則,應建立新的連線,盡量避免重用舊的工作階段。瀏覽器可先關閉相關頁面再重新開啟,獨立應用程式則可結束後重試;不必一開始就重設系統網路。每個操作都應用來排除一個具體變因。

第二步:核對目標與第一條命中規則

在應用程式提供的連線記錄或診斷資訊中,找出本次請求的網域、目的 IP、規則與策略。記錄中顯示的 API 網域可能與頁面網址不同,應以實際請求為準。先確認請求是否進入目前使用的設定,再檢查是否被更早的後綴、關鍵字、位址規則或拒絕例外攔截;不要只搜尋自己剛新增的那一行。

若看不到預期的網域,應考慮請求可能只帶有位址、加密連線可見資訊有限、應用程式使用其他主機名稱,或記錄範圍不同。不要憑猜測新增數十個網域。先用相同的規則類型建立一個較容易觀察的測試目標,確認基本比對邏輯,再回頭分析原本的應用程式。尤其是 USER-AGENT,必須先證明能取得對應識別資訊。

第三步:分開判斷策略正確與連線成功

觀察結果優先檢查下一步
意外命中 REJECT關鍵字範圍、精確例外順序縮小規則範圍並重新建立連線
命中 PROXY 但連線失敗伺服器選擇、驗證資訊、目標可達性以 Proxy 模式測試相同目標進行比對
命中 DIRECT 但連線失敗本機網路、DNS、內部路由比對實際目的位址與網路條件
一律落到 FINAL目標欄位、規則類型、可見資訊確認網域與位址是否符合條件
修改後情況沒有改變選取的檔案、快取、既有連線確認已儲存並啟用,再發出新請求

Connectivity Test 可協助檢查伺服器連線狀況,但不能取代對特定服務目標的完整存取測試。測試位址可能與實際目標不同,使用的協定能力與請求類型也可能不同。同樣地,Data 中出現上傳或下載流量,只能表示相應統計範圍內有流量,不能只憑流量大小判定某條規則已命中。統計畫面的說明請見Data 頁面流量統計說明。

第四步:保留證據並採取最小幅度還原

新增設定後若出現異常,先停用最近加入的一組規則或重寫,並還原至先前儲存的設定進行比對。若還原後恢復正常,再逐項重新加入,不要重設所有設定。記錄中應包含目標、預期策略、實際命中的第一條規則與錯誤發生階段;這些資訊比「有時無法開啟」更能協助判斷問題出在順序、解析還是代理連線。

分享排錯資料時,請移除訂閱連結、驗證欄位、存取權杖及含有個人資訊的查詢參數。教學與交流可使用 example.com 和保留位址重現結構,不必公開真實憑證。規則範例中的網域通常不敏感,但連線記錄可能包含完整路徑與工作階段資訊;整理前應逐項檢查,不要直接轉傳整份設定。

建立可重複執行的維護檢查

每次更新規則後,至少重新測試一個代理目標、一個直連目標,以及一個不應符合的反例;若使用 REJECT,也要確認拒絕範圍沒有擴大。更換網路後,重點檢查內部位址與 DNS;更換伺服器後,重點檢查代理路徑;更新設定後,則檢查規則順序與新增區段。測試項目不必多,但應固定,且能涵蓋實際用途。

若問題出在首次連線步驟,可回到快速入門教學重新確認;若涉及取得方式或系統允許設定,請查看下載頁的安裝與允許設定說明;若是常見使用問題,請前往常見問答。規則參考的最終目標,是讓每個結果都有可追溯的依據,而不是不斷增加規則,直到某次存取碰巧成功。