官方手冊 功能與常用設定

Shadowrocket 功能與設定

先確認 Global Routing,再檢查 Config 與伺服器。連線開關、規則比對和按需觸發屬於不同層級,排解問題時不要同時修改。

Home · 連線與路由 Config · 規則與設定檔 Settings · 行為與診斷

Home / Global Routing

三種路由模式

設定檔、代理、直連分別對應 Config、Proxy、Direct。它們決定整體處理方式,不等於連線開關,也不等於規則列中的策略名稱。

介面選項處理方式適用情境優先檢查項目
Config · 設定檔依目前啟用的設定檔規則決定處理策略。日常依網域、IP 位址範圍等條件進行分流。確認 Config 選取了預期檔案,且規則與 FINAL 完整無缺。
Proxy · 代理整體採用代理路徑,但實際範圍仍受系統與 App 處理方式限制。短暫切換以測試代理路徑,判斷問題是否與規則比對有關。確認選取的伺服器是否可連線,以及認證、DNS 和目標服務是否正常。
Direct · 直連整體採用直連路徑,不經由代理伺服器轉送。測試目前網路直接存取目標的情況。確認本地網路、DNS 與目標是否可連線。

設定位置與驗證方式

在 Home 找到 Global Routing,先記下原本的選項,再選擇要測試的模式。使用 Config 前,請進入 Config 確認實際啟用的是預備好的檔案,而不是只有將檔案下載到清單中。接著回到 Home,確認選取的伺服器並開啟連線;使用同一個目標比較變更前後,避免因更換目標而無法比較。

若 Proxy 可以存取、Config 卻不行,請進一步檢查命中的規則及其策略;這只是排查線索,不能因此斷定規則一定有誤。Direct 也無法存取時,應先檢查目前網路與目標狀態。Direct 不代表關閉系統 VPN 設定;若要完全停止客戶端接管連線,請使用連線開關,並檢查 On Demand 是否可能再次觸發。

部分介面也會顯示 Scene,用於場景相關設定,不屬於本節介紹的三種基本模式。開始排查時,先固定一種明確模式,避免同時加入場景切換條件。

Config / [Rule]

規則類型與執行策略

規則描述「哪些請求符合條件」,策略描述「符合後如何處理」。在 Config 模式下,規則由上而下檢查,命中第一條後即停止,不會依關鍵字長短自動排序。

先列出具體條件,再設定兜底規則

DOMAIN 比對完整網域;DOMAIN-SUFFIX 比對指定網域及其子網域;DOMAIN-KEYWORD 依網域中的關鍵字比對,涵蓋範圍通常較廣。IP-CIDR 與 IP-CIDR6 分別表示 IPv4、IPv6 位址範圍;GEOIP 依 IP 歸屬資料比對,結果會受資料庫與解析流程影響,不能作為網站所在地的證明。

USER-AGENT 依可取得的 User-Agent 資訊比對,不宜假設它涵蓋所有 App 請求,更不能將它視為通用的 App 身分識別方式。FINAL 是兜底規則,用來處理前面都未命中的請求;若放在前面,後續規則就沒有比對機會。

閱讀用規則片段

[Rule]
DOMAIN,api.example.net,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

example.com 與 example.net 是教學用網域。這是規則順序範例,不是可直接取代現有設定檔的完整檔案。

PROXY、DIRECT 與 REJECT

PROXY 將請求交由代理路徑處理,DIRECT 直接連線,REJECT 則拒絕對應請求。規則中出現 PROXY 並不會自動補上伺服器參數;仍須確認所需伺服器或策略有效。REJECT 適用於明確需要封鎖的目標;若範圍過大,頁面中的認證、圖片或 API 也可能一併失效。

在 Config 開啟目前使用的檔案,檢查 [Rule] 區段,再逐項核對類型、比對值、策略與順序。修改前先保留原始檔案,每次只調整一項條件;重新送出目標請求並查看記錄,確認命中結果。不要為了修正單一網域,就將涵蓋範圍很廣的關鍵字規則直接移到最前面。

查看規則與設定檔完整參考

Home / SERVER / Add Server

訂閱與伺服器管理

伺服器項目儲存連線參數;Subscribe 用於透過使用者已有的訂閱更新項目;Config 則負責規則等設定內容。三者彼此相關,但不能互相取代。

Subscribe:批次匯入與更新

