Shadowrocket 規則參考
從設定分段到首條命中,依問題查閱規則條件、策略與生效範圍。
本頁是系統化查閱手冊,適合已熟悉連線操作、準備修改設定的使用者。初次使用請先閱讀入門指南,完成既有訂閱匯入與連線驗證後,再回來查閱規則。以下內容假設你已有自己的訂閱或伺服器資訊;訂閱連結請向你的服務商取得。
Shadowrocket 提供 iPhone / iPad、Mac、Windows、Android 與 Linux 版本。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。客戶端一次性買斷不等於線路方案。各裝置的取得方式請見下載指南;iPhone / iPad 系統需求以 App Store 頁面標示為準。以下介面操作以 iPhone / iPad 為例,其他裝置的入口位置與可用設定請以目前應用程式實際顯示為準。
設定檔結構
Shadowrocket 的規則設定通常以 .conf 文字檔儲存,並以方括號標示不同功能區段。理解各區段的用途,比記住整份設定更重要:連線參數決定如何連至伺服器,規則決定個別請求採用哪種策略,DNS 則負責將網域解析為位址。這些項目彼此會有影響,但並非同一項設定。將訂閱連結貼進規則區段,或把網域規則寫在 Host 區段,都無法達到預期效果。
先區分三種項目
Home 中的伺服器項目用於連線,訂閱用於批次管理這些項目,Config 中的設定檔則用於儲存路由與相關行為。更新既有訂閱不等於更換目前設定;選用另一份設定檔也不一定會改變目前使用的伺服器。排查時請分別記下訂閱名稱、目前伺服器與啟用中的設定檔名稱,避免把三者的變動誤認為同一項操作。
在 Config 中開啟目標設定檔,確認編輯的是本機副本還是遠端設定。再次取得遠端內容時,可能會覆寫直接寫入其中的修改。若要長期保留測試內容,建議先複製為本機檔案並使用容易辨識的名稱。儲存後還要確認該檔案已選取;清單中有設定檔,不代表目前正在使用。
| 設定區段 | 主要職責 | 無法取代的內容 |
|---|---|---|
[General] | DNS 等整體行為參數 | 伺服器驗證資訊與逐項分流 |
[Rule] | 比對請求並指定策略 | 建立可用的代理伺服器 |
[Host] | 指定網域的靜態位址對應 | 決定連線使用 PROXY 或 DIRECT |
[URL Rewrite] | 處理可辨識請求中的 URL | 通用網路路由與任意讀取加密內容 |
從最小設定結構開始看
[General]
dns-server = system
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
FINAL,PROXY
這段範例僅說明整體參數與規則區段的關係。dns-server = system 表示使用系統 DNS;其後的規則依序處理範例網域、某個私有位址範圍及其餘請求。範例沒有 Host 或重寫區段,因為空區段並非必要。設定越精簡,越容易將每個實際參數與其造成的現象對照,適合作為排查基準。
規則中的逗號是欄位分隔符,請使用英文半形標點。依序排列類型名稱、比對內容與策略,額外參數放在最後;不要直接在策略後附上中文說明。範例說明可另起一行註解,避免複製時混入不可見空格或全形逗號。網域欄位不包含通訊協定前綴,也不要填入完整網頁網址。
儲存不代表驗證完成
編輯後先檢查區段標題是否完整、規則是否仍位於正確區段,再儲存並重新選取目標設定檔。若應用程式提示解析問題,請先檢查剛修改的行與欄位數量,不要急著繼續新增規則。設定檔能夠儲存,只代表編輯流程已結束;實際路由是否符合預期,仍須建立新請求並查看連線記錄。
部分變更只會影響新連線;已建立的長連線可能繼續使用舊路徑。驗證前請關閉測試頁面再重新開啟,必要時於適當時機重新連線 Shadowrocket。重要傳輸進行中,請勿連續切換設定檔。若還原後現象沒有立即改變,先排除連線重用與應用程式快取,再判斷還原是否無效。
完整設定檔可能包含本文未提及的區段與設定。遇到不熟悉的項目,先保留原值並確認用途,不要直接拼接來自不同來源的整份文字。重複區段、衝突參數與遠端更新覆寫,往往比單條規則拼字錯誤更難排查。後續各段範例用於局部替換或查閱,不必一次全部啟用。
比對順序與模式
規則的排列位置和規則內容同樣重要。在 Config 模式下,Rule 區段通常由上而下依序檢查;請求命中一條規則後,就會採用對應策略,不會繼續尋找所謂更精確的下一條。Shadowrocket 不會自動將 DOMAIN 排在 DOMAIN-SUFFIX 前面,也不會因為某條規則看起來更具體,就替你調整順序。
先確認 Global Routing
Global Routing 常用的 Config、Proxy、Direct 三種模式,分別對應介面用詞 Config、Proxy、Direct。學習自訂規則時,請先確認目前選擇的是 Config。若處於 Proxy 或 Direct 模式,發現請求沒有依 Rule 區段分流,不能直接判定規則語法有誤。模式決定如何使用設定檔,實際流量仍受系統路由範圍與接管能力限制。
| 介面用詞 | 運作方式 | 適用的檢查目的 |
|---|---|---|
| Config | 依目前設定檔處理路由 | 檢查 Rule 順序與策略命中情形 |
| Proxy | 以代理模式處理已接管的流量 | 短時間比對代理路徑是否可用 |
| Direct | 以直連模式處理已接管的流量 | 比對本機網路是否可連線 |
三種模式是診斷變因,不是效能等級。切換至 Proxy 後頁面能開啟,只能表示變更路徑後現象有所不同,不能證明每項 DNS 設定都正確。切換至 Direct 後無法開啟,也可能是本機網路本身無法連至目標。每輪比對後請切回 Config,再驗證要保留的規則,避免把暫時使用的模式誤當成最終修正。
明確例外必須排在前面
[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
存取 login.example.com 時,第一條規則已命中,因此不會繼續檢查第二條;存取 www.example.com 時,第一條不符合,才會套用第二條。若交換前兩行,後綴規則會先比對到登入網域,原本的直連例外便不會執行。這是順序問題,不需要重複新增相同網域來解決。
常見的排列方式是將明確例外放在前面,接著放範圍較窄的業務規則,再放較廣泛的位址或地區條件,最後放 FINAL。這種排列方便檢查,但不是固定規則。條件有交集時,應依預期結果決定優先順序;例如同一網域既符合關鍵字條件又有個別例外,就必須讓例外排在關鍵字規則之前。
分開檢查命中與連線成功
規則命中只代表已選出策略。命中 PROXY 後,仍可能因伺服器無法連線、驗證失敗或傳輸受限而失敗;命中 DIRECT 後,也可能因目標端拒絕連線而失敗。將「命中正確」與「存取成功」分開判斷,才不會用不斷調整規則的方式,處理原本屬於伺服器或目標網站的問題。
規則不會因前一項策略連線失敗,就自動繼續嘗試下一條 Rule。後面的規則不是前一條的備援清單。需要切換連線時,請檢查實際設定的伺服器選擇或策略群組行為,不要在同一網域下連續寫入多條不同策略,並期待系統依序重試。本文中的 PROXY 指向目前選用的代理,不代表會自動挑選最快線路。
On Demand 決定是否依條件建立連線,不能取代 Rule 對個別請求的比對;Scene 的具體設定也不應與上述三種模式混為一談。若網路變更後連線狀態與預期不同,先檢查自動連線條件,再檢查流量分流。更多首條命中與條件交集的範例,請閱讀自訂規則與優先順序說明。
網域與請求條件
網域規則適合描述「哪項服務使用哪種策略」,通常比追著網站位址變動更容易維護。先確認手上的資訊是主機名稱、完整 URL,還是應用程式顯示名稱,再選擇規則類型。網頁標題、應用程式名稱與實際建立連線的主機名稱並不相同;把畫面上看到的中文名稱填入 DOMAIN,不會自動找到對應的網路服務。
DOMAIN 與後綴範圍
[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
DOMAIN-KEYWORD,example,PROXY
FINAL,DIRECT
DOMAIN 用於精確比對網域。第一條規則只針對 api.example.com,不會一併涵蓋 www.example.com 或更深層的主機名稱。填寫時只寫主機名稱,不加上 https://、連接埠或路徑。若需求只涉及某個明確的介面,精確規則的影響範圍較容易預測,也方便發現後續網域變更。
DOMAIN-SUFFIX 會比對指定網域及其子網域。第二條規則可涵蓋 example.org 與 img.example.org,但不是任意搜尋字串結尾,因此 notexample.org 不會是正常的比對目標。前面也不必加星號;*.example.org 不是本文所示的後綴寫法。
使用後綴規則前,請先確認網域歸屬範圍。將公用託管平台的寬泛後綴整體指定為一種策略,可能同時影響許多互不相關的網站。若能以具體業務網域表示,就不要擴大到公用後綴。反過來說,若服務明確使用多個子網域,只寫一條首頁 DOMAIN 也可能涵蓋不足,出現首頁正常但圖片或登入失敗的情形。
關鍵字不等於服務識別
DOMAIN-KEYWORD 會依網域中出現的關鍵字比對,涵蓋範圍往往比後綴更廣。範例中的 example 可能命中多個不同網域,不能據此認定它們屬於同一服務商。關鍵字適合用於已知且可檢查的命名規則,不適合把常見短字詞當作可靠的分類條件。若發生誤判,請先改用精確條件,而不是不斷堆疊補救例外。
例如將 ads 指定為 REJECT,只能說明關鍵字拒絕的語法,不能保證只會比對廣告請求;一般網域也可能剛好包含這幾個字母。請先查看實際連線中的網域,再決定是否拒絕。頁面能開啟,不代表登入、媒體與提交介面都未受影響;驗證時應涵蓋實際使用的操作。
USER-AGENT 的可辨識範圍
[Rule]
USER-AGENT,ExampleClient*,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
USER-AGENT 會依可辨識請求中的 User-Agent 內容進行比對,範例中的星號代表萬用字元範圍。它不是依程序名稱識別,也不等同於「某個應用程式的所有流量」。同一應用程式可能使用不同的請求函式庫與識別字串,多個應用程式也可能共用相似識別字串,因此不能只憑一條 USER-AGENT 規則,就認定已完整實現應用程式層級的分流。
HTTPS 會加密請求標頭,單純的通道轉送無法任意讀取其中的 User-Agent。此類規則能否比對,取決於應用程式實際取得的資訊及相關處理條件。不要為了讓規則生效,就把額外的憑證信任或解密設定視為必要步驟;本頁不要求啟用這些功能,常見分流應優先使用可驗證的網域條件。
網域規則看似漏掉比對時,先確認連線實際使用的目標。網頁轉址、內容傳遞網路、獨立驗證網域與直接連線至 IP,都可能讓原本的假設不再成立。若用戶端沒有可用的網域資訊,DOMAIN 類規則也無法憑空推導。請依據連線記錄補上確有需要的條件,不要把所有失敗都歸咎於後綴規則「不夠強」。
維護時建議每項業務只保留少量有依據的規則,並將特殊例外放在該組前面。服務變更後,移除已無用途的舊網域,避免設定檔長期累積難以說明的條件。規則數量多不代表涵蓋更精確;每條規則都能說明存在原因與預期命中對象,才是穩定設定的基礎。
IP 與地區比對
目標透過 IP 建立連線,或需要明確處理區域網路位址時,IP 規則更直接。它比對的是最終目標位址,而非網域的拼寫。使用前請區分單一位址、子網路範圍與地區資料庫:網站可能解析出多個位址,一個位址也可能承載多個網域;依 IP 分流的影響範圍,不一定等同於特定網站的業務範圍。
IP-CIDR 的範圍
[Rule]
IP-CIDR,192.168.50.10/32,DIRECT,no-resolve
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
IP-CIDR,172.16.0.0/12,DIRECT,no-resolve
FINAL,PROXY
IP-CIDR 用於處理 IPv4 網段。斜線後的數字代表前綴長度,不是連接埠或位址數量。/32 指定單一 IPv4 位址,/16 則表示前 16 位固定的範圍。撰寫規則時應使用實際需要的網路範圍,不要只為了讓某台裝置直連,就任意擴大到遠超過實際區域網路的位址空間。
範例中的前三類大範圍是常見的私有位址範圍,可用來理解區域網路直連,但不保證目前網路一定能連線。公司內網、訪客網路與家用路由器可能設有隔離,路由表也可能不同。命中 DIRECT 只會讓本機網路嘗試連線,不會建立存取權限,也不會自動打通遭網路設備隔開的子網路。
no-resolve 的意義
no-resolve 的重點是:不會為了比對這條 IP 規則而主動觸發網域解析;它不是關閉所有 DNS,也不保證規則永遠不會看到解析後的位址。若目標原本就是 IP,或處理流程已取得目標位址,仍可依相應位址進行判斷。此參數適合用來減少僅為檢查部分網段而引入的額外解析,但實際效果仍須配合請求路徑理解。
假設請求一開始只有網域,前面的網域規則已命中,就無須依靠後面的 IP 規則再次決定策略。若網域規則未命中,而後面的位址規則都帶有 no-resolve,不能直接假設用戶端一定會先解析並比對某個網段。撰寫與排查時,請區分「已有位址可供判斷」和「需要為了比對而解析」這兩種情況。
IPv6 與 GEOIP
[Rule]
IP-CIDR6,fd00::/8,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
IP-CIDR6 用於 IPv6 位址,採用相同的前綴概念。範例僅選取唯一區域位址空間的一部分說明語法,並非完整列出所有 IPv6 本機位址。若目標同時有 A 與 AAAA 記錄,只寫 IPv4 範圍不足以表達完整需求;驗證時請確認實際連線使用的位址族,而不只是看網域是否相同。
GEOIP 會依目標 IP 的地區資料庫進行判斷,範例中的 CN 是地區代碼,不代表中文網頁、中文網域或帳號所屬地區。內容傳遞與跨地區部署可能讓同一網域在不同網路解析到不同地區的位址,資料庫本身也有更新與分類範圍限制。因此 GEOIP 較適合作為廣泛分類條件,不適合取代明確的業務例外。
對於必須固定策略的服務,先寫入網域或精確位址例外,再讓 GEOIP 處理其餘範圍。若將範圍廣泛的地區規則放在前面,後續業務規則可能就沒有機會執行。若希望 GEOIP 不主動觸發解析,也要了解相應的 no-resolve 行為可能影響哪些請求有位址可供判斷,不要只複製參數而不檢查結果。
排查位址問題時,請一併記錄目標網域、實際目標 IP、位址族與命中規則。不要把在終端機隨手查到的 IP 當成應用程式連線的唯一目標,因為快取、網路 DNS 與內容傳遞調度都可能造成差異。遇到「同一網域偶爾採用不同策略」時,先確認這四項是否一致,再調整網段;通常比不斷擴大地區規則更有效。
策略與 FINAL
規則左側說明「比對什麼」,右側的策略則說明「命中後如何處理」。PROXY、DIRECT 與 REJECT 是三種不同動作,不是伺服器通訊協定名稱,也不是連線品質評等。條件與策略都正確,規則才完整表達預期用途。檢查設定檔時,可以將每一行讀成一句話:目標符合此條件時,就依指定方式處理。
PROXY 與 DIRECT
PROXY 表示使用代理策略,實際出口取決於目前選用的代理或設定中的關聯內容。它不會憑空從訂閱中挑選可用伺服器,也不保證目標服務會接受該出口。規則命中 PROXY 後,仍須確認目前伺服器、通訊協定參數與連線狀態;若伺服器資訊已失效,新增更多 PROXY 規則也無法修復驗證問題。
DIRECT 表示透過本機網路直接連線至目標,不經過選用的代理伺服器。這不等於停用 Shadowrocket,也不保證請求完全不受系統網路機制影響;在用戶端接管範圍內,DNS 與其他設定仍可能影響存取。直連適用於明確需要本機連線的目標,但「直連」不代表任何地點、任何網路都能連線。
| 策略 | 動作 | 下一步應檢查 |
|---|---|---|
PROXY | 交由代理路徑處理 | 目前伺服器、驗證與目標端回應 |
DIRECT | 交由本機網路路徑處理 | 本機路由、網路權限與目標連線狀態 |
REJECT | 拒絕符合條件的請求 | 是否誤擋必要介面或相關網域 |
REJECT 必須限定範圍
[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
此處先拒絕一個精確網域,再保留登入網域的直連例外,接著讓其他範例子網域使用代理。REJECT 一旦命中,請求不會自動改用 DIRECT。若應用程式不斷重試、部分內容空白或提交按鈕沒有反應,請檢查是否拒絕了所需介面,而不只是確認首頁能否載入。
拒絕規則尤其需要有明確理由。用途不明的網域,請先觀察實際請求及其功能關聯,不要只因名稱陌生就立即拒絕。部分統計、驗證與設定請求可能共用基礎網域,範圍過廣的後綴或關鍵字可能影響必要功能。排查誤擋時,暫時停用單條規則並重做相同操作,比同時刪除整組規則更容易確認原因。
FINAL 表示預設處理方式
FINAL 不需要網域或網段欄位,常見寫法為 FINAL,PROXY 或 FINAL,DIRECT。當前面的條件都未命中時,它會決定如何處理,因此是整份設定檔的預設策略。應選擇哪一種,取決於使用目的與網路條件,沒有適用於所有裝置的固定答案。修改前請先考慮未列出的網域、背景請求與新服務會採用哪種處理方式。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
這段範例採用「明確列出的網域使用代理,其餘直連」模式。若改成 FINAL,PROXY,則其餘請求會預設使用代理,必須事先列出需要直連的例外。兩種模式都可使用,但維護重點不同:前者要留意遺漏的代理範圍,後者要留意遺漏的直連範圍,不要用同一套判斷方式解讀兩種設定。
除非你已準備好維護允許範圍並逐項驗證,否則不建議將 FINAL 設為 REJECT 後直接日常使用。預設拒絕會使未明確列出的新網域無法連線,頁面新增一個介面也可能引發問題。學習階段請先使用容易觀察的預設策略,建立穩定基準,再依明確需求收緊條件。
若設定檔引用自訂策略名稱,請確認該名稱確實存在且拼寫一致;本文僅使用內建策略,以避免這類歧義。不要將服務商顯示的伺服器名稱當成通用內建關鍵字。最終驗收須確認三件事:比對條件是否正確、動作是否符合預期,以及執行後的連線路徑是否可用;三者缺一都不算驗證完成。
General 與 DNS
General 用於設定整體網路行為,其中 DNS 往往是「規則看似正確但網頁無法開啟」的關鍵因素。DNS 會先將網域解析為位址,接著路由規則再依可用資訊選擇策略;實際運作時兩者可能互相影響,但概念上應分開排查。代理伺服器延遲正常,只代表測試涵蓋的連線環節可用,不表示目標網域解析與頁面資源請求都已成功。
建立可比較的解析基準
[General]
dns-server = system
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
dns-server = system 是使用系統 DNS 的範例,不代表適合所有網路的效能建議。若已有明確的 DNS 設定,請先備份原值再進行比較。不要把網路上找到的一長串解析伺服器直接加入設定,並期待數量越多就越可靠;解析結果、網路可達性與故障等待時間都可能讓問題更難釐清。
使用自訂 DNS 時,先確認位址格式與目前應用程式支援的寫法一致,再確認本機網路或相應請求路徑能連至該位址。DNS 服務可連線、回傳結果可用、後續目標可連線,是三個不同的檢查項目。即使查詢成功,回傳位址也可能不適合目前的存取路徑;即使代理可用,DNS 請求本身也不一定會依照預期經過代理。
辨識三種不同的失敗情況
第一種是未取得位址,常見現象是解析逾時或網域相關錯誤;第二種是已取得位址,但連線至該位址逾時;第三種是連線已建立,但目標回傳憑證或應用層錯誤。三者的修復方向不同。單憑瀏覽器顯示的「無法開啟頁面」無法判斷是哪一種,應搭配 Shadowrocket 可用的連線記錄與同一時間的測試結果來確認。
同一網域在兩個網路解析出不同 IP,不必立刻認定其中一個結果有誤。內容傳遞網路會依網路位置與解析路徑分配位址。真正要確認的是:目前的結果能否透過選用策略存取,以及它是否屬於預期服務。切換網路後請重新建立測試請求,並留意快取可能仍保留舊位址;不要將所有差異都歸因於規則順序。
IPv6 也是必要的比較項目。網域同時回傳 IPv4 與 IPv6 時,系統可能優先嘗試其中一種,實際選擇也會受網路狀態影響。如果只檢查 IPv4 規則,實際連線卻使用 IPv6 位址,觀察到的策略便可能不同。先確認實際位址族,再決定是否補上規則;不要把停用某個位址族當成所有 DNS 問題的預設解法。
不要同時修改多項整體參數
General 中還可能包含略過範圍、位址族與其他整體行為設定。這些設定與 Rule 的作用層級不同:若某類流量沒有進入預期的接管路徑,再精細的網域規則也無法解釋問題。看到設定檔中有 skip-proxy 等參數時,先確認用途與目前值,不要把它當成一般 DOMAIN 例外任意替換。
修改整體參數應比新增精確規則更加謹慎。一次同時修改 DNS、位址族、略過範圍與 FINAL,即使問題暫時消失,也無法判斷是哪個項目生效,更難發現副作用。可先固定伺服器與 Rule,只更換一項 DNS 設定;還原後再固定 DNS,調整目標規則。每次記錄變更項目、測試對象與結果,建立可重複的比較流程。
遇到「部分網頁無法開啟」時,先選定一個固定目標並記錄錯誤發生階段,不要連續切換多個網站。若只有某個應用程式發生問題,再比對瀏覽器是否使用相同網域與位址族。更具體的檢查順序請見DNS 解析失敗排查;本章說明概念範圍,該文章則依現象逐步定位。
Host 與 URL Rewrite
Host 與 URL Rewrite 都會影響存取流程,但不能取代一般 Rule。Host 用來指定網域對應的位址;URL Rewrite 則在請求資訊可用時處理 URL;Rule 決定流量採用哪種策略。將這三層職責分開,便能避免誤以為「修改網域對應就會自動使用代理」或「設定重新導向就能修復所有連線」。
Host 用於位址對應
[Host]
test.example.com = 192.0.2.10
[Rule]
DOMAIN,test.example.com,DIRECT
FINAL,PROXY
此處將 test.example.com 對應至 192.0.2.10,並另外透過 Rule 指定該網域的策略。此位址屬於文件範例範圍,不提供實際服務,不能用來驗證網頁是否可連線。實際使用時,請填入你有權使用且已確認適用於該網域的目標位址,並為臨時對應記錄新增原因與移除條件。
靜態對應不再依照一般 DNS 更新而改變位址,因此也失去自動配合調度的能力。服務遷移或內容傳遞切換後,舊位址可能失效。若某網域在其他裝置正常、只有目前設定異常,請先檢查是否保留舊的 Host 記錄,不要立即新增 DNS 伺服器。臨時對應驗證完成後,應決定保留或移除。
HTTPS 憑證驗證仍會將存取網域視為重要依據。將網域對應至任意可連線的 IP,不會讓對方伺服器自動取得正確憑證或對應網站。遇到憑證錯誤時,不要透過略過驗證來掩蓋位址不符;請確認對應位址是否確實提供目標服務,必要時移除對應並改用一般解析路徑進行比較。
URL Rewrite 的欄位
[URL Rewrite]
^http://old\.example\.com/(.*)$ http://new.example.com/$1 302
這是一條 HTTP 重新導向範例:開頭是正規表示式,中間是目標 URL,最後是重新導向狀態碼。^ 限定從字串開頭比對,網域中的句點以反斜線跳脫,(.*) 擷取後續內容,目標中的 $1 則引用這個群組。範例僅用於說明語法,不代表這兩個範例主機上有可用網頁。
正規表示式應盡量限定通訊協定、主機與必要路徑。網域中的句點若未跳脫,會被視為可比對任意字元的中繼字元;缺少開頭限制也可能擴大比對範圍。修改前先列出一個應命中的 URL 和一個不應命中的 URL,再確認表示式能否區分兩者。只測試正例,容易漏掉範圍過廣的問題。
重新導向會讓用戶端繼續請求新位址,因此也要留意循環。若目標再次符合原表示式,或被另一條規則導回舊位址,存取可能不斷跳轉。新網域仍須正常解析,並依相應 Rule 套用策略。重寫成功不代表新目標可連線;請分別確認原請求是否已處理、新請求是否送出,以及後續路由結果。
加密範圍與敏感參數
一般 HTTPS 轉送無法看見完整的加密請求路徑與標頭,不能因為寫了正規表示式,就假設可以任意重寫。本文範例使用 HTTP,避免將憑證信任、解密條件與基本規則混為一談。若沒有明確需求且尚未充分理解,不要為了測試一段重寫設定而額外變更裝置的信任設定;基本網域分流也不需要這項操作。
URL 可能包含登入狀態或其他敏感查詢參數。範例中的 (.*) 會將比對範圍內的內容帶到新目標,實際使用前請確認是否會將不應跨網域傳遞的參數一併轉送。不要將真實業務 URL、驗證連結或私人設定貼到公開討論中;排查時可用範例網域說明結構,保留欄位形式並移除敏感值。
若同時設定 Host 與重寫,建議分層驗證:先停用重寫,確認原網域的位址與路由;再啟用重寫,觀察目標是否改變;最後檢查新目標的解析與策略。一次只恢復一層,便能區分靜態位址過期、正規表示式未命中與目標路由錯誤,也能避免用更複雜的重寫設定掩蓋簡單的 DNS 故障。
驗證、排錯與維護
維護規則的目的不是讓設定檔越來越長,而是讓每個重要請求都能說明為何採用目前策略。可靠流程應包含備份、單項修改、正反例測試與還原。先保留一份可正常連線的設定,再建立測試副本;若基本連線本身不穩定,應先處理伺服器或網路問題,不要在同一輪同時重建所有規則。
依固定順序驗證
- 確認 Home 中目前選用的伺服器可用、Global Routing 設為 Config,且 Config 中已選取要測試的檔案。
- 只新增或修改一條規則,儲存後重新建立目標請求,避免舊連線繼續沿用原路徑。
- 檢查目標網域、實際 IP、位址族、命中規則與最終策略,再記錄存取結果。
- 測試一個不應受影響的目標,確認新增條件沒有擴大到預期範圍之外。
- 結果符合預期就保留修改;否則還原這項變更,恢復基準後再測試下一個假設。
正例應能明確命中新規則;反例則應盡量與正例相似,但不符合條件。例如測試後綴規則時,可選擇同一後綴下的主機與另一個不同網域;測試精確網域時,再檢查另一個子網域。這種比對能找出「更早的寬泛規則已經命中,所以新增規則其實沒生效」的假成功。
以最小片段隔離衝突
[Rule]
DOMAIN,api.example.com,PROXY
FINAL,DIRECT
若設定檔太長而難以判斷,可在副本中暫時只保留一項精確條件與預設策略。先確認最小片段符合預期,再分組恢復其他規則。恢復某一組後結果改變,就檢查該組是否過早涵蓋目標。不要在原檔大幅刪除後再憑記憶重建;測試副本與明確備份能讓每次還原都有可靠起點。
| 觀察到的現象 | 優先檢查 | 不宜直接下的結論 |
|---|---|---|
| 所有請求似乎都使用相同策略 | Global Routing、目前設定檔、較早命中的規則 | 所有網域規則都不受支援 |
| 規則命中正確但存取失敗 | DNS、目前伺服器、目標端回應 | 繼續新增相同規則就能修復 |
| 只有部分頁面功能異常 | 相關網域、REJECT、重寫與快取 | 首頁能開啟就代表整個網站正常 |
| 更新後修改內容消失 | 遠端設定覆寫、本機副本與選取狀態 | 訂閱更新一定會修改所有設定檔 |
區分兩種更新
訂閱更新主要用於維護服務商提供的伺服器項目;遠端設定更新則可能取代規則文字,兩者不可混為一談。更新前記下目前使用的項目與名稱,更新後分別檢查伺服器清單和設定內容。若只想了解如何重新整理伺服器項目,請參閱訂閱更新教學;不要反覆匯入整份設定檔來取代正常更新。
長期維護時,為每組規則寫一句用途說明,比只記下含糊的「修復」更有幫助。說明應包含影響對象、預期策略與保留理由,不要寫入真實憑證。網路環境或服務網域變更後,先確認規則是否仍有必要;移除失效條件可減少條件交集,也讓日後排查更容易找到真正相關的行。
分享排錯資料時,保留規則類型、相對順序與錯誤階段即可;請先移除伺服器驗證資訊、私人訂閱網址與個人網路資訊。訂閱連結請向你的服務商取得;遇到驗證或伺服器端參數問題,也應核對既有服務商資訊。本手冊說明用戶端設定,不會以未知來源的伺服器資訊作為修復前提。
最後完整驗收一次:檢查網頁載入、登入、媒體播放或檔案傳輸等實際操作,再確認切換網路後是否仍符合預期。若只做過一次延遲測試,結論應限於該測試可用,不應宣稱所有設定都正常。若要回到快速操作流程,請閱讀入門指南;取得方式與常見取得問題請見全平台下載說明。穩定的設定應可重現、可解釋,也能明確還原。