官方手冊 · 設定指南

Shadowrocket 設定
路由、規則與連線檢查

先確認 Global Routing 與目前使用的設定,再調整 DNS 或自動連線。每次只修改一項,並以相同目標重新測試,才能分辨問題來自規則、伺服器或本機網路。

本頁依 iPhone / iPad 介面整理操作步驟,其他平台的版面與可用選項請以實際介面為準。Shadowrocket 提供 iPhone / iPad / Mac / Windows / Android / Linux 版本;Mac 分為 Apple 晶片與 Intel 版本。

iPhone / iPad 版於 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。下載用戶端及查看各系統安裝與安全性提示,請前往用戶端下載頁;電腦與 Android 等版本的安裝檔統一由本站 /dl/shadowrocket/ 路徑提供。

01 · 路由入口

Global Routing:設定、代理與直連

三種模式會決定流量採用哪種路徑,但不會取代伺服器參數,也無法自動修復無法使用的服務。

在 Home 開啟 Global Routing,可選擇 Config、Proxy 或 Direct。一般使用時,通常先選 Config,讓目前設定檔中的規則決定請求路徑。選好模式後,也要確認 Home 中選取的伺服器與連線開關;模式名稱本身不代表連線已建立。

介面選項主要用途適用情境檢查事項
Config · 設定依目前設定中的規則與策略處理請求。適合需要區分網域、位址與預設路徑的日常使用情境。確認 Config 中選取的檔案正確,且規則順序符合預期。
Proxy · 代理以代理路徑處理流量,不依照 Config 的一般分流規則逐項選擇。暫時確認伺服器路徑是否可用。確認目前伺服器有效;本機網路資源可能受到影響。
Direct · 直連以直連路徑處理流量。暫時比對本機網路的連線狀況。Direct 不代表已關閉連線開關,也不保證網路一定可連通。

設定方式:固定條件後再切換模式

先記下目前模式與伺服器,選定一個要測試的目標。在相同網路下先以 Config 測試,再短暫切換至 Proxy 比較。如果 Proxy 可以連線而 Config 不行,應優先檢查規則比對結果與策略引用,不要立刻重新填寫伺服器資料。如果兩種模式都失敗,再檢查伺服器資訊、DNS 與本機連線。

Direct 適合觀察不經代理路徑時的連線狀況,但單次直連成功不代表所有服務都正常。不同目標可能需要不同的解析與連線條件。比對完成後,請恢復原本的 Config 模式,避免測試設定長期保留,導致區域網路存取或日常分流與預期不符。

02 · Config

規則分流:先比對條件,再套用策略

規則分流會在 Config 模式下,依據網域、IP 位址等條件為請求選擇處理策略。進入 Config 後,先確認目前選取的檔案,再查看檔案中的規則內容。匯入檔案不代表正在使用該檔案;修改其他檔案,也不會改變目前連線的分流結果。

規則通常依由上而下的順序比對,最先符合的規則會決定後續處理方式。特定網域與區域網路位址應放在適當位置,範圍較廣的條件則放在後面;FINAL 用來處理此前未符合任何規則的請求。不要只因某條規則「已存在」就認定它會生效,也要檢查前面是否已有更早符合的條件。

關鍵字比對對象設定注意事項
DOMAIN指定的完整網域。適合精確控制單一主機名稱。
DOMAIN-SUFFIX指定網域及其子網域。請勿輸入完整網頁網址或附加路徑。
DOMAIN-KEYWORD網域中包含的關鍵字。比對範圍較廣,請留意意外符合的情況。
GEOIPIP 所屬的地區分類。結果取決於解析取得的位址及所使用的資料。
IP-CIDR / IP-CIDR6IPv4 / IPv6 位址範圍。確認位址類型與前綴長度。
FINAL此前未符合任何規則的請求。放在規則末尾,明確指定預設路徑。

設定方式:以少量明確規則進行測試

以下片段僅示範語法與順序,不是完整設定,也不包含可用來連線的伺服器。PROXY 表示採用代理處理,DIRECT 表示直連,REJECT 用於拒絕符合條件的請求。若引用自訂策略名稱,請先確認該名稱存在於目前設定中,不要只複製範例名稱。

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

修改前先備份原始檔案;修改後確認仍選取該檔案,必要時重新建立連線,再開啟目標並查看記錄。瀏覽器可能沿用現有連線,因此只重新整理頁面未必能驗證新規則。更完整的比對說明請參閱規則關鍵字比對邏輯。

