Shadowrocket 代理模式
Global Routing 與常用設定

Global Routing：Config、Proxy 與 Direct

是什麼：Global Routing 決定進入 Shadowrocket 處理範圍的連線如何選擇出口。設定模式 Config 依目前設定中的規則分流；代理模式 Proxy 讓相關連線採用代理路徑；直連模式 Direct 則透過目前網路直接連線。這三種模式是路由決策，不是三種連線協定，也不代表伺服器本身是否正常。

在哪裡：前往 Home，找到 Global Routing。選擇前先確認目前使用的伺服器，以及 Config 中啟用的是哪份設定；匯入設定但未選取，不代表它已開始套用。

如何設定：平常已有可用的分流設定時，先選擇 Config。若某個目標無法連線，維持相同網路、伺服器與目標，暫時切換至 Proxy 進行比較；需要確認本機網路能否直接連線時，再測試 Direct。每次切換後重新發起連線，必要時重新開啟連線開關，避免舊連線影響判斷。

注意事項：Proxy 不代表能接管裝置上的所有通訊，系統服務、區域網路排除項目與平台機制仍可能影響連線路徑。若 Proxy 可用而 Config 不可用，優先檢查規則與策略引用；若兩者都失敗，先檢查伺服器與網路。完成比較後請恢復日常模式，勿將測試狀態長期保留。

規則分流：比對條件與執行策略

是什麼：規則由比對條件與策略組成。DOMAIN 比對指定網域，DOMAIN-SUFFIX 比對網域後綴，DOMAIN-KEYWORD 依網域中的關鍵字比對；IP-CIDR 和 IP-CIDR6 分別表示 IPv4、IPv6 網段，GEOIP 則依 IP 地理位置比對。USER-AGENT 能否正確比對，還取決於是否能取得相應的請求資訊，不應視為通用的應用程式識別方式。

在哪裡：前往 Config，查看目前選取的設定及其規則內容。Home 中的 Global Routing 必須選擇 Config，才會依這份設定進行分流。伺服器清單與規則清單用途不同：前者儲存連線參數，後者決定各連線採用哪項策略。

如何設定：先備份現有設定，再將範圍較小的例外規則放在較廣泛的規則之前。以下僅示範語法，example.com 和 example.org 是文件中的示例網域，並非伺服器資訊；使用前請依實際需求替換並驗證。

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

PROXY 表示採用代理策略，DIRECT 表示直接連線，REJECT 表示拒絕連線。FINAL 是前面的條件都未符合時採用的最終處理項目，應放在規則末尾。若設定使用自訂策略名稱，還要確認名稱確實存在且引用一致，不能將不存在的名稱當成可用出口。

注意事項：規則通常依序尋找符合項目，前面的廣泛條件可能會先於後面的精確條件生效。網域規則與 IP 規則取得的資訊不同，連線結果也會受到 DNS 與快取影響。修改後先用明確的目標確認比對結果；若誤用 REJECT，可能會阻擋頁面所需資源。不要為了解決單一目標的問題，一次替換整份設定。

Subscribe 與 Add Server：訂閱及伺服器管理

是什麼：伺服器項目儲存單一連線的位址、連接埠、協定與驗證參數；訂閱則可從使用者已有的網址讀取一組伺服器資訊，並在之後更新。匯入成功只代表內容已讀取，不代表項目仍有效，也不保證每台伺服器都能在目前網路下連線。

在哪裡：在 Home 管理伺服器，透過 Add Server 新增項目。若已有訂閱，請在新增入口選擇 Subscribe；若已有 QR Code，可使用 Scan QR Code。介面入口位置可能因平台版面而異，請依相同的英文名稱尋找。

如何設定：先確認自己已有訂閱或伺服器資訊。訂閱網址請完整照原樣貼上，不要額外加入空格或換行；手動新增時，逐項核對協定、位址、連接埠與驗證欄位。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 所需欄位各不相同，請依所選協定的表單與現有參數填寫，不要只變更協定名稱，卻沿用其他協定的參數。

匯入後，為項目設定容易辨識的名稱，使用 Connectivity Test 進行檢查，再到 Home 選取要使用的伺服器。更新訂閱後，請再次確認目前選取的項目仍存在；若要保留本機修改，請先備份，以免遠端更新覆蓋訂閱管理的內容。訂閱與完整的 Config 也不可混為一談：伺服器清單可以更新，不代表所有分流規則也會一併同步。

