官方手冊 · 功能與設定
先確認流量要如何處理，再檢查規則、伺服器與連線條件。設定是否合適，應以實際請求的比對結果為準，而非只看連線開關。
本文以 iPhone / iPad 的操作為主。介面入口與可選項目請以裝置上顯示的英文名稱為準；系統需求以 App Store 頁面標示為準。
流量處理入口
Config、Proxy、Direct 決定目前採用的整體處理方式。設定檔中有規則，不代表目前流量一定會依規則處理。
功能說明：Global Routing 是選擇路由方式的入口。Config 會使用目前啟用的設定規則；Proxy 會將需要由客戶端處理的流量交由所選代理策略；Direct 則採用直連方式。這裡的 Proxy、Direct 是介面選項，規則行中的 PROXY、DIRECT 則是策略關鍵字，兩者作用的層級不同。
位置與設定方式：在 Home 找到 Global Routing，進入後選擇一種模式，再返回確認目前的伺服器與連線狀態。初次使用時，先確認已有伺服器可以連線；準備日常分流時，再切換至 Config，並核對 Config 頁面目前啟用的檔案。不要只匯入檔案，就認定設定已生效。
| 介面選項 | 處理依據 | 適用情境 | 檢查重點 |
|---|---|---|---|
| Config（設定檔） | 目前設定檔中的規則及對應策略 | 日常使用時，依網域、位址等條件分流 | 檔案是否已啟用、規則順序與最後比對到的策略 |
| Proxy（代理） | 目前選取的代理伺服器或策略 | 暫時排查代理路徑，減少分流規則的干擾 | 伺服器參數、認證資訊與目標請求的連線狀況 |
| Direct（直連） | 目前網路的直接連線路徑 | 比較原始網路狀況，檢查本地網路是否可用 | 本地網路與 DNS；無法用來驗證代理是否可用 |
注意事項：切換模式後，已建立的長連線可能仍維持原有連線狀態。驗證時應重新發出請求，必要時關閉並重新開啟測試 App。Proxy 適合用於對照測試，但不能因此認定 Config 中的每條規則都正確；Direct 下可正常存取，也只能表示目前的直連路徑在該次測試中可用。
分清條件與策略
規則先描述「比對哪些內容」，再指定「如何處理」。使用 Config 時，規則順序與策略名稱都需要檢查。
功能說明：規則分流會根據請求的網域、目標位址等資訊選擇處理策略。DOMAIN 比對指定網域，DOMAIN-SUFFIX 比對網域後綴，DOMAIN-KEYWORD 檢查網域中的關鍵字；IP-CIDR 與 IP-CIDR6 用於比對位址網段，GEOIP 則依據位址歸屬資料判斷。不同規則仰賴的資訊各異，網域解析結果也可能影響位址類規則的比對。
位置與設定方式：在 Config 進入目前設定檔的編輯入口，檢查 [Rule] 區段。通常應將較具體的條件放在前面，預設處理規則放在後面。DIRECT 表示直連，PROXY 表示交由代理策略處理，REJECT 表示拒絕；若使用自訂策略名稱，也要確認該名稱在目前設定檔中有效。
規則語法範例 · 非完整設定檔
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY範例先比對指定網域後綴，再處理一個區域網路位址網段；若前面的規則都未比對成功，則由 FINAL 決定後續處理方式。
注意事項：規則會依序檢查，前面的寬泛條件可能會遮蔽後面的具體條件。FINAL 用於處理前面的規則都未比對成功的情況，不宜放在仍需要繼續比對的規則之前。USER-AGENT 等條件也取決於客戶端能取得的請求資訊，不能假定適用於所有流量。調整後可到 Data 查看實際比對結果，比只閱讀規則文字更容易找出順序問題。
設定檔若包含 DNS、Host 或其他區段，應一併了解它們對請求的影響。不要為了解決單一網頁問題就一次更換整套設定檔；先備份目前檔案，只修改相關規則，再對同一個目標發出請求進行比較。
連線資料與設定檔
伺服器記錄負責保存連線參數，設定檔則負責規則等行為。更新訂閱與切換設定檔是兩種不同的操作。
功能說明：伺服器記錄會保存位址、連接埠、協定、認證及相關連線參數；Subscribe 用於管理使用者已有的訂閱。Shadowrocket 支援多種協定，例如 Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2，以及 HTTP、SOCKS5。協定名稱只是設定欄位的一部分，同一協定的傳輸、TLS 與認證設定也必須符合既有伺服器資訊。
位置與設定方式：從 Home 的新增入口進入 Add Server。已有訂閱時選擇 Subscribe，填入自己的訂閱網址及方便辨識的備註；只有單一伺服器資料時，選擇對應協定並逐項輸入。已有 QR Code 可使用 Scan QR Code；從剪貼簿匯入前，請確認內容確實是準備新增的連線資料。
匯入後先確認清單中是否出現預期項目，再檢查協定、位址、連接埠及必要的安全設定。接著選取一個項目進行 Connectivity Test，並發出實際請求。測試有回應，只表示在相應測試條件下取得結果，不代表認證、DNS、規則及目標服務都正常。
注意事項：更新訂閱可能會變更伺服器名稱、數量或參數，手動修改過的訂閱項目也可能被後續內容覆蓋。建議將手動記錄與訂閱分開命名，更新前保留必要備份，更新後重新檢查目前選取的項目。不要在截圖或討論中公開失敗的訂閱網址、QR Code 或完整連線連結，其中可能包含存取憑證。
訂閱與規則設定應分別核對：更新伺服器清單，不一定會改變 Config 中的規則；切換 Config，也不代表伺服器資料已更新。多筆訂閱的整理、分享、備份及刪除步驟，請參閱訂閱與伺服器管理手冊。
依網路條件管理連線
On Demand 控制何時嘗試建立連線，Global Routing 則控制連線後如何處理流量。兩者不能互相取代。
功能說明：On Demand 會根據設定的網路條件配合系統觸發連線，可減少在不同網路間切換時的手動操作。它不保證伺服器可用，也不是分流規則；觸發連線後，請求仍會依目前的 Global Routing 與設定檔處理。
位置與設定方式：進入 Settings 中的 On Demand，先閱讀裝置目前提供的條件選項。初次設定建議只啟用一個容易驗證的情境，例如針對目前的 Wi-Fi 環境設定連線行為。儲存後離開設定頁，實際切換一次網路，再檢查系統連線狀態與 Shadowrocket 目前的狀態；確認行為符合預期後，再增加條件。
注意事項：啟用 On Demand 後，系統可能在符合條件時重新觸發連線，因此手動中斷後再次顯示連線狀態，不一定代表開關失效。排查這類情況時，先檢查 On Demand 條件。若要暫時停用自動連線，應調整按需條件，並在切換 Wi-Fi 或行動網路後再次確認；不要只觀察一次手動關閉的結果。
若測試環境中有其他網路設定，先記錄目前狀態，再逐項排除干擾。每次只變更一個條件，並保留可還原的設定，才能判斷變化是來自 On Demand、本地網路還是伺服器連線。
從結果回頭檢查設定
Data 可用於查看客戶端處理的連線與流量。排查故障時，目標請求的詳細資料通常比累計數字更有參考價值。
功能說明：Data 提供流量與連線記錄等查看入口，可用於核對請求目標、處理策略及相關連線資訊。它反映的是客戶端能記錄到的資料，不能直接視為服務商帳單，也不能只憑單一統計數字判斷某個 App 的所有網路活動。
位置與設定方式：開啟 Data，先查看目前可用的統計範圍與記錄入口。若要驗證規則，先記下測試時間，再只開啟一個目標頁面；返回 Data 找到對應請求，查看目標網域或位址，以及顯示的策略資訊。若要比較兩種 Global Routing 模式，請分別重新發出請求並保留各自結果，避免將舊記錄當成新測試。
注意事項：一個頁面可能同時存取多個網域，同一個 App 也可能保留背景連線。只看到主網域使用 PROXY，不能據此認定頁面中的所有資源都經由同一路徑。統計週期、記錄保留範圍與快取也會影響觀察結果；清除前，先確認是否仍需要這些排查資訊。
需要分享記錄時，只保留與問題相關的項目，並遮蔽訂閱網址、認證欄位及其他個人資訊。描述問題時應包含使用的模式、網路類型、測試目標與發生步驟，不要直接公開完整設定檔。
逐項檢查常用功能
以下功能請依用途分別設定。若目前裝置沒有顯示某個入口，請以裝置上的實際介面為準，不要套用其他環境的開關狀態。
功能與位置：DNS 會將網域名稱解析為位址。檢查時，既要查看 Settings 中與 DNS 有關的選項，也要確認目前 Config 是否包含 DNS 設定；不能只看其中一處就推斷最終行為。
設定方式與注意事項：先記錄目前設定值，再核對解析方式及所填伺服器能否從目前網路存取。若出現「測試有回應、網頁卻無法開啟」，應分別檢查網域是否能解析、解析出的位址是否合理，以及 DNS 請求本身採用哪種路徑。不要同時更換解析方式、規則與伺服器；先還原已知可用的設定，再逐項比較。更多步驟請參閱DNS 解析失敗排查。
功能與位置：Test Method 用來設定相關連線測試採用的方法，可在 Settings 中查看目前選項。不同方法涉及的網路環節不同，顯示的結果也不能直接混為一談。
設定方式與注意事項：比較伺服器前，先使用相同的 Test Method，並維持相同的本地網路。若選用的方法需要測試目標，也要核對目標設定。測試失敗可能與目標或協定回應有關，不必立即刪除伺服器；某次測試速度較快，也不代表大型檔案傳輸一定更快。最後仍須透過實際請求確認是否符合用途。
功能與位置：Today Widget 可設定系統小工具相關的快速操作或狀態顯示，可從 Settings 中的對應入口查看。系統允許的小工具顯示位置與互動方式，請以目前裝置實際可加入的小工具為準。
設定方式與注意事項：先在 App 中選好伺服器並確認首次連線，再前往系統的小工具管理入口加入可用的小工具。操作後返回 Home 核對實際連線狀態。若顯示未即時更新，不要只憑小工具外觀判斷已中斷或連線成功，也不必反覆切換，以免測試狀態混亂。
功能與位置：iCloud 相關選項用於在裝置間儲存或同步資料。進入 Settings 中的對應入口，閱讀目前版本顯示的項目與操作說明，分清同步、匯入與還原各自處理的內容。
設定方式與注意事項：先確認裝置的 iCloud 狀態，再備份需要保留的設定檔與記錄，最後啟用或執行相應操作。在另一台裝置上確認結果時，請逐項檢查 Config 與伺服器資料，不要假定所有內容都已完整同步。同步也不等於還原購買記錄，App 仍須透過 App Store 取得；覆蓋或刪除前，請先確認操作影響範圍。
功能與位置：Diagnostics 是診斷相關入口，可在 Settings 中查看裝置目前提供的工具及輸出。診斷結果用於蒐集線索，不能取代伺服器參數與設定檔的核對。
設定方式與注意事項：先用最少步驟重現問題，再執行與故障相關的檢查，依序判斷本地網路、DNS、伺服器連線、規則比對及目標回應。記錄問題發生在哪一層，不要只保留最後一行錯誤提示。匯出前檢查內容是否包含憑證或個人資訊，並保留修改前後的結果以供比較。
完成設定後進行驗證
分別檢查「是否已連線」、「是否完成解析」、「是否比對到規則」及「目標是否有回應」，避免用一次測試結果代替對整條路徑的判斷。
首次匯入至連線驗證的完整操作，請參閱入門指南；整理多筆既有訂閱、更新與備份，請參閱伺服器管理。App 僅於 Apple 平台發行，唯一取得管道為 App Store；購買、相容性與系統需求以 App Store 頁面標示為準。