03 · Home / Add Server

訂閱與伺服器管理

伺服器項目會儲存連線所需的位址、連接埠、協定與驗證資訊;訂閱則用於匯入及更新一組伺服器項目。以下操作以使用者已有自己的訂閱或伺服器資訊為前提。本網站不提供、銷售或推薦節點或訂閱服務;用戶端一次性購買 ≠ 線路方案。

在 Home 使用新增入口進入 Add Server。新增單一伺服器時,先選對 Type,再依現有資料填寫參數;匯入訂閱時,選擇 Subscribe,輸入已有的訂閱網址並儲存。不同協定所需欄位不同,請勿將 VLESS 欄位直接套用到 Trojan 或 Shadowsocks。

更新訂閱與切換伺服器是不同操作

更新訂閱會重新取得清單,不保證自動切換到你想使用的項目。更新後請回到 Home 確認目前選取的伺服器,尤其是原項目遭移除或重新命名時。訂閱網址也不應填入 Config 的檔案網址欄位:前者通常提供伺服器清單,後者則用於規則與設定內容,請依各自來源的說明分別處理。

刪除訂閱前,先確認是否仍需要其中的項目;手動修改由訂閱產生的項目後,後續更新可能會覆寫修改內容。訂閱網址、QR Code 與驗證欄位可能包含存取憑證,分享截圖或排查資訊前請先遮蔽。完整匯入流程請參照首次使用教學逐步操作。

04 · 自動連線

On Demand:依條件觸發連線

On Demand 可依設定條件觸發 VPN 連線,但不會替你挑選可用伺服器,也不會改變規則的比對順序。請在 App 的 On Demand 設定中檢查可用條件;實際位置與條件項目可能隨系統及 App 介面更新,請以裝置顯示為準。

設定方式:手動連線確認正常後再啟用

先關閉自動觸發,確認目前伺服器、Config 與手動連線都能正常運作。接著進入 On Demand,依實際需求設定網路條件,再啟用功能。如果介面提供 Wi-Fi 名稱條件,請逐字確認網路名稱;網路更名後也要重新檢查原有條件,勿憑記憶判斷是否仍符合。

測試時應實際變更網路,例如在符合與不符合條件的網路間切換,再觀察系統 VPN 狀態與 App 連線記錄。只在設定頁開啟開關,無法證明條件已正確觸發。測試期間請保持伺服器與設定不變,才能判斷變化是否由 On Demand 引起。

其他 VPN 設定與系統網路狀態也可能影響觸發結果。若出現連線循環,先停用 On Demand,恢復一次穩定的手動連線,再逐項重新啟用條件。自動觸發不保證網路隨時可用;裝置從睡眠喚醒、網路切換及伺服器狀態變化仍需分別檢查。

05 · 流量觀察

Data:查看流量,不等同服務帳單

Data 用於查看 App 記錄的流量統計。開啟 Data 後,先確認目前頁面顯示的統計範圍、時間或連線對象,再觀察上傳與下載的變化。不同統計口徑不宜直接相減,更不能將 App 記錄視為服務供應商的計費結果。

使用方式:固定時間區間觀察變化

若要確認某項操作是否產生流量,先記下目前數值,盡量維持其他 App 的活動不變,執行一次明確的連線操作,再回到 Data 查看變化。如果介面提供重設統計功能,請先記下需要保留的資訊;重設用戶端統計不會改變伺服器端記錄,也不會恢復任何服務額度。

有流量只表示發生了資料傳輸,不代表目標內容一定成功載入;流量沒有明顯增加,也可能是快取、既有連線或觀察對象不同所致。應一併參考 Data、連線記錄、Global Routing 與實際結果。發現流量異常增加時,先確認背景 App 活動與目前網路,不要只憑累積數字判定特定伺服器有問題。

06 · Settings

常用設定:每次只修改一個項目

請以目前介面顯示為準。部分選項取決於系統功能或目前設定,排查時先確認實際生效的位置,不要同時修改多個類似開關。

DNS:確認網域如何解析為位址

DNS 會將網域解析為連線所需的位址。先在 Settings 檢查 DNS 相關選項,再查看目前 Config 是否有設定 dns-server 等項目,避免只修改一處而忽略另一處。記下原始值後,再依使用的網路與設定需求調整;排查時不要一次填入多個來源不明的位址。

完成設定後,以相同網域重新測試,並參考記錄區分解析失敗與連線失敗。若 IP 可以連線而網域不行,可優先檢查解析,但仍須留意 TLS 與目標服務是否依賴網域名稱。以下是設定中使用系統解析的語法範例,並非適用於所有網路的建議設定。

