官方手冊 · 功能與設定

Shadowrocket 功能與常用設定

以下說明以使用者已有自己的訂閱或伺服器資訊為前提,依選擇連線路徑、管理伺服器、核對實際請求的順序,介紹各項功能如何搭配使用。初次連線請先依教學完成驗證,再逐項調整設定。

GLOBAL ROUTING

三種模式與適用情境

先確認請求採用哪種連線路徑,再判斷特定規則是否生效。

功能說明:Global Routing 用來選擇整體路由方式。Config、Proxy、Direct 分別對應介面中的設定、代理與直連。它們不是三台伺服器,也不是速度等級:Config 依目前設定中的規則處理請求;Proxy 以代理路徑為主;Direct 則以直接連線為主。實際例外情況仍須配合 App 設定及系統網路行為判斷。

所在介面:在 Home 開啟 Global Routing 查看目前選項。使用 Config 前,也要進入 Config 確認實際選取的設定檔;將檔案匯入清單,不代表它已成為目前使用的設定。

設定方式:日常需要依網域或位址分流時,選擇 Config。若要確認自己的伺服器能否處理目標請求,可暫時切換至 Proxy 作為比較;若要檢查目前網路能否直接連線至目標,可暫時切換至 Direct。每次切換後請重新發出請求,避免將舊連線的結果誤認為新設定的效果。

介面選項主要處理方式適用情境檢查重點
Config · 設定依目前設定中的規則選擇策略日常規則分流、驗證規則是否命中目前設定、規則順序、策略引用
Proxy · 代理透過代理路徑處理請求排除規則因素,檢查伺服器連線目前伺服器、協定參數、目標可連線性
Direct · 直連透過直接連線處理請求檢查本地網路與直接連線狀況基礎網路、DNS、目標服務狀態

CONFIG & RULES

規則類型、順序與策略

規則決定「比對什麼」,策略決定「命中後如何連線」。

功能說明:規則分流會將請求特徵對應至處理策略。DOMAIN 比對指定網域,DOMAIN-SUFFIX 比對網域後綴,DOMAIN-KEYWORD 依網域中的關鍵字比對;IP-CIDR 與 IP-CIDR6 用於位址網段,GEOIP 則依據位址歸屬資料庫判斷。USER-AGENT 取決於請求中可觀察到的相應欄位,不應假設它適用於所有加密請求。

所在介面:在 Config 查看及編輯目前設定中的規則。修改前先確認檔案名稱、目前選取狀態及既有策略定義。設定檔也可能包含 DNS 或其他設定,因此切換設定檔的影響不只限於規則清單。

設定方式:先保留一份原始設定,將明確的比對規則排在範圍較廣的規則之前,再設定兜底規則。規則通常依序比對,命中前面的規則後便按其策略處理;FINAL 用於前面的規則都未命中時兜底。PROXY、DIRECT、REJECT 分別代表代理、直接連線與拒絕處理;設定中也可能引用自訂策略群組名稱,名稱必須與定義相符。

DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

注意事項:以上是規則語法範例,並非適用於所有網路的完整設定。網域解析可能在位址規則判斷之前發生,網域規則與位址規則也可能對同一請求產生不同的比對結果。驗證時應一併查看目標網域、解析位址、命中規則及最終策略,不要只根據網站能否開啟來判斷規則是否正確。若需統一術語,可參閱術語手冊。

SUBSCRIBE & SERVER

匯入訂閱與伺服器管理

訂閱用於管理伺服器項目;設定檔則用來整理規則及其他設定。

功能說明:Subscribe 會透過使用者自己的訂閱網址取得伺服器清單。手動新增則是逐項輸入單一伺服器的連線資訊。無論採用哪種方式,最後都要選取可用的伺服器並驗證連線;清單中出現項目,只能代表匯入或儲存完成,不能證明遠端服務一定可用。

所在介面:在 Home 點選 Add Server 新增伺服器;匯入訂閱時選擇 Subscribe 並輸入網址。若已有可辨識的 QR Code,也可使用 Scan QR Code。手動輸入時,請選擇與伺服器資料相符的類型,再填寫對應參數。實際入口位置及可用的匯入方式,請以 App 內顯示為準。

設定方式:向自己的服務供應商取得完整訂閱連結,貼上後檢查是否混入空格、換行或多餘標點。儲存並更新清單後,確認群組與項目名稱,再選取一台伺服器執行 Connectivity Test。若要更新現有清單,請從對應訂閱的操作選單執行更新;即使已開啟 App 啟動時自動更新,初次設定後仍應手動驗證一次,確認網址能正常傳回內容。

