Shadowrocket 官方手冊 / 功能與設定
Shadowrocket 常用設定
先確認分流模式,再檢查設定、伺服器與連線狀態。
本頁依功能說明「是什麼、在哪裡、如何設定、有哪些注意事項」。介面位置以 iPhone / iPad 常見版面為參考;Mac、Windows、Android、Linux 也有 Shadowrocket,但選單排列及可用的系統整合功能可能因平台而異,請以目前裝置實際顯示為準。
連線方式
Global Routing 三種模式
是什麼:Global Routing 決定連線採用哪一種轉送方式。設定、代理、直連分別對應介面中的 Config、Proxy、Direct。它不是協定選擇器,也不會自動將訂閱中的伺服器調整為可用狀態。切換模式前,請先確認目前選取的伺服器與設定檔。
在哪裡、如何設定:在 Home 開啟 Global Routing,選取所需項目後返回。日常使用既有分流規則時,選擇 Config;要確認問題是否由規則造成,可暫時切換至 Proxy 對照;要檢查本地網路能否連上目標,則可用 Direct 對照。完成比對後,請恢復原本模式,避免將臨時測試設定留作日常使用。
| 介面項目 | 處理方式 | 適用時機 | 檢查重點 |
|---|---|---|---|
| Config · 設定 | 依目前啟用設定中的規則與策略處理請求。 | 需要區分不同網域或位址的連線路徑時。 | 確認設定是否已啟用、規則順序及策略引用是否正確。 |
| Proxy · 代理 | 將納入客戶端處理範圍的流量導向代理路徑。 | 暫時排除分流規則造成的差異。 | 確認目前伺服器是否可連線,以及協定參數是否一致。 |
| Direct · 直連 | 採用直接連線,不透過所選代理伺服器轉送。 | 比對基礎網路狀況,檢查本地資源是否可存取。 | 確認本地網路與目標服務本身是否正常。 |
注意事項:Proxy 不代表一定能連上目標,Direct 也不等於關閉系統連線開關。連線是否建立、請求是否進入客戶端處理範圍,以及最後採用哪項策略,是三個不同問題。系統排除項目或應用程式本身的特殊連線方式,也可能影響實際處理範圍,請搭配請求記錄判斷。
比對與處理
規則類型與策略
是什麼:規則用來識別目標,策略則決定處理方式。例如 DOMAIN-SUFFIX 表示網域後綴條件,PROXY 表示交由代理路徑處理。請勿混淆 Proxy 模式與規則中的 PROXY 策略:前者選擇整體運作方式,後者是設定中個別規則的動作。
在哪裡、如何設定:在 Config 找到目前啟用的設定,進入該檔案的編輯畫面或規則清單。先備份,再將範圍較小、例外性較高的規則排在前面,範圍較廣的規則放後面,最後以 FINAL 處理先前未符合的請求。以下僅以示範網域說明語法,不代表線路資訊。
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
依照這個順序,api.example.com 會先符合第一條規則,不再套用後面的網域後綴規則;其他符合 example.com 後綴的網域則採用第二條規則。這表示「寫了某條規則」不代表請求一定會套用到它。
| 關鍵字 | 比對對象 | 使用注意事項 |
|---|---|---|
| DOMAIN | 完整網域。 | 用於指定主機的精確例外。 |
| DOMAIN-SUFFIX | 網域後綴及其子網域。 | 涵蓋範圍比完整網域更廣,請確認是否會涵蓋前面的需求。 |
| DOMAIN-KEYWORD | 網域中包含的關鍵字。 | 可能符合不相關的網域,設定前請縮小條件範圍。 |
| IP-CIDR / IP-CIDR6 | IPv4 / IPv6 位址範圍。 | 留意位址類型、遮罩,以及網域解析對比對結果的影響。 |
| GEOIP | 位址資料庫中的區域歸屬。 | 資料庫中的歸屬地不等於服務營運者所在地。 |
| USER-AGENT | 可供規則識別的 User-Agent 內容。 | 只有在能取得相關欄位時,才有比對依據。 |
| FINAL | 先前未符合任何規則的請求。 | 放在規則末尾作為後備處理。 |
注意事項:PROXY 使用代理路徑,DIRECT 使用直接連線,REJECT 拒絕符合條件的請求。拒絕規則可能同時影響頁面所需資源;若頁面內容缺漏,請先檢查符合規則的記錄,不要立刻更換伺服器。引用自訂策略時,名稱也必須與設定中實際定義的名稱一致。更多規則排序說明請見自訂規則與 FINAL 說明。
伺服器類型
多種協定與參數對應
是什麼:協定決定客戶端如何與伺服器建立通訊。Shadowrocket 支援的 Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 對應不同的伺服器設定,不能只憑名稱判斷某種協定在所有網路環境下都更快或更省電。
在哪裡、如何設定:在 Home 開啟 Add Server,依照現有伺服器資訊選擇類型;編輯既有項目時,先確認類型,再逐一核對位址、連接埠、驗證欄位,以及服務資訊要求的傳輸與 TLS 選項。匯入訂閱通常會帶入這些欄位,但仍應確認客戶端辨識的類型與原始資訊一致。不同類型顯示不同欄位是正常情況,請勿將某一種協定的參數照搬到另一種協定。
注意事項:連接埠相同不代表協定相同,啟用 TLS 也不表示已符合所有憑證與主機名稱要求。請勿為了讓測試通過而任意放寬憑證檢查;應先核對伺服器名稱、系統時間及服務端提供的參數。欄位意義與設計取捨請見協定參考。分享含有驗證資訊的螢幕截圖或記錄前,請先移除敏感內容。
服務資訊管理
Subscribe 與伺服器清單
是什麼:Subscribe 用來讀取使用者既有訂閱中的伺服器資訊;Add Server 則用來手動填寫單一伺服器。伺服器清單解決的是「使用哪個連線項目」,不等於完整的規則設定。訂閱更新成功,只表示本次取得與解析完成,並不保證清單中的每個項目都能建立連線。
在哪裡、如何設定:在 Config 找到 Subscribe 相關入口,填入從自己使用的服務業者取得的訂閱網址,確認名稱後執行更新,再回到 Home 檢查清單。手動新增請使用 Add Server;已有 QR Code 時可使用 Scan QR Code。從剪貼簿匯入前,請先確認內容來自自己的服務資訊;儲存後再核對項目類型與數量是否符合預期。
管理現有清單時,建議使用容易辨認用途的名稱,區分手動項目與訂閱群組。先測試新增項目,再決定是否刪除舊項目。訂閱產生的伺服器若直接修改參數,下次更新時可能會被覆寫;若要保留個別調整,請先了解該項目的來源與更新方式,避免將暫時修改誤以為會永久保存。
注意事項:訂閱網址通常包含驗證參數,應視為私人資訊妥善保管,勿張貼至公開問答或記錄中。更新失敗時,請依序檢查目前網路、網址是否完整、服務是否仍有效,以及回應內容格式;不要反覆刪除整份清單。相關入口的操作順序請見訂閱匯入方法。
設定檔
Config 儲存與啟用
是什麼:Config 用來管理設定檔,檔案可包含規則、DNS 行為、本機對應等項目。儲存檔案、選取要啟用的檔案,以及切換至 Config 分流模式,是彼此相關但不相同的操作。排查「修改設定後沒有作用」時,請分別檢查這三處。
在哪裡、如何設定:進入 Config,先確認目前啟用標記對應哪個檔案,再進行編輯。修改前請保留副本,一次只調整一種行為,例如先修改某條網域規則,儲存並確認啟用後,再測試相同目標。需要匯入設定時,請先分辨匯入內容是伺服器訂閱還是設定檔,不要只憑網址外觀判斷用途。
注意事項:遠端設定可能在更新時取代本機內容,長期自訂前請確認覆寫範圍。設定中的 General、Rule、Host、URL Rewrite 各有不同用途,規則檔不只包含伺服器位址。請勿直接以來源不明的完整設定覆蓋目前檔案,尤其應仔細檢查會影響 DNS、對應及位址改寫的內容。請參閱設定檔各區段的用途。
自動連線條件
On Demand 按需連線
是什麼:On Demand 會依系統支援的網路條件觸發連線,減少切換網路時反覆操作開關。它處理的是「何時嘗試連線」,不會取代 Global Routing 對「連線後如何分流」的設定,也不負責判斷所有遠端服務是否正常。
在哪裡、如何設定:在應用程式的 Settings 中尋找 On Demand,依目前平台實際列出的條件,逐項設定 Wi-Fi、行動網路或指定網路相關行為。請先確認手動連線正常,再啟用並分別測試連上目標網路、離開目標網路,以及鎖定螢幕後重新使用等情境。需要系統確認連線設定時,請閱讀提示後再完成確認。
注意事項:不要同時修改多項條件後只測試一次。若關閉連線後又自動連上,請先檢查 On Demand 是否再次觸發,再檢查其他系統自動化設定。各系統的背景排程、網路權限與省電策略不同,不能將某台裝置的觸發時機視為所有平台的固定行為。
流量記錄
Data 統計與觀察範圍
是什麼:Data 用於查看客戶端記錄的流量,協助判斷操作是否產生資料傳輸,以及連線前後是否有明顯變化。顯示數值依客戶端的統計方式計算,不是線路服務帳戶的計費記錄,也不能直接取代系統的行動網路用量。
在哪裡、如何設定:開啟 Data,先查看目前顯示的統計範圍與分類,再觀察上傳和下載流量的變化。要排查單次操作時,可先記下原有數值、關閉不必要的背景傳輸,再只開啟一個測試目標,比對操作前後的變化。若介面提供重設統計的功能,請先保存需要的記錄,再進行重設;清除統計並不能修復連線問題。
注意事項:協定額外負載、統計起點、背景活動及處理範圍,都可能造成客戶端與系統記錄不同。連線開關顯示已啟用但暫時沒有流量增加,可能只是沒有請求進入處理範圍;流量增加也不代表所有頁面資源都已載入。請搭配目標存取結果與請求記錄一併判斷。
常用選項
Settings 常用項目
Settings 集中管理應用程式行為與部分系統整合選項。以下項目須以實際介面有顯示為前提;若目前平台未列出某項設定,請勿照著其他裝置的截圖尋找相同位置。修改前請記下原始值,之後才有可靠的還原依據。
DNS:分別檢查解析與連線
是什麼、在哪裡:DNS 會將網域名稱解析為位址,可在 Settings 的 DNS 項目及設定檔相關選項中檢查。解析成功不代表目標連接埠可連線;伺服器可連線,也不代表所有網域都能正常解析。
如何設定、注意事項:先確認目前啟用的設定是否指定 DNS 行為,再查看全域選項,避免同時修改兩處而無法判斷生效來源。請使用既有網路或服務設定要求的解析方式,修改後重新送出目標請求。若只有部分網域失敗,請先區分解析錯誤、規則比對錯誤與連線錯誤,不要直接將所有問題歸因於 DNS。IPv6 相關選項也應配合本地網路的實際支援情況檢查。
Test Method:選擇測試方式
是什麼、在哪裡:Test Method 是 Settings 中與連線測試相關的選項,用來選擇測試方式。不同方式觀察的連線環節不同,顯示結果不宜混在一起比較。
如何設定、注意事項:依目前介面支援的項目選擇一種方式,再回到清單執行 Connectivity Test。比較多台伺服器時,請保持測試方式、網路與測試目標一致。測試結果僅反映當下條件,不代表能持續維持特定頻寬;測試成功後,仍應實際存取所需目標。
Today Widget:系統快速入口
是什麼、在哪裡:Today Widget 是系統小工具的快速操作設定,可在提供此項目的裝置上從 Settings 查看。它只提供操作入口,不會重新產生伺服器或規則。
如何設定、注意事項:先在應用程式內確認連線正常,再依系統提供的小工具管理方式新增可用的小工具。操作後若顯示狀態不同步,請先開啟應用程式確認實際連線狀態,不要連續重複點選。系統小工具的支援範圍與更新時機可能不同,請以目前系統顯示為準。
iCloud:同步範圍與本機副本
是什麼、在哪裡:在提供 iCloud 選項的 Apple 裝置上,可於 Settings 檢查同步設定,並確認系統已允許應用程式使用 iCloud。此功能依賴系統帳戶與權限,並非所有平台都通用的同步方式。
如何設定、注意事項:啟用前請先保留本機設定副本,再確認介面說明的同步範圍。不要假設伺服器、設定檔、系統連線權限與即時連線狀態都會一併移轉。更換裝置後,請分別核對清單、啟用中的設定及連線授權;兩台裝置同時編輯前,應先確認同步已完成,避免以舊副本覆蓋新內容。
故障排查
Diagnostics 與排查順序
是什麼、在哪裡:Diagnostics 可協助查看網路與連線問題,可在 Settings 尋找目前平台提供的診斷入口;伺服器清單中的 Connectivity Test 則用於測試連線。診斷記錄只能作為排查依據,不會自動修正錯誤的協定參數或已失效的服務資訊。
如何設定:不必一開始就修改大量設定。固定使用一台伺服器和一個測試目標,依照下列順序操作,每完成一步就記下結果,再決定是否進行下一步。如此可避免將多項同時發生的變化誤認為同一個原因。
- 確認基本網路。檢查裝置目前使用的網路是否需要先完成驗證,以及系統時間是否正確;必要時可改用另一個既有網路進行比對。
- 測試伺服器。保持
Test Method一致,執行Connectivity Test。若全部失敗,先檢查網路與訂閱是否有效;若只有部分失敗,優先核對對應項目。 - 核對協定欄位。逐一檢查位址、連接埠、驗證資訊、傳輸與 TLS 參數,不要只看伺服器名稱。
- 區分分流影響。記下目前模式,短暫切換
Config與Proxy進行比對,再恢復原設定;若結果不同,請繼續檢查規則與策略引用。 - 查看個別請求。檢查診斷或請求記錄中可用的目標、解析結果、策略及錯誤資訊。若只有部分頁面資源載入失敗,請單獨分析對應網域。
- 還原最近的變更。還原最近修改的 DNS、規則或設定副本,再測試相同目標;不要以清除所有設定代替問題排查。
注意事項:記錄可能包含伺服器位址、存取目標及驗證相關內容,分享前請逐一移除敏感資訊。某次測得的延遲較低,只代表該次測試條件下的結果,不等於實際下載速度或所有應用程式的使用體驗。詳細連線失敗檢查方式請見節點逾時排查順序。