Shadowrocket 官方手冊 · 功能介紹

Shadowrocket 功能與常用設定

先確認請求採用哪種路由方式，再調整規則、連線條件與診斷選項。設定是否合適，須依據現有伺服器、目前網路及實際連線結果判斷。

  • Global Routing
  • Config / Proxy / Direct
  • Settings / Data
先閱讀入門指南 查看完整使用手冊 →

五大功能，先了解用途

以下為功能說明，並非應用程式介面。切換分類查看用途；操作方式與注意事項請參閱後續章節。

規則決定請求的處理方式

規則分流會將請求的網域或目標位址逐一比對設定中的條件，再交由相應策略處理。入口位於 Config；要讓規則生效，還須將 Home 的 Global Routing 設為 Config。先確認目前啟用的設定檔，再調整個別規則；若修改的檔案未啟用，連線結果不會改變。排查時請查看請求記錄確認命中項目，不要只根據伺服器延遲判斷分流是否正確。

DOMAIN-SUFFIX,example.com,PROXY
Home

Global Routing：Config／Proxy／Direct

Global Routing 用來控制整體路由方式。日常需要依網域與位址分流時，使用 Config；需要檢查代理連線路徑時，可暫時切換至 Proxy；需要檢查直接連線結果時，可使用 Direct。這三者並非速度等級。

模式與介面用詞處理方式常見用途檢查重點
設定 · Config依目前啟用設定中的規則與策略處理請求。日常分流；驗證自訂規則。確認設定檔已啟用、規則順序正確，且策略指向無誤。
代理 · Proxy以代理方式處理整體流量；仍受系統與應用程式的處理範圍限制。暫時檢查目前伺服器的代理連線路徑。確認選取的伺服器有效；測試後切回日常使用模式。
直連 · Direct以直接連線方式處理整體流量。檢查本機網路或直接連線的結果。Direct 不等於停用系統中的 VPN 連線。

設定順序與重新測試方式

在 Home 開啟 Global Routing，選擇所需模式後返回，確認目前顯示的值。使用 Config 時，再到 Config 確認設定檔已啟用；使用 Proxy 時，核對目前選取的伺服器。接著重新送出目標請求，必要時先結束舊連線再測試，因為既有連線可能不會立即依新設定重新建立。

如果只有在 Config 下發生問題，而同一目標在 Proxy 下可以連線，請優先檢查規則命中、策略組選擇與解析路徑。這只是縮小排查範圍的方法，並非故障結論。若兩種模式都無法連線，還需核對伺服器參數、驗證狀態與目前網路。

Config

規則類型、處理策略與比對順序

規則用來決定「哪些請求採用哪種處理方式」。在 Config 中開啟目前使用的設定檔，找到規則編輯入口，先了解現有項目，再新增例外。規則通常由上而下檢查，命中後便採用相應策略；較明確的條件應排在較廣泛的條件前面，FINAL 則作為未命中請求的預設處理方式，放在最後。

依目標選擇比對類型

  • DOMAIN：比對指定網域，適合只針對單一完整主機名稱的情況。
  • DOMAIN-SUFFIX：比對指定網域及其子網域，適合依網域範圍管理請求。
  • DOMAIN-KEYWORD：依網域中的關鍵字比對，涵蓋範圍較廣，新增前請評估誤判風險。
  • IP-CIDR 與 IP-CIDR6：依 IPv4 或 IPv6 位址範圍比對；請留意是否涉及解析，以及目標是否使用動態位址。
  • GEOIP：依位址地理資料庫分類進行比對；資料庫結果不能取代對服務實際位置與用途的判斷。
  • USER-AGENT：依據可見的請求資訊比對，不能視為適用於所有應用程式的可靠識別方式。

分清策略名稱與介面模式

DIRECT 代表直接連線，REJECT 代表拒絕符合條件的請求，PROXY 用於代理處理，實際指向須依設定確認。規則中的大寫策略與 Global Routing 中的 Config／Proxy／Direct 屬於不同層級；也可能有自訂策略組名稱，引用時必須與設定一致。

DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.net,PROXY
FINAL,PROXY

以上為規則語法範例，並非可直接取代現有設定的完整檔案。修改前請保留原設定，修改後確認該檔案仍為啟用狀態，再透過請求記錄檢查實際命中項目。不要把所有異常都交由範圍寬泛的關鍵字規則處理，否則日後難以追查哪些網域因此改變了處理方式。

Home / Add Server

伺服器管理與協定參數

伺服器項目會儲存連線至遠端所需的資訊；名稱只是方便辨識的標籤，不會決定協定類型。使用者須先備妥自己的伺服器資訊，再於 Home 選擇 Add Server，挑選相應協定，並逐項填寫位址、連接埠與驗證欄位。不同協定的欄位用途各異，不要將 Shadowsocks 密碼直接填入需要其他身分參數的項目。

