Shadowrocket
功能與設定

Global Routing

配置、代理與直連模式

功能說明：Global Routing 決定如何以整體方式處理請求。配置模式對應 Config，代理模式對應 Proxy，直連模式對應 Direct。這不是伺服器清單，也不會補上伺服器的驗證資訊；選好模式後，連線是否成功仍取決於本機網路、目標位址及所選伺服器的狀態。

操作位置與設定方式：在 Home 找到 Global Routing，開啟後選擇所需模式。日常使用規則分流時選擇 Config，並前往 Config 頁面確認目前選用的設定檔。要單獨測試代理連線時，可暫時切換至 Proxy；要確認直連是否正常時，可暫時切換至 Direct。切換後，請重新向同一目標發出請求，避免將先前已建立的連線誤當成新模式的測試結果。

注意事項：Direct 不等於關閉連線開關，系統顯示 VPN 標誌也無法證明特定請求一定經過代理。Proxy 不代表所有系統流量都會由它處理。要判斷特定請求的實際路徑，應一併查看請求記錄、命中的策略與新連線的測試結果；排查完成後，請將模式切回日常使用的選項。

Config / Rule

規則類型與處理策略

功能說明：規則會將比對條件與處理策略連結起來。DOMAIN 比對完整網域，DOMAIN-SUFFIX 比對網域及其子網域，DOMAIN-KEYWORD 則檢查網域中的關鍵字。位址相關條件包括 IP-CIDR、IP-CIDR6 與 GEOIP，分別用於 IPv4 網段、IPv6 網段與 IP 地區判斷；GEOIP 的判斷結果取決於 IP 位址資料庫，而非網站使用的語言。

操作位置與設定方式：前往 Config 確認目前啟用的設定檔，再編輯其中的 [Rule] 區段。通常將條件較明確的規則放在前面，並將 FINAL 放在最後，作為前面條件都未命中時採用的最終策略。修改前請先儲存副本，修改後重新測試特定目標；只儲存另一份未啟用的設定檔，不會改變目前連線使用的規則。

[Rule]
DOMAIN,example.org,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,ads,REJECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

上述範例僅用於說明語法，並非適用於所有網路的完整設定。PROXY 表示交由代理策略處理，DIRECT 表示直接連線，REJECT 表示拒絕請求。規則也可以引用設定檔中已定義的策略群組；引用名稱必須與實際定義相符，否則應先修正引用關係。

注意事項：規則通常會依序比對，前面已命中的條件會影響後續規則是否還有機會執行。關鍵字比對範圍可能比預期更廣，拒絕規則應盡量明確。網域規則與 IP 規則檢查的對象不同，DNS 解析結果也會影響位址規則；請勿只看規則文字，就認定特定目標一定會命中。USER-AGENT 取決於請求中可見的對應欄位，並非適用於所有加密請求的通用分類方式。

若要逐條了解語法，請接著閱讀規則關鍵字與比對順序。排查時先確認實際目標網域，再檢查最先命中的規則，最後核對對應策略，而非反覆新增相同條件。

Home / Add Server / Subscribe

伺服器與訂閱管理

功能說明：單一伺服器項目會儲存協定、位址、連接埠與驗證等連線資訊；訂閱則可透過使用者已有的連結取得並更新一組項目。更新訂閱會變更伺服器清單內容，不代表規則設定也會同步更新，更不代表更新後的每台伺服器都能連線。

操作位置與設定方式：在 Home 使用新增入口進入 Add Server，依照已有資訊選擇類型並填寫欄位。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 等協定的欄位不盡相同，請依原始連線參數填寫，不要只因名稱相似就套用其他協定的表單。若已有 QR Code，可透過 Scan QR Code 匯入；匯入後仍須確認協定與位址。

匯入訂閱時，請在 Add Server 的類型中選擇 Subscribe，輸入自己的訂閱連結並儲存，再執行更新。返回 Home 後，點選要使用的伺服器並確認選取標記。預設伺服器與設定中的策略群組選擇可能是兩個不同層級的設定；若使用策略群組，也應確認群組內目前選用的項目。