注意事項：訂閱網址可能包含存取憑證，請勿放入公開截圖、記錄或聊天內容。更新失敗時，先確認網址是否完整、目前網路能否讀取，以及憑證是否有效，再重新嘗試；若現有項目仍在，不必先刪除所有資料。本網站不提供、販售或推薦節點或訂閱，只說明如何使用使用者已有的資訊。

On Demand：依條件建立連線

是什麼：On Demand 會在符合條件時，由系統嘗試建立連線。它處理的是「何時連線」，而 Global Routing 處理的是「連線後如何分流」。啟用按需連線不會自動修正伺服器參數，也無法保證網路切換期間每個現有連線都能維持不中斷。

在哪裡：前往 Settings，尋找 On Demand，並查看目前平台提供的條件與例外項目。若目前客戶端沒有顯示同名項目，請以該平台的設定介面為準，不要以其他平台的系統設定取代客戶端選項。

如何設定：先手動完成一次連線，確認伺服器、DNS 與規則都可正常使用，再啟用 On Demand。若介面提供網路條件，先只設定一種明確情境，例如在指定網路條件下連線；儲存後切換網路，檢查系統連線狀態，並實際連線至目標進行驗證。每新增一項例外，都應重新測試觸發與解除條件。

注意事項：手動關閉後又出現連線，可能是按需條件再次觸發，不一定是開關故障。若要徹底停止測試，請先關閉 On Demand，再關閉主要連線。遇到需要登入網頁驗證的公共網路時，請先完成網路登入，再檢查連線；網路尚未可用前，不要反覆修改協定參數。

Data：查看流量，勿以統計取代連線測試

是什麼：Data 提供客戶端處理流量的統計資訊，可用來觀察上傳、下載與用量變化。統計內容僅涵蓋目前客戶端可見的資料，不等同於電信業者帳單，也不等同於伺服器端的計費紀錄。統計週期、重設方式與顯示項目請以目前介面說明為準。

在哪裡：開啟 Data，先確認目前檢視的統計範圍，再比較數值。若目前平台提供依連線或時間檢視的入口，請選擇與本次測試相符的範圍；不要直接相減不同時段的累計值，並據此認定為單次連線的用量。

如何設定：通常只需觀察，不必為了開始使用而調整統計設定。需要進行對照時，記下測試前的時間與數值，關閉其他持續下載工作，再執行一次固定操作，之後查看數值變化。若要重設統計，請先保存需要留存的紀錄，並確認重設影響的範圍。

注意事項：背景同步、圖片載入與連線重試都可能產生流量。數值增加不能單獨證明頁面已成功載入；數值沒有增加也不能直接判定節點失效，還要檢查路由模式、連線狀態與實際請求。流量統計適合觀察變化，連線是否成功仍需搭配測試與記錄判斷。

Settings：DNS、測試方式與常用入口

DNS：一併檢查網域解析與路由

是什麼、在哪裡：DNS 會將網域解析為 IP 位址。在 Settings 中查看 DNS 相關設定，同時檢查目前的 Config 是否也定義了解析項目；設定層級的選項可能影響實際行為，不能只查看設定頁上的單一數值。

如何設定：修改前先記下原值，並確認問題是否僅發生在網域連線。如果網路正常但特定網域無法連線，請核對 DNS 位址格式、目前網路是否可連線至該位址，以及設定中是否另有指定。採用已確認適合目前環境的解析方式，每次只修改一項，重新連線並發出新請求後再比較結果。

注意事項：解析成功不代表目標連線一定成功；目標可透過 IP 位址連線，也不代表所有網域請求都能改用 IP，因為憑證與服務選擇可能依賴網域。不要將 DNS 當成所有連線問題的通用解法，尤其不要同時修改 DNS、伺服器與路由模式後才判斷原因。

Test Method：使用一致條件比較 Connectivity Test

是什麼、在哪裡：Test Method 用來選擇連線測試方式，可在 Settings 中尋找，再回到 Home 執行 Connectivity Test。可選方式請以目前客戶端列出的項目為準。

如何設定：比較多台現有伺服器時，請維持測試方式、網路與測試目標一致；若可設定測試目標，先確認該目標本身能正常回應。單次結果異常時，間隔片刻再測，並搭配實際連線情況判斷，不要只依某次顯示的數值作選擇。

