Shadowrocket 官方手冊
Shadowrocket 功能與常用設定
從連線模式、規則、伺服器與自動觸發條件了解各項設定。先確認要調整的層面,再修改對應項目,避免一次更動多處而難以判斷原因。
- Global Routing · 連線模式
- Config · 請求策略
- On Demand · 連線觸發
Global Routing:選擇連線模式
功能說明:Global Routing 決定目前請求採用哪種路徑。設定檔模式對應 Config,代理模式對應 Proxy,直連模式對應 Direct。這與 Home 中的連線開關不同:開關控制是否啟用連線,Global Routing 則決定啟用後如何處理進入用戶端的請求。
位置與設定方式:在 Home 找到 Global Routing,進入後選擇所需模式。日常需要依網域或目標位址區分路徑時,選擇 Config,並確認 Config 頁面已選取預期的設定檔。若只想暫時確認目前伺服器能否連線至目標,可切換至 Proxy;需要比對本機網路狀況時,則可暫時使用 Direct。
| 模式 | 處理方式 | 適用情境 | 注意事項 |
|---|---|---|---|
| 設定檔 · Config | 依目前設定檔中的規則與策略處理請求。 | 日常規則分流,分別使用 PROXY、DIRECT 或 REJECT。 | 檢查已啟用的設定檔、規則順序及最後符合的項目。 |
| 代理 · Proxy | 將納入代理處理範圍的請求交由所選伺服器處理。 | 暫時確認伺服器連線,或排除特定分流規則的影響。 | 不代表所有系統流量都必然經過伺服器。 |
| 直連 · Direct | 透過本機網路直接連線至目標。 | 比對網路可達性,判斷故障是否與代理路徑有關。 | 這不會關閉連線開關,也不能取代系統網路設定。 |
注意事項:切換模式後,請重新發出目標請求再觀察結果。瀏覽器快取、既有連線與應用程式背景工作可能保留先前狀態,不能只重新整理一次就認定規則未生效。排查完成後請恢復原本模式,尤其別把暫時使用的 Proxy 誤認為仍依 Config 分流。
規則分流:比對條件與執行策略
功能說明:規則由比對類型、比對內容與策略組成。例如 DOMAIN-SUFFIX,example.com,PROXY 表示依網域後綴比對,再使用 PROXY 策略處理。比對類型說明「識別哪種請求」,策略則說明「符合後如何連線」,兩者應分開確認。
位置與設定方式:在 Config 查看目前使用的設定檔,修改前先儲存副本。若要指定某個網域的連線路徑,先確認目標是單一完整網域還是整個網域後綴,再選擇 DOMAIN 或 DOMAIN-SUFFIX。較明確的規則通常排在較廣泛的規則之前;FINAL 用於前面的規則都未符合時決定最終策略,應放在規則清單末尾。
| 類型 | 比對對象 | 適用範圍 |
|---|---|---|
DOMAIN | 完整網域。 | 適合只調整單一明確的主機名稱。 |
DOMAIN-SUFFIX | 網域及其子網域後綴。 | 範圍大於單一完整網域。 |
DOMAIN-KEYWORD | 網域中的關鍵字。 | 可能符合名稱相似但用途不同的網域。 |
IP-CIDR / IP-CIDR6 | IPv4 / IPv6 位址範圍。 | 應確認位址範圍與實際目標,不能只看網頁網域。 |
GEOIP | IP 地理位置資訊。 | 結果會受使用的資料庫與解析結果影響。 |
FINAL | 未符合前面規則的請求。 | 用來決定最終去向,不應排在具體規則之前。 |
以下片段僅供理解規則順序,並非完整設定,也不含可用伺服器。範例網域 example.com 不代表實際連線路徑。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
注意事項:PROXY 表示交由代理策略處理,DIRECT 表示本機直連,REJECT 表示拒絕請求。選擇 REJECT 後無法存取,可能正是規則預期的結果。單一頁面也可能請求多個網域,只為主網域新增規則未必涵蓋所有資源;應查看連線記錄找出實際請求,不要一再擴大關鍵字範圍。
Subscribe 與 Add Server:管理連線資訊
功能說明:伺服器項目會儲存一次連線所需的位址、連接埠、協定與驗證參數;Subscribe 用來管理一組可更新的伺服器資訊。更新訂閱與更新 Config 是不同操作:重新整理伺服器清單不代表規則檔也會一併變更,匯入設定檔也不代表已選取正確的伺服器。
位置與設定方式:在 Home 使用 Add Server 手動輸入已有的伺服器資訊;輸入時依實際協定核對欄位,不要直接套用其他協定的參數。透過 Subscribe 新增自己已有的訂閱時,完整貼上連結並儲存,再確認項目是否歸入預期的群組。若已有 QR Code 或分享資訊,可使用 Scan QR Code 或相應的匯入入口;匯入後仍須確認伺服器類型與連線參數。
Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 以及 HTTP、SOCKS5 等協定的欄位各不相同。填寫 TLS、傳輸方式或其他附加參數時,應以既有伺服器的實際需求為準;只修改顯示名稱不會改變連線目標。不熟悉的欄位先保留原始資訊,再逐項確認,避免只憑名稱猜測用途。
注意事項:更新訂閱前先記下目前選取的項目,更新後確認項目是否仍存在。若多個訂閱出現相同名稱,先依群組辨別來源,再決定保留或刪除,不要只憑名稱就認定完全重複。Connectivity Test 適合初步篩選,但測試通過不代表所有目標都能存取。刪除群組前先備份;設定檔與分享連結中的驗證資訊也不應公開。
本站不提供、不販售也不推薦節點或訂閱。用戶端一次買斷 ≠ 連線服務方案;用戶端的取得方式與既有伺服器的使用條件應分開看待。完整的匯入、更新與整理方式請參閱訂閱與伺服器管理手冊。
On Demand:依條件觸發連線
功能說明:On Demand 可依網路等條件觸發連線。它處理的是「何時連線」,而非「某個請求採用哪種策略」。觸發連線後,請求仍由當下的 Global Routing 與設定決定去向,因此 On Demand 不能取代規則分流。
位置與設定方式:在 Settings 找到 On Demand 相關設定。先確認預期行為,例如在特定 Wi-Fi SSID 下採用不同連線狀態,或在 Cellular 條件下啟用連線,再依目前介面提供的條件建立規則。若涉及 Domain 條件,請逐項閱讀介面對網域觸發條件的說明,不要將它與 Config 中的 DOMAIN-SUFFIX 規則混為一談。
- 先手動連線,確認既有伺服器與 Config 均可正常運作。
- 每次只新增一個觸發條件,並記錄對應的網路環境與預期動作。
- 切換至符合該條件的環境,等待系統處理後檢查連線狀態,並實際發出一次請求。
- 確認運作符合預期後,再新增其他條件並檢查是否重疊。
注意事項:系統排程、網路切換與既有連線都可能影響觀察時機。手動中斷後再次連線,不一定表示開關故障,也可能是 On Demand 條件再次符合。排查時先暫時停用 On Demand,再測試手動連線;確認基本連線正常後,逐條恢復條件。若要了解條件組合,請參閱On Demand 設定說明。
Data:查看流量與連線記錄
功能說明:Data 可查看用戶端記錄的流量資訊,協助了解上傳、下載與連線活動。這些資料反映用戶端可觀察到的使用情形,不應直接視為行動電信帳單,也不等同於既有伺服器服務的計費記錄。
位置與設定方式:開啟 Data,先查看目前介面提供的統計範圍、時間範圍與分類方式,再記錄數值。若要觀察某項操作產生的流量,先記下操作前的統計狀態,暫停無關的背景下載,再執行一次目標操作並比較變化。若介面提供重設統計資料的功能,請先儲存所需資料再使用。
注意事項:上傳與下載方向、統計起點,以及連線是否經過用戶端,都會影響數值的解讀。切換網路或更換伺服器前後,不宜直接相減比較不同範圍的累計值。規則是否符合,應配合實際連線記錄確認,不能只因總流量增加就認定某個網域經由 PROXY 連線。
向他人描述問題時,提供時間、網路類型、目標網域與所選策略等必要資訊即可。記錄或連線詳情可能包含伺服器位址、請求路徑與驗證資訊,分享前請先檢查並遮蔽敏感內容。
Settings:常用設定的調整範圍
Settings 中的項目涵蓋解析、測試、快速入口、同步與診斷,各自影響的範圍不同。部分設定也可能由目前的 Config 定義;判斷實際運作時,應同時檢查設定檔與應用程式設定,不要只看單一頁面。以下依常見需求說明調整方式,實際可用入口請以目前應用程式顯示為準。
DNS:確認網域的解析方式
功能說明與位置:DNS 負責將網域解析為位址。可在 Settings 檢查 DNS 相關選項,並在 Config 確認是否有 dns-server 等設定。解析結果不同,可能使同一網域連線至不同目標位址,進而影響依 IP 判斷的規則。
設定方式與注意事項:先保留目前設定並記下故障網域,確認問題是解析失敗還是連線失敗,再考慮調整解析方式。一次只修改一項,重新發出請求後比較結果。不要因為某個位址看起來常見就直接替換,也不要把所有存取失敗都歸因於 DNS;目標伺服器無法使用、規則拒絕或本機網路異常,也可能造成類似情況。
Test Method:維持測試條件一致
功能說明與位置:Test Method 決定連線測試採用的方法,可在 Settings 中查看。它會影響 Connectivity Test 的測試流程與結果解讀,不會自動替使用者修正伺服器參數,也不代表實際使用速度。
設定方式與注意事項:整理伺服器清單時,先選定符合目前檢查目的的方法,再於相同網路條件下測試。更換 Test Method 後,不宜直接將舊結果與新結果混在一起比較。若測試失敗,也應以實際目標進行驗證,區分測試目標無法連線與伺服器本身連線失敗。
Today Widget:提供快速操作入口
功能說明與位置:Today Widget 是與系統小工具相關的快速入口設定,可在 Settings 尋找對應項目,再到系統支援的小工具區域新增。是否顯示及可執行哪些操作,取決於目前系統與應用程式提供的功能。
設定方式與注意事項:先確認應用程式內的手動連線正常,再設定要顯示的快速操作。使用後回到 Home 確認實際連線狀態,不要將小工具中的快取顯示當作最終結果。找不到入口時,先確認目前系統的小工具管理方式,不必因此刪除既有設定。
iCloud 同步:區分同步與獨立備份
功能說明與位置:iCloud 同步可在支援此功能的裝置間同步應用程式支援的資料,可於 Settings 的相關入口及系統 iCloud 設定中確認。同步會受目前帳號、網路與系統狀態影響,不等同於保留每個歷史時間點的設定副本。
設定方式與注意事項:先在原裝置確認所需資料仍完整,再啟用相應的同步設定;接著在另一台裝置檢查具體項目與 Config,而非只看同步開關。大量刪除或整理前,仍應另行匯出備份,避免刪除操作隨後同步至其他裝置。若還原不完整,先檢查帳號與同步範圍,再考慮重新匯入,以免產生重複項目。
Diagnostics:針對可重現問題蒐集線索
功能說明與位置:Diagnostics 提供診斷工具,協助找出網路與連線問題,可在 Settings 中尋找。解讀診斷結果時,須一併考量當時的網路、Global Routing、伺服器與目標;單一結果通常不足以說明所有原因。
設定方式與注意事項:先記錄重現問題的步驟,再執行相關檢查;每次只變更一項條件,並保留變更前後的結果。提交問題說明前,請移除訂閱連結、密碼及其他驗證資訊。不要為了產生較長的記錄而任意啟用不理解的設定,也不要將診斷輸出中的目標位址誤認為可用伺服器資訊。
設定檢查順序:從手動連線到自動觸發
遇到「可以連線但某個頁面無法開啟」或「中斷後又自動連線」時,先依層次逐項檢查,通常比同時更換伺服器、DNS 與規則更容易找出原因。建議保留一份能重現問題的設定檔副本,讓每次修改都有可供比對的起點。
- 確認基本網路:檢查目前 Wi-Fi 或 Cellular 是否正常連線,並記錄故障發生時的網路環境。
- 確認伺服器:核對 Home 中實際選取的項目、協定與參數,避免混淆顯示名稱相似的項目。
- 確認連線模式:檢查 Global Routing。需要規則分流時選擇 Config,並確認已啟用預期的設定檔。
- 確認請求去向:查看連線記錄中的目標網域、比對條件與策略,再檢查 DNS 與規則順序。
- 確認自動條件:手動連線穩定後,再啟用 On Demand 並逐項檢查觸發條件。
首次使用可依入門教學完成匯入、選擇連線模式與連線確認;若要處理訂閱更新、重複項目或備份,請前往伺服器管理。本頁協助了解各項功能的用途,遇到具體問題也可參照常見問題逐項確認。