Shadowrocket 官方手冊 · 設定參考
Shadowrocket 規則與設定完整指南
本頁依設定區段、規則欄位與排查流程編排,供修改或檢查設定時參考。首次匯入現有訂閱、選擇連線模式或開啟連線開關,請先完成使用教學;若已能連線,但想了解某項請求為何直連、代理或遭拒絕,可從下方目錄前往相關章節。
範例使用保留網域與文件用地址,僅用於說明設定與比對邏輯,並非可用的連線節點。驗證代理策略前,請先確認已有可用的訂閱或伺服器資訊。本網站不提供、不販售也不推薦節點或訂閱。
設定結構:區分一般設定、規則與映射
先確認目前使用的是哪個檔案
設定檔可包含多個以方括號標示的區段。區段標題會決定後續各行的解讀方式,直到遇到下一個區段標題。同一串字元放在不同區段,意義也可能不同。例如 portal.example.com 在 [Rule] 中可作為待比對的主機名稱,在 [Host] 中則可作為要映射的主機名稱。請先找到區段,再編輯其中的內容。不要把整份檔案當成可任意拼接的規則,也不要將新的區段標題插入既有規則清單中。
在 Config 中查看目前選取的設定。同名檔案若出現在清單中,光看名稱很難確認剛才修改的是哪一份;建議先保留可用的原始檔,再為測試副本取一個容易辨識用途的名稱。編輯、儲存與選取是不同操作:儲存副本不代表流量已依該副本處理。修改後請確認已選取副本,並檢查 Global Routing 是否設為 Config。若原始檔來自遠端網址,重新整理可能會覆蓋本機修改;需要長期保留的自訂規則,應另存為獨立副本。
| 區段 | 主要用途 | 檢查時機 |
|---|---|---|
[General] | 設定整體網路行為,例如解析設定 | 可透過 IP 位址連線,但網域解析異常 |
[Rule] | 依條件選擇處理策略 | 實際策略與預期不符 |
[Host] | 為特定主機名稱指定映射 | 只有個別主機解析到非預期的位址 |
[URL Rewrite] | 對可見且符合條件的 URL 執行改寫 | 發生重新導向,或依路徑處理的結果異常 |
[General] 與 [Host]:解析不等於分流
[General]
dns-server = system
[Host]
portal.example.com = 192.0.2.10
這裡的 dns-server = system 表示使用系統的解析設定;實際解析結果也會受到目前網路、快取與 App 解析方式影響。[Host] 範例則是將指定名稱映射到文件用地址。這不是路由策略,也不會讓該地址上的服務自動變得可用。在實際環境中,只有確認目標地址的歸屬、用途與維護者後,才考慮為本機測試服務建立固定映射。若目標由多台伺服器輪替提供,或仰賴動態 DNS,靜態綁定可能在地址變更後才導致部分請求失敗。
固定地址也不會改變瀏覽器對原始網域的憑證驗證。若將名稱指向一台可建立連線、但未設定該名稱憑證的伺服器,仍可能發生名稱不符。若測試回報只有「無法開啟」,請先將錯誤拆分為網域解析、建立連線與憑證驗證三個階段;前一階段成功,只能表示已進入下一階段,不能取代下一階段的驗收。刪除測試映射後,記得重新發出請求,不要直接以已開啟的頁面判斷修改是否生效。
[Rule] 與 [URL Rewrite]:不要混用
[Rule]
DOMAIN,portal.example.com,DIRECT
FINAL,PROXY
第一行規則會依完整主機名稱設定直連,最後一行則指定其餘進入規則處理的流量走代理。[URL Rewrite] 使用另一套語法,不能把比對路徑的正規表示式寫進 DOMAIN 欄位,也不能用重新導向動作取代 PROXY。遇到陌生檔案時,先找到區段,再核對關鍵字、分隔符號與策略;單看某一行像是網域,無法判斷它用於 DNS、分流還是請求處理。
設定副本可從最少的變更開始驗證。複製現有設定後,先不要改解析設定;將待檢查的規則放入正確區段、置於兜底規則之前,再確認能否正常載入。若儲存後出現解析錯誤,優先檢查最近加入的區段標題、全形標點,以及遭編輯器截斷的行,而非先從 DNS 或伺服器著手。文字在畫面上換行只是顯示效果;實際檔案中的換行則可能將一條規則拆成兩筆無效記錄。需要還原時切回原始檔即可,不必在同一份檔案中反覆手動復原。
訂閱提供連線所需資訊,設定則描述如何處理請求。更新現有訂閱後,仍須確認目前選取的設定與策略所需的伺服器是否可用;兩者不能互相取代。
Global Routing 與策略:先選模式,再看規則
三種模式的排查用途
Global Routing 決定進入用戶端處理的流量是否依目前設定分流。設定模式對應 Config,用於檢查規則;代理模式對應 Proxy,用代理路徑作為對照;直連模式對應 Direct,以直連路徑作為對照。這裡指的是進入用戶端處理範圍的流量,並非裝置上的所有流量都一定遵循相同設定。以另外兩種模式完成對照後,請切回 Config,才能判斷個別規則是否有效。
| 介面用詞 | 處理依據 | 適合釐清的問題 |
|---|---|---|
Config | 目前設定中的規則與策略 | 這項請求符合哪條規則? |
Proxy | 透過目前的代理路徑處理 | 不使用目前分流規則時,代理路徑是否可用? |
Direct | 透過直連路徑處理 | 目前網路能否直接連到同一個目標? |
進行對照時,請維持相同網路、目標與伺服器選擇,只切換模式。如果同時從 Wi-Fi 切換到行動網路,或期間更換伺服器,就很難分辨差異來自路由模式還是網路條件。不要只看已載入的網頁來判斷:瀏覽器可能沿用原有連線,也可能直接顯示快取內容。針對同一目標重新建立連線,再參考可見的請求記錄,比單看頁面能否載入更可靠。若需多次比較,請記錄每次使用的模式與觀察結果,不要憑印象歸因。
PROXY、DIRECT 與 REJECT
[Rule]
DOMAIN,admin.example.com,DIRECT
DOMAIN,metrics.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
DIRECT 表示不經代理伺服器連線至目標,但仍仰賴可用的解析與本機網路路徑。PROXY 表示使用代理路徑,前提是已有可用的伺服器地址、協定與驗證資料。REJECT 表示拒絕符合這條規則的請求;App 可能顯示連線失敗、重試或功能無法使用,不一定會清楚提示遭拒絕。設定中使用這些大寫策略名稱,介面上的 Proxy 或 Direct 則是模式選項,兩者並非同一層級。
例如,在上述設定中選擇 Config 時,管理主機會符合第一條規則,指標主機符合第二條,其他符合後綴條件的主機才會嘗試走代理。若手動切換到 Proxy 後某個目標恢復連線,只能先確認代理路徑對這個測試目標可用,不能斷定原規則一定符合了 DIRECT;原請求也可能符合 REJECT,或是在其他環節失敗。反過來說,即使規則已依預期符合 PROXY,頁面仍載入失敗,也不能單憑失敗結果認定「規則沒有生效」。
分別記錄連線、測試與請求結果
開啟連線開關代表用戶端的連線狀態有所變化,不代表每個目標都能連線。Connectivity Test 可用來參考目前伺服器的連線狀況,但測試目標與實際服務請求並不相同:網站主頁可能成功載入,認證、圖片或 API 請求卻仍會失敗。遇到這種情況,請先在相同模式下重現出錯的操作,再找出同一時間發生的失敗請求。若只以首頁能否開啟作為驗收標準,容易漏掉結帳、登入或檔案上傳等後續才建立的連線。
On Demand 著重於在什麼條件下建立或維持連線,並不會替網域指定策略。切換網路後若發現連線重新建立,請先確認連線行為,再檢查目前模式與規則。如此可將「是否進入用戶端處理」與「進入後使用哪條路徑」分成兩個獨立問題,而不是試圖用一條 FINAL 同時解決兩者。若裝置受組織管理,系統也可能另有限制連線行為,請依裝置管理規範操作。
網域規則:精確主機、後綴與關鍵字
規則欄位填寫的是主機名稱
使用網域分流時,請從網址中單獨取出主機名稱。例如造訪 https://api.example.com:443/v1/items 時,主機名稱是 api.example.com;通訊協定、連接埠、路徑與查詢參數都不是網域比對欄位。DOMAIN 適用於指定單一主機,DOMAIN-SUFFIX 適用於將網域本身及其子網域歸為一組,DOMAIN-KEYWORD 則會比對主機名稱中出現的字串。後兩種規則較容易涵蓋原本不打算處理的請求,修改前請列出不應符合的反例。
[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,preview-build,DIRECT
FINAL,PROXY
| 條件 | 符合範例 | 不符合範例 |
|---|---|---|
DOMAIN,login.example.com | login.example.com | test.login.example.com |
DOMAIN-SUFFIX,example.com | example.com、api.example.com | notexample.com、example.com.example.net |
DOMAIN-KEYWORD,preview-build | preview-build.example.net | preview.example.net |
後綴是依網域邊界判斷,不是單純檢查文字最後幾個字元。使用 DOMAIN-SUFFIX 時也不必加上 *. 表示子網域。相對地,關鍵字規則不要求關鍵字剛好是子網域標籤,也不保證它屬於某家公司或專案。若將這類規則用於跨網域的暫時測試,請留下檢查紀錄,確認之後能移除;若用於長期規則,通常應改用已核實的主機或後綴。
從實際請求擷取網域,不要依頁面名稱推測
在網址列開啟頁面,不代表所有請求都會送往網址列顯示的主機。登入流程可能重新導向,靜態檔案可能來自另一個網域,同一頁面也可能透過不同 API 載入資料。若只有某個按鈕操作失敗,請用容易重現的操作縮小範圍,再查看該時段有哪些主機請求失敗。先為確定相關的單一主機新增精確規則,重做相同操作;只有在多個子網域確實需要相同處理時,才改用後綴規則。直接將整個網域交給另一種策略,或許能讓問題消失,卻無法指出究竟是哪項請求需要調整。
若記錄中只有目標地址,網域規則可能缺少必要的比對對象。App 直接連線到地址、使用自有解析機制或沿用既有連線時,不能只根據服務使用的網域推斷用戶端一定看得到該網域。反過來說,DNS 回傳別名或多個地址,也不代表應將別名和每個地址都加入規則。請優先根據用戶端實際可見且相對穩定的請求屬性撰寫規則;目標地址經常變動時,維護固定地址通常比核對主機名稱更容易失效。
每次驗證至少加入一個反例
為登入主機設定直連後,除了確認該主機使用 DIRECT,也要確認同網域的另一個主機仍使用預期路徑。驗證後綴規則時,可一併檢查根網域、一個符合條件的子網域,以及一個看起來相似但不屬於該後綴的主機。這些正反例用於檢查比對邊界,範例網域不必對應實際服務。實際測試時,請改用可存取且允許驗證的目標,並記錄預期與實際策略。
若兩條規則都導向相同策略,只看連線結果無法分辨符合的是哪一條。最好查看現有的命中記錄,或在獲准的測試目標上,使用暫存副本為待驗證條件與兜底規則設定可區別的策略;完成驗證後再還原。不要為了驗證一條規則,就對日常業務使用的整個網域設定拒絕策略;若其他 API 也因此受影響,反而更難判斷是原有問題還是測試規則造成。
IP 位址規則:IP-CIDR、IP-CIDR6 與 GEOIP
前綴長度決定範圍,不是連接埠
[Rule]
IP-CIDR,192.0.2.10/32,DIRECT,no-resolve
IP-CIDR,198.51.100.0/24,PROXY,no-resolve
IP-CIDR6,2001:db8:40::/48,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
IP-CIDR 用於 IPv4,IP-CIDR6 用於 IPv6。斜線後的整數代表必須相同的前綴位元數。IPv4 的 /32 指單一地址;198.51.100.0/24 則涵蓋從 198.51.100.0 到 198.51.100.255 的地址範圍,但符合規則不代表這些地址都能作為主機連線。IPv6 的單一地址寫法為 /128,範例中的 /48 則涵蓋前三組十六進位數字相同的地址。若只想為一台服務新增例外,不要為了方便書寫而擴大到整個網段。
維護雙協定堆疊的目標時,請先確認實際連線使用的位址族。瀏覽器或系統可能會在兩種地址間選擇,IPv4 規則不會自動涵蓋 IPv6 請求。若同一目標有時符合地址規則、有時落入兜底,請先核對兩次連線使用的目標地址,再檢查解析結果是否隨網路變化。為了讓單次測試通過而擴大地址範圍,可能連帶改變同一網段中其他無關服務的請求;若用戶端能看到穩定的主機名稱,網域規則通常更能準確表達服務需求。
no-resolve 控制的是這條規則的解析行為
請求以網域形式出現時,地址規則必須知道目標地址,才能比對前綴。no-resolve 放在支援此選項的規則末尾,表示不要為了這條規則主動解析網域;已知的地址仍可用於判斷。它不是整份設定的 DNS 開關,也不會清除既有解析結果。上述前綴規則適用於「目標地址已可用時才依地址分類」的情況;後續規則仍可能需要解析,實際建立連線時也仍可能需要 DNS。
檢查此選項時,建議分別觀察直接以地址連線的請求,以及以網域發起的請求。不要因為瀏覽器開啟某個 HTTPS 地址失敗,就判定地址規則沒有命中:憑證可能無法驗證該地址,服務也可能需要原始網域才能回傳內容。請分開記錄命中策略與服務回應。若移除 no-resolve 後行為改變,請進一步確認是因為網域終於解析到符合條件的地址,還是 DNS 查詢變慢或失敗;兩種情況需要不同的處理方式。
GEOIP 是地址分類,不是地理位置證明
GEOIP,CN,DIRECT 表示當目標地址被目前資料分類為 CN 時,使用直連。此規則依據地址分類資料,而非網域後綴、用戶端所在位置或帳戶地區。同一網域在不同網路中可能解析到不同地址,地址分類也可能隨資料更新而變動。由於分類範圍較廣,適合放在明確的網域與網段例外之後,不宜用來指定某台主機固定使用哪條路徑。
例如,某項指定服務需要代理,卻剛好解析到被分類為直連的地址;若地理規則排在該服務的例外之前,地址符合前面的條件後,後方的精確服務規則就沒有機會命中。排查時請記錄該次連線使用的正確主機名稱、地址與第一條命中規則;只看網域後綴,既無法證明地址如何分類,也不能解釋為何相同網域換了網路後會採用不同路徑。
只有確實需要依地址分類時才加入地址規則。若目標是組織內部服務,請先核對目標網段與目前的網路範圍;
DIRECT不會自動建立連往內部網路的路由。
請求屬性與改寫:USER-AGENT、REJECT 與 URL Rewrite
USER-AGENT 比對的是可辨識的請求屬性
[Rule]
USER-AGENT,ExampleClient*,DIRECT
FINAL,PROXY
USER-AGENT 用於比對用戶端能辨識的請求標識。上例以萬用字元表示標識以 ExampleClient 開頭,並非依系統中顯示的 App 名稱搜尋處理程序。同一個 App 的網頁、API 請求與背景連線不一定帶有相同標識;多個 App 也可能使用相同的請求元件。修改設定前,請先從自己能控制的測試請求確認標識確實存在且格式穩定,並以另一種標識發出對照請求,確認不會一併符合。
一般加密連線中的 HTTP 標頭,無法只憑目標網域就讀取。不應將 USER-AGENT 當成所有 HTTPS 流量都適用的 App 辨識方式,也不應據此推定某個 App 的所有請求都採用相同策略。若規則沒有命中,請先確認用戶端是否能取得這個欄位,再核對模式寫法與順序。單純不斷擴大萬用字元範圍,無法解決欄位不可見的問題,還可能誤中其他請求。對於穩定的目標主機,優先使用較容易核對的網域規則。
使用 REJECT 拒絕指定主機
[Rule]
DOMAIN,telemetry.example.com,REJECT
DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXY
此範例會拒絕指定主機,並讓同一後綴下的其他主機繼續進入下一條規則。它不會檢查該主機下的路徑,也不會區分同一主機上的不同 API。如果某項服務將登入與指標回報放在同一主機,依網域拒絕可能會一併影響兩者。需要判斷影響範圍時,請先在副本中使用精確網域,再測試主頁、登入與相關 API;不要一開始就拒絕整個後綴。請參考REJECT 規則的原理與適用範圍,了解請求重試、誤攔與失敗狀況。
規則只會攔截進入比對流程的請求,無法撤回已完成的下載,也不能刪除 App 已儲存的內容。第一次測試看似沒有變化,可能是 App 使用了快取;多次測試後連線提示變多,則可能是 App 自動重試。這兩種狀況都需要搭配請求時間與命中記錄判讀。若錯誤消失,但服務功能也一併無法使用,不能認定規則已符合需求;請依變更前的驗收步驟重新檢查。
URL Rewrite 處理的是可見的 URL
[URL Rewrite]
^http://example\.com/old$ http://example.com/new 302
此範例由左至右依序為比對表示式、替換目標與重新導向動作。表示式使用起始與結束錨點,經跳脫的句點代表字面上的句點,因此只會比對範例中的完整網址;含查詢參數的網址不符合此寫法。302 用於示範暫時重新導向;重新導向後,目標網址仍須能獨立存取。不要將新網址也納入同一條規則的比對範圍,否則測試時可能形成重新導向迴圈。也不要用永久重新導向進行測試,瀏覽器可能會保留先前結果,導致還原設定後難以判讀重測結果。
此處使用未加密的 HTTP,是為了示範 URL 欄位本身的比對條件;現代瀏覽器可能會自動升級為 HTTPS,升級後便不符合範例。對於 HTTPS,只有目前處理環境確實能看到所需 URL 欄位時,才可能依路徑比對;看得到主機名稱,不代表也看得到路徑或查詢參數。本文不要求為驗證分流額外設定解密;若只需要為整個主機選擇連線路徑,使用 [Rule] 即可。若 App 不接受改寫後的網址,請先判斷是目標無法連線、請求方法改變,還是 App 本身不接受重新導向,不要用更寬鬆的表示式掩蓋錯誤。
比對順序:將例外放在涵蓋它的規則之前
找出第一條命中規則,不要猜測規則名稱的優先順序
在 Config 模式下查看一般 [Rule] 清單,可由上往下尋找第一條符合條件的規則,以判斷採用的策略。若某條後綴規則已符合請求,清單下方更精確的主機規則不會因為條件更具體而自動優先。同樣地,排在後面的拒絕規則也不會因策略名稱是 REJECT 而獲得較高優先順序。修改前先確認兩件事:目前要改變的是哪一組請求?新規則之前是否已有其他條件會先符合?
[Rule]
DOMAIN,auth.example.com,DIRECT
DOMAIN,metrics.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
依照範例順序,主機名稱為 auth.example.com 的請求會先直連,metrics.example.com 會先遭拒絕,其他符合後綴條件的請求才走代理。若將後綴規則移到第一行,前兩個主機就會先符合該規則。地理分類排在後綴規則之後,是為了避免已確認的網域受到目標地址分類變動影響。這不表示「網域規則一律優先於地址規則」;應先處理應用層面已確認的例外,再處理涵蓋範圍較廣、條件較容易變動的請求。
FINAL 只處理前面的規則都未命中的請求
FINAL 不帶網域或地址參數,策略緊接在逗號之後。日常維護時,保留一條明確的兜底規則並放在清單末尾即可。FINAL,DIRECT 表示未涵蓋的請求預設直連,適合只將明確列出的目標交給代理的設定;FINAL,PROXY 表示未涵蓋的請求預設交由代理處理,適合明確列出直連例外的設定。更換兜底規則會改變整份設定的預設行為,不是針對單一故障主機的局部修正。修改前請先確認尚未明確列出、但仍需正常使用的服務。
例如使用 FINAL,PROXY 時,即使特定代理規則根本沒有命中,目標仍可能透過代理連線。將「可以走代理」當成「新增規則已生效」,是最常見的誤判之一。請查看實際命中的依據,或在測試副本中為自己能控制的請求設定可區別的對照結果。對於 REJECT 也一樣,不能將某次連線錯誤直接視為拒絕成功;解析失敗的請求也可能根本沒有進入預期的規則分支。
每次移動規則,都要視為範圍變更
檢查現有設定時,先標出兜底規則,再從清單底部往上找涵蓋範圍較廣的規則,尤其是關鍵字、後綴與較大的地址前綴。逐一列出每條新例外與哪些舊規則重疊,再將它放在最早的重疊規則之前。若舊規則是接在其他例外後方的通用規則,不要整段移到最上方,否則可能連帶遮蔽原本優先的拒絕或直連規則。比對時保留原有規則中的一個代表性請求,有助於快速發現調整順序造成的意外變化。
合併他人提供的設定片段時,先確認片段所屬區段、策略與前置條件。不要直接貼上第二個 [Rule] 標題、另一份檔案的預設規則,或尚未建立的策略名稱。若設定涉及遠端規則來源,也要區分本機可見的順序與來源更新造成的內容變化。若某個過去不符合的主機突然被較前面的規則集合涵蓋,只檢查清單末尾新增的例外不足以解釋結果。重新驗證時,應記錄實際使用的設定來源與副本。
排查優先順序時,每次只移動或修改一條規則,並保留一個不應受影響的請求作為對照。確認變化後,再處理下一條。
常見寫法:依預期行為選擇最精簡的規則組合
只讓已知目標使用代理
[Rule]
DOMAIN,signin.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
這組規則讓登入主機維持直連,讓同一後綴下的其他主機走代理,其餘請求則維持直連。適用於需求範圍明確,且能以少數主機名稱描述的情況。測試時,請分別檢查登入主機、同後綴的一個服務主機,以及後綴範圍外的目標。若同一服務日後將檔案服務遷移到另一個後綴,原規則不會自動涵蓋;請確認遷移後的主機與存取需求,再新增一條範圍精確的規則,不要只為補上一項功能就變更 FINAL。
若服務未登入時可以開啟,但登入後只有部分功能失敗,問題可能發生在請求從登入主機返回服務主機之後。若要確認是否涉及不同路徑,請先整理一次完整操作中,分別由哪些主機提供網頁、驗證與 API,再逐一檢查策略。若這些主機必須使用同一路徑,分流設定應依服務相依關係撰寫,不要只因主機名稱含有某個字詞,就一律套用相同策略。若存取方式受服務提供者限制,請遵循對方允許的方式。
以代理作為兜底,保留明確的本機服務例外
[Rule]
DOMAIN,printer.example.net,DIRECT
IP-CIDR,192.0.2.10/32,DIRECT,no-resolve
FINAL,PROXY
此範例分別設定:依名稱存取特定服務時直連,以及直接存取指定地址時直連。地址與網域都是教學用值,不代表裝置能透過這些資訊找到本機服務。實際使用時,請先確認所用名稱能否正確解析、目前網路是否有通往該裝置的路由,再依實際情況選用網域規則、地址規則或兩者。若裝置地址由網路動態分配,使用單一地址規則就需要定期維護;若放行範圍過大的地址區段,也可能讓與該服務無關的連線一併成為例外。
在兩個網路都使用同一份設定時,私有地址相同也不代表目標裝置相同。原本指向辦公室裝置的地址,在家中可能指向另一台裝置,或完全沒有回應。檢查時也要將網路環境納入預期:在原有網路確認目標身分與直連結果,並在另一個網路確認不會意外連到地址相同的其他服務。地址規則只能決定請求使用哪條路徑,無法驗證遠端服務的身分。
保留服務主機,只精確拒絕獨立請求
[Rule]
DOMAIN,stats.example.org,REJECT
DOMAIN-SUFFIX,example.org,DIRECT
FINAL,PROXY
確認某個獨立主機不需要存取後,可使用精確拒絕規則表達需求。修改前先列出應維持可用的操作,例如載入主頁與儲存設定;新增規則後,依相同步驟重新測試。若某項重要功能與待拒絕請求共用同一主機,就不能用這種方式區分兩者。若整個後綴原本都應直連,拒絕規則的位置也很重要:放在後綴規則之後,預期的封鎖就會被前面的直連條件涵蓋。
平時維護時,可為每項變更留下簡短說明:為何需要這條規則、依賴哪個目標,以及失敗時應撤回哪一行。摘錄設定片段時,請一併保留前後的涵蓋條件,尤其不要只複製 FINAL 或看似有效的關鍵字規則。將範例合併到現有設定前,先比對原本的預設策略;若目的只是新增一項例外,就不應連帶改變未列出目標的處理方式。
驗證與還原:逐步縮小故障範圍
先建立可重複的基準
開始前保留一份最近可用的設定,在 Config 確認目前選取項目,並記下使用的網路、模式與測試目標。選一個已知可直連的目標,再選一個原本需要透過現有伺服器存取的目標,分別記錄實際結果。可在 Home 查看伺服器選擇,並參考 Connectivity Test;但不要將一次測試成功解讀為所有目標都能存取。若兩條路徑都失敗,先檢查裝置網路;若只有代理路徑失敗,再核對現有伺服器地址、驗證資料與協定參數。
若只有 Config 模式出錯,而兩條對照路徑都正常,請記錄此目標依目前設定應符合的規則、對應策略,以及之前所有可能涵蓋它的條件。接著建立新連線以重現相同操作,並查看目前平台可用的診斷記錄。若命中兜底規則,優先檢查請求實際可見的主機名稱或地址;若命中意外的通用規則,先檢查規則順序;若策略已符合預期,則應改查解析、連線或目標服務,而非繼續新增比對條件。
依錯誤發生階段排查,不要同時變更多個因素
- 設定無法載入:檢查最後一次修改的區段位置、標點符號、參數數量與策略拼字。使用相同的設定副本,只還原這一處,確認是否恢復載入。
- 無法取得目標地址:檢查 DNS 設定與
[Host]是否留有舊映射;若只有一個網路發生問題,保留另一個網路的解析結果作為對照,不要同時更換伺服器。 - 目標已有地址但連線失敗:檢查目前模式、實際命中的策略與連線路徑。確認是否因位址族變更而落入另一個規則分支,或原本應連線的網路目前無法使用。
- 已建立連線但服務功能不完整:找出出錯操作後續發出的請求,檢查是否需要連線到其他主機、重新導向目標是否可達,以及拒絕規則的範圍是否過廣。
例如,系統解析出兩個地址,但只有其中一種路徑失敗時,可以先記錄該次請求使用的地址,再檢查地址區段規則是否只涵蓋其中一種位址族。反過來說,若存取同一網域時出現憑證錯誤,請優先檢查靜態映射是否指向錯誤的伺服器,不要透過忽略憑證錯誤來通過測試。釐清失敗階段能保留有用線索;反覆切換模式、DNS 與伺服器,則會讓每次結果失去可比性。
[Rule]
DOMAIN,check.example.com,PROXY
FINAL,DIRECT
這組最小規則用來區分一個可控的代理目標與其他直連目標。請將網域換成實際測試主機,在獨立副本中驗證,並保留原設定所需的網路參數。不要為了進行對照而直接刪除可用設定、清除現有伺服器資料,或改寫日常使用的訂閱內容。若最小對照正常,再逐段加入網域例外、地址分類與改寫規則;首次重現異常的部分,就是下一輪縮小範圍的起點。
還原後也要重新測試
若無法判斷新設定的影響範圍,請重新選取備份,恢復原先需要的 Global Routing 模式,再測試原本情境與一個正常的對照目標。錯誤頁面消失,不代表已完成還原。需要諮詢時,可提供已去識別化的規則行、預期策略、使用的網路類型與重現步驟;不要公開完整訂閱網址、驗證資訊、含敏感參數的請求網址或未處理的記錄。其他排查方向請參考疑難排解與已連線卻無法開啟網頁的逐項排查。
如需更換裝置,請至全平台下載頁選擇對應的取得方式。iPhone / iPad 請從 App Store 產品頁取得,美國 App Store 售價為 $2.99,一次性付費;系統需求以 App Store 頁面標示為準。Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費,安裝檔僅透過本站 /dl/ 提供。一次買斷用戶端 ≠ 連線方案;更換裝置後仍需使用自己已有的訂閱或伺服器資訊。