OFFICIAL MANUAL / SETTINGS

Shadowrocket 設定與功能指南

先確認請求如何判定，再決定何時啟動連線。依序檢查 Global Routing、規則、伺服器、系統觸發條件與診斷設定，避免同時變更多項設定而失去排查依據。

Config / Proxy / Direct On Demand Data / Diagnostics

本篇適用於 iPhone 和 iPad，介面項目名稱保留英文。實際可用選項請以裝置上的 Shadowrocket 為準；系統需求請以 App Store 頁面標示為準。

01 / GLOBAL ROUTING

Config、Proxy、Direct 三種模式

功能說明：Global Routing 決定用戶端如何處理納入處理範圍的請求。Config 依目前設定的規則判定，Proxy 採用代理模式，Direct 則採用直連模式。這是請求判定方式，不是協定選擇器，也不是速度等級。切換至 Proxy 不會修正錯誤的伺服器密碼，切換至 Direct 也無法證明代理伺服器可用。

所在位置：在 Home 找到 Global Routing，進入後確認目前選取的是 Config、Proxy 或 Direct。連線開關與 Global Routing 是不同的控制項；看到開關已開啟，只能表示連線狀態有所變化，不能據此判定某個網域已套用預期策略。

模式與介面項目 判定方式 適用檢查情境 注意事項
設定 · Config 依目前生效設定中的規則處理請求。 日常規則分流，或確認特定請求的比對結果。 請確認設定已啟用，且規則順序與預設策略符合預期。
代理 · Proxy 以代理模式處理納入範圍的請求。 短時間確認故障是否與 Config 中的分流規則有關。 伺服器參數與連線仍須有效，也不代表所有系統通訊都由同一策略處理。
直連 · Direct 以直連模式處理納入範圍的請求。 確認目前網路的直連是否正常。 無法用來驗證代理連線，也不代表已關閉所有系統網路設定。

依序切換進行比對

  1. 記下目前的 Global Routing、選取的伺服器與生效設定，並確認可以還原原狀。
  2. 先在 Config 模式下重現具體問題，記錄目標網域與請求結果，不要只描述「無法上網」。
  3. 只切換至 Proxy，使用相同目標重新測試。若結果不同，再檢查規則比對結果與策略指向。
  4. 若要確認基礎網路狀況，再以 Direct 進行比對；完成後恢復原本的 Config，並重新測試。

注意事項：測試期間不要同時更換伺服器、修改 DNS 和重寫設定。否則即使狀況改善，也無法確認是哪項變更發揮作用。實際行為還會受到設定中的特殊處理、系統路由與目標連線方式影響；應搭配請求記錄判斷，不要將模式名稱解讀為絕對覆蓋所有流量的保證。

02 / RULE MATCHING

規則類型、順序與策略

功能說明：規則會將比對條件與處理策略連結起來。DOMAIN 用於比對指定網域，DOMAIN-SUFFIX 用於比對網域後綴及相關子網域，DOMAIN-KEYWORD 依網域中的關鍵字比對；IP-CIDR 與 IP-CIDR6 對應 IP 位址範圍，GEOIP 則依據 IP 位址歸屬資料判斷。USER-AGENT 需要請求中有可辨識的相關資訊，不應假設每個連線都符合這項條件。

所在位置：在 Config 中確認目前啟用的設定，再查看其中的規則內容。Home 中選取伺服器不代表已切換設定檔；編輯未生效的檔案，也不會改變目前請求的判定結果。檢查前請先確認檔案與 Global Routing 都符合預期。

先看條件，再看策略

PROXY 表示交由代理策略處理，DIRECT 表示直接連線至目標，REJECT 表示拒絕符合條件的請求。規則也可能指向設定中定義的策略群組，此時還要檢查群組內實際選取的項目。策略名稱不代表連線一定成功：即使比對到 PROXY，伺服器連線失敗仍會導致請求無法完成。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

以上為教學範例，並非可直接取代所有設定的完整設定檔。第一條網域規則適用於 example.com 及其子網域，GEOIP 規則用於判定相應的 IP 位址歸屬，FINAL 則為先前未比對到的請求提供預設策略。example.com 僅用來說明語法，不代表需要修改的實際目標。

設定方式：先保留設定副本，再將較具體的例外條件排在較廣泛的條件之前，最後檢查 FINAL。每次只新增一條用途明確的規則，儲存並確認設定生效後，再以對應目標進行驗證。若設定中已有同類規則，請先找出重複或更早比對到的項目，不要只在末尾不斷追加。

注意事項：規則通常依序判定，前面的比對結果會影響後續規則是否有機會執行。位址類規則可能涉及網域解析，解析結果與資料庫內容也會影響判定。REJECT 是拒絕請求，不是編輯頁面內容的功能；若誤擋登入、資源或 API 網域，可能導致頁面空白、圖片缺失或操作失敗。

進一步排查時，請將「規則未比對到」、「比對到錯誤策略」及「策略正確但連線失敗」拆開處理。這些問題涉及不同設定，不能一概靠新增網域規則解決。請參閱故障排除手冊，依症狀檢查實際請求路徑。

