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-CIDR6IPv4 / 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 則用於測試連線。診斷記錄只能作為排查依據,不會自動修正錯誤的協定參數或已失效的服務資訊。

如何設定:不必一開始就修改大量設定。固定使用一台伺服器和一個測試目標,依照下列順序操作,每完成一步就記下結果,再決定是否進行下一步。如此可避免將多項同時發生的變化誤認為同一個原因。

  1. 確認基本網路。檢查裝置目前使用的網路是否需要先完成驗證,以及系統時間是否正確;必要時可改用另一個既有網路進行比對。
  2. 測試伺服器。保持 Test Method 一致,執行 Connectivity Test。若全部失敗,先檢查網路與訂閱是否有效;若只有部分失敗,優先核對對應項目。
  3. 核對協定欄位。逐一檢查位址、連接埠、驗證資訊、傳輸與 TLS 參數,不要只看伺服器名稱。
  4. 區分分流影響。記下目前模式,短暫切換 Config 與 Proxy 進行比對,再恢復原設定;若結果不同,請繼續檢查規則與策略引用。
  5. 查看個別請求。檢查診斷或請求記錄中可用的目標、解析結果、策略及錯誤資訊。若只有部分頁面資源載入失敗,請單獨分析對應網域。
  6. 還原最近的變更。還原最近修改的 DNS、規則或設定副本,再測試相同目標;不要以清除所有設定代替問題排查。

注意事項:記錄可能包含伺服器位址、存取目標及驗證相關內容,分享前請逐一移除敏感資訊。某次測得的延遲較低,只代表該次測試條件下的結果,不等於實際下載速度或所有應用程式的使用體驗。詳細連線失敗檢查方式請見節點逾時排查順序。