官方手冊 / CONFIG
Shadowrocket 規則手冊
本頁說明如何依區段、規則類型與比對結果查閱設定。如果尚未匯入自己的伺服器資料,或還沒完成首次連線,請先依使用說明完成初始設定,再回到本頁調整分流。如果只想查詢安裝、商店帳號或換機問題,請參閱取得應用程式與常見問題。
iPhone / iPad 版請從 App Store 取得,美國商店售價為 $2.99,一次性付費;系統需求以 App Store 頁面標示為準。Mac(Apple 晶片與 Intel)、Windows、Android 和 Linux 版免費,安裝檔由本站 /dl/shadowrocket/ 提供。一次性購買用戶端 ≠ 線路方案;本手冊以你已有自己的訂閱或伺服器為前提;本站不提供、銷售或推薦連線服務。
設定檔結構:General、Rule、Host、URL Rewrite
先釐清三個層次:目前啟用的設定決定用哪個檔案,檔案區段決定每一行的功能,而 [Rule] 中的順序則決定規則的檢查順序。檔案出現在 Config 清單中,只代表可以選用,不代表目前正在使用。開啟 Home,確認 Global Routing 設為 Config,再到 Config 確認目前使用的檔案。修改前先留存一份可還原的副本,尤其不要直接把遠端管理的設定檔當成本機工作檔。
General:先建立解析基準
[General]
bypass-system = true
dns-server = system
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
[General] 使用鍵值格式。此處以 dns-server = system 建立採用系統 DNS 的測試條件,不要在同一次操作中同時更換解析器與修改分流規則。bypass-system 涉及系統流量略過設定,不能用來取代特定網域的 DIRECT 規則,也不能根據單一分流命中紀錄推斷所有系統流量都經過用戶端。比較自訂 DNS 或 DoH 時,請維持啟用中的設定、測試目標與網路不變,另請參閱DNS 設定詳解。
Rule:條件、對象與動作寫在同一行
DOMAIN-SUFFIX,example.com,PROXY 的三個欄位依序為規則類型、比對對象與目標策略;FINAL,DIRECT 則沒有對象欄位。不要把網址、通訊協定前綴或說明文字直接貼進網域欄位。手動編輯時請使用半形逗號、方括號與等號,避免從富文字內容複製時混入全形標點。上述範例不含伺服器資料;若要驗證 PROXY,請先在 Home 選用自己的可用伺服器。範例網域僅用來說明規則範圍,不保證能在你的實際環境中連線。
Host 與 URL Rewrite:位址對應和請求改寫各有適用範圍
[Host]
dev.example.com = 192.0.2.10
[URL Rewrite]
^http://old\.example\.com/guide$ http://new.example.com/guide 302
[Host] 範例將指定名稱對應至文件中的示範位址。改用自己的環境時,請先確認該位址可連線、服務確實在該位址提供存取,且原主機名稱與伺服器端憑證及虛擬主機設定相符。位址對應不等於變更請求主機名稱,也不等於設定直連。如果加入對應後才發生問題,先移除該對應重新測試,不必同時更換 DNS 與策略。
[URL Rewrite] 範例只比對指定的 HTTP 路徑,並以 302 重新導向至另一個位址;它不會將舊網域的所有連線改走代理。正規表示式中的句點需要跳脫,結尾的 $ 限定比對至字串末端,因此附帶查詢參數的請求也不符合此範例。加密連線中的路徑並非預設可見;不要將此範例照搬成可改寫任意 HTTPS 請求的保證。請在自己管理的服務上測試,並同時觀察原始位址與重新導向後的位址。
出現匯入錯誤時,先檢查區段標題是否缺少右方括號、規則行是否位於正確區段,以及從聊天文字複製時是否一併貼入程式碼圍欄。若能匯入但行為不如預期,再核對啟用中的檔案與實際比對對象。將格式檢查與行為檢查分開,避免在檔案根本未參與路由時仍反覆調整規則順序。
網域規則:精確比對、後綴比對與關鍵字比對
知道請求使用的主機名稱時,優先從範圍最明確的網域規則著手。選擇規則時,應看連線目標,而非網頁標題、應用程式名稱或畫面上的按鈕文字。例如,瀏覽器開啟頁面後,主文件、圖片、API 與登入回呼可能分別連線至不同主機。一條規則只會套用至符合條件的連線,不會自動將同一應用程式的所有請求歸入同一策略。
| 規則 | 比對對象 | 適用範圍 |
|---|---|---|
DOMAIN | 完整主機名稱 | 單一 API、閘道或例外主機 |
DOMAIN-SUFFIX | 指定網域及其子網域 | 可採用相同策略的一組主機 |
DOMAIN-KEYWORD | 主機名稱中的關鍵字 | 已評估誤命中範圍的命名模式 |
DOMAIN:為已知主機設定例外
[Rule]
DOMAIN,auth.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
第一條只會比對 auth.example.com。如果服務另有 api.auth.example.com,該主機不會因此改走直連,而會繼續比對下一條規則。這種寫法適合讓登入閘道排除於同網域代理範圍之外,但不能只因主機名稱含有 auth,就認定所有驗證請求都已涵蓋。驗證時請分別執行開啟登入頁、提交請求及登入後返回業務頁面的流程;若只有其中一個步驟失敗,記下該步驟實際連線的目標,避免為了解決單一主機問題而更改整個網域的策略。
DOMAIN-SUFFIX:涵蓋網域本身及其子網域
DOMAIN-SUFFIX,example.com,PROXY 涵蓋 example.com 與 img.example.com,但不應將 notexample.com 或 example.com.example.net 視為同一網域的成員。若要將範圍縮小至 API 網域,可直接使用 DOMAIN-SUFFIX,api.example.com,PROXY,而非先將整個主網域納入,再用許多例外補救。欄位中只填網域名稱,不要加上 https://、萬用字元前綴、連接埠、斜線或路徑;網域規則判斷的是「連線至哪個主機」,不是「存取該主機上的哪個頁面」。
從應用程式故障回推規則時,先確認目標是完整名稱,還是重新導向前看到的位址。使用者看到的網址不一定是最後實際連線的主機名稱。別名解析也不能單獨證明會依解析鏈中的另一個名稱進行比對;應以用戶端實際辨識的目標及可取得的命中資訊為準。如果請求直接使用位址,或連線沒有提供用戶端可用的網域名稱,網域規則可能不會參與比對;此時應改查位址規則,不要改用關鍵字碰運氣。
DOMAIN-KEYWORD:一併測試誤命中的案例
[Rule]
DOMAIN,media-admin.example.com,DIRECT
DOMAIN-KEYWORD,media,PROXY
FINAL,DIRECT
關鍵字不會辨識組織邊界。上述範例除了可能比對 media.example.com,也可能比對 multimedia.example.net。它不會在 URL 路徑中搜尋 media,也不會依頁面內容分類。如果目標只位於已知網域,使用後綴限制範圍,比增加一組寬泛的關鍵字更容易檢查。確實需要使用關鍵字時,先列出預期命中、預期不命中及必須優先排除的主機,再用這三組案例驗收。
排除問題時,第一輪就替換關鍵字規則的策略,通常不是理想的測試方式:影響範圍太廣,多個請求會一起改變,難以判斷是哪個結果讓頁面恢復。先在副本中為單一目標新增 DOMAIN 規則,確認該目標的路由差異,再決定是否擴大至後綴或關鍵字。移除暫時規則後再測一次,才能確認最終設定不依賴該條除錯例外。
位址與請求規則:IP-CIDR、IP-CIDR6、GEOIP、USER-AGENT
網域規則依名稱分類,位址規則依目標位址分類,兩者的判斷結果可能不同。同一名稱可能因網路或解析器不同而取得不同位址,同一位址也可能提供多個名稱的服務。若要依業務身分區分目標,網域通常較容易維護;若要涵蓋明確的區域網路或固定位址,前綴規則更直接。遇到「網域改對了卻走了另一條路徑」,先確認這次連線使用的是原始名稱、IPv4 位址還是 IPv6 位址,再檢查規則順序。
IP-CIDR 與 IP-CIDR6:前綴長度決定範圍
[Rule]
IP-CIDR,192.168.50.0/24,DIRECT
IP-CIDR,192.168.0.0/16,PROXY
IP-CIDR6,2001:db8:20::/48,DIRECT
FINAL,DIRECT
/24 固定 IPv4 位址的前 24 位元;/16 固定前 16 位元。範例將較窄的網段排在較寬的網段之前,示範網段重疊時如何選中例外;不建議將其他私有網段一律設為代理。如果把第二行移至第一行之前,目標 192.168.50.8 會先命中較寬的網段,不會因為 /24 更精確而重新選擇策略。只要比對單一 IPv4 位址,請使用 /32;只要比對單一 IPv6 位址,請使用 /128。
IP-CIDR6 用於處理 IPv6 前綴,上例採用文件示範網段,不可照抄為真實服務位址。在雙協定網路中,一次重新測試可能使用 IPv4,下一次卻改走 IPv6,因此只看到 IPv4 命中,不能證明兩條路徑的策略一致。若目標是區域網路裝置,先從裝置的管理頁面或網路設定確認網段,再於相同網路測試位址是否可達。設定 DIRECT 只表示不經代理轉送,不會替目前網路新增通往目標網段的路由。
需要檢查名稱目標是否符合 IP 條件時,比對過程可能涉及解析。對已確認支援此選項的位址規則,可使用 IP-CIDR,192.168.50.0/24,DIRECT,no-resolve,避免為了這條規則主動解析名稱。這不是全域 DNS 開關,也不會阻止其他處理流程進行解析。啟用後,若直接輸入位址可以命中、輸入名稱卻無法命中,不要立即判定規則失效;先比較兩次輸入的目標資訊是否足以評估此條件。
GEOIP:位址資料庫分類不代表服務歸屬
[Rule]
DOMAIN,api.example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
GEOIP,CN,DIRECT 依目標 IP 的位址資料庫分類進行判斷,不會依語言、頂層網域、裝置所在地或帳號商店地區分類。使用共用基礎架構或就近連線的服務,同一網域可能在不同網路取得不同位址,進而套用不同策略。若自有服務必須穩定採用指定路徑,請將網域例外排在區域規則之前,不要以區域條件代替業務定義。排除問題時請記錄當下使用的目標位址,不能只記下「這個網域昨天可以直連」。
USER-AGENT:只有在請求標識可用時才進行判斷
[Rule]
USER-AGENT,ExampleDesktop*,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
USER-AGENT 比對可取得的請求標識,不是處理程序名稱、系統權限或發起連線的應用程式身分。兩個請求可能傳送相同標識,同一個應用程式也可能在不同功能中傳送不同標識。若請求未提供此欄位、欄位不可見,或連線根本未使用 HTTP,就不應預期這條規則會命中。範例只適合在自己管理的測試環境中驗證已知標識;若要確保某項服務始終採用相同策略,優先使用可獨立核對的網域或位址。
策略與路由:PROXY、DIRECT、REJECT 的處理方式
Global Routing 與規則中的策略屬於不同層次。前者選擇如何處理進入用戶端的連線;後者則是在 Config 模式下由規則指定處理方式。如果你正在驗證一份規則檔,卻讓 Home 中的 Global Routing 維持在 Proxy 或 Direct,觀察到的出口就不能證明該檔案的規則順序。排除問題前先記錄目前模式,並使用可重複的同一請求進行比較。
| 模式 | 處理方式 | 可用於確認 |
|---|---|---|
| Config(設定) | 依啟用中的設定檔分流 | 規則條件、順序與預設策略 |
| Proxy(代理) | 適用的連線使用代理路徑 | 選定的伺服器能否連線至同一目標 |
| Direct(直連) | 適用的連線使用直連路徑 | 目前網路能否直接連線至同一目標 |
PROXY:分別檢查策略命中與伺服器連線
[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,local.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
PROXY 表示將符合條件的連線交由代理路徑處理,不會自動建立伺服器,也不會確認你的訂閱是否仍可使用。命中 PROXY 後,仍可能因伺服器無法連線、驗證資料不一致、目標服務異常或應用程式逾時而失敗。請使用自己已有的伺服器測試:先在 Home 確認選取的項目,再透過 Connectivity Test 輔助檢查。測試可連線只代表在該測試條件下有回應,不保證每個業務目標都能成功。比較 Config 與 Proxy 時,兩次測試必須使用相同伺服器、相同網路與相同目標,否則無法將差異歸因於規則。
DIRECT:不代表暫時關閉用戶端
DIRECT 表示目標連線不經代理伺服器轉送,目前的網路仍須能解析並連線至目標。如果 local.example.com 已命中直連卻無法開啟,請檢查目前裝置是否位於可存取該服務的網路、解析結果是否指向預期位址,以及服務是否正在監聽。切換至 Direct 可用來比較,但不要把關閉用戶端後的結果直接等同於某條 DIRECT 規則:關閉後不再由這份啟用中的設定處理,解析設定等條件也可能隨之改變。
同一頁面的主要請求與附屬請求可能分別走直連與代理。驗證時不要只看頁面是否顯示標題;也要測試先前受影響的登入、清單更新或附件載入操作。只要其中一項依賴無法完成,應用程式就可能顯示籠統的連線錯誤。針對該項依賴檢查網域,比將整段業務切換至另一種模式更容易判斷必要的規則範圍。
REJECT:命中後即停止,不會在失敗時自動嘗試下一條
REJECT 用來封鎖符合條件的請求。範例要求封鎖 blocked.example.com,因此將精確條件排在後綴代理規則之前。如果應用程式接著發出另一個請求,例如改用備援主機,該請求會獨立進行比對;這不代表原請求從 REJECT 自動改用下一行。應用程式可能顯示載入失敗、立即報錯或重試,這些表現都不能單獨證明封鎖是否生效。
使用網域規則封鎖某個主機,也會影響該主機上符合條件的正常請求。若目標與正常內容共用同一主機,單靠網域無法區分兩種路徑。先在設定副本中用一條精確規則驗證,並分別檢查應封鎖與應保留的請求;若兩者無法區分,就不要擴大至整個主網域。更多範例與適用範圍請參閱REJECT 規則寫法。
比對順序:首條命中、例外與 FINAL
在 Config 模式下理解一般規則,先記住一個原則:由上往下檢查,第一條命中即採用其策略。規則類型不會自動改變優先順序;精確網域不會自動優先於排在前面的後綴規則,較長的位址前綴也不會自動優先於排在前面的寬廣網段。同一裝置上的兩份設定即使包含相同規則,只要順序不同,結果也可能不同。
先寫例外,再寫涵蓋該例外的一般規則
[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN,unused.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
若目標是 login.example.com,第一條規則便會結束比對;unused.example.com 會符合第二條;files.example.com 則會符合第三條。對於已被第三條涵蓋的網域,即使解析到符合 GEOIP,CN 的位址,也不會再由後續規則覆蓋既有結果。反過來說,若把區域規則提前,部分原本預期依網域處理的連線可能會先被分類。要判斷規則順序,不能只測一個結果剛好相同的目標,應找出兩條重疊規則會套用不同策略的案例。
測試順序時,先複製一份設定,只交換兩條相關規則,不要同時更動 DNS、伺服器或末尾策略。儲存後確認已切換至該副本,再分別觸發例外主機、一般後綴主機,以及一個與兩者都無關的主機。若只測例外,可能只發現它已恢復,卻漏掉一般規則遭到提前攔截;若只測一般主機,也可能看不出例外規則從未參與比對。反向測試案例同樣有用,能找出寬泛規則是否誤傷無關存取。
使用 FINAL 明確指定未命中時的預設處理方式
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
此設定會將指定網域及其子網域交由代理,其餘連線則採直連。若將 FINAL,DIRECT 改為 FINAL,PROXY,受影響的不只是某個無法開啟的主機,而是先前未命中的所有適用請求。撰寫設定前,先用一句話說明「清單以外的流量要走哪裡」,再選擇兜底策略;合併設定時保留明確的 FINAL 並放在末尾,不要將補充規則加在既有的 FINAL 之後。
排查命中 FINAL 的請求時,先判斷該連線是否原本就應採用預設處理方式。若不是,請核對目標是否為另一個子網域、是否直接使用位址、是否經過重新導向,或規則條件是否依賴用戶端未取得的請求屬性。為漏掉的目標新增具體規則,是修正比對範圍;修改 FINAL 則是改變整份設定的預設策略,兩者不能互相取代。
合併兩組規則前,先檢查重複與遮蔽
檢查合併後的內容時,從每一條具體例外往前找出能涵蓋它的寬泛規則,也要留意相同對象的重複項目。例如兩條 DOMAIN,api.example.com 即使策略不同,後一條也不會因為更新而取得優先權;應優先檢查排在前面的那一條。範圍重疊不一定有問題:若較窄範圍與較寬範圍採用不同策略,且較窄範圍排在前面,這種重疊正是例外設計。相反地,若較大範圍排在前且策略相同,後面的具體項目可能只是冗餘;移除前仍應確認它是否用於維護說明或預定的例外。
依用途將規則分成清楚的小段:單一主機例外、網域後綴分類、位址或區域分類,以及預設策略。這不是必須遵循的固定範本;如果明確要讓某個私有網段優先於一組網域,就應依該目的另行安排,並記錄涉及名稱解析的條件。優先順序不是死記規則,重點是能針對某個目標逐條說明:哪些規則不符合、哪一條命中,以及哪些項目因此不再檢查。
常見組合:依清單分流、區域網路例外與精確封鎖
以下各段都是獨立參考範例,不應直接首尾相接,拼成一份設定。每段都會先說明預設動作,再交代例外與驗收方式。套用至自己的裝置前,只替換已確認的網域與網段;涉及代理時,請使用自己已有的伺服器。如果使用的檔案還包含 [Host] 或 [URL Rewrite],測試組合規則時先保持這些區段不變,避免將位址對應或請求重新導向的變化誤認為規則效果。
組合一:僅讓明確列出的服務使用代理
[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN,assets.example.net,PROXY
FINAL,DIRECT
適合預設採直連、只有少數業務目標需要代理的設定。先驗證登入主機使用直連,再驗證業務網域中的一個子網域使用代理,接著檢查另一個網域上的獨立資源如何處理。不要只以首頁能否載入作為驗收標準:首頁可能只顯示快取內容,驗證或靜態資源則可能使用不同連線。最好從空白或獨立工作階段開始,重現一項完整操作,例如登入後開啟先前未載入的頁面,並分別記錄主要請求與資源請求的結果。
新增資源網域時,先從 DOMAIN 開始,避免連同該網域的其他用途一起改走代理。若測試確認其子網域用途相同,再改用 DOMAIN-SUFFIX。如果瀏覽器與應用程式存取同一服務時結果不同,先比較它們的實際目標與錯誤發生階段;不能因其中一方能開啟,就推斷另一方一定選用了相同規則。
組合二:已知區域網路位址維持直連
[Rule]
DOMAIN,printer.example.com,DIRECT
IP-CIDR,192.168.50.0/24,DIRECT
FINAL,PROXY
此範例預設使用代理,但已知名稱與實際使用的私有網段各有直連條件。分別透過名稱與位址存取同一台自有裝置,有助於區分名稱解析問題與連線路徑問題。若透過位址可連線、透過名稱不行,先確認名稱是否解析至預期位址;若透過名稱可連線、某個位址不行,也要確認輸入的位址確實是該裝置目前使用的位址,而非舊位址或管理頁面顯示的另一個介面位址。
從家用網路切換至行動網路後,目標可能無法連線;從一個 Wi-Fi 網路切換至另一個時,相同私有位址甚至可能指向不同裝置。不要因此將所有私有位址都加入例外,也不要把無法存取歸咎於 FINAL。若應用程式依賴本機裝置探索,請先檢查系統是否授予該應用程式本機網路權限,以及裝置是否位於同一網路;單一直連規則無法保證廣播、探索與實際連線都成功。
組合三:封鎖已確認的獨立主機,保留同網域業務
[Rule]
DOMAIN,telemetry.example.com,REJECT
DOMAIN,updates.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
此範例只封鎖指定主機,不會一併封鎖相同後綴下的更新或業務請求。測試前先確認哪些操作可以失敗、哪些必須成功:檢查指定主機的連線是否如預期遭拒,再驗證更新主機與一般業務主機仍能正常運作。如果用戶端紀錄顯示拒絕已生效,但應用程式仍能完成相同操作,可能是使用了快取、備用主機或其他傳輸方式;請確認實際目標,不要自動擴大封鎖整組網域。
如果封鎖規則導致頻繁重試、額外錯誤提示或功能異常,先在副本中撤回這一行進行比較。撤回後恢復正常,只能說明它與症狀有關;還需要查明它封鎖的是目標本身,還是業務功能依賴同一主機而受到連帶影響。確認無法透過網域區分時,應保留正常功能,不要繼續追加含糊的 DOMAIN-KEYWORD。組合規則的驗收依據是實際存取目標符合預期,而不是規則越多越好。
驗證與排除問題:區分設定、解析、策略與連線故障
遇到故障時,先記錄可重複的操作:裝置目前的網路、啟用中的設定名稱、Global Routing 模式、Home 選取的伺服器、觸發故障的應用程式操作,以及已知目標。不要記錄訂閱連結、密碼或伺服器驗證參數。比起「應用程式無法開啟」,具體記下「重新開啟後,提交某個自有服務的登入請求失敗」,更容易將說明對應到實際連線。若能查看連線或診斷資訊,優先保存目標、策略與結果三項,不必蒐集無關內容。
第一步:確認設定檔正在參與路由
先檢查連線狀態,再確認 Home 的 Global Routing 與 Config 中目前使用的檔案。修改了同名備份、只儲存草稿,或匯入後未選取,都可能導致預期規則沒有生效。如果問題發生於切換網路之後,先確認連線已恢復再測試,不要把剛中斷的連線誤認為規則拒絕。兩次測試都應發出新請求;重複使用中的連線、瀏覽器快取或已建立的應用程式工作階段,不適合用來判斷剛修改的規則。
初次設定與首次連線的操作請參閱使用說明。如果 Home 中沒有列出可用伺服器,先確認自己的 Subscribe 資料或單一伺服器資訊已正確匯入。清單為空時,請查看訂閱解析失敗與清單為空的自我檢查順序,不要隨意更換 FINAL 來解決資料來源問題。規則可以選擇代理路徑,卻無法補足缺少的伺服器資料。
第二步:為單一可控目標建立最小化對照
[General]
dns-server = system
[Rule]
DOMAIN,check.example.com,PROXY
FINAL,DIRECT
在副本中以自己可測試的主機取代 check.example.com,並保留目前選取的伺服器。先預測目標會命中精確網域規則,其他連線則採預設直連。若測試結果不符合預期,先確認實際連線是否使用該名稱,例如重新導向後可能改用另一個主機;再比較同一目標在 Direct 與 Proxy 下的結果。單次速度測試不等於業務存取,請盡量在相同請求、相同網路與相同時段進行比較。
如果在 Proxy 模式下也無法存取相同目標,問題不一定出在規則順序。請檢查伺服器是否在線、匯入資料是否與服務提供方交付的參數一致,以及其他已知可用的目標能否透過同一伺服器存取。如果只有 Config 模式失敗,而 Proxy 與 Direct 都能存取,則應著重檢查 Config 的比對條件、是否被 REJECT 提前攔截,以及該設定是否另外配置了 Host 或 URL Rewrite。切換模式是排除問題的手段,完成後請切回要驗證的模式。
第三步:依故障表現縮小檢查範圍
未取得預期位址時,先檢查解析與 [Host];已取得位址但無法建立連線時,再檢查路由、網段可達性與服務狀態;連線已建立卻出現憑證提示、重新導向迴圈或業務錯誤時,不要直接判定伺服器無法使用。解析快取、應用程式快取與連線重複使用是不同因素,清除其中一項不代表另外兩項也會失效。每次只修改一項,並發出可辨識的新請求,才能比較修改前後的差異。
如果紀錄或介面沒有提供所需的命中細節,不要把缺少紀錄視為未命中。可使用受控設定進行對照:先用一條精確規則與不同的兜底策略隔離該目標,再於相同環境還原舊設定。如果兩份設定的結果不同,逐段加入舊設定中的規則與其他區段,每次少量加入。重現問題前不要先重設所有規則與設定,否則即使功能恢復,也很難判斷是哪一行造成故障。
維護與還原:管理設定來源、規則變更與複測案例
規則要能長期使用,仰賴明確的預設策略、可追蹤的例外與可還原的變更。將日常使用的檔案與實驗副本分開;遇到服務異常時,先切回已驗證的設定,再於副本中找出原因。切回舊設定不代表伺服器狀態也會恢復原狀:伺服器選擇、訂閱更新與目前網路都可能已經改變。每次還原後,都要重新確認目前使用的檔案與 Home 選項,再用先前的案例重新測試。
區分設定檔與伺服器清單
Config 中的規則設定檔負責描述分流與相關設定;透過 Subscribe 匯入後產生的伺服器清單則提供連線目標。儲存規則副本,不代表也儲存了伺服器驗證資料;更新伺服器清單,也無法修正某個規則條件。如果你已有的遠端設定由其提供方維護,而你需要在本機新增例外,建議另存工作副本並保留來源說明。重新取得遠端內容後,應將變更視為一次新的合併,不要預設本機編輯內容一定會保留。
比較兩份文字時,先檢查 [General]、[Host] 與 [URL Rewrite] 是否有變更,再核對 [Rule] 中新增、移除或調整順序的項目。兩份設定都能匯入,只代表文字格式可接受,不代表行為相同。尤其要檢查寬泛規則是否移到例外之前、預設策略是否變更,以及原本由網域規則處理的連線是否開始依賴解析位址來決定路徑。
為每次變更設定可驗證的預期結果
[Rule]
DOMAIN,status.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
將預期具體寫成「狀態主機持續直連,業務子網域使用代理,無關主機仍直連」,不要只寫「規則已最佳化」。如此一來,至少要測試三個目標。若調整的是區域網路例外,還要增加一個位於允許網段之外的位址案例;若調整的是 IPv6 條件,請確認測試實際使用 IPv6;若調整的是封鎖規則,也要驗證同網域中必須保留的功能。範例網域與範例網段不適用於可用性測試;套用至自己的環境時,請使用自己能控制且預期結果明確的目標。
對特別重要的服務,保留一項可重現的業務操作作為驗收,不要只測試首頁。修改登入例外後,至少執行一次登入並返回業務頁面;修改檔案服務規則後,至少驗證一項實際資源請求。測試前請確認舊工作階段不會掩蓋連線變化。若某個案例失敗,記錄當時的目標、選用策略及是否解析成功;這比沒有條件說明的「成功或失敗」清單更有參考價值。
一次還原一項變更,不要連續修改整份檔案
如果合併後的副本造成故障,先還原上一份已驗證的啟用中設定,並確認業務是否恢復。若能恢復,再從有問題的設定中逐一撤銷變更,例如先還原 FINAL,保留其他規則,觀察問題是否仍存在。如果還原設定後業務仍未恢復,問題也可能涉及目前網路、伺服器變更或應用程式狀態;此時請回到驗證與排除問題,不要繼續刪除無關規則。
提供給自己的其他裝置使用前,請再次確認介面功能、設定來源與目前網路條件。複製範例只會移轉文字,不會同步裝置權限、DNS 環境或已選取的伺服器。文件可記錄策略目的、規則範圍與還原步驟;個人訂閱網址與驗證資料應另外妥善保存。只要能對照啟用中的檔案重現命中、說明故障屬於哪個層次,並還原至已驗證的行為,這份設定就具備可維護的基準。