使用 Scan QR Code 匯入既有資訊時，相機權限僅用於完成掃描。匯入後仍須開啟項目檢查類型與位址；QR Code 可能包含單一伺服器資訊，也可能指向訂閱，不能只憑外觀判斷內容。透過剪貼簿匯入時，也請確認沒有一併複製前後的說明文字。

修改項目時，先保留可還原的狀態

先記錄原始參數或保留一個獨立項目，再修改需要驗證的欄位。TLS、伺服器名稱與傳輸參數應符合既有服務資訊。連線失敗時，不要不斷猜測連接埠，也不要把降低驗證要求當成通用修復方式。HTTP、SOCKS5、WireGuard、Hysteria2 等類型，請依實際欄位說明填寫，不要將一種協定的經驗照搬到另一種協定。

儲存後，先在 Home 選取該伺服器，再執行 Connectivity Test 並嘗試實際連線。項目出現在清單中只代表儲存成功；測試方式、遠端可達性與實際服務連線是三件不同的事。刪除項目前，也請確認是否有策略組或目前設定檔正在引用該項目。

Subscribe

匯入、更新與維護既有訂閱

Subscribe 用於集中取得並更新伺服器清單，與規則設定不同。將使用者已有的訂閱網址填入相應欄位並儲存後，執行更新，確認是否出現預期項目。網址應來自自己的服務資訊；網站後台、付款頁面與訂閱網址用途不同，不能互相替代。

更新後檢查三件事

  1. 確認此次更新是否成功，並區分網路連線失敗與內容無法解析；不要反覆新增同一個網址。
  2. 確認目前選取的伺服器仍存在，並留意項目名稱或群組變更後是否誤選了其他項目。
  3. 重新驗證實際連線，確認規則中的策略組仍指向正確的伺服器範圍。

訂閱更新可能覆蓋由訂閱管理的項目。若要獨立維護特定參數，請先了解更新行為，再決定是否另外保留手動項目。不要直接刪除整個群組後才發現沒有原始網址；清理前請先確認能否重新匯入，並妥善保存必要資訊。

用戶端一次性買斷 ≠ 連線服務方案。Shadowrocket 的購買與使用既有服務的資格分開管理。本教學站不提供、不銷售也不推薦節點或訂閱，僅說明如何使用使用者已有的資訊。

訂閱網址常包含身分憑證。分享故障截圖時，請遮蔽完整網址與驗證欄位；不要將連結放在公開文件中。若無法取得內容，請先確認網址是否仍有效、目前網路能否連線，以及回傳內容是否正確，再考慮調整應用程式設定。

On Demand

On Demand：按需連線條件

On Demand 是自動連線行為的條件設定，不是規則分流的另一種名稱。請先在應用程式中開啟 On Demand，閱讀目前介面提供的條件與動作，再依自己的網路情境設定。實際入口與可用選項以目前應用程式介面為準；請勿只依其他裝置上的設定位置尋找。

從單一條件開始測試

若要依 Wi-Fi 區分，請核對 SSID 拼寫與適用動作；若要涵蓋行動網路，請另外檢查相應條件，不要以為 Wi-Fi 條件會自動套用至所有網路。使用網域觸發條件時，請了解它與規則檔中的網域策略分別負責觸發連線與處理請求。

建議先保留一項容易驗證的條件，切換至目標網路後觀察系統 VPN 狀態，再離開該網路重新測試。若有多項條件，請依介面順序與實際動作檢查是否重疊，避免一項要求連線，另一項卻要求不同處理方式。每新增一項條件就進行雙向測試，比一次設定所有條件更容易定位問題。

若手動中斷後系統又重新連線，請先暫時停用 On Demand 並重新測試，確認是否由條件觸發。若日常需要完全中斷連線，也要同時檢查應用程式的連線狀態與按需連線設定。正常使用前，還須完成系統要求的 VPN 設定授權；取得連線權限不代表已有可用伺服器。

Data

Data：流量變化與統計方式

Data 用於查看應用程式能夠統計到的流量資訊。開啟 Data 後，先確認目前頁面的統計範圍、方向與時間區間，再觀察特定連線前後的變化。上傳與下載代表資料傳輸方向，不直接表示網頁是否完整載入，也不能只憑某個數字判斷問題出在規則或伺服器。

排查時可先暫停其他明顯的網路活動，記下測試前的數值，再造訪已知目標並比較。若統計數值有變化但頁面仍無法載入，還需檢查解析、交握或應用程式層級的錯誤；若變化不明顯，則繼續核對連線狀態、路由方式與請求是否進入預期的處理路徑。

不要將用戶端統計視為服務帳單

用戶端、系統與既有服務的計量範圍可能不同，連線額外流量、統計週期與計費規則也可能各異。Data 適合觀察趨勢與輔助排查，不能取代服務端的剩餘額度或使用記錄。需要比較時，請先統一時間範圍與單位，不要直接將兩個總數相減。