03 / SERVERS & SUBSCRIBE

既有訂閱與伺服器管理

功能說明：伺服器項目會儲存協定、位址、連接埠、驗證資訊與傳輸等參數；Subscribe 用於更新使用者既有訂閱中的項目。訂閱著重於項目來源與維護，Config 則著重於規則及相關設定，兩者不能直接畫上等號。匯入多個伺服器，不代表目前規則已變更，也不代表這些伺服器都能成功連線。

所在位置：在 Home 查看伺服器清單，透過 Add Server 新增使用者已有的伺服器資訊；匯入既有訂閱則使用 Subscribe 對應的入口。使用 Scan QR Code 前，請先確認 QR Code 來源可信。介面欄位會因協定而異，只填寫目前協定所需的內容，不要將其他協定的參數直接套用到同一表單。

匯入後確認四個項目

  1. 確認協定與伺服器位址。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的欄位定義各不相同，名稱相近不代表可以互換。
  2. 逐一確認連接埠、驗證資訊與傳輸參數；若伺服器要求 TLS 或指定名稱，請依使用者既有設定正確填寫。
  3. 選取一個項目執行 Connectivity Test，再進行實際請求測試。清單中顯示名稱只代表已匯入，不表示連線能力已確認。
  4. 記下項目來源與更新方式。需要保留的手動變更請先備份，避免下次 Subscribe 更新後難以還原。

設定方式：先匯入，再選取並測試，最後才調整規則。訂閱更新失敗時，先確認連結是否完整、目前網路能否連上來源，以及帳戶端的訂閱是否仍有效；更新成功後，請檢查實際項目是否有變動，不要只憑一次提示就認定所有設定都已完成。分享排查資料時，請遮蔽訂閱憑證、密碼與個人位址資訊。

注意事項：不要把更新訂閱當成解決所有連線問題的方法。伺服器逾時可能與參數、網路或伺服器狀態有關；反覆刪除後重新匯入，會失去有用的比對資訊。完整匯入步驟請參閱入門指南；正版取得管道與購買確認方式請參閱App Store 取得說明。

04 / ON DEMAND

On Demand 按需連線

功能說明：On Demand 會依已設定的條件觸發連線，處理「何時建立連線」的問題；Global Routing 與規則則處理「如何處理請求」的問題。啟用 On Demand 不會自動產生分流規則，也不會修正伺服器參數，因此請先確認手動連線正常，再進行設定。

所在位置：在 Settings 中尋找 On Demand，查看裝置實際提供的網路條件與對應動作。設定過程可能需要授權系統 VPN 設定；系統提示是確認寫入設定，不代表伺服器連線已通過檢查。若已有其他系統 VPN 設定，也請確認目前啟用的是預期的設定。

從單一觸發條件開始

  1. 先暫時停用按需觸發，手動建立連線，確認目前伺服器與 Config 都能如預期運作。
  2. 記下 On Demand 原有設定，只修改一項網路條件與動作；若使用 Wi-Fi 條件，請仔細確認網路名稱。
  3. 在情況允許時切換 Wi-Fi 與行動網路，觀察觸發結果，再確認請求是否依原定規則處理。
  4. 測試結束後記錄有效條件，避免多項彼此衝突的條件讓行為難以判斷。

注意事項：手動中斷連線後再次連上，可能是系統重新符合按需條件，不一定代表開關失效。若要停用自動觸發，請回到 On Demand 檢查相關設定，不要只反覆點擊 Home 的開關。需要網頁認證的 Wi-Fi，請先完成網路本身的認證，再判斷連線問題。裝置狀態、系統策略與網路變化都會影響觸發時機；不要將按需連線理解為每個 App 各自獨立的代理開關。

05 / DATA

Data 流量統計與觀察範圍

功能說明：Data 用來查看用戶端記錄的流量狀況，協助判斷測試期間是否有通訊，以及上傳、下載量是否變化。這不是連線服務帳戶的餘額頁面，也不能取代服務提供者的計費紀錄。統計數值只反映用戶端能記錄的範圍，不應直接視為裝置所有網路通訊的總量。

所在位置：進入 Data，先查看目前顯示的統計對象與範圍。不同裝置實際提供的明細可能不同，請以裝置上的標題與選項為準。若介面提供重設統計資料的操作，請先儲存需要的紀錄，再決定是否使用；重設本機數值不會改變外部服務的計費週期。

設定方式：進行固定目標測試前，先記錄 Data 中的初始狀態；只開啟需要檢查的頁面或 App，等待請求完成後再比較變化。盡量暫停背景下載與系統更新，否則流量增加可能來自其他工作。若要判斷特定目標使用哪項策略，還需要搭配請求記錄，不能只因總流量增加就認定流量經過 PROXY。

注意事項：上傳與下載的比例取決於實際使用情況，短時間內的變化無法說明伺服器速度是否穩定。協定額外負載、重試與統計方式也可能造成數值差異。排查耗電時，可將 Data 與系統電池、行動網路使用紀錄交叉比對；不要只因流量較大就判定用戶端異常，持續傳輸本身就會增加網路活動。