注意事項：不同測試方式測量的階段不同，結果不宜直接比較。測試顯示的時間不等於下載速度，也無法涵蓋所有應用程式的使用情況。變更測試方式只會改變測試依據，不會替你修改伺服器的協定或驗證參數。

Today Widget：使用快速操作後仍須確認狀態

是什麼、在哪裡：Today Widget 是系統支援時提供的快速入口，可在 Settings 中尋找相關設定，再依系統提供的方式加入相應區域。是否提供此入口，以及可執行哪些操作，取決於目前平台與系統。

如何設定：先在主應用程式中選好伺服器、設定與模式，並完成一次正常連線，再新增快速入口。首次透過快速入口切換後，回到 Home 核對選取項目與實際連線狀態，確認操作符合預期。

注意事項：快速入口並非獨立的設定。若顯示未即時更新，請先開啟主應用程式確認，避免連續點選造成多次切換。自動連線條件仍可能在手動操作後觸發，請一併了解 On Demand 的作用。

iCloud：同步前先確認資料範圍

是什麼、在哪裡：在支援的 Apple 裝置上，iCloud 相關選項可在同一帳戶環境中儲存或同步客戶端支援的資料。前往 Settings 尋找 iCloud 項目，同時確認系統是否允許 Shadowrocket 使用 iCloud。

如何設定：先在來源裝置儲存本機備份，再啟用同步；等待完成後，在另一台裝置核對設定名稱、規則與伺服器項目。依介面提供的項目確認同步範圍；裝置上的連線權限、目前網路與實際連線結果仍須分別驗證。

注意事項：不要將 iCloud 視為即時、完整且絕不衝突的備份。兩台裝置同時修改相同內容前，請先確認同步狀態。iCloud 也不是適用於所有平台的通用設定移轉方式；跨平台移轉時，請確認目標客戶端支援的匯入格式，並妥善保護其中的憑證。

Diagnostics：透過記錄定位故障階段

是什麼：Diagnostics 用於檢查與收集連線相關資訊，協助判斷設定讀取、網域解析、伺服器連線與目標回應等階段的問題。記錄是排查依據，不是自動修復按鈕；單一錯誤訊息也須搭配發生時間與觸發操作解讀。

在哪裡：前往 Settings，尋找 Diagnostics 及目前客戶端提供的記錄入口。開始記錄前，先確認目前使用的伺服器、Global Routing 與設定名稱，避免記錄內容與問題描述來自不同的測試狀態。

如何設定：先將問題縮小至可重現的故障，例如某個網域無法開啟。記下測試時間，啟用所需的診斷項目，再重現一次問題。查看同一時段附近的解析結果、連線錯誤與命中策略；若只有 Config 模式失敗，應優先核對規則，而不是立即更換所有伺服器。

注意事項：記錄可能包含目標網域、IP 位址、訂閱憑證或伺服器資訊。匯出前請檢查內容；對外說明問題時，只保留必要片段並移除敏感欄位。排查完成後，請關閉暫時啟用的詳細記錄；長時間持續記錄可能增加儲存與處理負擔。完整故障排查流程請見排查手冊。

設定完成後的檢查順序

各項功能彼此有依賴關係：先確認網路可用且伺服器參數完整，再設定模式與規則，最後才處理自動連線與快速入口。依照下列順序驗證，可保留清楚的因果關係，也方便在修改失敗時還原。

1. 檢查基礎網路。確認裝置已完成網路登入，且目前網路可正常使用；若基礎網路無法使用，請先停止修改客戶端設定。
2. 檢查伺服器。核對現有資訊，執行 Connectivity Test，選取項目後進行實際連線，區分測試結果與實際請求結果。
3. 檢查 Global Routing。使用固定目標比較 Config、Proxy 與 Direct，記錄哪種模式失敗，再恢復日常模式。
4. 檢查規則與 DNS。確認目前設定、規則順序與最終策略；每次只修改一項，重新建立連線後再判斷。
5. 檢查自動化功能。手動連線穩定後再啟用 On Demand，接著驗證 Today Widget 等快速入口；同步後逐台檢查裝置狀態。
6. 保留還原方式。儲存可用的設定與修改紀錄。發生異常時，先還原上一項修改，再前往 Diagnostics 收集對應時段的資訊。

需要從頭建立連線時，請閱讀使用教學；需要了解協定或規則關鍵字時，請參閱術語表。本頁供查閱功能與設定；應用程式取得方式及各平台需求，請統一參閱下載頁。