官方手冊 / Global Routing · Settings
代理模式與常用設定
先選擇 Global Routing,再檢查 Config、目前伺服器與連線狀態。模式決定處理方向,規則決定比對結果,伺服器參數則影響能否建立連線;這三個部分需要分開檢查。
- 模式 Config / Proxy / Direct
- 規則 符合第一條規則時即生效
- 設定 一次調整一項
01 / Home
Global Routing 三種模式
Global Routing 位於 Home,用來決定連線採用哪一種整體處理方式。配置對應 Config,代理對應 Proxy,直連對應 Direct。選擇模式本身不會補齊伺服器資料,也不代表已開啟連線;操作後仍須檢查 Home 顯示的目前伺服器與實際連線狀態。
日常需要依目標位址區分處理方式時,先在 Config 選擇並啟用適用的設定檔,再將 Global Routing 設為 Config。此時會依設定中的規則判斷連線方式,而非讓所有目標固定採用相同策略。只匯入檔案卻未啟用,或目前選取的檔案與預期不同,都可能使結果不符合正在查看的規則。
| 模式 | 處理依據 | 適用情境 | 主要檢查項目 |
|---|---|---|---|
| 配置 / Config | 依目前啟用的 Config 規則決定策略。 | 日常規則分流,依目標區分連線處理方式。 | 啟用的檔案、規則順序、策略引用與 FINAL。 |
| 代理 / Proxy | 整體採用代理處理方向,不依 Config 的一般目標規則分流。 | 暫時降低規則因素的影響,檢查所選伺服器是否可用。 | 目前伺服器、驗證參數與實際請求結果。 |
| 直連 / Direct | 整體採用直接連線,不透過所選代理伺服器轉送一般連線。 | 暫時比對目前網路的直接存取情況。 | 本地網路、目標本身的連線能力與連線狀態。 |
Proxy 適合短時間診斷:如果同一目標在 Proxy 下可用,但在 Config 下發生異常,下一步應檢查目標符合的規則與策略,不要立刻重填所有伺服器參數。Direct 則可協助判斷直接連線時是否也有問題,但目標無法直接存取,並不能單獨證明代理設定正確或有誤。
完成比對測試後,請恢復原本需要的模式。Global Routing 的 Proxy / Direct 是介面選項,規則中的 PROXY / DIRECT 則是策略關鍵字,兩者層級不同,不要因為名稱相近就將它們視為同一個開關。
02 / Config
規則類型與策略
規則分流是在 Config 中描述「哪些目標採用什麼策略」。進入目前設定的編輯或規則檢視畫面,先確認檔案已啟用,再檢查 [Rule] 區段。一般規則會由上而下比對,第一條符合的規則決定處理方式;同一次比對不會再以後續規則作為替代結果。
DOMAIN 用於比對完整網域名稱,DOMAIN-SUFFIX 用於比對網域及其子網域,DOMAIN-KEYWORD 則依網域中的關鍵字比對。IP-CIDR 與 IP-CIDR6 分別描述兩種 IP 位址範圍,GEOIP 則仰賴 IP 地理資料。網域規則與 IP 規則需要的資訊不同,因此規則順序和 DNS 解析結果都可能影響判斷。
策略描述符合規則後的處理方式:PROXY 使用代理連線,DIRECT 直接連線至目標,REJECT 拒絕連線。如果設定使用自訂策略群組,還要檢查群組名稱是否存在,以及群組內的選擇是否符合預期;規則文字正確,不代表引用的群組一定可用。
[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
DOMAIN,ads.example.net,REJECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
以上是閱讀文字設定的範例,並非可直接取代現有設定的完整檔案。精確規則通常應放在涵蓋範圍較大的規則之前;FINAL 放在最後,用來處理前面都未符合的連線。若將範圍較廣的規則放得太前面,後續的精細規則即使設定正確,也可能沒有機會生效。
修改前請保留可還原的副本,每次只修改一條規則,並以同一目標驗證。發現異常時,記下目標網域、當時的 Global Routing 與符合的策略,再查看記錄;不要只憑頁面是否開啟,就判定某條規則已經生效。規則關鍵字的說明請參閱術語表。
03 / Home · Add Server
訂閱與伺服器管理
伺服器項目會儲存連線所需的協定、位址、連接埠與驗證資料;訂閱則透過單一網址更新一組項目。兩者主要在 Home 管理。已有訂閱時,前往 Add Server,在 Type 選擇 Subscribe,依畫面欄位填入向服務商取得的網址,儲存後執行更新。已有單一伺服器資料時,請選擇相符的協定並逐項填寫,不要將伺服器位址當成訂閱網址匯入。
儲存後先確認清單中是否出現預期的群組與項目,再選取要使用的伺服器。協定類型必須與伺服器端一致,連接埠、密碼或識別資料、TLS 與傳輸相關欄位也應依原始資料核對;不要只因為熟悉某個協定名稱,就只修改 Type,卻沿用另一種協定的參數。
Subscribe 更新的是來源端維護的項目,Config 更新的則是設定檔,兩者不可混為一談。更新訂閱後,請重新確認所選項目是否仍存在、名稱是否變更,以及目前策略群組是否仍指向有效內容。手動修改由訂閱產生的項目,後續更新時可能會被覆蓋;需要長期保留的差異應先獨立記錄,並確認管理方式。
同時管理多個訂閱時,請使用容易辨識的備註區分來源,更新後檢查名稱重複與失效項目。刪除前先確認操作影響的是單一伺服器,還是整個訂閱群組;名稱相同不代表參數相同,暫時測試失敗也不代表來源已失效。訂閱網址可能包含存取憑證,截圖、分享記錄或備份檔案前,請先檢查其中是否有敏感資訊。
Connectivity Test 可用於初步檢查,但測試通過不代表每個目標都能正常存取。測試失敗時,先確認目前網路與 Test Method,再檢查伺服器資料及訂閱更新結果。詳細匯入流程請參閱使用教學,協定欄位的技術含義請參閱協定手冊。
04 / Settings
On Demand 按需連線
On Demand 會依設定的網路條件觸發連線行為,適合已完成手動連線驗證,並希望在特定網路環境下自動處理連線的情況。入口位於 Settings 的相關設定中,系統 VPN 設定也可能顯示相應狀態。實際選項以應用程式目前顯示為準;設定前,先釐清希望在哪些網路下連線,以及哪些情況下不連線。
建議先關閉 On Demand,手動完整驗證一次「選擇伺服器、設定 Global Routing、開啟連線、存取目標」的流程。確認基本連線可用後,再前往 On Demand 閱讀條件與動作,先設定一條容易重現的條件並儲存。接著分別在條件符合、不符合及切換網路時檢查實際狀態,避免一次加入多條重疊條件,導致難以判斷觸發來源。
On Demand 無法修復過期的驗證資料,也不能取代 Config 規則。它處理的是何時發起連線,Global Routing 處理的則是連線方式。如果關閉主開關後仍出現連線,請先檢查是否有自動觸發條件,而不是反覆刪除伺服器項目。
05 / Data
Data 流量統計
Data 可查看用戶端記錄的流量狀況,協助判斷連線期間是否有資料傳輸,以及某次測試是否造成明顯變化。進入 Data 後,先確認目前顯示的統計範圍與計數方式;如果介面提供不同時間或連線範圍,請先選定範圍再比較前後數值,不要直接相減不同範圍的數字。
一種容易重現的做法是:記下測試前的顯示值,維持相同伺服器與模式,只存取一個已知目標,再返回 Data 查看變化。測試時盡量暫停其他應用程式的背景傳輸,因為系統同步、媒體預載及其他連線都可能影響統計。流量增加只能說明發生了資料傳輸,不能單獨證明某個頁面已完整載入,也無法據此判斷目標符合哪條規則。
用戶端統計與服務商帳單的計量位置、統計週期及計算方式可能不同,因此不要將 Data 當成剩餘流量的唯一依據。訂閱中顯示的流量資訊與本機記錄來源不同,應分別核對。若要清除或重設統計,請先記錄所需資料並確認重設範圍;還原設定檔不保證能復原所有歷史統計。
06 / Settings
Settings 常用項目
Settings 集中管理用戶端行為,但並非所有連線參數都在這裡。伺服器本身的參數應在對應項目中檢查,規則與部分 DNS 行為則可能來自目前的 Config。進入某項設定前,先確認它適用於全域、目前設定或單一項目;若設定檔內已有相關指令,也要依該指令的適用範圍判斷實際結果。
DNS:先檢查解析,再檢查轉送
DNS 會將網域名稱解析為連線所需的位址。如果 IP 目標可用但網域目標異常,或同一網域在不同網路的表現不一致,解析結果可作為排查線索。查看 Settings 中的 DNS 相關選項,同時核對目前 Config 的 DNS 指令;記下原始值後一次調整一項,再以同一網域重新測試。
不要把更換 DNS 當成所有問題的通用解法。解析成功只代表取得位址,後續仍可能在連線、TLS 或伺服器驗證階段失敗。修改後也要留意快取的影響,並確認測試請求使用的是修改後的設定。優先採用你能說明用途且與現有設定相容的選項,避免疊加多組來源不明的參數。
Test Method:了解測試結果的限制
Test Method 決定清單測試採用的方式,可在 Settings 中尋找對應項目。不同方式檢查的連線環節不盡相同,結果也不能直接混合比較。先選定合適的方式,並維持測試目標與網路環境一致,再前往 Home 執行 Connectivity Test。
清單測試適合篩查明顯失敗的項目,不能取代實際使用情境的請求。如果測試通過但目標無法存取,應繼續檢查網域解析、規則與目標服務;如果測試失敗但實際請求成功,也應先確認測試方式本身,不要立刻刪除該項目。
Today Widget:使用快速操作後確認狀態
Today Widget 提供系統元件的相關快速入口,實際可用操作依目前系統與應用程式顯示為準。在 Settings 查看相關設定,並在系統的元件編輯畫面加入可用元件。首次使用時,先返回 Home 確認主開關、目前伺服器與模式,再透過元件觸發一次操作,並回到應用程式確認結果。
元件顯示可能有更新延遲,快速入口也不能取代完整診斷。點按後若結果不如預期,請回到應用程式查看實際狀態,並檢查 On Demand 是否再次觸發連線。不要只憑元件的一次顯示,就判定伺服器是否可用或規則是否符合。
iCloud:同步前先保留獨立備份
iCloud 用於應用程式提供的雲端同步或相關儲存操作。使用前請確認裝置登入的帳號、系統 iCloud 權限與應用程式內的相關開關,再依目前畫面說明檢查同步項目。不同類型的資料應分別核對;某個 Config 已出現,不代表訂閱、選取狀態與統計記錄也都已還原。
更換裝置前,請先保留可還原的獨立備份,並避免同時在兩部裝置上大幅編輯。新裝置上先檢查檔案內容與伺服器項目,再確認目前啟用的 Config 和 Global Routing。同步雖然方便,仍不能省略連線參數的核對;包含憑證的檔案也應以敏感資料妥善保管。
Diagnostics:針對單次故障蒐集線索
Diagnostics 用於診斷與記錄相關操作,可從 Settings 的對應入口查看。先記下問題發生時間、網路類型、所選伺服器與目標,再重現一次故障,接著檢查應用程式提供的診斷資訊。比起連續修改多項設定後匯出大量記錄,條件明確的單次重現更容易找出問題。
檢查記錄時,請區分解析失敗、連線建立失敗,以及驗證或交握失敗,不要將所有異常都歸因於規則。準備分享記錄前,請檢查訂閱網址、伺服器資料、存取網域與驗證內容,並移除敏感資訊。記錄只反映當時的條件;網路切換後出現的新問題,需重新記錄與驗證。
檢查順序
設定變更後的驗證
維持相同目標、網路與伺服器,逐層確認。每次只改變一個條件,才能判斷是哪項設定影響結果。
- 確認基本狀態。在 Home 檢查連線開關與目前伺服器,確認沒有誤選名稱相同的項目;先確保手動連線可重現,再處理自動連線。
- 確認模式與設定。查看 Global Routing;使用 Config 時,核對實際啟用的檔案、第一條符合的規則與 FINAL,不要只查看編輯中的副本。
- 確認解析與請求。綜合 DNS、Connectivity Test 與實際存取目標的結果判斷,不要以單一測試數值作為完整結論。
- 確認自動行為。測試 On Demand、Today Widget 與網路切換,檢查是否發生自動重新連線或顯示更新延遲。
- 保留結果與還原方式。記錄這次的變更,發生異常時還原原值;需要進一步排查時,請前往疑難排解,不要繼續疊加未經驗證的設定。
本頁為 Shadowrocket 官方手冊中的功能與設定說明。iPhone / iPad 的系統需求請以 App Store 頁面標示為準;介面位置與選項範圍請依應用程式目前的實際畫面確認。