官方手冊 / 功能與常用設定
Shadowrocket 設定指南
先確認 Global Routing 的運作方式，再檢查 Config 中的規則與策略，最後調整依需求連線、DNS 和測試選項。每次只修改一項，並以相同目標驗證，才能判斷變化的原因。
- 路由入口 Global Routing
- 設定入口 Config
- 統計入口 Data
依功能查找設定
以下是頁面內的章節連結，不會切換或隱藏正文。各項名稱以裝置上目前 App 顯示為準；若位置不同，請先依英文名稱查找，不要套用其他設定項目的位置。
Global Routing：設定、代理與直連
功能說明：Global Routing 決定用戶端處理請求時採用哪種路由方式。三種常見模式為 Config（設定）、Proxy（代理）和 Direct（直連）。這些模式不是速度等級，而是決定是否依照設定規則判斷請求去向。
位置與設定方式：在 Home 開啟 Global Routing，選擇所需模式，再返回確認目前顯示的模式。日常需要依網域、位址等條件分流時使用 Config；需要暫時確認所選代理是否可用時使用 Proxy；需要對照本地網路的直接連線情況時使用 Direct。
| 介面選項 | 運作方式 | 適用情境 | 優先確認項目 |
|---|---|---|---|
| Config（設定） | 依照目前啟用設定中的規則與策略處理請求。 | 日常使用，需要區分直連、代理或拒絕的情況。 | 已啟用的檔案、規則順序、策略名稱。 |
| Proxy（代理） | 以代理方式處理由用戶端接管的請求，仍須考量 App 與系統的相關處理條件。 | 排除規則因素，確認所選代理是否可用。 | 選取的伺服器、連線參數、測試目標。 |
| Direct（直連） | 以直連方式處理由用戶端接管的請求。 | 對照本地網路，確認問題是否出在代理路徑。 | 目前網路本身能否連線至相同目標。 |
注意事項：Direct 不代表關閉用戶端連線，Proxy 也不應理解為系統中的所有通訊必定經由相同路徑。切換模式後，既有長連線可能仍沿用先前狀態；驗證時請重新發出請求，必要時結束相關連線後再測試。若為排查問題而暫時切換至 Proxy，記得恢復原本需要的 Config。
規則分流：比對條件與策略去向
功能說明：規則由比對條件和處理策略組成。比對條件用來判斷「這是哪個請求」，策略則決定「比對成功後要送往哪裡」。在 Config 模式下，常見規則會依序判斷，前面命中的規則會影響後續規則是否有機會生效，因此應將明確且範圍較小的例外規則放在較廣泛的條件之前。
位置與設定方式：在 Config 檢查目前啟用的檔案，進入對應的編輯入口查看規則。先確認目標要以完整網域、網域後綴還是 IP 網段進行比對，再填入規則值與策略。儲存後確認啟用的是剛修改的檔案，並重新連線至相同目標。
| 規則關鍵字 | 比對依據 | 確認要點 |
|---|---|---|
DOMAIN | 完整網域。 | 只填網域，不要填路徑或協定前綴。 |
DOMAIN-SUFFIX | 網域後綴及其子網域。 | 後綴範圍可能涵蓋多個服務。 |
DOMAIN-KEYWORD | 網域中包含的關鍵字。 | 比對範圍較廣，請先排查是否誤命中。 |
IP-CIDR / IP-CIDR6 | IPv4 / IPv6 位址網段。 | 確認位址類型、前綴長度及解析條件。 |
GEOIP | IP 地理位置歸屬資料。 | 資料所示的歸屬地不等於服務實際使用的地區。 |
FINAL | 前面的規則都未命中時的最終去向。 | 作為兜底規則放在規則末尾。 |
DIRECT、PROXY 與 REJECT
DIRECT 表示直連，PROXY 表示使用代理策略，REJECT 表示拒絕。設定也可能引用自訂策略群組名稱；該名稱必須在設定中有對應定義，不能只憑文字推測實際出口。規則關鍵字的大小寫與分隔符號應維持正確格式。
以下僅為規則語法示意，並非 App 介面，也不是可直接覆寫現有檔案的完整設定。範例中的 example.com 僅用來說明後綴比對。
DOMAIN-SUFFIX,apple.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY注意事項：規則未如預期運作時，先確認前面的規則是否已命中，再核對請求記錄中的實際網域與 IP。單一頁面可能連線至多個網域，只為主網域新增規則未必涵蓋所有資源。不要反覆增加範圍寬泛的關鍵字來掩蓋真正的比對問題。
Subscribe：管理既有訂閱與伺服器
功能說明：Subscribe 是透過使用者既有的訂閱網址匯入並更新伺服器資訊的方式。訂閱通常管理一組伺服器；個別新增伺服器則由使用者自行維護各項參數。訂閱更新與 App Store 中的 App 更新是兩回事，更新其中一項不會自動取代另一項。
位置與設定方式：在 Home 使用新增入口進入 Add Server，依照目前介面提供的 Subscribe 選項，填入自己的訂閱網址與備註。儲存後執行更新，再確認群組與項目是否出現。已有 QR Code 時可透過 Scan QR Code 匯入；匯入後仍應檢查類型、位址與連接埠，不要只看備註名稱。
手動管理伺服器時，先在 Add Server 選擇正確的協定類型，再填寫位址、連接埠與對應的認證資訊。備註只供辨識，不會決定連線方式。建議使用容易辨認的用途或自訂名稱區分項目，避免因名稱相同而選錯。
注意事項：訂閱網址可能包含個人存取憑證，請勿放入公開截圖、記錄或回報文字中。更新後，項目名稱、群組與數量可能隨來源內容變動；訂閱項目的本機修改也可能受到後續更新影響，修改前請先保留必要記錄。更新失敗時，應分辨網址失效、請求逾時與內容解析失敗，不要立刻刪除仍可使用的整組項目。
本站僅說明既有內容的匯入與管理。訂閱是否有效、是否允許多部裝置使用及服務期限，應以使用者既有服務的說明為準，不能根據 App 購買記錄推斷。
多協定：先選擇類型，再填寫參數
功能說明：協定決定用戶端與伺服器之間如何建立連線及交換資料。Shadowrocket 支援多種協定，常見名稱包括 Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 和 Hysteria2；實際可選類型與參數請以 App 內 Add Server 顯示為準。
位置與設定方式：在 Add Server 的類型選單中，依照既有伺服器資訊選擇相應協定。接著逐項確認位址、連接埠、認證資訊，以及該類型要求的 TLS 或傳輸相關欄位。匯入連結也必須包含正確類型；不可將某種協定的欄位直接套用到另一種協定。
注意事項：伺服器位址相同，不代表不同協定可以互換；顯示名稱也無法證明參數正確。網域、TLS 驗證名稱、傳輸路徑等欄位用途各不相同，填寫前請對照自己的連線資料。連線失敗時，優先檢查缺漏欄位與輸入錯誤，不應將關閉憑證驗證當作一般排查步驟。協定名稱本身也無法保證在特定網路環境中的速度或穩定性。
Config：啟用與修改設定檔
功能說明：Config 是管理設定檔的入口。設定檔可以包含規則、策略及其他相關選項；伺服器訂閱主要用於匯入與更新連線項目。兩者用途不同，匯入訂閱後，不應假設分流規則也已依個人需求設定完成。
位置與設定方式：在 Config 查看檔案清單，先記下目前啟用的項目，再開啟要修改的檔案。編輯前保留原檔副本，並了解既有規則與策略群組之間的關係；儲存後選取相應檔案，確認目前已啟用該檔案。若使用遠端來源，請先確認內容用途與可信度，再決定是否更新。
注意事項：遠端檔案後續更新可能改變本機設定，尤其是規則順序、策略群組名稱或解析設定。不要直接拼接不同來源的規則片段而不檢查引用關係。發生問題時，還原至上一份已驗證可用的檔案，通常比繼續疊加修改更容易找出原因。設定中若包含私人位址或憑證，備份與同步時也應視為敏感資訊處理。
On Demand：依條件觸發連線
功能說明：On Demand 用於依條件觸發或維持系統 VPN 連線。它與規則分流屬於不同層級的設定：On Demand 處理「何時連線」，Config 中的規則則處理「連線後請求要前往何處」。啟用依需求連線不會自動修正伺服器參數或補上規則。
位置與設定方式：開啟 App 內的 On Demand 設定入口，先檢查現有條件，再依照目前介面支援的網路條件新增規則。可依 Wi-Fi、行動網路或網域相關條件設定依需求連線行為，實際動作與欄位以 App 內顯示為準。第一次設定時建議只保留一項明確條件，確認生效後再擴充。
- 先以手動連線確認既有伺服器與設定能否正常使用。
- 記錄測試時使用的網路，新增相應條件與動作，並檢查規則順序。
- 切換至符合條件的網路，觀察系統 VPN 狀態與實際請求。
- 再測試不符合條件的情境，確認不會意外重新連線或中斷。
注意事項：請仔細確認 Wi-Fi 名稱；多個條件重疊時，應檢查其順序。啟用 On Demand 後，手動中斷連線可能因條件再次符合而重新連線，這是排查時應先確認的因素。暫時排查時，請先停用依需求觸發，避免自動行為影響比對；測試完成後再恢復原設定。依需求連線不代表停止背景通訊，耗電情況仍取決於實際請求、網路狀況及重新連線頻率。
Data：流量統計與請求確認
功能說明：Data 提供用戶端記錄範圍內的流量統計，可用來觀察上傳、下載及相關請求的變化。適合用來確認「哪段時間有資料傳輸」及「哪些請求值得進一步檢查」，但無法取代行動網路帳單或使用者既有服務中的用量記錄。
位置與設定方式：進入 Data，先確認目前的統計範圍與顯示方式，再查看相關記錄。測試特定目標時，記下開始時間，發出少量新請求後再比對流量變化；若要進一步確認路由結果，可搭配 App 內可查看的連線記錄，檢查目標與去向。重設統計前，先保存需要比較的數值。
注意事項：App 記錄、系統統計與遠端用量可能因計算時段、協定額外負荷及統計範圍不同而不一致。不能只因下載數字較大就判斷某條規則錯誤，也不能將測試期間其他 App 的背景通訊算作目標請求。排查時請盡量維持測試條件一致，避免同步、播放媒體等並行傳輸影響判斷。
Settings：解析、測試、元件與同步
Settings 中的選項會影響不同層面的運作。先確認要解決的問題，再調整相應設定；功能名稱、可用範圍與入口以目前 App 及系統顯示為準。
DNS：先區分解析問題與連線問題
功能說明與位置：DNS 會將網域名稱解析為 IP 位址。檢查 Settings 中的 DNS 相關選項時，也要確認目前 Config 是否包含解析設定，避免只修改了實際上未使用的項目。
設定方式與注意事項：先保留原有值，以相同網域確認解析是否成功，再依照既有網路需求選擇系統 DNS 或自訂解析方式。使用 DNS over HTTPS 時，也要考量解析服務本身是否可連線；若解析請求依賴尚未建立的連線路徑，可能造成啟動問題。網頁無法開啟不一定是 DNS 問題，錯誤位址、伺服器認證與規則去向都應分別檢查。詳細原理請參閱DNS 設定說明。
Test Method：使用一致的測試方式進行比較
功能說明與位置：Settings 中的 Test Method 會影響 Connectivity Test 所使用的測試方式。測試結果反映所選方法、目標及當時的網路狀況，不能保證伺服器在完整使用情境中的體驗。
設定方式與注意事項：依照介面提供的選項選擇一種方法，並維持測試目標與網路不變，再比較既有項目。不同方法測出的數值不宜直接排序；測試逾時也不一定代表所有 App 請求都無法連線。應再以實際需要存取的目標進行驗證，並區分交握失敗、解析失敗與目標回應緩慢。不要反覆測試並將瞬間最低值視為穩定表現。
Today Widget：快速操作後確認狀態
功能說明與位置：Today Widget 提供系統元件中的快速入口。可在 Settings 確認相關選項，並透過系統提供的元件編輯介面新增元件；實際可用形式取決於裝置與系統顯示。
設定方式與注意事項：先在主 App 完成伺服器與路由選擇，再新增所需元件。透過元件執行操作後，可返回 Home 確認連線狀態與選取項目。系統元件可能有更新延遲，不要只根據元件中未更新的文字判斷目前連線狀態；若操作未生效，先開啟主 App 確認授權與狀態。
iCloud：同步範圍與裝置差異
功能說明與位置：iCloud 相關選項用於同步 App 支援範圍內的資料。在 Settings 確認 App 的同步選項時，也要檢查系統中的 iCloud 存取權限。App 購買記錄與設定同步屬於不同機制，不應混為一談。
設定方式與注意事項：先在原裝置確認同步狀態，再到另一部裝置檢查實際同步的項目；修改前請保留一份可還原的設定。不要假設所有本機歷史記錄、系統 VPN 授權與裝置狀態都會完整移轉。同步內容也可能包含私人伺服器資料，請妥善管理帳戶與裝置存取權限。新裝置首次連線時，仍須依照系統提示完成相應授權。
Diagnostics：透過對照記錄找出問題
功能說明：Diagnostics 是診斷功能的入口，用來查看或收集排查所需資訊。診斷的目的不是一次修改所有選項，而是將問題定位到本地網路、伺服器連線、網域解析或規則處理的其中一個層面。
位置與設定方式：從 Settings 查找 Diagnostics，使用目前介面提供的工具檢查連線或記錄。先記下失敗目標、網路類型、Global Routing 模式與已啟用的 Config，再重現一次問題。若診斷需要暫時啟用記錄，重現問題後請立即關閉，並檢查匯出內容是否包含敏感資料。
- 檢查基礎網路。確認裝置目前的網路是否可用，並區分整個網路無法使用與單一目標異常。
- 檢查伺服器。核對既有連線資料，使用 Connectivity Test，並記下測試方式，而不只是記錄數值。
- 檢查模式與規則。暫時使用 Proxy 與 Config 進行對照；若結果不同，再檢查規則命中情況與策略引用。
- 檢查解析。只有在網域解析異常時才檢查 DNS，避免將伺服器認證失敗歸因於解析問題。
- 還原測試變更。還原原本的模式、依需求連線條件與記錄設定，並保留一次只修改一項所得的結論。
注意事項：診斷記錄可能揭露存取網域、伺服器位址、訂閱參數或認證資訊。對外說明問題時，請保留錯誤類型與必要脈絡，並遮蔽私人欄位；不要公開完整設定或原始訂閱網址。工具輸出只是部分證據，應搭配實際請求與目前設定一併判斷。