OFFICIAL MANUAL · SETTINGS

Shadowrocket
功能與常用設定

先在 Home 確認所選伺服器與 Global Routing,再檢查 Config 和 Settings。連線開關、路由模式與比對規則屬於不同層次的設定,不能互相取代。

閱讀與設定範圍

本頁依 iPhone / iPad 的 Home、Config、Data、Settings 編排說明。不同系統與應用程式版本的項目位置可能有所調整,請以目前介面顯示的名稱為準;若沒有顯示某個選項,不必依照相近名稱猜測設定。

Shadowrocket 提供 iPhone、iPad、Mac、Windows、Android 與 Linux 版本。Mac 版包含 Apple 晶片版和 Intel 版。需要取得用戶端時,請參閱全平台下載指南,選擇適用的裝置。

01 · GLOBAL ROUTING

Config、Proxy、Direct 三種模式

Global Routing 決定連線採用哪種處理方式。日常依規則使用時選擇 Config;臨時確認代理路徑是否可用時選擇 Proxy;需要比對目前網路的直連狀況時選擇 Direct。

模式與介面用語連線處理方式適用情況注意事項
設定 · Config依據目前啟用的設定檔比對規則,並執行相應策略。需要將不同目標分別交由 PROXY、DIRECT 或其他已定義的策略處理。先確認啟用的是預期設定檔,再檢查規則順序與 FINAL。
代理 · Proxy通常會將接管的連線交由目前選取的代理伺服器處理。暫時檢查伺服器及代理路徑,排除規則分流的影響。這不是驗證規則命中結果的方法,也不保證伺服器可用。
直連 · Direct接管的連線會直接連線,不經所選代理伺服器轉送。比對本地網路、目標服務與代理路徑之間的差異。這不代表關閉連線開關;系統中的 VPN 狀態仍可能維持啟用。

在 Home 切換並重新測試

進入 Home,開啟 Global Routing 後選擇所需模式,再返回確認目前顯示的設定值。切換後重新發出一次網頁請求;已建立的長連線可能仍沿用原本的連線狀態,因此不能只看舊頁面是否仍顯示,就判定新設定已套用至所有請求。

如果 Proxy 下正常、Config 下異常,請優先檢查設定檔、策略名稱和規則比對;如果兩者都異常,先檢查所選伺服器與基本網路,不要立刻重寫整份設定。疑難排解結束後,請恢復原本使用的模式,避免暫時切換至 Proxy 後長期改變應用程式的流量路徑。

02 · CONFIG / RULE

規則負責比對,策略負責處理

在 Config 中檢查目前設定檔。規則類型說明「比對什麼」,規則末端的策略則說明「比對後如何處理」;兩者應分開理解。

Config 不只是存放檔案的位置,也關係到目前使用的是哪一份規則。匯入或下載設定檔後,請確認已選取並啟用,而不只是出現在清單中。編輯前先儲存副本,並記下原本可正常連線的設定;每次只修改一類規則,方便對照變更與實際狀況。

規則類型比對對象設定依據與注意事項
DOMAIN指定的完整網域名稱。適用於只處理單一明確主機名稱,無法自動涵蓋所有子網域。
DOMAIN-SUFFIX指定網域及其子網域。適合依網域後綴分類,請填寫網域而非完整網頁網址。
DOMAIN-KEYWORD網域中包含的關鍵字串。比對範圍較廣,請留意誤比對到無關網域。
IP-CIDR / IP-CIDR6IPv4 / IPv6 位址範圍。適用於明確的網路範圍;請確認位址類型與前綴長度。
GEOIPIP 地理位置資料庫中的分類。結果取決於資料庫與解析出的位址,不能據此推斷帳號地區。
FINAL未符合前面規則的其餘連線。作為最後的兜底規則,明確指定最終策略。

依照由具體到一般的順序排列

規則通常會依序比對,因此應將更具體的例外規則放在較廣泛的規則之前。PROXY 表示交由代理路徑處理,DIRECT 表示直連,REJECT 表示拒絕連線;設定中的自訂策略名稱也必須有對應的定義。名稱拼寫不一致或策略引用失效,都可能導致規則看似正確,實際上卻無法如預期運作。

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

這段範例僅用來說明語法,並非完整設定:example.com 及其子網域交由 PROXY 處理,指定的本機位址範圍使用 DIRECT,其餘連線則由 FINAL 指定為 DIRECT。實際使用前,請依照自己的目標與現有設定決定策略,不要直接以整段內容覆蓋原有檔案。

判斷規則效果時,先確認 Global Routing 設為 Config,再針對明確目標重新發出請求。若目標是透過 IP 位址直接存取,網域規則不一定會參與比對;若服務同時使用多個網域,也不能只憑首頁成功一次,就認定所有請求都採用相同策略。

03 · HOME / ADD SERVER

訂閱與伺服器管理

訂閱用來批次維護伺服器項目;Home 中選取的伺服器則是目前預設的代理出口。匯入成功、更新成功與實際連線可用,是三件不同的事。