[General]
dns-server = system

Test Method:了解 Connectivity Test 的測試項目

Test Method 用於選擇連線測試方式,可在 Settings 中確認,再回到 Home 執行 Connectivity Test。不同方式檢查的網路環節不同,因此切換方式後,不宜直接比較前後數值。若介面允許設定測試目標,請使用明確且能正常回應的目標。

測試通過不代表所有網站都能連線;測試失敗也無法單獨證明驗證資訊有誤。請記下測試方式、目標與網路條件,再搭配一次實際請求檢查。執行批次測試時,請等候結果完成,避免連續觸發而難以分辨各次結果。

Today Widget:快速查看與操作入口

Today Widget 是系統支援時可使用的快速入口。先在 Settings 查看相關設定,再依系統提供的小工具新增流程進行設定。可顯示哪些狀態、能否執行操作,取決於目前系統與 App 提供的功能;小工具顯示的舊狀態不應視為即時連線記錄。

首次使用時,先開啟主 App 完成設定與必要授權,再測試小工具。若顯示內容與主 App 不一致,先回到 Home 確認目前連線,再檢查系統中的小工具設定。伺服器參數、規則編輯與診斷仍應在 App 內完成。

iCloud:先確認同步範圍,再處理內容覆寫

在 Settings 查看 iCloud 相關入口,同時確認系統中目前的 Apple 帳號與 App 的 iCloud 使用權限。同步前先確認介面列出的項目,不要預設伺服器清單、規則檔案、統計資料與所有偏好設定都會同步。不同裝置可同步的項目請以實際顯示為準。

首次在另一台裝置啟用前,請保留本機的重要設定。若內容不一致,先停止在兩台裝置上同時編輯,確認要保留哪一份,再依介面提供的操作處理。同步不等於獨立備份,誤刪的狀態也可能繼續同步;含有驗證資訊的檔案應視為敏感資料妥善管理。

07 · Diagnostics

診斷與復原:從失敗環節找出設定問題

Diagnostics 用於收集及查看排障資訊,可在 Settings 的相關入口中尋找。進入後依目前介面提供的工具檢查連線、解析或請求記錄。診斷資訊只能協助縮小問題範圍;沒有相應證據時,不應將所有失敗都歸因於 DNS、規則或伺服器其中一項。

檢查方式:保留最精簡的重現步驟

  1. 確認目前狀態。記下網路類型、Global Routing、選取的伺服器與 Config 檔案,先排除修改到非目前使用檔案的可能。
  2. 重現單一目標。只進行一次明確的連線操作,記下發生時間,避免多個 App 同時測試而使記錄混雜。
  3. 判斷失敗階段。先確認是否取得位址,再檢查連線與驗證是否繼續,最後核對規則選取的策略是否符合預期。
  4. 修改一項後重新測試。保留修改前後的結果;若沒有改善,先還原原值再檢查下一項,避免累加多項不確定的修改。

如果 Proxy 可用而 Config 不可用,優先檢查規則與策略;如果更換網路後恢復,著重比較網路條件與解析;如果匯入後始終無法連線,重新核對原始伺服器資料。以上現象僅供排查參考,仍應以目前請求記錄與重複測試結果為準。

分享診斷內容前,請遮蔽伺服器驗證欄位、訂閱網址中的憑證、個人網域及其他敏感資訊。不要直接傳送含有憑證的完整設定檔。復原時優先使用修改前備份的檔案與設定記錄,重新檢查 Config、Global Routing 與 On Demand,最後再確認實際連線結果。

修改規則後沒有變化,該先檢查什麼?

先確認 Global Routing 設為 Config,再檢查 Config 中選取的檔案、規則順序與策略名稱。重新建立連線並發出新請求,排除沿用舊連線的情況後,再查看對應記錄。

Data 顯示有流量,為什麼頁面仍然無法開啟?

流量可能來自連線嘗試、其他 App 或已建立的連線。請檢查該請求的解析、策略與連線結果,不能只憑累積流量判斷目標是否連線成功。

關閉連線後又自動連上,如何暫停?

先檢查並停用 On Demand 的觸發條件,再關閉連線。接著觀察系統 VPN 狀態;若要恢復自動連線,再逐項啟用條件並測試。

繼續閱讀:首次設定請依教學操作;商店、開發者與購買記錄的確認方式請參閱正版指南。