06 / SETTINGS

Settings 常用項目

Settings 集中管理部分 App 偏好設定，但不是所有設定的唯一來源。DNS 等設定也可能由目前的 Config 定義，檢查時應同時查看生效中的設定與相關介面。以下操作請以裝置實際顯示的入口為準；若沒有該選項，不要以名稱相近的項目取代，更不要在設定檔中猜測欄位。

DNS：分別檢查解析與路由

功能與位置：DNS 會將網域名稱解析為位址，相關設定需在 Settings 的對應入口與目前的 Config 中一併確認。解析成功不代表代理連線成功，解析失敗也不一定是伺服器驗證錯誤。網域規則與位址規則使用的資訊不同，因此變更 DNS 可能影響規則判定結果。

設定方式：先記錄原有設定，確認是所有網域異常還是只有個別網域異常，再檢查解析設定及其可連線性。一次只修改一處，儲存後以相同目標重新驗證；必要時重新建立連線，減少既有連線對觀察結果的干擾。注意：不要疊加多項來源不明的 DNS 變更，也不要把某個解析服務當成解決所有問題的通用答案。

Test Method：測試結果的解讀方式

功能與位置：在 Settings 中尋找 Test Method，確認連線測試採用的方法，接著可返回 Home 使用 Connectivity Test。不同測試方法檢查的網路環節可能不同；某種探測沒有回應，不一定表示實際使用中的請求都失敗。

設定方式：比較伺服器時，請使用相同的 Test Method、相同網路，並盡量在相近時間測試，再以實際目標驗證。注意：測試數值不代表吞吐量保證，測試值最低也不保證所有網站都會最快。變更方法只會改變觀察方式，不會替伺服器修正連接埠、密碼或傳輸設定。

Today Widget：快速操作與連線狀態

功能與位置：Today Widget 是快速操作相關設定，能否加入及如何顯示取決於裝置的系統支援。先在 Settings 確認對應選項，再透過系統提供的小工具管理入口操作；小工具入口無法取代 Home 中完整的設定檢查。

設定方式：加入後回到 App，確認目前伺服器與 Global Routing，再測試快速操作是否符合預期連線狀態。注意：小工具畫面可能有更新延遲；若顯示與實際情況不符，請以 App 內狀態和實際請求為準。若找不到對應選項，不要為了追求相同外觀而修改無關的網路設定。

iCloud：分別處理同步與復原

功能與位置：iCloud 相關選項用於 App 支援的資料同步或備份，可在 Settings 的對應入口及系統 iCloud 設定中確認。App 購買紀錄屬於 App Store 帳戶範圍，不代表設定資料已同步，兩者需要分別確認。

設定方式：先確認裝置登入的 iCloud 帳戶、系統權限與可用空間，再檢查 App 顯示的同步範圍。轉移前請保留本機副本，並在新裝置上逐項確認伺服器、Config 與選取狀態。注意：不要假設所有資料都會自動覆寫或立即同步；訂閱與驗證資訊屬於敏感內容，處理同步檔案時也應限制存取。

07 / DIAGNOSTICS

Diagnostics 與設定驗證順序

功能說明：Diagnostics 用於收集及查看排查資訊，協助將故障定位到解析、規則、伺服器連線或請求階段。診斷資訊是判斷依據，不是自動修復結果。請先確認具體症狀，再選用裝置提供的相關工具，不要一次啟用所有開關。

所在位置：在 Settings 中尋找 Diagnostics 或相應的診斷入口，並搭配 Home 的 Connectivity Test、Data 與可用的請求紀錄檢查。工具是否顯示及輸出內容，請以目前裝置上的介面為準。若需啟用額外紀錄，請只在排查期間使用；完成後恢復原設定，避免長期保留不必要的詳細資料。

每次故障保留一組可供比對的紀錄

  1. 記錄環境：註明使用 Wi-Fi 或行動網路、Global Routing、目前伺服器與 Config；不要記錄密碼等憑證。
  2. 檢查基礎網路：確認網路本身可以正常通訊；必要時確認 Wi-Fi 網頁認證已完成。
  3. 檢查伺服器：執行 Connectivity Test；若測試失敗，請確認協定、位址、連接埠、驗證資訊、傳輸參數與系統時間。
  4. 重現單一目標：對明確的網域發出請求，檢查解析是否成功、比對到哪條規則，以及實際採用的策略。
  5. 一次只變更一項：修改後以相同目標重新測試；若未改善就還原，避免殘留變更影響下一步判斷。

注意事項：逾時只表示請求未能在等待時間內完成，無法直接指出是哪一端發生問題。若只有個別目標失敗，請優先檢查目標與規則；若所有目標都異常，再進一步檢查基礎連線與共用設定。提交診斷資料前，請遮蔽訂閱連結中的憑證、伺服器驗證資訊、個人網域及可識別使用活動的內容，只保留與症狀相關的最少資料。