注意事項：訂閱連結可能包含存取憑證，截圖、複製記錄或傳送求助資料前，請遮蔽完整連結與驗證資訊。手動修改由訂閱產生的項目，可能在下次更新時被覆蓋；若要保留調整內容，應先了解更新方式並另存必要記錄。手動更新失敗時，請分別檢查連結是否完整、目前網路是否可連線，以及回傳內容是否為支援的格式。

刪除訂閱與刪除單筆伺服器記錄，影響範圍不一定相同，操作前請先閱讀確認提示。名稱相同不代表參數也相同，位址、連接埠、驗證資訊與 TLS 相關欄位都應逐一核對。詳細更新步驟請參閱訂閱更新與失敗排查。

On Demand

按需連線與觸發條件

功能說明：On Demand 可依設定的網路條件觸發連線行為。它處理的是「何時連線」，而 Global Routing 處理的是「連線後如何處理請求」；兩者用途不同。按需連線也無法修正錯誤的伺服器資訊或失效的訂閱。

操作位置與設定方式：在 Settings 中找到 On Demand 相關選項，依照目前介面提供的條件進行設定。設定前先手動連線，並使用 Connectivity Test 確認基本連線正常。接著每次只調整一種條件，分別在預計使用的 Wi-Fi 或行動網路下測試；若條件涉及特定 Wi-Fi，請仔細確認網路名稱。

注意事項：啟用自動觸發後，手動中斷連線不一定能讓連線持續保持關閉，符合條件時系統可能再次觸發連線。若要暫時停止自動連線，請一併檢查 On Demand 狀態。系統的網路切換與省電行為也可能影響觸發時機，不應將它視為會持續監測伺服器狀態的健康檢查。

若出現「剛中斷又重新連線」的情況，先記下發生時的網路類型，再核對觸發條件，不要立刻刪除設定。反過來說，若切換網路後未如預期連線，應先確認條件確實符合，再檢查系統 VPN 設定是否有效，以及手動連線是否仍然成功。

Data

流量統計與請求記錄

功能說明：Data 可查看應用程式記錄的流量與相關請求資訊。這有助於觀察連線期間的資料變化、找出存取目標，並搭配記錄核對策略。App 內統計有自己的計算範圍與計數時機，不應直接視為行動通訊帳單或遠端帳戶的用量。

操作位置與設定方式：開啟 Data，先確認目前查看的是哪一類統計或記錄，以及頁面顯示的統計範圍。若要觀察某項操作，先記下目前計數，再只開啟一個目標頁面，返回檢查新增記錄與流量變化。若目前介面提供篩選、清除或重設選項，請先確認影響範圍，再決定是否執行。

注意事項：快取、背景連線、協定封裝與不同的統計範圍，都可能讓計數結果與直覺不一致。流量增加不代表服務請求已完成；沒有立即出現記錄，也可能與沿用既有連線或記錄設定有關。比較兩次測試時，應盡量保持網路、目標與測試操作一致。

請求記錄中的網域、IP 與時間有助於定位問題，也可能暴露個人瀏覽習慣。分享資料時，只保留與故障相關的項目。若要清除記錄，請先保存必要的排查線索；清除後便無法再透過清單還原先前的測試過程。

Settings

DNS、測試與輔助設定

Settings 集中管理解析、測試與輔助功能。以下依用途說明常用選項，不提供適用於所有裝置的固定數值。現有設定可能也包含相關參數，編輯前請確認目前生效的設定來源；預設值與開關狀態請以 App 目前顯示為準。

DNS：先區分解析與連線問題

功能與位置：DNS 會將網域名稱解析為位址；相關選項可在 Settings 的 DNS 設定及目前設定檔中的相關區段確認。網域無法解析、解析到不適用的位址，以及代理驗證失敗，是發生在不同階段的問題。

設定方式與注意事項：先記下目前設定，確認目前設定檔是否指定解析伺服器或解析方式，再修改目標選項。排查時使用同一網域，比較修改前後的解析結果，每次只變更一個因素。自訂解析位址本身也必須能連線，不能只因「填入了位址」就視為測試完成。若遇到 TLS 相關故障，也應檢查網域與憑證是否相符，不要把關閉憑證驗證當成一般的 DNS 修復方式。