匯入已有資訊

在 Home 使用 Add Server,依照已有資料選擇對應類型;匯入訂閱時選擇 Subscribe,並填入完整訂閱網址。若有 QR Code,可使用 Scan QR Code,但掃描後仍須確認項目類型與重要欄位。請勿將一般網站網址、帳號管理頁面或設定說明網頁當作訂閱網址。

手動新增伺服器時,協定類型、伺服器位址、連接埠、驗證資訊,以及 TLS、傳輸相關欄位都應與使用者已有資料一致。協定名稱保留原文,例如 Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2。不要為了讓表單成功儲存而任意填入欄位;不確定的參數應回頭核對原始資料,也可繼續閱讀協定參考。

更新、選取與清理

訂閱更新後,請檢查伺服器清單是否有變化,並在 Home 重新確認以圓點標示的預設伺服器。原先選取的項目可能已移除或替換;清單中有名稱相似的伺服器,也不代表它們的位址和參數相同。手動新增的項目可加上方便辨識的備註,但備註本身不會改變連線方式。

刪除訂閱前,先確認需要保留的項目與原始訂閱網址。訂閱管理中的項目再次更新時可能被覆寫,因此直接修改其中一項未必能長期保留。若要單獨測試參數,請先保留原項目,再建立容易辨識的測試副本;測試結束後清除重複項目,避免選錯。

04 · ON DEMAND

按需連線與手動連線的差異

On Demand 用於依系統網路條件觸發連線,不負責選擇特定網域的 PROXY 或 DIRECT 策略。請先建立穩定的手動連線,再設定自動觸發條件。

在 Settings 中找到 On Demand,檢查目前開關與可用的網路條件。初次設定時,先在 Home 手動選取伺服器並確認可用,再逐項設定按需連線行為;若系統要求允許新增 VPN 設定,請閱讀提示並確認。具體條件以目前介面提供的項目為準,不必同時啟用所有選項。

啟用後,在實際使用的 Wi-Fi 與行動網路之間切換,觀察連線是否依預期建立或中斷,再檢查 Home 中的 Global Routing 是否仍為所需模式。自動建立連線不代表目前伺服器可用,也不表示所有請求都會使用代理;最終處理方式仍由路由模式與目前設定共同決定。

如果手動關閉後連線又恢復,請先檢查 On Demand,再查看系統中的 VPN 設定,而不是反覆刪除訂閱。進行連線疑難排解或需要完全停止自動連線時,請先暫時關閉 On Demand,再操作 Home 的連線開關。記下原本設定,測試結束後依實際需求恢復。

按需連線不等於持續傳輸資料。耗電與流量也會受到實際使用情況、協定、網路穩定度及重新連線頻率影響,不能只憑系統顯示 VPN 圖示就判定流量異常。需要核對時,應一併參考 On Demand 觸發記錄、Data 的觀察區間與實際應用程式使用情況。

05 · DATA

Data 流量統計的閱讀方式

Data 用於觀察用戶端記錄的流量變化,不是服務商帳單,也不是網路速度或線路品質的直接評分。

開啟 Data,先辨認目前頁面顯示的統計範圍、方向與單位,再對照實際操作。上傳和下載代表不同方向的資料;若頁面提供不同統計區間或清除功能,請先確認所選範圍。不要把單次連線的數字直接當成整月用量;清除統計後,也不要沿用原本的觀察起點。

進行對照測試時,可先記下目前讀數,暫停無關的背景傳輸,接著只執行一項明確操作,再觀察數值變化。流量增加只能表示有記錄到資料傳輸,不能單獨證明某個網域符合 PROXY 規則。若要判斷策略,還需一併參考 Global Routing、設定規則及可用的連線記錄。

用戶端與服務商的統計可能有所差異,原因包括統計起訖時間、協定額外負載、重傳及計量方式。若要確認帳戶剩餘用量,請查看使用者既有服務的帳戶記錄;不要只憑 Data 的單一數值推斷帳單。保留疑難排解記錄時,註明網路類型與測試操作,比只截取累計數字更有幫助。

06 · SETTINGS

Settings 常用項目與調整依據

以目前可用的設定作為基準,一次只變更一個項目。DNS、測試方法、快速入口、同步與診斷各自處理不同問題,不應把同時修改所有開關當成疑難排解步驟。

DNS:先區分解析與連線

DNS 會將網域名稱解析為位址。先在 Settings 檢查 DNS 相關設定,並一併確認目前 Config 是否包含 DNS 設定;實際運作方式可能受到設定檔影響。沒有明確需求時,先保留目前可用的設定;若有指定的解析方案,再依原始資料填寫,並記下修改前的值。

網域無法開啟但直接存取位址有回應,可能與解析有關,但這還不足以證明原因;HTTPS 網站也涉及憑證與網域。更換 DNS 後應重新發出請求,避免將快取結果誤認為新設定的效果。不要把變更 DNS 當成修正伺服器參數,也不要同時調整 IPv6、規則與伺服器,否則難以找出原因。

Test Method:先維持一致的測量方式

