官方手冊 · 功能與設定
Shadowrocket 代理模式 與常用設定
先確認請求的處理方式,再調整規則、連線與診斷選項。Global Routing 決定整體處理方式,Config 決定規則細節,伺服器資訊則決定實際連線目標。
Shadowrocket 是僅於 Apple 平台透過 App Store 發行的付費閉源商業 App。本頁主要說明 iPhone 與 iPad 上的操作;系統需求以 App Store 頁面標示為準。
Global Routing
規則分流
訂閱與伺服器
On Demand
Data
Settings
設定檢查順序
修改前先記錄目前狀態
本頁以使用者已有自己的訂閱或伺服器資訊為前提。一次買斷用戶端 ≠ 線路方案。開始調整前,記下目前的伺服器、Global Routing 選項及正在使用的 Config;每次只調整一類設定,方便比較與還原。
功能與設定位置
Global Routing 是選擇整體路由方式的入口,通常可從 Home 進入。本文將三種常見方式稱為設定檔、代理、直連;介面選項則維持 Config 、Proxy 、Direct 。切換此選項不會替你填入伺服器位址,也不會讓失效的認證資訊恢復有效;它決定的是「如何處理請求」,而不是「連線資訊從何而來」。
選項中的 Config 與底部的 Config 頁面有關,但用途不同:前者表示依目前設定檔處理流量,後者用於管理及編輯設定檔。只儲存規則檔案,不代表目前連線已依該檔案分流;還須確認選用的檔案及 Global Routing 狀態。
切換與比較方式
先在 Home 確認所選伺服器,再進入 Global Routing 選擇需要的方式。比較時使用同一個目標與同一類請求,必要時重新建立連線,避免沿用舊連線影響觀察。若 Proxy 可用、Config 卻異常,接著應檢查規則命中狀況與策略選擇;若兩者都異常,應檢查伺服器資訊、本地網路與 DNS,而非反覆更換規則。
Direct 適合用來比較連線路徑,但不代表所有網路相關設定都已關閉。DNS、既有連線及系統行為仍可能影響結果。臨時測試完成後,請還原原先預定使用的方式,並檢查連線開關;不要將測試狀態長期保留在日常設定中。
在 Config 檢查目前設定檔
規則分流可讓不同請求採用不同的處理方式。進入 Config ,確認目前使用的檔案,再查看其中的規則與策略。通常會依序比對,由第一條符合的規則決定該請求的處理方式;因此,若範圍較廣的規則排得太前面,後續更精確的規則可能無法生效。調整前先儲存原設定,接著只移動或修改與問題目標相關的少數規則。
DOMAIN 比對指定網域;DOMAIN-SUFFIX 比對網域後綴及其子網域;DOMAIN-KEYWORD 依網域中的關鍵字比對,涵蓋範圍可能比預期更廣。IP-CIDR 與 IP-CIDR6 分別表示位址網段;GEOIP 依位址歸屬資料庫判斷,與服務的註冊地或使用語言並不相同。涉及網域與位址轉換時,也須考量 DNS 解析結果。
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
以上僅為語法閱讀範例,並非完整設定檔。PROXY 表示交由代理處理,DIRECT 表示直接連線,REJECT 表示拒絕;若規則引用自訂策略名稱,該策略必須存在於目前設定檔中。FINAL 是前述條件皆未符合時的預設規則,須確認其位置與目標策略。
留意比對條件的適用範圍
USER-AGENT 取決於請求中可供比對的資訊,不能假設每個請求都含有相同的可見欄位。不要只憑規則名稱判斷它必定生效。請求結果不如預期時,先查看可用的連線記錄,確認目標網域、位址及使用的策略;確認 Global Routing 設為 Config 後,再檢查規則順序與引用關係。規則只能決定連線路徑,無法修復目標服務本身的錯誤。
遠端規則與訂閱伺服器是兩種不同的內容。更新伺服器清單,不代表規則也會一併更新;更換設定檔也可能改變策略名稱。若要有系統地整理設定檔之間的關係,請參閱訂閱與伺服器管理手冊 ,先清楚記錄來源與用途,再進行批次調整。
Subscribe:匯入現有訂閱
在 Home 點選新增入口進入 Add Server,選擇 Subscribe,並貼上自己已有的訂閱連結。儲存後執行更新,確認是否新增伺服器項目,再選擇實際要使用的項目。訂閱連結與單一伺服器分享連結並非同一種內容;若匯入結果異常,先確認填寫入口是否與內容類型相符,再檢查連結是否完整。
為多個訂閱加上容易辨識用途的備註,避免只依排序位置選取。更新時會依遠端傳回的內容調整項目,手動修改的名稱或參數可能在下次更新時被覆蓋。更新前記下目前選取的項目,更新後再次確認;不要把「更新完成」當成所有伺服器都能正常連線的證明。
Add Server:手動確認欄位
已有獨立伺服器資訊時,請在 Add Server 選擇相應的 Type,再填寫位址、連接埠及該協定要求的認證欄位。Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 等協定的參數並不通用;請依現有資料逐項填寫,不要只更改 Type,就沿用上一組內容。
若資料包含 TLS、伺服器名稱或傳輸相關欄位,請保持與伺服器端設定一致。儲存成功只代表本機已建立項目,不代表認證與連線都已通過。先執行 Connectivity Test,再實際連線至目標;若發生問題,保留原始資料以供比對,避免同時嘗試修改多個欄位。
掃描 QR Code、剪貼簿與多訂閱整理
使用 Scan QR Code 或從剪貼簿匯入前,請確認內容來自自己已有的伺服器資料。匯入後檢查協定、位址、連接埠與備註;成功辨識 QR Code 不代表參數一定完整。訂閱連結、分享內容與設定備份可能包含認證資訊,不應放入公開截圖或診斷說明;展示問題時僅保留必要的欄位名稱。
整理多個訂閱時,先依用途分類,再進行測試與排序。刪除訂閱前,確認操作會影響哪些相關項目,並儲存仍需保留的個人設定。訂閱更新與 App Store App 更新的作用不同:前者更新伺服器資料,後者更新用戶端,兩者不能互相取代。
04 · 條件觸發連線
On Demand 按需連線
先建立可重複的手動連線,再設定自動觸發條件。
功能與設定方式
On Demand 可依已設定的條件觸發 VPN 連線。它決定何時建立連線;Global Routing 與 Config 則負責連線建立後如何處理請求。可在 Settings 中尋找 On Demand 相關設定,實際可用條件以目前 App 介面為準。先確認希望在哪類網路環境下觸發,再啟用相應條件;不要為了自動連線而一次開啟所有選項。
設定前,先手動選擇伺服器、確認 Global Routing,並完成一次實際連線驗證。接著設定 On Demand,在切換 Wi-Fi 或行動網路後,觀察系統與 App 內的連線狀態是否符合預期。測試時也應記錄目前的網路條件,避免將伺服器暫時無法使用,誤判為觸發條件未生效。
留意中斷後的自動行為
啟用按需連線後,手動中斷不一定代表連線會持續保持中斷;條件再次符合時,系統可能重新發起連線。若遇到「中斷後又重新連線」,先查看 On Demand,而不是反覆刪除設定。若要暫停自動連線,先關閉相應條件,再觀察一次完整的網路切換過程。
On Demand 不會判斷所有網站是否可用,也不保證伺服器持續在線。其運作仍受系統排程、網路環境與有效設定影響。調整規則或伺服器時,可暫時停用自動觸發,避免自動重新連線干擾比較;驗證完成後再恢復原有條件。
查看位置與數值變化的判讀方式
進入 Data 查看目前介面提供的流量統計,先確認統計對象、時間範圍與重設狀態,再比較數值變化。不同統計項目可能採用不同計算方式,不能將單次連線、特定伺服器與裝置整體網路用量直接畫上等號。系統網路、傳輸額外負載及外部服務的計量方式也可能造成差異。
若要確認某次操作是否產生流量,先記錄起始狀態,再執行一項明確的連線操作,最後返回 Data 查看變化。測試期間盡量減少其他 App 的背景活動。累計用量不是速度測試結果:數值增加只表示記錄範圍內有資料傳輸,不能據此判斷頻寬、回應品質,或所有請求是否都依預期分流。
重設與排查注意事項
若介面提供重設功能,先儲存需要比較的記錄,再執行重設;不要把清除統計資料當成修復網路的方法。若流量持續增加但目標頁面無法開啟,仍須檢查請求是否套用正確策略、DNS 是否解析成功,以及伺服器能否連線至目標。反之,統計沒有明顯變化,也可能是觀察範圍或既有快取所致,不能單憑此點判定連線失敗。
DNS:先確認解析路徑
DNS 負責將網域解析為位址。進入 Settings 查看 DNS 相關項目,同時檢查目前 Config 是否另有 DNS 設定,避免只修改一處而忽略另一處的影響。開始時先保留目前可正常運作的設定;只有在明確遇到解析失敗、回傳位址異常,或需要指定解析路徑時,再調整相關項目。
自訂 DNS 或 DNS over HTTPS 都需要可連線的解析服務,並非在所有網路環境下都比系統 DNS 更合適。修改時一次只變更一個項目,重新建立連線並存取同一目標,再依解析記錄判斷是否改善。使用 DoH 不代表所有請求都會自動經由代理;解析路徑與目標連線路徑應分別確認。
Test Method:統一測試條件
在 Settings 找到 Test Method ,選擇目前介面提供且適用於現有網路的測試方式,再返回 Home 使用 Connectivity Test 。不同方法檢查的層面不同,測得的時間也不能直接跨方法比較。若測試需要指定目標位址,先確認該目標本身可連線,再比較伺服器之間的差異。
測試通過不代表所有服務都能存取;測試逾時也不能直接證明整條連線完全無法使用。比較多個伺服器時,應維持測試方法、目標與本地網路一致,並搭配實際請求判斷。排序僅反映當下的測試結果,不代表長期品質。
Today Widget:快速入口與狀態檢視
Today Widget 相關選項可設定系統提供的快速檢視或操作入口。先在 Settings 檢查 App 支援的項目,再依系統允許的位置加入。可用形式會受系統環境影響,請以實際顯示為準;不要將某種系統版面視為所有裝置都固定具備的介面。
快速入口可減少重複開啟 App 的步驟,但設定後應返回 Home 確認伺服器、Global Routing 與連線狀態。若快速入口顯示與 App 內狀態暫時不同,先開啟 App 重新確認,不要直接修改伺服器參數。連線是否建立,以及目標請求是否正常,仍須分別驗證。
iCloud:同步範圍與還原順序
在 Settings 查看 iCloud 相關同步或備份選項,先確認目前介面標示的同步對象,再決定是否啟用。同步設定不等於還原購買記錄;App 的取得與已購項目還原仍須透過 App Store 完成。不同裝置的系統權限與目前連線狀態,也不應假設會隨檔案一併完整複製。
啟用前先儲存本機現有設定,尤其是兩部裝置都曾修改過設定時。還原後逐項確認訂閱、伺服器選擇與目前 Config,再手動驗證連線。包含訂閱連結或認證欄位的內容應視為敏感資料妥善管理;同步的便利性不能取代對備份範圍與內容的檢查。
Diagnostics:針對單一問題蒐集線索
Diagnostics 可檢視或執行目前 App 提供的診斷項目,可從 Settings 尋找相關入口。開始前先確認問題發生在哪個步驟:訂閱無法更新、無法建立連線、網域無法解析,或特定目標請求失敗。先記錄目前網路、模式與操作順序,再執行與問題現象相關的檢查。
每次只調整一項設定,重現問題後再比較結果。診斷資料可能包含位址、網域、請求資訊或認證相關內容,分享前應檢查並遮蔽敏感資訊。診斷工具提供的是線索,不保證能自動修復;即使本機設定與現有資料一致,仍須繼續確認伺服器端狀態與目標服務是否可用。
07 · 實際操作順序
從連線資訊到規則命中
分層檢查,避免同時變更多項條件而無法找出原因。
確認連線資料。 檢查 Subscribe 更新結果,或逐項確認 Add Server 中的協定、位址、連接埠與認證欄位;保留原始資料以供比對。
確認目前選擇。 在 Home 確認實際使用的伺服器與 Global Routing,不要只憑上次使用的印象,也不要將清單第一項當成目前選取項目。
先驗證連線,再確認分流。 搭配 Connectivity Test 與實際請求判斷連線狀況;使用 Config 時,接著確認設定檔、策略引用與規則順序。
分別檢查 DNS 與目標連線。 解析成功與連線成功是兩個不同環節。只有在有證據顯示問題出在 DNS 時,才調整解析設定,避免以更換 DNS 掩蓋其他問題。
最後恢復自動化設定。 手動驗證完成後,再啟用 On Demand、同步與快速入口,並觀察網路切換後的實際行為。
若要從首次開啟開始操作,請參閱入門指南 ;若要整理多個訂閱與設定檔,請參閱訂閱手冊 。若涉及購買與裝置相容性,請前往App Store 正版核對頁 ,依開發者 Shadow Launch Technology Limited、官方圖示及 App ID 932747118 確認;價格、系統需求及通用購買資訊以 App Store 頁面標示為準。