官方手冊 · 設定參考

Shadowrocket 設定大全

設定檔結構、分流規則與比對優先順序

首次連線時,先依照快速上手匯入現有訂閱或伺服器資訊,並確認連線可用。若要了解某個請求為何直連、為何符合預設策略,或準備修改設定檔,再回到本頁查閱相關章節。尚未取得用戶端,可先查看全平台下載。

iPhone / iPad 版在 App Store 一次性付費 $2.99,系統需求請以 App Store 頁面標示為準;Mac(Apple 晶片版及 Intel 版)、Windows、Android、Linux 版免費,安裝檔請從本站 /dl/ 取得。用戶端一次買斷 ≠ 連線服務方案。本站不提供、不銷售、不推薦節點或訂閱。

設定檔結構與 [General]

閱讀設定檔時,先確認目前使用的是哪個檔案,再檢查規則內容。匯入成功只代表檔案已加入用戶端,不表示它正在處理目前的連線。請在 Config 確認生效中的檔案,再回到 Home 檢查 Global Routing。若後者未選擇 Config,就不能根據實際連線結果判斷檔案中的一般分流規則是否命中。開始編輯前,請保留一份可還原的原始設定,並記下目前使用的檔名與模式。

先依區段定位,再檢查各行參數

方括號標示區段名稱。後續內容都屬於該區段,直到下一個區段標題為止。[General] 用於一般設定,[Rule] 用於比對條件與策略,[Host] 用於主機名稱解析對應,[URL Rewrite] 用於設定符合條件的 URL 改寫動作。這些區段不是四個優先層級,也不表示每個請求都會從頭到尾依序執行四遍。排查時,請依問題定位區段:連線去向不符就看分流,解析結果不符就看主機對應,路徑改變才檢查重寫。

四個常用設定區段的用途
設定區段主要用途修改前記錄
[General]設定連線處理的一般選項。原有的排除項目,以及需要繼續處理的請求。
[Rule]依條件選擇連線策略。請求的實際目標、預期策略與預設策略。
[Host]指定個別主機名稱的解析對應。目標主機名稱、原始位址與測試位址。
[URL Rewrite]比對 URL 並執行指定的改寫動作。原始 URL、預期目標與重新導向結果。

這四個區段的行格式不能互換。等號用來連接設定名稱與值,也會用於下文的靜態對應範例;規則區段以逗號分隔欄位;重寫範例則以空格分隔比對式、目標位址與動作。複製程式碼區塊時,請勿將說明文字一併寫入檔案。若應用程式提示無法讀取,先檢查剛修改的區段標題與欄位分隔符號,尤其留意輸入法產生的全形逗號、全形等號,以及編輯器自動插入的換行。網頁上的視覺換行與檔案中的實際換行不同;每條規則都應維持在同一行。

一般設定:只保留用途明確的排除項目

[General]
skip-proxy = localhost, 127.0.0.1

skip-proxy 是一般設定中的排除清單,範例列出兩個本機目標。它不是一條 DIRECT 規則:前者決定哪些請求進入代理處理範圍,後者則是請求進入規則比對後得到的策略結果。分流記錄中沒有某個項目,不代表它命中了直連規則。不同網路或應用程式的請求擷取方式可能不同,尤其要先確認請求是否進入目前用戶端的處理範圍,再討論具體命中哪一行。

保留原檔中的其他一般設定,不要只為新增一條網域規則,就複製整段來源不明的設定。若排除清單已有其他目標,請先逐項確認用途;重複寫入同一個設定名稱不能取代清單合併,也不應假設系統會自動追加。若要解決某項服務連線路徑錯誤,優先在 [Rule] 加入精確規則並測試;只有確認問題出在一般設定所涵蓋的範圍時,才單獨修改該設定。這樣才能保留修改前後的狀態供比較。

同時修改檔案、模式與伺服器,往往會讓測試失去比較基準。請一次只變更一個因素並重新測試;先確認設定檔能正常讀取,再確認請求確實使用了新規則。

區分訂閱內容與本機規則副本也很重要。現有訂閱可能用於更新伺服器項目,也可能由外部來源提供整份設定檔,這兩種行為不能混為一談。編輯前,先確認應用程式使用的是匯入後的本機副本,還是仍會隨遠端來源更新的設定檔。若本機修改在重新整理後消失,先檢查檔案來源與目前選取的檔案,不要立刻改用另一種規則語法。請另存不含憑證的自訂行記錄,下次更新後即可確認是否仍需合併。