https://example.com/sub?token=xxxx

注意事項:範例網址僅供說明格式,無法用於連線。實際訂閱連結可能包含存取憑證,請勿公開貼在截圖、記錄或對話內容中。更新訂閱可能會取代由遠端管理的項目,手動修改這些項目前請先留存記錄;更新失敗時,先確認連結有效期限、請求網路及回傳格式,不要立即刪除仍可使用的舊清單。更新訂閱與在 App Store 更新 App 是兩件事,目的並不相同。

PROTOCOL PARAMETERS

多種協定與欄位對應

功能說明:Shadowrocket 支援多種連線協定,包括 Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 與 Hysteria2。協定說明用戶端與伺服器如何建立連線;只將協定名稱改成另一種,並不會讓原伺服器支援其他通訊方式。

所在介面:手動新增時,在 Add Server 選擇類型;若要查看既有項目,則進入編輯介面。不同類型顯示的欄位各異,應以伺服器提供的參數及目前 App 介面為準,不要用同一組欄位填寫所有協定。

設定方式:先確認位址、連接埠及身分驗證資訊,再核對 TLS、伺服器名稱、傳輸方式及對應路徑等其他參數。WireGuard 的金鑰與位址資訊須依其設定資料填寫;Hysteria2 是否可用,也與網路對 UDP 的處理方式有關。只填寫自己的資料中明確提供的項目,不要混用其他項目的參數。

注意事項:連線失敗時,不能只憑協定名稱判斷原因。憑證驗證失敗、連接埠無法連線、驗證資訊不符及傳輸參數錯誤,應分別排查。不要將關閉憑證驗證當作一般修復方式;請先確認系統時間、伺服器名稱及憑證鏈。協定本身也不保證速度,實際狀況取決於端對端網路及伺服器狀態。

ON DEMAND

隨選連線與觸發條件

功能說明:On Demand 利用系統 VPN 的隨選機制,依照設定的網路條件決定是否發起連線。它管理的是連線觸發條件,不會取代 Global Routing 為每個請求決定路由策略,也無法修復失效的訂閱或錯誤的伺服器參數。

所在介面:在 Settings 中進入 On Demand 查看相關選項與規則。初次使用前,請先完成系統 VPN 設定授權,並確認手動開啟連線可以正常運作。不同裝置環境下可用的條件,請以 App 顯示為準。

設定方式:先釐清希望在哪類網路下連線、在哪類網路下不觸發,再依介面提供的 Wi-Fi、行動網路或特定 Wi-Fi 名稱等條件設定。先從一項條件開始測試:切換至目標網路,等待系統網路狀態穩定,檢查連線狀態並重新發出實際請求。確認無誤後再增加其他條件,避免多項條件重疊而難以判斷。

注意事項:手動關閉後又自動連線,不一定是開關故障,也可能是 On Demand 再次符合觸發條件。排查反覆重新連線時,先記錄規則並暫時停用隨選機制,再測試手動連線。若需先登入公共 Wi-Fi,應先處理登入頁面的存取問題;反覆重新連線無法取代基礎網路驗證。

DATA

流量統計與請求核對

功能說明:Data 提供流量檢視入口,可用來了解 App 記錄的上傳、下載及相關請求活動。統計資料適合輔助判斷某次瀏覽是否產生流量、是否使用預期的伺服器,但不是遠端服務的計費系統,也不能單憑累計數字確認特定規則是否命中。

所在介面:進入 Data,先查看目前顯示的統計範圍、分類及記錄起點。若目前介面提供依伺服器或 App 等角度檢視,請先確認所選維度;App 歸屬資訊是否完整,取決於系統能提供或辨識的資訊,不應將所有記錄都視為精確的 App 歸因。

設定方式:驗證時先記下測試前的數值,只存取一個目標,再觀察新增流量;並配合可查看的請求記錄,核對網域、策略與伺服器。若要重新統計,請先保存有用資訊,再使用介面提供的重設操作。速度測試、影片預載及背景同步都會改變數值,測試期間請盡量減少這些干擾。

注意事項:統計方式、協定額外負載、記錄週期及背景活動,都可能使本機數值與伺服器端記錄不同。少量流量也可能來自建立連線或背景請求,不能直接判定為異常。網速較慢時,應結合目標回應、伺服器連線及網路切換測試排查,而不是只看累計流量。詳細操作請參閱疑難排解手冊。

SETTINGS

常用設定的適用範圍

以下項目可在 Settings 中查找;設定檔也可能包含相關參數,修改前請先確認目前生效的設定來源。

DNS:解析來源與實際路徑

