[Rule] 結構示意
示意內容 · 不代表目前設定[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,DIRECT
example.com 是教學用網域。正式規則應依自己的連線需求與現有設定撰寫。
先確認 Global Routing,再檢查 Config 與伺服器。依功能查找介面位置、設定順序及適用條件,避免一次修改多個選項,之後難以找出原因。
Shadowrocket 適用於 iPhone / iPad / Mac / Windows / Android / Linux。以下操作路徑以 iPhone / iPad 為例;其他平台的選單位置與系統功能可能不同,請以目前應用程式實際顯示的選項為準。
iPhone / iPad 版在 App Store 售價 $2.99,一次性付費;系統需求以 App Store 頁面標示為準。Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費。
先選擇流量處理方式
在 Home 開啟 Global Routing。Config、Proxy、Direct 是三種常用模式,決定是否依規則處理連線。
功能說明:Global Routing 是流量處理的主要入口,不是伺服器清單,也不是通訊協定類型。選擇 Config 時,客戶端會依目前設定檔中的規則決定策略;選擇 Proxy 時,會以代理方式處理送入客戶端的連線;選擇 Direct 時,則以直連方式處理。系統本身的限制,以及未送入客戶端的流量,不應只憑這個選項推斷其流向。
設定方式:首次使用時,先在 Home 選取已有且可用的伺服器,再進入 Config 確認目前設定檔,最後返回 Global Routing 選擇 Config。若要判斷故障是否由規則造成,可暫時切換為 Proxy,對同一個目標重複測試;測試後請還原原設定。若要比較目前本機網路的連線情況,也可暫時切換為 Direct。
| 模式與介面用語 | 處理方式 | 適用情境 | 需確認項目 |
|---|---|---|---|
| 設定 · Config | 依目前設定檔逐條比對規則。 | 日常依網域、IP 範圍等條件分流。 | 啟用中的設定檔、規則順序與最終策略。 |
| 代理 · Proxy | 以代理方式處理送入客戶端的連線。 | 暫時確認代理伺服器與目標是否可連線。 | 目前選取的伺服器及其連線參數。 |
| 直連 · Direct | 以直連方式處理送入客戶端的連線。 | 比較本機網路連線情況,或排查代理造成的影響。 | 本機網路、DNS 與目標服務本身。 |
注意事項:Proxy 無法修復失效的伺服器,Direct 也不代表已關閉系統 VPN 設定。若要完全停止客戶端接管連線,請操作 Home 的連線開關。部分介面也會顯示 Scene,但不影響本節判斷三種基本模式的方法;若不需要切換場景,請先用明確的 Config、Proxy 或 Direct 進行排查。
條件決定是否命中,策略決定流量去向
在 Config 查看目前的設定檔。只有 Global Routing 選擇 Config 時,才應搭配這份檔案判讀分流結果。
功能說明:每條規則由比對條件與處理策略組成。DOMAIN 比對完整網域,DOMAIN-SUFFIX 比對網域後綴,DOMAIN-KEYWORD 比對網域中的關鍵字;IP-CIDR 與 IP-CIDR6 分別表示 IPv4、IPv6 位址範圍,GEOIP 則依位址所屬地區資訊比對。USER-AGENT 涉及請求特徵,能否取得所需資訊取決於實際連線情況,不能將它視為適用於所有流量的通用應用程式識別條件。
位置與設定方式:從 Config 開啟目前的設定檔,檢查 [Rule] 區段。規則依由具體到廣泛的順序排列,將精確網域或區域網路範圍放在適當位置,再由 FINAL 指定未符合前面條件的連線所採用的策略。修改前先保留原設定檔,每次只調整一項條件;儲存後確認目前啟用的仍是這份檔案。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,DIRECT
example.com 是教學用網域。正式規則應依自己的連線需求與現有設定撰寫。
策略說明:PROXY 表示使用代理策略,DIRECT 表示直連,REJECT 表示拒絕連線;若檔案引用自訂策略名稱,也要確認其指向的伺服器或群組存在。規則通常依序比對,前面較廣泛的條件可能導致後面的精確條件無法命中。
注意事項:不要只因設定檔中出現某個網域,就認定規則已生效。還要檢查 Global Routing、目前啟用的設定檔,以及連線記錄中的實際目標。有些請求直接使用 IP 位址,或接著連線到其他網域,此時應根據記錄進一步判斷,而不是一再擴大關鍵字範圍。各區段的用途請參閱.conf 結構說明。
分開處理匯入、更新與選取
Home 用於查看與選取伺服器,Add Server 用於新增資訊,Subscribe 用於管理訂閱。
功能說明:單一伺服器會儲存一組連線參數,訂閱則用來取得並更新一組伺服器項目。更新訂閱與更新 Config 設定檔是兩回事:前者可能變更伺服器清單,後者則會變更規則及其他設定內容。匯入伺服器後,仍須選擇正確的 Global Routing 模式與設定檔。
設定方式:若已有訂閱連結,請在 Home 的 Add Server 中選擇 Subscribe,輸入網址與方便辨識的備註,儲存後執行更新,並確認清單已建立。若已有單一伺服器資訊,請依實際通訊協定填寫位址、連接埠與驗證欄位。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 所需欄位各不相同,不要只更改通訊協定名稱,卻保留不相符的參數。
若已有分享內容,可使用 Scan QR Code 或從剪貼簿匯入。匯入後先檢查通訊協定、位址及必要參數,再執行 Connectivity Test。測試結果有助於初步排查,但不能取代實際連線驗證;清單排序也不會自動確保目前選取的項目可用。多個訂閱應分別命名,更新後確認原先選取的伺服器是否仍存在。
注意事項:訂閱連結可能包含存取憑證,排查時不要公開完整網址或 QR Code。編輯訂閱產生的項目前,先確認下次更新是否會覆蓋手動修改。刪除訂閱前請保留必要資訊;刪除清單項目與停止連線是不同操作。匯入、更新、排序、刪除與備份的完整步驟,請參閱訂閱與伺服器管理手冊。
先手動確認連線,再設定觸發條件
在 Settings 尋找 On Demand,並以目前介面提供的 Wi-Fi、Cellular 等條件為準。
功能說明:On Demand 會依系統允許的條件觸發連線,適用於需要在特定網路環境下自動連線的情境。它決定何時建立連線,不負責判斷網域應直連或使用代理;後者仍由 Global Routing 與規則決定。
設定方式:先停用按需條件,手動完成一次連線與實際瀏覽,確認伺服器、Config 和 DNS 均正常運作。接著進入 On Demand,依需求設定 Wi-Fi 或 Cellular 條件;若介面提供 Wi-Fi 名稱條件,請逐一核對網路名稱,避免因名稱相似而判斷錯誤。儲存後,分別在目標網路與非目標網路觀察連線狀態,再確認鎖定螢幕、解鎖及切換網路後的情況。
注意事項:系統觸發連線有其條件,不應將按需連線理解為所有 App 都會持續使用同一個連線工作階段。手動中斷後又重新連線時,請先檢查 On Demand 是否仍啟用,不要反覆刪除 VPN 設定。排查問題時可暫時停用按需條件,改用手動開關,避免自動重新連線干擾測試。不同平台的背景執行機制不盡相同,不要直接套用行動裝置的條件。
統計資料可供觀察,不等同帳單
在 Data 查看目前介面提供的流量統計與連線資訊,解讀數值前先確認統計範圍。
功能說明:Data 用於查看經客戶端處理的流量與相關記錄,可協助判斷是否出現請求、連線目標為何,以及規則處理是否符合預期。頁面顯示的統計會受記錄範圍、清除操作及連線方式影響,不代表裝置的所有網路流量,也不能取代伺服器端的用量記錄。
使用方式:排查特定網頁時,先記下目前狀態,只瀏覽一個目標,再返回 Data 尋找相關記錄。若能查看規則或策略資訊,請一併核對目標網域、命中條件與處理策略;若沒有新增記錄,先檢查連線開關、頁面是否確實發出新請求,以及請求是否使用快取。
注意事項:清除記錄前,先保留需要比對的資訊。上傳與下載統計可能因通訊協定額外開銷、快取及統計時間範圍,與 App 顯示的檔案大小不同,不宜據此判斷伺服器計費是否正確。連線記錄可能包含瀏覽過的網域及其他個人資訊,分享截圖或記錄前請先檢查內容。
保留原值,每次只調整一項
以下項目請在 Settings 中尋找;是否顯示及所在層級,依目前平台與應用程式介面為準。
功能與位置:DNS 會將網域名稱解析為位址,可在 Settings 的 DNS 項目及設定檔的 [General] 參數中查看相關設定。DNS 設定來源、請求路徑與快取都會影響觀察結果,因此不能只更改一個位址,就認定解析方式已完全切換。
設定方式與注意事項:先記下原有設定,並確認目前設定檔是否另有 DNS 參數。只有在出現網域解析失敗、解析結果異常等明確線索時,才依網路環境調整。修改後重新建立連線,並再次瀏覽相同目標;若介面提供清除 DNS 快取的選項,可視需要使用。不要同時修改 DNS、伺服器與規則,否則無法判斷是哪項設定造成變化。即使連線已建立,網頁仍無法開啟,也可能是伺服器或目標服務的問題。
功能與位置:Settings 中的 Test Method 會決定 Connectivity Test 採用的測試方式。不同方式檢查的環節不同,數值不能直接跨方式比較;某項測試成功,只能表示該測試涵蓋的路徑有回應。
設定方式與注意事項:依介面提供的方式選擇;比較同一組伺服器時,請保持測試方式與測試目標一致。切換 Wi-Fi 與 Cellular 後應重新測試,不要沿用前一種網路下的結果。若所有項目都失敗,先檢查本機網路與測試目標;若只有單一項目異常,再核對該伺服器參數。最後仍須以實際使用情境驗證,不可只憑清單中的結果,就認定所有網站都能連線。
功能與位置:Today Widget 是受系統支援情況影響的快速入口,可在 Settings 查看相關選項,並透過系統提供的小工具新增介面設定。它不能取代 Home、Config 中的完整設定。
設定方式與注意事項:先在 App 中設定好伺服器與 Global Routing,再新增系統可用的小工具。確認小工具顯示內容與 App 目前狀態是否一致;若內容未即時更新,請返回 App 確認實際連線狀態。小工具類型、新增位置與可操作範圍取決於系統;目前裝置未顯示相關入口時,不要照搬其他系統的操作路徑。
功能與位置:iCloud 相關選項位於 Settings,能否使用取決於平台、系統帳號與雲端權限。請先閱讀目前介面列出的同步範圍,不要假設所有伺服器、規則與執行狀態都會一併同步。
設定方式與注意事項:確認系統已登入自己的 iCloud 帳號,並允許相關存取;啟用前先儲存重要的本機設定。另一台裝置首次使用時,先比較本機與雲端內容,再決定後續操作,避免尚未確認同步方向就大量刪除項目。同步不等於保留獨立的歷史備份;訂閱連結與伺服器驗證資訊都屬於敏感資料,匯出的檔案也應妥善保管。其他平台的資料移轉,請依其實際提供的功能操作。
使用相同條件重現問題
在 Settings 尋找 Diagnostics,並搭配 Home 的伺服器測試與 Data 記錄判斷;不要將單項檢查視為完整結論。
功能說明:Diagnostics 彙整目前平台提供的診斷功能,協助檢查網路、解析或連線環節。執行前先確定要釐清的問題:本機網路是否可用、伺服器是否有回應、網域能否解析,或是某條規則是否生效。不同問題需要不同證據。
使用方式:先記錄目前的網路類型、Global Routing 與設定檔名稱,再針對同一個目標重現一次異常。依下列順序逐項驗證,每次只修改一項並重新測試;保留結果後再進行下一步。
注意事項:開啟更多記錄前,先確認儲存範圍;排查完成後,及時停止不再需要的記錄。向他人說明問題時,請提供可重現的操作、錯誤訊息與已完成的檢查,不要公開完整訂閱網址、密碼或驗證欄位。若要逐項判斷,請繼續閱讀已連線但網頁無法開啟的檢查清單。