Test Method：測試方式與數值說明

功能與位置：Test Method 決定延遲測試採用的方式，可在 Settings 中查看與調整。不同方式檢查的連線階段各異，因此不宜直接混合比較同一伺服器以不同方式測得的結果。

設定方式與注意事項：先選定一種測試方式，再測試需要比較的項目。若目前方式使用測試位址，也應確認該位址本身可以連線。測試成功只能證明對應的測試程序已完成，不代表所有網站都能正常使用；延遲數值也不等同於持續下載速度。若要確認實際服務是否正常，請開啟目標服務並查看請求記錄。

Today Widget：小工具入口與顯示

功能與位置：Today Widget 提供小工具相關的快速檢視或操作選項。先在 Settings 確認 App 提供的小工具設定，再前往系統對應的小工具編輯畫面，加入可用的小工具。具體形式取決於目前系統與 App 的支援情況。

設定方式與注意事項：依實際需求選擇要顯示或操作的內容，加入後返回 App 確認連線狀態。小工具顯示可能有更新間隔，不應作為請求已成功的唯一依據；若小工具狀態與 App 不一致，請先開啟 App 更新並確認，再判斷連線是否異常。小工具的快速操作仍會受到系統權限與按需連線條件影響。

iCloud：同步範圍與還原確認

功能與位置：iCloud 相關選項用於 App 支援的資料同步或雲端儲存流程。前往 Settings 查看相關開關，並確認系統中此 App 的 iCloud 權限。只有目前介面明確支援的內容，才應列入同步預期。

設定方式與注意事項：在不同裝置間操作前，先保留現有設定檔副本，再確認兩台裝置的帳戶與同步狀態。同步不等於完整備份，也不代表重新下載 App 後所有資料都會自動還原。還原後應逐項檢查伺服器清單、目前設定檔與策略選擇，不要只憑檔名判斷內容是否一致；敏感的訂閱連結也應視為私人憑證妥善保管。

若要查閱更詳細的設定說明，請前往Settings 設定項目參考。避免一次調整 DNS、測試方式與自動連線條件，否則即使問題消失，也難以確認真正有效的變更。

Diagnostics / Connectivity Test

診斷順序與結果確認

功能說明：Diagnostics、日誌與 Connectivity Test 可用於查看不同階段的狀態。單一連線測試的結果，無法取代對 DNS、規則與實際目標存取的完整檢查。診斷的目的，是將問題縮小到可重複驗證的步驟。

操作位置與設定方式：先在 Home 確認伺服器選擇、連線開關與 Global Routing，再執行 Connectivity Test。若要進一步排查，請在 Settings 查看目前提供的 Diagnostics 或 Log 相關選項，視需要記錄一次故障過程。各項入口請以目前介面為準；完成記錄後，請還原原本的日誌設定。

1. 確認本機網路。先確認網路本身可以使用，並排除需要登入驗證的 Wi-Fi；在同一網路下再次測試，記錄故障是否穩定重現。
2. 確認伺服器參數。依照使用者已有的資訊，檢查協定、位址、連接埠與驗證欄位。訂閱可以更新但無法連線時，仍須個別測試實際選用的伺服器。
3. 排除路由因素。暫時比較 Proxy 與 Config 下對同一目標的測試結果。如果前者正常、後者異常，請優先確認目前設定檔、命中的規則與策略群組選擇。
4. 確認解析與請求。查看目標是否解析成功、實際位址為何，以及請求最後採用的策略。若只有個別目標異常，請先針對該目標檢查，不必立刻重建所有設定。
5. 還原並重新測試。保留已確認有效的變更，撤銷暫時測試設定，還原日常路由與按需連線條件，再進行一次實際存取測試。

注意事項：日誌可能包含伺服器位址、驗證資訊、訂閱連結與存取記錄。對外分享前，請逐項檢查並遮蔽敏感欄位；請勿公開完整憑證作為排查資料。系統顯示 VPN 標誌、伺服器測試成功與目標頁面載入成功，代表不同層面的證據，應分別確認。