若目前介面提供重設統計資料的功能，請先確認是否需要保留排查記錄，再執行重設。重設顯示記錄不會改變已產生的服務用量；更換裝置或重新安裝後，也不要假設所有歷史統計都會還原。

Settings

常用 Settings：依問題調整

先維持可正常運作的基準，再逐項修改。部分設定可能由目前的 Config 管理；檢查應用程式設定時，也要查看設定檔是否有相應項目。以下依用途說明，不需要逐一修改所有選項。

DNS：網域解析路徑

DNS 會將網域解析為位址。請在 Settings 與目前的 Config 中檢查相關設定，先確認使用哪種解析來源，再查看是否有設定互相覆蓋。若網頁無法開啟但 Connectivity Test 正常，可優先檢查目標網域是否解析成功。

修改前先記錄原始值，每次只更換一個相關選項，再重新建立連線驗證。不要同時疊加多組用途不明的 DNS 設定；解析成功也不代表後續連線一定成功。

Test Method：測試方式

在 Settings 中查看 Test Method，並了解目前測試方式實際檢查哪一段連線。不同測試方式所依賴的請求與目標可能不同，因此同一伺服器的結果未必能直接比較。

比較既有伺服器時，盡量使用相同網路、相同測試方式，並選擇相近的時間。測試正常後仍應嘗試連線至實際目標；測試失敗時也要依錯誤類型進一步檢查，不能直接認定所有服務都無法使用。

Today Widget：快速查看與操作

Today Widget 適用於系統支援的快速查看或操作情境。先在應用程式中查看相關設定，再前往系統提供的小工具管理入口新增；可用形式與操作能力依目前系統及應用程式說明為準。

若顯示狀態與預期不同，請先返回 Home 核對實際連線狀態，再檢查 On Demand。小工具是快速入口，不能取代伺服器設定、系統授權與完整的連線驗證。

iCloud：同步前先確認範圍

在 Settings 中查看 iCloud 相關選項，並檢查系統中的相應 iCloud 權限。依目前介面說明確認同步範圍，不要假設伺服器、設定檔、統計資料與系統授權都會一併同步。

首次啟用或更換裝置前，請保留重要設定；若多部裝置的內容不一致，先停止同時編輯。應用程式購買記錄與設定同步是不同流程；系統 VPN 授權仍須在各裝置上確認。

Diagnostics

Diagnostics：記錄、重現、驗證

Diagnostics 用於取得排查線索，通常可從 Settings 的相關入口進入。先記下故障發生時的網路、選取的伺服器、Global Routing 模式與目標，再依目前介面說明啟用所需診斷功能。並非每種問題都需要長時間記錄；針對一次可重現的請求收集資訊，通常更容易判讀。

依固定順序縮小範圍

  1. 檢查連線基礎。確認系統網路正常、應用程式連線狀態符合預期，且既有伺服器參數未遭誤改。
  2. 檢查網域解析。查看是否解析失敗或逾時；若使用位址可以連線，但網域請求失敗，請進一步核對 DNS 路徑。
  3. 檢查規則命中。在 Config 模式下確認請求採用的策略，再核對策略組實際選取的伺服器。
  4. 檢查連線錯誤。分別處理逾時、驗證失敗與 TLS 相關問題，不要用同一項設定修改來處理所有錯誤。
  5. 每次只修改一項，再重新測試。使用相同目標重新建立請求，確認結果後再決定保留或還原修改。

完成排查後，依需要停止額外記錄，只保留能說明問題的必要片段。對外回報前，請檢查內容中的伺服器位址、驗證資訊、訂閱網址與存取網域；移除敏感資訊後，再說明重現步驟及已嘗試的修改。

為什麼 Proxy 可以連線，切回 Config 就失敗？

先檢查目前啟用的設定檔、目標命中的規則與策略組指向，再核對 DNS。兩種模式採用的處理路徑可能不同，不能只憑這個現象就認定伺服器故障。修改後請重新建立連線，避免既有連線影響判斷。

延遲測試正常，還需要檢查什麼？

測試結果只反映所選 Test Method 下的狀況。請繼續檢查實際目標的網域解析、規則命中、TLS 連線與存取結果，並確認目前選取的伺服器與剛才測試的是同一個項目。

設定越來越多，如何恢復到便於排查的狀態？

先保留目前設定，再回到一份已知可正常運作的基準，暫時簡化 On Demand 條件，並選定一部既有伺服器與一個測試目標。之後每次只修改一項，逐步恢復設定；沒有備份時，請勿直接清空所有內容。

需要完整的操作順序，可繼續閱讀入門指南；若要依首次啟動、設定管理與日常維護逐章查閱，可參閱新手到進階官方手冊。