在 Home 透過新增入口進入 Add Server,選擇 Subscribe,並填入自己已有的訂閱網址。儲存後執行更新,再回到 SERVER 確認是否已建立項目。訂閱網址通常包含存取憑證,請勿放入公開截圖、聊天紀錄或診斷分享內容。

更新失敗時,先確認連結沒有空格、換行或失效參數,再檢查目前網路是否能連線至該網址。更新只代表重新取得訂閱內容,不表示其中每一台伺服器都能連線。訂閱管理中的項目可能在後續更新時重建,重要的手動修改請另外記錄。

Add Server:手動填寫與掃描 QR Code

已有單一伺服器的參數時,在 Add Server 選擇相應協定,再依實際資料填入位址、連接埠、認證與傳輸選項。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 與 WireGuard 的欄位意義各不相同,請勿只更換協定名稱,卻沿用上一筆記錄的參數。

Scan QR Code 只是輸入資料的方式,不會驗證來源或可用性。掃描後仍須核對協定、位址與重要參數;QR Code 也可能包含敏感資訊。儲存項目後,先執行 Connectivity Test,再選取該項目測試實際存取,避免將「已新增」誤認為「已成功連線」。

整理清單時保留可追溯性

為項目加上容易辨識的備註,但不要在名稱中寫入密碼。區分訂閱建立的記錄與手動新增的記錄,刪除前確認是否仍有設定檔引用。若伺服器測試正常、目標存取卻異常,請繼續檢查 Global Routing、規則、DNS 與目標服務,不要反覆刪除並重新匯入相同內容。第一次完整連線流程請參閱快速入門。

Settings / On Demand

依網路條件觸發連線

On Demand 會在符合設定條件時,由系統觸發 VPN 連線。它回答的是「何時建立連線」,而不是「這個網域要走哪條路徑」。Wi-Fi、Cellular 等條件與 Global Routing、[Rule] 分屬不同層級;啟用後仍須確保目前設定檔與伺服器可正常運作。

在 Settings 尋找 On Demand,先閱讀目前介面列出的條件與動作,再依明確的使用情境設定。涉及 Wi-Fi 名稱時,請確認實際連線的網路,不要只憑相似名稱判斷。初次設定建議只保留一項容易重現的條件,確認行為符合預期後再加入其他條件。

建議驗證順序

  1. 先手動連線,確認目前設定檔可正常存取所需目標。
  2. 設定一項 On Demand 條件,其他設定維持不變。
  3. 切換至相應的 Wi-Fi 或 Cellular,觀察系統連線狀態。
  4. 再切換至不符合條件的網路,確認實際行為。

系統排程、網路切換與 App 狀態都可能影響觸發時機,On Demand 並非精確到秒的計時器。

若手動中斷後又自動連線,請先檢查 On Demand 條件,不要立刻刪除系統 VPN 設定。排查一般連線問題時,可先記錄並暫時關閉按需觸發,完成手動連線測試後再恢復。頻繁切換網路時也請留意認證頁面:需要登入網頁的 Wi-Fi,應先完成網路本身的連線程序。

Data

流量統計的判讀限制

Data 用於查看客戶端記錄範圍內的流量資訊。進入 Data 後,先確認目前顯示的統計範圍、方向或時間區間;不同頁面的彙總方式可能不同。上傳與下載計數有助於觀察是否發生連線,但不能只憑總數判斷目標頁面是否完整載入,也不能將客戶端統計直接等同於電信業者帳單。

測試時先記錄操作前的數值,再執行一項明確操作,結束後查看變化。背景同步、系統請求、重試與協定額外流量都可能增加用量;若一邊播放內容、一邊測試其他網站,統計變化就難以判斷來源。需要重新建立觀察基準時,請先記錄舊資料,再使用目前介面提供的重設功能;重設後已清除的本機統計無法復原。

Data 不能取代訂閱額度查詢。使用者已有服務的額度、有效期限與計費方式,請查閱原有帳戶說明;客戶端顯示的流量不保證等於服務端剩餘可用量。排查流量異常增加時,優先透過請求記錄確認來源,再縮小測試範圍,不要直接改成另一種全域模式後長時間維持。

Settings

常用設定逐項檢查

設定項目是否顯示及支援哪些選項,請以目前系統與 App 介面為準。修改前先記錄原值;若相關功能受設定檔控制,也請檢查 Config,避免只修改介面中的一處。

