官方手冊 · 功能與設定
Shadowrocket
常用設定與生效條件
先確認要求的處理方式,再調整規則、DNS 與連線條件。每次只修改一項,並以相同要求驗證結果。
本頁依 iPhone / iPad 常見介面整理操作步驟;Mac、Windows、Android、Linux 版同屬 Shadowrocket,不同系統的功能入口與可用設定可能有所差異,請以目前介面顯示為準。須先備妥訂閱或伺服器資訊,才能建立代理連線;設定檔本身不代表已有可用線路。
iPhone / iPad 版於 App Store 售價 $2.99,單次付費;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費。取得方式與裝置說明請參閱全平台下載頁。
01 / GLOBAL ROUTING
Global Routing:Config、Proxy、Direct
功能:Global Routing 決定要求採用哪種整體處理方式。日常依網域與 IP 分流通常使用 Config;若要暫時確認問題來自規則或代理伺服器,可分別用 Proxy 與 Direct 進行比對。這三個選項只會變更路由模式,不會替換伺服器密碼,也無法讓失效的訂閱恢復正常。
設定位置:在 Home 找到 Global Routing,開啟後確認目前選取的項目。本節說明 Config / Proxy / Direct 三種常見模式;若目前介面另有 Scene,請依該場景的設定方式理解,不要直接將其視為上述三者之一。
| 介面選項 | 處理方式 | 適用時機 | 優先檢查項目 |
|---|---|---|---|
| Config(設定檔) | 依目前啟用設定檔中的規則決定處理策略。 | 日常規則分流;驗證自訂規則。 | 啟用的檔案、規則順序及策略參照。 |
| Proxy(代理) | 將通常可處理的要求交由目前的代理路徑處理。 | 暫時排除規則分流的影響。 | 目前選取的伺服器及其參數。 |
| Direct(直連) | 要求透過直連路徑處理。 | 與原始網路狀況進行比對。 | 原始網路是否可用,以及 DNS 狀態。 |
設定方式:先記下原本的選項,再選取需要的模式,接著返回 Home 檢查連線狀態。使用同一個網站或 App 重試;必要時先結束舊連線再測試,避免既有連線工作階段影響判斷。若 Proxy 可用而 Config 不可用,應優先檢查規則與策略,不要立刻重新填寫所有伺服器參數。
注意事項:Direct 不代表系統中的 VPN 設定已中斷;Proxy 也不表示所有 App 和系統服務一定都會走相同路徑。測試結束後請恢復原本需要的模式;不要因為一次連線成功,就長期保留暫時用於排查的設定。
02 / RULE MATCHING
規則類型、策略與比對順序
功能:規則由比對條件與執行策略組成。DOMAIN 用於比對完整網域,DOMAIN-SUFFIX 用於比對網域及其子網域,DOMAIN-KEYWORD 依網域關鍵字比對;IP-CIDR 與 IP-CIDR6 用於比對 IP 網段,GEOIP 則依賴相應的 IP 位址資料。USER-AGENT 是否適用,取決於要求能否取得相關欄位;不能將它視為所有加密流量都能讀取的條件。
設定位置:在 Config 確認目前啟用的檔案,再進入該檔案的規則編輯位置。Global Routing 必須選擇 Config,否則不能只根據規則文字推斷實際分流結果。先確認「啟用的是哪個檔案」,再檢查「檔案內寫了什麼」。
[Rule]
DOMAIN-SUFFIX,ad.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
設定方式:由上而下逐條檢查,命中第一條符合的規則後,就會執行相應策略。PROXY 代表交由代理路徑處理,DIRECT 代表直連,REJECT 代表拒絕。以下範例先拒絕特定子網域,再處理其上層網域;若調換兩行,範圍較廣的網域規則可能會先命中。FINAL 放在最後,為前面都未命中的要求指定預設策略。範例網域僅用於說明語法。
注意事項:規則中的策略也可能參照設定檔內已定義的策略群組,請確認名稱及群組中實際選取的項目。網域比對、DNS 解析與 IP 比對並非同一個環節;不要只看最終 IP,就判定網域規則失效。修改前請保留原始檔案,先用一條範圍明確的規則驗證,再逐步擴大適用範圍。更多範例請參閱規則順序與 FINAL 說明。
03 / SERVER MANAGEMENT
分開管理訂閱與伺服器
功能:伺服器項目會儲存協定、位址、連接埠與驗證等連線資訊;訂閱用來批次取得及更新這些項目;Config 中的設定檔則描述路由、DNS 等行為。三者彼此相關,但更新其中一項不代表其他項目也已更新。訂閱更新成功只表示取得可識別的內容,不保證每台伺服器都能連線。
設定位置:已有的伺服器通常可在 Home 清單中查看及選取;手動輸入請使用 Add Server,掃描 QR Code 則使用 Scan QR Code。匯入既有連結時,先確認內容是伺服器訂閱還是設定檔,再依目前介面提供的相應入口操作;Config 中的 Subscribe 用於相應的設定內容,不要混用不同用途的 URL。
設定方式:向自己已使用的服務提供者取得原始資訊,匯入前檢查連結是否完整,以及前後是否有空白。手動填寫時,先選擇正確協定,再逐項確認位址、連接埠、密碼或識別資訊、傳輸方式與 TLS 參數。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的參數要求各不相同,不能只更改協定名稱,就沿用同一組欄位。編輯後先儲存,再選取該項目進行測試。
注意事項:更新訂閱時可能會重建伺服器項目,直接修改訂閱提供的項目也可能在下次更新時被覆蓋。若要保留個別調整,請先確認目前版本是否提供獨立儲存方式,並記錄所做的修改。刪除整份訂閱前請確認所屬群組,避免誤刪其他資料。連結、QR Code 與連線記錄可能包含認證資訊,分享截圖或尋求協助前請先遮蔽;本站不提供、不銷售也不推薦節點或訂閱。
04 / ON DEMAND
On Demand:依條件啟動連線
功能:On Demand 利用系統的按需機制,依已設定的網路條件觸發連線。它處理的是「何時建立連線」,Global Routing 處理的是「建立連線後如何處理要求」,兩者不能互相取代。開啟 On Demand 不會自動補上缺漏的伺服器參數,也無法修復目前無法使用的網路。
設定位置:在 Settings 或目前版本顯示的 On Demand 設定入口查看條件,並確認系統儲存的 VPN 設定。可設定的條件取決於系統與目前介面,請勿只憑其他裝置的截圖,尋找完全相同的開關。
設定方式:先關閉 On Demand,手動連線並確認既有伺服器可用,再啟用按需機制。若設定介面提供 Wi-Fi、行動網路或網路名稱等條件,請先從一種網路開始設定;儲存後切換至目標網路,觀察系統連線狀態及實際連線結果。每次只新增一個條件,並記錄哪些網路應該連線、哪些網路應維持原狀。
注意事項:手動關閉連線後又自動恢復,可能是按需條件再次符合,不一定是開關故障。若要暫停,請先關閉 On Demand,再中斷連線;排查多組 VPN 設定衝突時,也要檢查系統端是否保留按需規則。網路切換、休眠及恢復連線會受系統排程影響,不能把按需機制視為持續連線的保證。
05 / DATA
Data:查看流量,不代表資費用量
功能:Data 用來查看客戶端處理的流量。上傳、下載、累計用量與目前速率代表不同指標,請先確認欄位名稱及統計範圍。客戶端統計、系統網路統計與服務提供者帳單的計算方式可能不同,不能用其中一個數字直接推算另一個數字。
設定位置:進入 Data 查看目前版本提供的統計項目,並留意計數從何時開始,以及是否依工作階段或其他範圍累計。若要核對行動網路的實際用量,也請查看系統設定;若要確認既有服務的額度,則以該服務的記錄為準。
設定方式:排查異常流量前,先記下目前計數、連線時間與網路類型,再暫時停止系統更新、雲端同步等已知的背景工作,以相同操作進行比對。若介面提供重設功能,重設前請保留必要記錄。比較兩次數據時,應盡量維持相近的觀察時間與操作內容,避免混用不同時間區間的結果。
注意事項:要求、回應、重傳及維持連線都可能影響流量。Data 顯示有流量,不代表目標頁面已完整載入;速率偏低也不代表協定設定錯誤。流量統計不是線路延遲測試;判斷是否可連線,仍須搭配 Connectivity Test、目標要求與記錄一起檢查。
06 / SETTINGS
Settings 常用項目的調整順序
Settings 中的項目涉及解析、測試、快速操作與資料同步。修改前先分辨全域設定與目前 Config 檔案內的設定;若相同主題出現在兩處,應搭配實際啟用的設定檔及記錄確認生效結果,不要只因某個輸入欄仍保留舊值,就判定設定的優先順序。
DNS:先確認是否為解析問題
功能與位置:DNS 會將網域名稱解析為 IP 位址,相關選項可能出現在 Settings 及 Config 的 DNS 設定中。若網域無法連線,但已知位址可以連線,DNS 是需要檢查的環節之一;不過,憑證、目標服務與規則也可能造成類似情況。
設定方式與注意事項:先記錄目前的解析方式,確認目前網路是否需要特定的本機解析服務,再依實際需求調整。企業內網或區域網路名稱可能仰賴網路提供的 DNS,直接替換可能導致無法使用。加密 DNS 同樣需要可連線的傳輸路徑;若解析要求本身依賴尚未建立的代理路徑,就可能形成連線前置條件問題。修改後重新送出要求,並比對解析記錄確認結果。
Test Method 與 Connectivity Test
功能與位置:在 Settings 的 Test Method 選擇目前版本提供的測試方式,再到 Home 對伺服器執行 Connectivity Test。不同方式測試的層面可能不同:連接埠可連通只代表連線路徑的一部分;使用目標 URL 測試,還可能涉及 TLS、目標回應與逾時設定。
設定方式與注意事項:比較伺服器時,請使用相同的測試方式、目標與目前網路,並持續觀察,不要只看單次結果。測試失敗時,先確認該方式是否適用於相應協定,尤其是依賴 UDP 的傳輸方式;測試成功也不能取代實際服務驗證。不要為了得到較小數值而頻繁更換測試目標,否則前後結果將無法比較。
Today Widget:快速入口的系統條件
功能與位置:系統允許時,Today Widget 可提供快速查看或操作入口;相關選項以 Settings 與系統元件新增介面實際顯示為準。它不是獨立的代理設定,也不能取代 Home 中的伺服器選取功能。
設定方式與注意事項:先在 App 內完成一次正常連線,再到系統支援的元件位置新增並測試操作。若系統沒有顯示此元件,不要假設每台裝置或每個系統版本都有相同入口;元件更新也可能受到背景排程影響。若顯示狀態不一致,請返回 App 確認,再查看系統 VPN 狀態;不要連續快速點按多個連線入口。
iCloud:同步前先備份
功能與位置:Settings 中與 iCloud 相關的選項,用於目前版本支援的資料同步或匯入操作。同步範圍請以介面說明為準,不要預設伺服器、訂閱、記錄與所有開關都會逐一複製。
設定方式與注意事項:先確認裝置使用的是預期的 iCloud 帳號,並在系統中允許相應存取。首次啟用、合併或還原前,請保留目前可用的設定;等一台裝置完成後再檢查另一台,避免同時編輯造成衝突。購買 App 使用的帳號與 iCloud 同步帳號用途不同;還原購買項目不能取代設定復原。設定檔可能包含認證資訊,請當作敏感資料妥善管理。
07 / DIAGNOSTICS
Diagnostics 與設定復原
功能:Diagnostics 用來收集及查看目前版本提供的連線診斷資訊。記錄有助於定位解析、連線、驗證或規則比對環節,但單一錯誤通常不足以說明整個問題,必須對照故障發生時間與實際操作。
設定位置:從 Settings 的 Diagnostics 或目前介面列出的診斷入口進入。若有暫時啟用詳細記錄的選項,請只在重現問題時開啟;不同系統與版本顯示的診斷項目可能不同。
設定方式:先記錄 Global Routing、目前伺服器、啟用的 Config 與網路類型,再開啟必要的記錄。只重現一次明確的操作,記下發生順序,接著查看相應時間附近的資訊。依照以下順序逐步排查,前一步確認無誤後再調整下一步:
- 暫時中斷連線,確認目前 Wi-Fi 或行動網路本身可用;必要時先完成網路登入。
- 關閉 On Demand 的自動觸發影響,手動選取一台既有伺服器,並確認協定及驗證參數。
- 使用相同的 Test Method 執行 Connectivity Test,再透過實際目標要求確認連線結果。
- 暫時以 Proxy 與 Config 進行比對;若只有 Config 異常,請檢查啟用的檔案、規則順序與策略群組。
- 若症狀顯示問題可能出在解析環節,再檢查 DNS;同時確認裝置系統時間已設為自動,避免影響 TLS 判斷。
- 撤回本次未能改善狀況的修改,恢復原本的 Global Routing 與 On Demand 條件。
注意事項:診斷內容可能包含伺服器位址、訂閱 URL、認證欄位、瀏覽網域及區域網路資訊。匯出前請逐項檢查,只保留排查所需的片段,並遮蔽敏感內容。重現問題後,請恢復一般記錄層級,避免長時間收集不必要的記錄。未備份前不要直接刪除所有設定或重新安裝;這樣可能會遺失線索,卻無法解決網路或伺服器端的問題。