功能說明與位置:DNS 會將網域名稱轉換為連線所需的位址。請在 Settings 的 DNS 相關項目及 Config 的 DNS 設定中核對現有設定。系統 DNS、自訂 DNS 與 DNS over HTTPS 是不同的解析方式;更換解析方式不代表所有連線問題都會自動修復。

設定方式與注意事項:先保留目前設定值,確認解析服務可從目前網路存取,再依欄位要求填寫。啟用 DNS over HTTPS 時,請使用完整且正確的服務網址,並確認解析服務本身可以連線。儲存後重新發出請求,檢查解析結果及後續連線;設定檔中的參數可能影響實際行為,不能只看 Settings 中的單一選項就斷定最終路徑。

Test Method:測試結果的解讀

功能說明與位置:在 Settings 中尋找 Test Method,它會決定 Connectivity Test 使用的測試方式。TCP 連線測試主要反映指定連接埠的連線狀況;其他測試方式也可能涉及目標回應,應依目前選用的方法解讀結果。

設定方式與注意事項:比較多台伺服器時,請使用相同的測試方式與目標,並盡量在相近的網路條件下重新測試。測試通過不代表目標網站一定可用,測試耗時較短也不代表持續下載速度更快;若測試失敗,應進一步區分連接埠、測試目標及實際代理連線問題。

Today Widget:快速操作入口

功能說明與位置:Today Widget 是提供系統相應區域使用的快速入口,可在 Settings 查看相關選項;新增入口則依照系統提供的小工具管理方式操作。是否顯示及可用操作,請以目前裝置的系統與 App 介面為準。

設定方式與注意事項:先在 App 中選好伺服器並完成手動連線驗證,再新增快速入口,返回系統介面測試狀態顯示與操作。快速入口不會補齊訂閱參數;若顯示狀態與預期不同,請回到 Home 確認實際連線,不要連續點按造成反覆切換。

iCloud:同步範圍與衝突處理

功能說明與位置:在 Settings 查看 iCloud 相關同步選項,可在符合條件的裝置間同步介面列出的資料。同步不等同於透過 App Store 還原購買項目,也不代表所有執行狀態、系統授權及統計記錄都會一併轉移。

設定方式與注意事項:先確認裝置的 iCloud 狀態及 App 權限,再核對允許同步的項目。首次啟用前請保留本機設定,等待同步完成後檢查重要欄位。兩台裝置同時編輯可能造成差異,建議先在一台裝置完成修改,再確認另一台的內容;不要將尚未同步成功誤認為訂閱失效,也不要把同步當成唯一備份。

Diagnostics:保留可重現的線索

功能說明與位置:Diagnostics 是排查網路與連線問題的診斷入口,可在 Settings 中尋找相關工具。它能協助蒐集故障線索,但不會自動判斷所有錯誤的根本原因;解讀結果時,應一併考量發生問題時的網路、Global Routing 模式及所選伺服器。

設定方式與注意事項:先記錄發生問題時的操作與提示,再依工具提供的項目檢查。必要時只在重現問題期間保留診斷記錄,完成後恢復日常設定。分享記錄前,請檢查訂閱網址、身分驗證資訊、個人網域及網路位址等內容,並刪除敏感資料;保留錯誤類型與發生順序即可,不必提交整份私人設定。

CHANGE & VERIFY

逐項設定與驗證順序

一次只變更一個變數,才能將結果對應至特定設定。

  1. 建立可用基準。確認基礎網路正常,在 Home 選取自己的伺服器,完成一次手動連線及實際存取。若無法建立基準,請先處理伺服器參數或網路問題,不要急著新增規則。
  2. 啟用目標設定。進入 Config 選取所需檔案,將 Global Routing 設為 Config,再驗證一項預期透過代理的請求及一項預期直連的請求。記錄實際採用的策略,而不只是頁面能否開啟。
  3. 調整單一設定。先備份,再修改 DNS、規則或測試方式。每次修改都記錄原值、修改理由及測試結果;遇到新問題時,先還原這個項目,避免連續變更而難以找出原因。
  4. 最後啟用自動化。手動連線穩定後,再設定 On Demand 與同步功能。切換一次網路、重新開啟 App,並檢查訂閱狀態,確認自動行為與手動基準一致。

本頁說明各項功能的分工。若要依序完成匯入至連線的操作,請閱讀首次設定教學;若已能連線但部分請求異常,請依疑難排解手冊中的症狀繼續檢查。購買或重新取得 App 時,請前往正版驗證說明,確認開發者 Shadow Launch Technology Limited、官方圖示及 App ID 932747118。