DNS:先區分解析與連線問題

用途:DNS 會將網域名稱解析為位址,結果可能影響後續 IP 類規則與連線路徑。網域解析成功不代表服務連接埠可用;連線失敗也不一定是 DNS 所致。

位置與設定方式:在 Settings 尋找 DNS 相關設定,同時檢查目前 Config 的 [General] 區段是否包含解析設定。依現有網路需求核對解析器與相關選項,每次只修改一項,再使用相同網域重新測試。

注意事項:不要把隨機更換 DNS 當成通用解決方式。內部網域、認證頁面與 IPv6 行為可能各有不同需求;快取也可能使修改效果無法立即顯現。保留修改前後的解析結果,才能比較差異。

Test Method:確認測試代表的意義

用途:Test Method 決定 Connectivity Test 採用的探測方式。不同方法測試的連線環節不同,回傳結果不適合脫離方法直接比較。

位置與設定方式:在 Settings 找到 Test Method,查看目前可選的方法與測試目標。記下選項後回到 Home 執行 Connectivity Test;比較不同伺服器時,請使用相同方法、相同目標與相近的網路條件。

注意事項:探測成功不代表所有網站都能存取;某種探測失敗也不能單獨證明認證參數錯誤。不要為了追求較低的顯示數值而反覆更換方法;應另外測試實際目標,並搭配錯誤訊息判斷。

Today Widget:快速操作與狀態確認

用途:Today Widget 提供系統小工具的快速存取功能,實際可用形式取決於系統支援範圍。它是操作入口,並非一套獨立的路由設定。

位置與設定方式:在 Settings 查看 Today Widget 相關選項,再前往系統的小工具管理介面確認是否能加入。依目前系統允許的方式完成設定後,執行一次快速操作,再回到 Home 確認連線狀態與選取的伺服器。

注意事項:小工具畫面可能有更新間隔,不要只憑舊狀態判斷目前連線情況。若未顯示入口,請先確認系統支援與 App 提供的選項,不要依照其他裝置的介面位置強行尋找。

iCloud:同步不等於完整備份

用途:iCloud 相關功能可在符合條件的裝置間同步 App 支援的資料。實際同步範圍請以介面說明為準,不要假設伺服器憑證、設定檔及所有 Settings 都會完整同步。

位置與設定方式:先檢查系統的 iCloud 權限與帳戶狀態,再到 Settings 確認 App 內的同步選項。切換前先保留現有設定,並在另一部裝置確認實際內容是否已同步,不要只確認檔名已出現。

注意事項:網路、可用空間與同步衝突都可能影響結果。刪除內容前,先確認是否會影響其他裝置;同步也不能取代獨立備份。匯出檔案或設定檔可能包含伺服器憑證,儲存與傳送時應限制存取範圍。

Settings / Diagnostics

診斷與逐步排查

Diagnostics 用於收集或查看診斷線索,協助區分解析、連線、認證與規則路徑等問題。在 Settings 找到相關入口後,先閱讀目前提供的工具與輸出說明,再重現一次故障。不同平台與介面提供的內容可能不同,不要因為缺少某項工具就認為 App 不具備連線能力。

排查時先設定一個明確目標:記下使用 Wi-Fi 還是 Cellular、Global Routing 的選項、選取的伺服器、目前的 Config 與失敗狀況。先確認基本網路,再檢查伺服器連線與認證,接著查看 DNS 和規則命中,最後恢復 On Demand 等自動化行為。每輪只修改一個變數,測試後記錄結果,避免多項變更掩蓋真正原因。

例如,目標在 Proxy 模式下可存取、在 Config 模式下卻失敗,可以保持伺服器不變,檢查該網域是否先被涵蓋範圍較廣的規則命中,以及命中策略是否符合預期。如果兩種模式都失敗,應轉而檢查伺服器參數、目前網路與目標狀態,而非不斷移動 FINAL。規則、伺服器與系統網路問題需要不同證據才能判斷。

分享診斷內容前,請檢查是否包含訂閱網址、認證欄位、個人網域、裝置資訊或存取記錄,並視需要遮蔽。提供重現步驟、相關錯誤與必要的規則片段即可;不要為了尋求排查建議而公開整份設定檔。問題排除後,請還原暫時測試的設定,並再次確認日常使用的 Config 與 On Demand 條件。

繼續查看設定檔結構與規則比對參考
Shadowrocket 全平台下載