Test Method 決定相關測試採用的檢測方式,可在 Settings 查看並選擇目前可用的選項。不同方法涵蓋的連線階段不同,因此測試結果只適合在相同方法及相近網路條件下比較;變更方法後,不能直接將新舊結果排列成伺服器品質結論。

選擇方法後,返回 Home 執行 Connectivity Test,再測試實際使用情境。測試成功不代表所有網站都能存取,測試失敗也需配合檢測目標與目前網路判斷。若只有某一種測試方式出現異常,請先確認該方式的檢測條件,不要立刻刪除所有伺服器。

Today Widget:使用快速操作仍須確認狀態

Today Widget 用於系統支援範圍內的快速檢視與操作。先檢查 Settings 中的相關選項,再依系統目前提供的元件新增方式設定入口;若系統或目前版本沒有顯示此入口,不必為了尋找元件而更改連線參數。

透過元件操作後,返回 Home 核對伺服器、連線開關與 Global Routing。快速入口顯示的狀態可能需要重新整理,不能取代實際連線驗證。若鎖定畫面會顯示相關內容,也請檢查系統的顯示權限,避免在公開場合暴露不必要的伺服器備註。

iCloud 同步:不同於訂閱更新

iCloud 同步用於在個人裝置間同步目前版本支援的資料,與向既有服務商更新訂閱清單是兩項不同功能。在 Settings 檢查同步選項,並確認裝置使用預期的 iCloud 帳號、系統允許相關存取且網路可用。啟用前先儲存重要設定並核對本機與雲端內容,避免誤將舊資料當成新設定。

一台裝置修改後,請等待同步,並在另一台裝置實際確認結果,不要假設連線狀態、系統授權及所有設定都能完整移轉至其他裝置。伺服器密碼、訂閱網址與金鑰都屬於敏感資訊,請先了解同步資料的範圍;各裝置的系統 VPN 授權仍須分別確認。

Diagnostics:記錄單次故障的條件

Diagnostics 用於收集及檢查連線相關診斷資訊,可從 Settings 的對應入口開啟。先記錄目前網路、所選伺服器、Global Routing 與重現步驟,再執行可用的診斷工具。盡量只重現一次明確故障,避免大量無關請求淹沒有效資訊。

查看輸出時,留意問題發生在哪個階段:無法建立連線、驗證失敗、網域解析異常,還是目標請求沒有得到預期回應。診斷結果有助於縮小範圍,不代表所有目標的長期狀況。分享資料前,請遮蔽訂閱參數、驗證資訊、金鑰及不必要的個人存取記錄;完成疑難排解後,再依實際需求關閉詳細記錄。

07 · CHECK ORDER

變更設定後的檢查順序

保留原本狀態,依「伺服器 → 模式 → 設定檔 → DNS → 診斷」逐項檢查,比同時修改多個開關更容易找出問題。

  1. 確認基本網路。先檢查目前 Wi-Fi 或行動網路是否可用,以及是否需要完成網路驗證;這類問題無法透過修改規則解決。
  2. 確認伺服器。在 Home 核對圓點標示的選取項目,對照已有資料檢查協定與參數,再執行 Connectivity Test。
  3. 確認 Global Routing。需要依規則使用時選擇 Config;暫時切換至 Proxy 進行比對後,記得恢復原本模式。
  4. 確認 Config。檢查啟用的檔案、規則順序、策略引用與 FINAL。修改後重新發出請求,不要只觀察既有連線。
  5. 檢查解析與診斷。確認前述資訊無誤後,再檢查 DNS 和 Diagnostics;每次變更都記錄結果,若無效就還原。

如果尚未完成首次連線,請先閱讀首次連線教學,依序完成匯入、選取伺服器、允許 VPN 設定與連線驗證。若只需了解協定欄位,請前往協定參考,不要以切換 Global Routing 取代協定參數核對。

Proxy 可以連線,Config 無法連線時,該先檢查什麼?

先檢查 Config 中啟用的檔案、特定目標符合的規則及其對應策略,再檢查 FINAL。切換至 Proxy 比對,只能說明目前代理路徑在該次測試中可用,不代表 Config 中每項策略都有效;先不要修改已確認可用的伺服器參數。

關閉連線後又自動連線,是訂閱更新造成的嗎?

先檢查 On Demand 與系統 VPN 設定。訂閱更新用來重新整理伺服器資訊,按需連線則負責自動觸發連線。疑難排解時,暫時關閉 On Demand,再觀察手動開關是否能維持預期狀態。

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

流量變化不能證明目標請求已成功。背景活動、連線重試或部分請求都可能產生資料。請針對同一個目標檢查伺服器、Global Routing、規則與 DNS,並搭配 Diagnostics 縮小問題範圍。

設定後每次都需要重新匯入訂閱嗎?

通常不需要。路由模式、DNS 與訂閱內容屬於不同層次。只有在訂閱網址或既有伺服器資料變更、項目確實遺失時,才需要更新或重新匯入;刪除前請保留原始資料與必要的設定副本。