網域規則:精確比對、後綴與關鍵字

知道要處理的主機名稱時,先使用網域規則。網域欄位只填主機名稱,不包含通訊協定、連接埠、路徑或查詢參數。若要從網頁網址擷取條件,先從完整網址中找出主機名稱。網址列只能顯示頂層頁面的位置;圖片、工作階段介面與靜態資源可能來自其他主機。若首頁能開啟但部分內容失敗,先找出實際失敗的請求,不能因此推斷同一個主機名稱同時使用兩種策略。

以最精確的條件表達需求

網域規則對照
關鍵字條件範例符合範圍
DOMAINapi.example.com只符合這個完整主機名稱。
DOMAIN-SUFFIXexample.com符合該網域及其子網域,不會把拼寫相似的名稱當成子網域。
DOMAIN-KEYWORDexample符合主機名稱中包含該字串的請求。
[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
FINAL,DIRECT

這個範例先將介面主機列為例外,再把同一網域下的其他請求交給 PROXY。請求 api.example.com 會在第一行停止,不再比對第二行。造訪 www.example.com 會符合後綴規則;造訪 api.example.org 不屬於該後綴,但會符合關鍵字規則。關鍵字規則用來展示涵蓋範圍,不代表建議在所有設定中保留這條規則。若只需處理一個可明確列出的網域,應刪除這條寬泛條件;若確實有多個後綴,通常逐一列出會更方便日後檢查。

後綴不是副檔名,也不是 URL 的結尾。例如 example.com.other.test 並非 example.com 的子網域,而 assets.example.com 是。關鍵字不必符合網域標籤邊界,同一片段出現在不相關的主機名稱中也可能命中。除非已檢查過相似網域,否則不要直接把品牌簡稱、環境名稱或常見業務詞當成關鍵字。若要同時涵蓋一個網站及其測試網域,通常使用兩條精確或後綴條件,比一條模糊條件更容易維護。

比對請求目標,而非網站顯示名稱

排查網頁問題時,最好記下可重現的操作,例如開啟頁面、載入某張圖片或送出表單,並確認該操作產生的主機名稱。其他應用程式也一樣,不要把桌面圖示顯示的名稱填入網域欄位。若用戶端只能看到目的 IP,就無法使用網域規則比對主機名稱;請檢查記錄顯示的是請求網域還是位址,再選擇相應的規則類型。網域解析到某個位址,也不代表使用該位址的其他網域應採用相同策略。

路徑差異不在網域規則的比對範圍內。同一主機上的兩個路徑即使用途不同,也會符合相同的網域條件。在 DOMAIN 的第二欄加入斜線與路徑,並不會得到更精確的分流。若要調整自己管理的 HTTP 網址路徑,請參閱 URL Rewrite;若只是想測試單一介面,仍可使用該介面的完整 URL 發起測試,但比對條件應填入它的主機名稱。

至少使用兩種樣本驗證網域規則:一個應該命中的目標,以及一個拼寫相似但不應命中的目標。若另有設定例外,再測試例外,確認前面的寬泛規則沒有先攔截它。

服務端新增資源網域時,先確認該資源是否確實用途相同,再決定新增精確條件或擴大原有後綴。擴大後綴會影響之後新增的子網域,雖可減少重複維護,也可能連測試或管理入口一併改道。若不確定是否應共用範圍,先將新主機單獨列出。想快速查閱各關鍵字的欄位與範圍,可參閱規則類型詳解。

位址規則:GEOIP、IP-CIDR 與 IP-CIDR6

位址規則比對的是連線目的位址,不是裝置本身的位址,也不是使用者所在的地區。適用於直接以位址存取的服務、用途已確認的位址範圍,或在網域例外之後執行較寬泛的地區條件。以位址表示固定的內部網段通常很直接;以位址取代公網網域則應謹慎。公網服務可能更換位址,也可能與無關網站共用位址,因此不宜將單次解析結果直接寫成長期規則。

先區分位址類別與前綴範圍

[Rule]
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR6,2001:db8:1::/48,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

IP-CIDR 用於設定 IPv4 網段。範例中的 /16 表示前 16 位固定,涵蓋從 192.168.0.0 到 192.168.255.255 的整個範圍。若實際需求只是連線到一台位址固定的裝置,使用該位址加上 /32 會更精確;只有確實需要涵蓋前三段相同的子網路時,才使用 /24。前綴越短,涵蓋範圍越大,不能把斜線後的數字理解為裝置數量。寫入檔案前,最好分別用網段內位址與相鄰網段位址檢查邊界。

IP-CIDR6 用於設定 IPv6 網段。範例使用的是文件專用示例位址,不是可連線的線上服務。若要指定單一 IPv6 位址,可使用 /128;不要以一條 IPv4 條件推斷 IPv6 請求會採用相同策略。單一主機可能同時解析出兩種位址,實際連線目標則會受網路與服務狀態影響。同一網域在不同網路下結果不同時,可比較兩次實際使用的位址類別,再確認是否只有其中一類位址設定了相應條件。

了解地區資料與解析的界線

GEOIP,CN,DIRECT 表示目的位址被地區資料歸類為 CN 時,採用 DIRECT。它不是依網域後綴判斷,也不會辨識內容語言、帳號地區或服務商名稱。使用共用基礎設施的網站可能在不同網路上解析到不同位址,資料庫的地區分類也可能與預期不符。若個別網站必須始終使用同一路徑,優先設定網域例外,再將地區規則作為一般條件;不要把地區標記當成網站身分的證明。

目標最初以網域形式出現時,單靠網域無法判斷位址條件:比對必須取得可用的目的位址,有時也會涉及解析。排在前面的位址規則,可能讓原本可由網域決定的請求先進入位址判斷。若已知某主機必須使用特定策略,請將其網域規則放在需要判斷位址的一般規則之前;只有確實希望位址範圍優先時,才將位址規則移到前面,並以已知網域的請求重新測試。不要把瀏覽器另一次查詢的結果,當成用戶端這次一定會使用的結果。

位址比對與位址可達是兩回事。目標可能正確符合 DIRECT,但目前網路沒有通往該網段的路由;此時繼續修改前綴也不會建立這條路由。

排查內部服務時,先確認網路環境。不同地點可能使用相同的私有網段;離開原本的網路後,原位址可能無法連線,也可能指向另一台裝置。範圍過廣的私有位址直連規則無法區分這些地點。若只有某處服務需要放行,請記錄限定條件,不要為了省事而擴大到所有私有位址。也要檢查既有的一般排除項目:若目標沒有進入規則處理,看不到位址規則命中並不代表前綴寫錯。

為位址規則保留兩份測試記錄:一份記下實際命中的行,另一份記下連線在哪個步驟中斷。測試位址範圍內的目標失敗時,先確認是策略選錯,還是已依預期直連但無法到達;若透過代理失敗,則檢查已選擇的伺服器能否連線到測試目標。不要因為單次無法連線,就把整個網段的策略從直連改成代理。需要復原時,移除剛加入的位址條件,再以相同目的位址重試,才能判斷新規則是否造成變化。

請求標識與 PROXY、DIRECT、REJECT

規則開頭的欄位說明要檢查什麼,行尾欄位則說明命中後要做什麼。USER-AGENT 是依據可用的請求標識進行判斷的條件類型;PROXY、DIRECT、REJECT 則是策略。不要把標識當成策略,也不要把介面中的 Proxy 模式寫在規則行首。以下範例將三種策略分別寫在不同的行,方便逐一驗證命中結果與執行效果。

依請求標識比對的前提

[Rule]
DOMAIN,unused.example.com,REJECT
USER-AGENT,ExampleReader*,PROXY
DOMAIN,docs.example.com,DIRECT
FINAL,DIRECT

範例中的 ExampleReader* 用來說明前綴比對:目標是請求實際送出的 User-Agent 值,不是應用程式圖示名稱、安裝檔名稱或登入帳號。不同的請求程式庫可能使用不同標識,同一款應用程式的網頁檢視、資源載入與背景工作也可能送出不同值。標識可以修改或省略,不能用來取代身分驗證,更不能據此斷定某次連線一定來自特定應用程式。測試時,請使用可控制的範例請求,並記錄送出的標識與實際命中行。

此外,規則是否可用取決於用戶端能從該請求取得哪些欄位。連線記錄中有主機名稱,不代表同時能讀取請求標頭。尤其不能將「連線到加密網站」解讀為「必定能取得標識欄位進行比對」。若記錄無法支持這項判斷,就不要不斷縮短關鍵字來嘗試命中。若需求本來就是處理某項服務,優先使用可確認的精確網域;只有確實需要依標識區分請求,且測試樣本能看見該欄位時,才保留這類規則。

選定策略後,應驗證實際執行結果,而不只看網頁

內建策略的用途與驗證方式
策略用途優先確認
PROXY依目前選取的代理處理請求。代理選擇是否正確,以及伺服器能否連線到該目標。
DIRECT透過目前的網路直接連線到目的服務。目前網路的解析、路由與目的服務是否可用。
REJECT拒絕符合條件的請求。遭拒絕的是否確實為預期的主機或請求。

PROXY 不是伺服器位址,也不會自動補上訂閱。命中後,用戶端仍須有可用且已選取的伺服器。若命中記錄符合預期,但頁面請求失敗,先以相同選擇測試一個已知可連線的非敏感目標,再檢查該代理能否處理出錯的目標。若訂閱更新遇到問題,可回到快速上手核對匯入與連線步驟。測試伺服器可用性與修改分流條件是兩種不同操作,不應同時進行。

DIRECT 也不代表退出用戶端或關閉連線。它表示這個請求選擇直接連線,用戶端仍可對其他請求套用不同規則。REJECT 則會主動拒絕請求;應用程式可能顯示失敗、反覆重試,或只呈現部分資源缺失。不能只憑失敗頁面就判定是拒絕規則,也不要因為部分資源未載入就修改所有拒絕項目。先縮小範圍,確認實際命中的請求與規則,尤其留意寬泛的後綴條件可能同時涵蓋正文、登入與資源服務。

同一個請求可能同時符合多項條件:例如範例中的文件主機也可能使用指定標識。若該標識可供比對,請求會先套用標識規則中的 PROXY,而不是後面的精確網域直連規則。若文件主機必須始終直接連線,請將它的網域規則移到標識規則之前。調整後,除了重新測試該主機,也要測試一個應繼續走代理的對照請求,避免修正影響不相關的行為。

比對順序、FINAL 與 Global Routing

驗證分流時,先檢查 Global Routing,再確認檔案中的行序。同一份檔案在不同模式下會有不同作用。若要檢查某條 [Rule] 是否生效,請先選取 Config。若目前使用 Proxy 或 Direct 進行連線對照,只能藉此判斷整體代理路徑或直接連線路徑是否可用,不能用來證明某條規則寫得正確。對照測試結束後,記得切回原本需要的模式。

模式與規則策略的關係
介面文字選擇方式適合驗證
Config依目前設定處理分流。規則命中順序、例外與預設策略。
Proxy讓進入處理範圍的流量透過代理連線。使用目前伺服器時,請求能否完成。
Direct讓進入處理範圍的流量直接連線。目前網路能否直接連線到目標。

先符合的規則先執行,不會自動挑選最精確的一條

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

以已進入規則比對的新請求為例:造訪 health.example.com 時,第一條規則符合,立即選擇直連;造訪 www.example.com 時則會在第二條停止。只有其他請求才有機會進入地區判斷,仍未符合條件時才會執行 FINAL。若對調最前面的兩行,檢查位址的請求也會先被後綴規則攔截。這不是精確規則失效,而是它還沒輪到執行。安排規則時,應從已知例外、一般條件到較寬泛條件依序編排;只有業務需求明確要求覆蓋例外時,才改變這個順序。

兩條涵蓋範圍相同、策略卻不同的條件,也不會等到檔案結尾再以最後一條為準。發現重複行時,先追查前面的規則是否來自原始設定,再決定要替換原策略,還是新增範圍更窄的例外。若難以找出遮蔽規則的條件,請依檔案順序列出目標主機及所有可能符合的條件。第一條資訊足夠且符合條件的規則,就是優先檢查對象;不要跳過它,反覆重寫後面的精確條件。

預設策略是處理方式的選擇,不是故障修復

FINAL 只包含規則名稱與策略,不需要網域或位址欄位。請將它保留在 [Rule] 最後一行;寫在它後面的普通條件不會成為有效例外。FINAL,DIRECT 會讓未列出的請求直接連線,適合明確列出需透過代理連線目標的設定;FINAL,PROXY 會讓未列出的請求使用代理,適合以代理為預設並維護直連例外的設定。選擇前先想清楚未知目標應如何處理,不要因為某次測試失敗,就臨時反轉所有未列出請求的處理方式。

看到請求命中 FINAL,表示沒有更前面的條件符合它。先確認目標是否確實需要新增規則,再檢查目標欄位、前綴與行序。不要先修改全域後備策略。

至少用三種對照操作驗證規則:造訪一個精確例外、一個只符合寬泛條件的目標,以及一個兩者都不符合的目標。若另有位址或標識條件,也要確認第三個樣本沒有被其他規則提前攔截。每次修改後,請等到設定儲存並生效,再建立新的連線;單純重新整理畫面不一定能避免重用連線。瀏覽器快取、應用程式長連線與既有頁面請求都可能讓觀察結果延遲。若看到的仍是上一輪記錄,不能據此判定行序沒有生效。

請求表現與記錄不一致時,可以先透過模式進行簡短對照:直連可用但代理不可用,應優先檢查已選取的伺服器;兩者都可用但設定模式出錯,則聚焦檢查命中行與該行策略;兩者都失敗,應先確認目標與目前網路。進行直連或代理對照時,只使用允許透過兩種路徑測試的目標。對照結果不能取代規則記錄,但能避免在錯誤的區段反覆修改。

[Host]:解析對應與分流的差異

[Host] 用於設定特定主機名稱的解析對應,不會將瀏覽器中的 URL 改成另一個網域,也不會直接選擇 PROXY 或 DIRECT。適合在受控環境中保留原主機名稱,改用已知的測試位址,例如測試自己管理的服務。若需求只是讓現有網站改走另一條網路路徑,修改 [Rule] 即可,不應先修改解析結果來配合策略。

分別記錄名稱、位址與策略

[Host]
lab.example.com = 192.0.2.20

[Rule]
DOMAIN,lab.example.com,DIRECT
FINAL,DIRECT

對應行左側是主機名稱,右側是位址;此處使用文件保留位址,不會提供實際可存取的服務。規則行則指定造訪該主機名稱時預期採用的策略,不會建立位址對應。即使範例中的兩處使用相同主機名稱,測試時仍應拆分為兩個問題:是否由預期位址接收,以及請求是否走預期路徑。測試自己管理的服務時,可對照伺服器收到請求的情況與用戶端記錄;只看到頁面開啟,還不足以證明對應有效。

不要把原網站的完整網址放在等號左側,也不要在右側附上連接埠與路徑。主機名稱解析與連線目標連接埠是不同參數;實際連接埠仍由請求指定,或依通訊協定預設值選擇。若原服務使用測試連接埠,應由發起請求的一方明確指定。也不要隨意將主機名稱擴大為整個網域的模式:若只要測試一項服務,請填寫明確的主機名稱,避免改變同網域其他入口的解析預期。

快取、解析路徑與服務身分

靜態對應會影響使用該對應的解析流程,但不會強制修改所有應用程式與所有解析路徑。如果應用程式已有快取、直接使用位址連線或自行解析,或解析實際上由遠端處理,就不應假設在本機新增一行對應後,所有請求都會使用新位址。測試時,請使用明確需要驗證的應用程式發起新請求,並確認記錄中的目的位址;不要只比較另一個應用程式或系統查詢工具提供的結果,因為它們未必使用相同的解析路徑。

為主機名稱指定新位址,不會將該網站的身分驗證移轉到新位址。請求仍會使用原主機名稱,受控測試伺服器必須能以該名稱提供相應服務。若出現憑證不符、業務頁面不正確,或伺服器傳回非預期網站,請先檢查伺服器對該主機名稱與連接埠的設定。不要忽略憑證警告來判斷對應是否成功,也不要任意替換自己無權管理網站的解析結果。驗證期間請使用不含帳號資訊的測試請求,避免將真實工作階段送往錯誤目標。

確認問題出在解析錯誤時,不要同時新增 GEOIP 例外或修改預設策略。位址條件取決於實際目的位址,因此解析對應改變可能間接影響比對結果。若要固定這項因素,可在測試副本中保留明確的網域規則,再單獨觀察位址。確認對應正確後,再決定是否恢復依賴位址的常規條件。如此既能驗證新位址,也不會把代理與直連的差異混入解析檢查。

對應行適合用於期限明確的測試。測試完成後,請從使用中的設定檔移除該行,再以新連線確認解析結果已恢復。若保留測試副本,也請註明它僅適用於測試環境。

移除對應後若仍連線到舊位址,先確認目前檔案中沒有第二條相同名稱的對應,以及是否仍在使用上一條連線。接著在同一網路中重新發起請求並比較記錄,不要直接修改系統的所有解析設定。若使用中的檔案來自會自動更新的來源,請確認該對應是本機新增,還是原始檔案所含;若屬於後者,可能會在設定更新後重新出現。持續生效的修改應從正確來源更新,臨時檢查則應留在獨立副本。

[URL Rewrite]:比對網址與驗證重新導向

重寫用於處理可辨識的請求 URL,適合在自己管理的測試服務上驗證舊路徑遷移到新路徑;它與分流規則解決的是不同問題。DOMAIN 決定某個主機的請求採用什麼策略,不會將舊路徑改成新路徑;[Host] 可以改變使用該對應時的解析位址,但不會變更路徑。遇到請求目標異常時,先分清楚改變的是連線去向、解析結果,還是用戶端實際請求的 URL。

從單一精確的 HTTP 範例開始

[URL Rewrite]
^http://example\.com/old$ http://example.com/new 302

這一行依序填入比對運算式、目標 URL 與動作。開頭的 ^ 和結尾的 $ 將條件限定為完整網址;\. 表示網域中實際出現的句點,而不是任意字元。只有完整網址與舊路徑完全相同的樣本才符合這個運算式;帶有查詢參數、結尾斜線或使用不同通訊協定的網址不在此範例的範圍內。結尾的 302 表示暫時重新導向。跟隨重新導向的請求端會向目標位址送出後續請求;後續請求的去向仍須分別檢查位址與適用規則。

範例網址僅用於說明寫法,不代表該網站提供這兩個路徑。測試時請使用自己控制的測試主機,以及不含個人資料的唯讀請求。將 example.com 替換為測試主機時,左側運算式中的句點仍須跳脫;右側作為字面目標 URL,則使用一般句點。若測試服務需要明確指定連接埠,比對式也須將實際輸入的連接埠納入考量。不要一開始就寫出涵蓋所有頁面的運算式,再試著用更多規則排除副作用;先確認單一路徑能依預期重新導向,再逐步擴大範圍。

檢查可見範圍、查詢參數與重新導向迴圈

此範例刻意使用 HTTP。用戶端能看見 HTTPS 連線的主機資訊,不代表它可以直接讀取連線內部的路徑或請求內容。不能因為看得到主機名稱,就認定將前綴改成 HTTPS 後完全等效。使用瀏覽器測試 HTTP 時,也要留意瀏覽器是否先將輸入網址升級為 HTTPS;如此一來,實際請求就不再符合範例。請先從測試端記錄的實際通訊協定與 URL 查起,不要為了讓測試命中而降低正常瀏覽時的安全設定。

查詢參數也是比對範圍的一部分。此範例不會攔截帶有參數的舊網址,也不會自動將參數附加到目標。若業務確實需要處理參數,請明確列出哪些參數應保留、哪些不應轉送,並使用不含憑證的測試值檢查結果。登入與提交類請求不適合用此範例推斷行為:請求端跟隨重新導向時可能變更方法,業務端也可能依賴請求本文。遷移驗證請從一般讀取請求開始;具有提交語意的路徑應另行測試。

目標網址不應再次符合本條件,也不應被另一條重寫規則送回原網址。至少發起三次請求進行檢查:舊網址應重新導向,目標網址應正常完成,相似但不符合條件的路徑應維持原樣。若瀏覽器提示多次重新導向,請逐次觀察實際目標,區分由設定造成的重新導向與伺服器端的重新導向。不要只看最後的網址列;錯誤的中間重新導向有時會被後續頁面掩蓋,卻仍可能影響資源請求或其他存取方式。

測試時先關注第一次回應:是否發生預期的暫時重新導向,以及目標網址是否正確。接著再確認後續請求能否到達;命中重寫規則與目標可連線是兩個不同的結果。

停用測試用重寫後,應主動發起新請求並再次比較。已快取結果的頁面、伺服器原有的重新導向,以及應用程式自行升級網址的行為,都可能持續出現,看起來就像設定仍在生效。若已確認目前檔案中沒有該行,請檢查請求端是否重用了上一輪結果,或目標服務原本就會提供相同的重新導向。記錄中只保留測試網域、路徑與動作,不要複製含身分資訊的完整真實網址。

設定範例、驗收順序與還原

以下以現有設定中的一項小幅修改為例:一個檢查主機應直連,同一網域下的其他服務使用已選取的代理,已確認的內部網段直接連線,未列出的目標則維持直連。範例網域僅用來說明語法,請換成允許測試且由自己管理的主機。若需要代理功能,前提是已匯入自己的訂閱或伺服器資訊,並使用現有連線完成一次可用性測試。

[Rule]
DOMAIN,health.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.40.0/24,DIRECT
FINAL,DIRECT

先寫下預期,再逐項驗收

這段內容不能原樣接在舊檔案的 FINAL 之後,也不必為了使用它而重新建立整份設定檔。若已有 [Rule],請將所需條件合併到該區段,先查看前面的規則是否已涵蓋相關目標,再決定插入位置。只有在需求確實要改變未列出請求的處理方式時,才替換既有預設策略。若原設定預設直連,內部網段規則與目前的預設結果相同,仍可明確寫出以表達意圖;日後若修改預設策略,也要重新驗證這條明確例外。

在測試筆記中,逐項記錄目標、預期命中行、預期策略與實際結果。用檢查主機驗證第一行,以同網域的另一台主機驗證後綴,以選定的內部位址驗證網段,再用不屬於其他範圍的目標驗證預設策略。也要增加一個衝突樣本:若同網域請求最後指向該內部網段,前面的網域後綴規則會優先。若實際需求是無論網域為何,內部位址都必須直連,現有行序就不符合需求;請先確認位址條件是否可用,再調整順序並重新執行前兩項測試。

應分開判斷規則命中是否正確與連線是否成功。即使命中錯誤但頁面能載入,也不代表驗收通過:同一目標可能透過代理或直連都能開啟。反過來說,命中正確但無法連線,也不應立即修改規則。觀察失敗集中在哪類目標:若只有代理目標受影響,檢查現有伺服器的選擇與連線狀態;若只有內部目標受影響,確認測試時所在的網路與實際位址;若只有頁面部分請求受影響,則比較資源使用的主機名稱及其比對記錄。

依序排查設定未生效、規則未命中與連線失敗

第一層是檔案與模式:儲存後重新確認目前使用的設定檔與 Global Routing,並確認測試請求是新發起的。若任何新規則都未反映在記錄中,先檢查是否選錯檔案,或仍處於對照模式。第二層是比對欄位:記錄只有位址就依位址檢查,有網域就核對實際主機名稱與行序,不要根據網頁標題推測。第三層才是執行結果:策略已正確命中時,再檢查直連或代理連線具體在哪個環節失敗。若要確認介面中的位置,可參閱介面英文詞彙對照。

若問題是在切換網路後才出現,先維持相同設定檔、模式與伺服器,只更換網路進行對照。記錄發生變化的是解析位址、命中規則,還是連線結果。位址變動可能符合不同的地區或網段條件;若規則與策略相同但連線失敗,則更應檢查網路路徑。若啟動用戶端時就遇到安裝或取得問題,不要修改設定檔來排除,請先查看下載頁的安裝說明或商店與帳號地區說明。

還原時,先切回保留的原始設定檔,並維持伺服器與測試網路不變,再以相同請求重新測試。只有原始設定下不再出現問題,才有依據逐項比較這次修改。

還原設定不代表要刪除觀察結果。請保留一份已去識別化的設定差異與幾筆最小重現記錄,說明預期與實際結果的差異。若原始檔案也有相同狀況,先暫停擴充規則,回到快速上手重新檢查現有訂閱、伺服器選擇與基本連線。若確認只有新檔案會重現問題,下次只重新加入一組條件,驗收通過後再加入第二組。這樣能找出是哪項修改造成行為改變,也方便設定來源更新後再次檢查。