使用指南・功能介紹
Shadowrocket 功能與常用設定
先分清流量的處理方式，再設定何時建立連線。本頁依介面入口說明各項功能，並提供調整順序與檢查方法。
- Global Routing
- 規則與策略
- On Demand
- Data 與 Diagnostics
操作說明以 iPhone、iPad 上的 Shadowrocket 為主，並假設您已有自己的訂閱或伺服器資訊。系統需求以 App Store 頁面標示為準。若尚未完成首次連線，請先閱讀入門指南，再依本頁逐項調整。
流量處理入口
Global Routing：Config、Proxy、Direct
Global Routing 決定 Shadowrocket 接管的連線要如何處理。這項設定與連線開關不同：開關用來建立或結束連線，Global Routing 則用來選擇處理模式。請先在 Home 找到 Global Routing，再依需求選擇 Config、Proxy 或 Direct。
Config 模式依目前設定檔中的規則分配策略，適合日常依網域或位址分流。Proxy 模式適合暫時檢查所選伺服器的連線能力。Direct 模式適合確認不經代理伺服器時的連線狀況。使用後兩種模式對照時，請保持目標網站與測試網路一致。
| 介面名稱與模式 | 處理依據 | 適用情境 | 檢查重點 |
|---|---|---|---|
| Config・設定檔 | 依目前設定檔中的規則選擇策略。 | 日常連線需要同時使用 DIRECT、PROXY 等策略時。 | 確認啟用的設定檔、規則順序與最終策略。 |
| Proxy・代理 | 由 Proxy 模式處理接管的連線。 | 暫時確認所選伺服器能否連線至目標。 | 確認預設伺服器、伺服器參數與測試目標。 |
| Direct・直連 | 由 Direct 模式處理接管的連線。 | 檢查本機網路，或與代理連線路徑進行比較。 | 仍須檢查 DNS 解析環境；這不等於關閉連線開關。 |
設定與還原
開啟 Global Routing 並選擇所需模式，返回 Home 確認目前設定，再使用相同目標進行連線測試。若 Proxy 可用但 Config 結果不如預期，請優先檢查規則與策略的設定，不要立刻重新匯入所有伺服器。暫時測試結束後，請還原原本模式，避免將診斷設定留作日常使用。
切換模式時，已建立的連線可能仍沿用原本路徑。請重新發出目標請求後再判斷結果。如需重新連線，請先儲存進行中的工作，以免傳輸中斷。
比對條件與執行結果
規則分流：規則類型與策略
規則用來描述符合條件的連線，策略則決定符合規則後如何處理。請進入 Config，確認目前使用的設定檔，再檢視或編輯其中的規則。了解目前使用的設定檔，才能判斷某次連線為何被分配至 DIRECT、PROXY 或 REJECT。
常見規則會依設定檔中的排列順序比對。較具體的條件通常排在較廣泛的條件之前，FINAL 則放在末尾作為最終處理。修改前請保留原設定，每次只調整一組相關規則，再觀察目標請求的比對結果。
| 規則類型 | 比對內容 | 使用注意事項 |
|---|---|---|
DOMAIN | 指定的完整網域。 | 適用於範圍明確的單一網域。 |
DOMAIN-SUFFIX | 網域本身及其子網域。 | 涵蓋範圍比單一 DOMAIN 更廣。 |
DOMAIN-KEYWORD | 網域中包含的關鍵字。 | 比對範圍容易擴大，修改後請檢查是否誤判。 |
GEOIP | 目標 IP 的地理區域分類。 | 結果會受解析出的位址與使用的資料影響。 |
IP-CIDR / IP-CIDR6 | IPv4 / IPv6 位址範圍。 | 確認位址族與前綴長度。 |
FINAL | 未符合前面規則的連線。 | 需要明確指定最終策略。 |
策略與規則範例
DIRECT 表示直連處理，PROXY 表示代理處理，REJECT 表示拒絕連線。若設定檔使用命名策略群組，也要檢查群組中的目前選項。規則指向 PROXY，並不能單獨證明預設伺服器已選正確。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY這段文字僅用來說明規則結構：example.com 及其子網域會先符合第一條規則，接著檢查 GEOIP，其餘連線則交由 FINAL 處理。這不是適用於所有網路的完整設定。造訪網域時可能同時要求多項資源，排查時應查看實際請求的網域，而不只看瀏覽器網址列。
匯入與整理現有資訊
訂閱與伺服器管理
伺服器項目會儲存連線至遠端所需的參數；Subscribe 則可透過已有的訂閱連結管理一組項目。常用入口位於 Home 的新增流程。手動輸入時，請進入 Add Server，先選擇正確的 Type，再依自己的伺服器資料填寫位址、連接埠與驗證資訊。
匯入後先確認，再連線
已有的訂閱可透過 Subscribe 匯入；已有的 QR code 可使用 Scan QR Code。從剪貼簿匯入前，請確認複製的是完整資訊，而非說明文字或遭截斷的位址。匯入成功只表示客戶端能讀取內容，不代表伺服器目前可連線，也不代表每筆資料都適用於目前的網路。
返回 Home 後，請檢查項目名稱與協定類型，選取預計使用的伺服器，再執行 Connectivity Test。手動新增的項目應逐一確認連接埠、驗證欄位，以及資料中要求的 TLS 或傳輸參數。不要因為欄位名稱相似，就將不同協定的欄位混用。
更新、整理與備份
更新訂閱會重新取得遠端提供的內容。更新可能新增、移除或改寫項目，因此重要的手動修改不宜只保存在訂閱產生的記錄中。管理多個訂閱時，請使用容易辨識用途的名稱；清理前先確認預設伺服器是否屬於即將移除的群組。
延遲測試適合用來初步篩選目前網路環境下的項目，並非速度或穩定性的永久排名。刪除項目或設定檔前，請先使用 App 提供的匯出或備份功能保留必要資訊。備份可能包含驗證資料，請限制存取權限。完整操作請見伺服器管理手冊。
連線觸發條件
On Demand 按需連線
On Demand 會依條件決定何時觸發連線。它處理的是連線時機，不會取代 Global Routing，也不會取代 Config 中的分流規則。請先確認手動連線與目標連線正常，再進入 Settings 中 On Demand 相關設定的入口設定條件。
從單一情境開始設定
先記下希望在哪一種網路環境下連線，再依介面提供的 Wi-Fi、行動網路或網域條件建立規則。若要依 Wi-Fi 名稱區分，請確認網路名稱完整無誤。先建立一條容易驗證的條件，儲存後切換至對應網路，觀察系統連線狀態與實際連線結果。
若要新增第二條條件，請先確認它是否與既有條件重疊。網路切換、裝置休眠後喚醒，以及 App 重新發出請求，都可能使觀察結果不同於單次手動操作。不要只憑一次狀態變化就判斷條件是否有效。
留意持續觸發與停止方式
啟用 On Demand 後，手動結束連線可能會在條件再次符合時重新觸發。若要暫停自動連線，請先檢查 On Demand 狀態，不要反覆切換 Home 開關。排查失敗原因時，先暫時停用按需條件，以手動連線作為對照，再逐項恢復條件。
按需連線會影響背景網路行為。測試期間請記錄原有條件，確認預期與實際結果一致後再長期使用。情境說明請見On Demand 設定說明。
觀察流量變化
Data 流量統計
Data 可查看 App 記錄的流量資訊。進入 Data 後，先確認目前顯示的統計範圍與計算期間，再比較上傳、下載及相關分類。它適合用來確認「測試期間是否有產生流量」，但無法單獨判斷「目標連線是否成功」。
固定條件後再比較
開始測試前先記錄目前統計值，暫時減少其他 App 的背景活動，再只執行一項明確操作，例如重新載入目標頁面。完成後返回 Data 查看變化。若介面提供重設功能，操作前請確認是否需要保留舊記錄；清除統計資料不會同時修復連線問題。
背景同步、圖片載入與失敗後重試都可能產生流量。數字增加不代表所有內容都已載入，數字很小也不代表規則沒有生效。請一併參考統計變化、連線結果、連線記錄與測試時間。
與計費方式分開看待
Data 的記錄範圍可能與系統或您的服務供應商不同。協定額外負載、統計週期與連線涵蓋範圍都會影響比較結果。Data 是客戶端的觀察工具，不應直接作為帳單依據。若要檢查異常用量，請先限定時間範圍，再找出具體活動，避免只根據累計總量推斷單次連線狀況。
常用項目逐一說明
Settings：解析、測試與輔助工具
Settings 集中提供連線相關選項與輔助功能。部分網路行為也會受目前 Config 影響。變更前請確認設定屬於全域選項還是設定檔，並記錄原始值。可用選項以裝置上實際顯示為準。
DNS：網域解析
DNS 會將網域解析為連線所需的位址。在 Settings 檢查 DNS 相關選項時，也請確認目前設定檔中的 DNS 區段，避免只修改一處就以為所有請求都會使用新值。選擇系統解析、自訂解析或 DNS over HTTPS 時，應依目前網路需求決定，不要預設某種方式一定更快。
設定時一次只調整一個解析來源或相關選項，儲存後重新連線至同一網域。若伺服器測試通過，但網域連線異常，請優先檢查解析結果、解析路徑與網域規則。詳細選擇方式請見Shadowrocket DNS 設定說明。
Test Method：測試方式
Test Method 決定相關連線能力或延遲測試所採用的方式。在 Settings 查看目前設定，再執行 Home 中對應的測試。選擇方式時，請考量自己的伺服器與目前網路是否支援該測試所需的連線方式。
比較多個項目時，請保持 Test Method 與網路環境一致。某種測試失敗，可能是測試目標或測試方式受到限制，不應直接解讀為所有實際連線都無法使用。測試顯示的耗時也不等於檔案下載速度，仍須驗證實際目標。
Today Widget：快速入口
Today Widget 可透過系統提供的小工具入口查看資訊或執行快速操作。先在 Settings 檢查 Today Widget 相關選項，再依裝置系統提供的方式加入可用的小工具。實際顯示內容與可執行操作，取決於裝置支援情況。
設定完成後，返回 Home 確認預設伺服器與目前狀態，再試用快速操作。快速入口可減少操作步驟，但無法取代首次設定，也無法證明目前規則已符合條件。若小工具資訊未即時更新，請開啟 App 確認實際狀態。
iCloud 同步：在不同裝置間保留設定
iCloud 同步可在支援範圍內同步 App 資料。請先確認裝置已登入自己的 iCloud 帳號，並允許 Shadowrocket 使用相關功能，再檢查 Settings 中的同步選項。請依介面說明確認同步內容，不要假設所有項目、統計資料與憑證都會完整轉移。
首次啟用前，請分別保留兩台裝置上的重要設定。同步後檢查設定檔名稱、預設伺服器與連線結果，不要立即刪除原裝置上的資料。同步不能取代獨立備份；若要還原誤修改，應事先保存設定檔副本。
Diagnostics：診斷資訊
Diagnostics 可檢查網路相關狀態並蒐集排查線索。在 Settings 的相關入口開啟診斷工具前，先確認要檢查的是解析、伺服器連線還是規則結果，再執行介面提供的檢查。診斷前記下網路類型、目前模式與所選伺服器，以便重現相同條件。
診斷結果需要與實際請求交叉比對。分享記錄前，請檢查是否包含訂閱網址、驗證資訊、裝置資訊或造訪的網域，只保留必要內容。請勿為排查問題而公開整份設定或完整訂閱內容。
從已知狀態找出變化
功能設定的檢查順序
同時變更多個選項，會讓問題原因難以判斷。先建立可重複的基準，再逐項加入規則、解析與按需條件。每一步記錄變更內容與測試結果，通常比反覆清除設定更有效。
- 確認伺服器資訊。在 Home 確認已選取的項目，檢查現有資料是否完整，執行 Connectivity Test，並實際測試一次連線。
- 確認 Global Routing。記錄目前模式。需要對照時，暫時切換至 Proxy 或 Direct，並使用相同目標重新發出請求。
- 確認 Config。檢查已啟用的設定檔、規則順序、策略指向與 FINAL，避免編輯到未啟用的副本。
- 確認 DNS。核對解析相關選項與設定檔內容。一次只修改一項，並觀察目標網域的新請求。
- 最後恢復 On Demand。手動連線穩定後再啟用自動條件，並測試網路切換。搭配 Data 與 Diagnostics 判斷結果。
若變更後出現異常，請先還原上一步記錄的原始值。訂閱匯入與項目維護的詳細步驟請見伺服器管理；從匯入到首次驗證的完整流程請見入門指南。