官方手冊 · 功能介紹

Shadowrocket
功能與常用設定

從 Global Routing 到 Settings，依照「先確認流量處理方式，再檢查連線與診斷」的順序，查閱各項功能的用途、位置、設定方式與注意事項。

  • 路由模式 Config / Proxy / Direct
  • 規則策略 PROXY / DIRECT / REJECT
  • 排查入口 Connectivity Test

Shadowrocket 提供 iPhone、iPad、Mac（Apple 晶片與 Intel）、Windows、Android 和 Linux 版本。以下以 iPhone / iPad 英文介面用語作為定位依據；其他平台的功能位置與系統權限可能不同，請以目前應用程式畫面為準，勿將單一平台的選單路徑套用至所有裝置。

開始前，請備妥已有的訂閱或伺服器資訊，並確認目前選取的設定檔。若尚未取得應用程式，請先參閱全平台下載指南；首次連線的完整操作請見使用指南。本頁著重說明各項設定之間的關係，不必逐一變更預設值。

01 / GLOBAL ROUTING

Global Routing：設定檔、代理與直連

功能說明：Global Routing 決定用戶端接管的請求如何處理。介面中的 Config、Proxy、Direct 分別代表設定檔、代理與直連三種模式；它們不是三台伺服器，也不代表連線品質等級。選擇模式後，仍須檢查連線開關、伺服器及系統授權。

位置與設定方式：在 Home 開啟 Global Routing，依需求選擇模式。若已有規則設定檔，且希望依網域或位址分流，請選擇 Config；若要判斷問題是否與規則有關，可暫時切換至 Proxy 或 Direct，使用相同目標重複測試並記錄結果。

介面選項處理方式適用情境檢查重點
Config · 設定檔依目前設定檔中的規則與策略處理請求。日常使用時，讓不同目標透過不同路徑連線。目前設定檔、規則順序與策略指向。
Proxy · 代理將用戶端接管的請求交由代理路徑處理。暫時排除規則分流的影響，確認伺服器連線路徑。預設伺服器是否已選取且可正常使用。
Direct · 直連將用戶端接管的請求交由直連路徑處理。確認目前網路能否直接連線至相同目標。本地網路、DNS 與目標本身的狀態。

注意事項：Proxy 不代表「所有系統行為必定經由同一路徑」，實際範圍仍取決於系統與接管設定。Direct 也不等於關閉連線開關。排查完成後請恢復原本模式，否則即使設定檔未變更，流量處理結果也可能與先前不同。若 Proxy 正常而 Config 異常，應優先檢查命中的規則，而非立即重新匯入伺服器。

02 / CONFIG

規則分流：比對條件與處理策略

功能說明：一條規則通常由比對類型、比對內容與策略組成。DOMAIN 用於比對完整網域；DOMAIN-SUFFIX 用於比對網域及其子網域；DOMAIN-KEYWORD 用於比對網域關鍵字。IP-CIDR 與 IP-CIDR6 分別表示 IPv4、IPv6 網段；GEOIP 則依 IP 位址歸屬資料庫比對。USER-AGENT 取決於可取得的請求資訊，不適合作為所有應用程式流量都能命中的通用條件。

位置與設定方式：進入 Config，先確認目前使用的設定檔，再檢查規則與策略。規則通常依序比對，因此應將具體條件排在較寬泛的條件之前，並在末尾設定 FINAL 處理未命中的請求。PROXY 代表交由代理策略處理，DIRECT 代表直連，REJECT 代表拒絕；若設定檔引用具名策略，還須確認該名稱實際關聯的項目。

DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

以上內容僅用於說明規則語法；example.com 是示範網域，並非可直接匯入的完整設定檔。第一條規則已涵蓋的網域，不必再依賴後續的關鍵字規則；末尾的 FINAL 則負責處理前面規則未涵蓋的請求。閱讀時將「比對對象」與「交由誰處理」分開判斷，比只看行尾的 PROXY 更容易找出問題。

注意事項：規則無法自動修復失效的伺服器。每次只修改一項，儲存後確認該設定檔仍是目前使用的設定檔，再重新送出請求檢查結果。使用 IP 類規則時，也要考量網域解析結果、IPv6 與資料庫差異；勿只憑單一地理位置比對規則，推斷所有請求的實際路徑。

03 / HOME · SUBSCRIBE

訂閱與伺服器管理

功能說明：伺服器項目會儲存單次連線所需的協定與參數；Subscribe 則用來透過使用者已有的訂閱網址更新伺服器清單。訂閱與 Config 是不同項目：匯入伺服器清單，不代表已切換至某個規則設定檔，也不代表已選取預設伺服器。

位置與設定方式：在 Home 使用新增入口。匯入已有訂閱時，選擇 Subscribe 類型，貼上完整網址，填寫便於辨識的備註並儲存，接著執行更新。手動新增時，透過 Add Server 選擇服務資訊明確列出的協定類型，再逐項填寫位址、連接埠與驗證參數；Scan QR Code 適用於掃描使用者已有的有效 QR Code。

Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 的參數結構各不相同。位址相同不代表可以更換協定類型，也不能將伺服器網域自動視為所有 TLS 欄位的值。各欄位應依使用者已有的資訊填寫；如需了解欄位用途，請參閱協定參考。

注意事項：更新訂閱可能會變更項目名稱與清單內容。更新後請重新確認預設伺服器，避免繼續使用已移除的項目。重複匯入同一訂閱會增加管理負擔；刪除前請先區分訂閱產生的項目與手動新增項目。訂閱網址可能包含存取憑證，分享截圖、記錄或設定檔前，請隱藏完整網址與驗證資訊。

04 / ON DEMAND

On Demand：依條件觸發連線

功能說明：On Demand 是系統隨需連線機制的設定入口，會在符合已設定條件時觸發連線。它不負責為網域指定 PROXY 或 DIRECT；是否觸發連線，以及連線建立後如何分流，是兩項不同的設定。

位置與設定方式：在 Settings 中尋找 On Demand，先閱讀目前的觸發條件，再啟用所需規則。若介面提供依網路類型或指定網路設定條件的選項，請按實際使用情境逐項設定。儲存後，在相應的網路環境中驗證一次，並確認系統已允許新增 VPN 設定。

注意事項：隨需連線可能在使用者手動中斷後再次啟動，這不一定表示開關失效，請先確認觸發條件。若要排查無法連線，可暫時停用 On Demand，改用手動連線建立可重複的測試條件；排查完成後再恢復設定。切換網路後的觸發時機由系統共同控制，不代表任何情況下都能持續保持連線。

05 / DATA

Data：查看流量記錄

功能說明：Data 可查看用戶端記錄的流量統計，協助觀察連線期間的資料活動。統計僅涵蓋用戶端本身的記錄範圍，不是系統所有應用程式的完整用量，也不能取代使用者既有服務的計費記錄。

位置與使用方式：進入 Data，先確認介面顯示的統計期間、流量方向與分類，再比較操作前後的變化。例如只開啟一個待測試目標，記錄前後數據是否增加，並配合目前的 Global Routing 模式判斷。若介面提供重設統計資料的功能，執行前請確認是否需要保留現有記錄。

注意事項：流量增加只能表示有資料活動，不能單獨證明目標內容已成功載入，也無法據此判斷所有請求都符合預期策略。背景請求、重試與連線耗用也可能計入統計。不同裝置的數據不宜直接加總後與服務商記錄比較；請先確認各自的統計期間、單位與計量方式。

06 / SETTINGS

Settings：常用設定項目的適用範圍

Settings 中的項目可能因平台與系統權限而異。以下依功能名稱說明，不將特定子選單層級視為固定路徑。進入設定前先記下原值；若應用程式同時提供設定檔內設定與全域設定，請確認目前設定檔是否另有覆寫，避免在多個位置反覆修改同一項目。

DNS：確認網域解析路徑

用途與位置：DNS 會將網域轉換為位址，可在 Settings 的 DNS 相關項目及目前設定檔中檢查。設定方式：先確認目前設定檔是否指定解析方式，再依既有設定需求調整，儲存後重新送出請求。注意事項：DNS 解析成功不代表代理連線成功；修改解析設定也無法修正錯誤的驗證參數。遇到「位址可連線、網域無法使用」時，DNS 是優先檢查項目之一，不建議將所有連線故障都歸因於 DNS。

Test Method：統一測試方式

用途與位置：Settings 中的 Test Method 可設定相關連線測試的方式。設定方式：依目前介面提供的選項選擇測試方式，再回到 Home 執行 Connectivity Test。比較多台伺服器時，請保持測試方式與網路環境一致。注意事項：不同測試方式涵蓋的連線階段不同，結果不宜直接混合比較；單次測試成功，也不代表所有網站、協定或長時間傳輸都正常。

Today Widget：查看快速入口

用途與位置：Today Widget 是與系統小工具顯示相關的設定項目，可在 Settings 查看目前可設定的內容。設定方式：依應用程式與系統提供的入口設定顯示項目，再到系統對應的小工具區域確認是否可加入。注意事項：小工具是否顯示、更新時機與可執行的操作會受系統版本影響；若未顯示，請先檢查系統小工具設定，勿因此重新建立伺服器設定。若不確定小工具的狀態，請以應用程式內 Home 顯示的狀態為準。

iCloud：檢查同步範圍與覆寫情況

用途與位置：iCloud 相關項目用於同步或復原應用程式支援的資料，可在 Settings 查看。設定方式：先確認系統已登入預期帳號、已允許應用程式使用 iCloud，並核對應用程式顯示的同步範圍，再執行同步或復原。注意事項：勿假設所有連線狀態、統計資料與各平台設定都會自動同步。復原前請保留目前可用的設定檔；遇到衝突時，先辨認本機與雲端內容，避免以舊資料覆寫新修改。

Diagnostics：收集排查線索

用途與位置：在 Settings 中尋找 Diagnostics，使用應用程式提供的診斷或記錄入口檢查錯誤線索。設定方式：先確認一個可重現的問題，再依介面提示收集該次操作的記錄；完成後停止不再需要的詳細記錄。注意事項：記錄可能包含目標網域、伺服器位址及其他敏感資訊；對外提供前，請刪除驗證參數、訂閱憑證與無關內容。勿將完整設定檔當作一般截圖公開。

07 / CONNECTIVITY TEST

修改設定後的驗證順序

每次驗證請聚焦一個問題，以區分「未選取伺服器」、「伺服器連線失敗」、「規則命中不符」與「目標本身異常」。勿同時修改 DNS、協定參數、Global Routing 與規則，否則即使恢復正常，也無法判斷是哪項設定發揮作用。

  1. 檢查 Home。確認使用者已有的伺服器資訊完整、已選取預設伺服器、連線開關狀態符合預期，且系統授權未遭取消。
  2. 執行 Connectivity Test。維持 Test Method 不變，記錄目前網路與測試結果。若測試失敗，先檢查位址、連接埠、驗證資訊與訂閱更新狀態。
  3. 比較 Global Routing。暫時以 Proxy 與 Direct 連線至相同目標，再切回 Config；若差異只出現在 Config，請檢查目前設定檔與規則策略。
  4. 依線索檢查設定。網域解析異常時檢查 DNS，自動重新連線異常時檢查 On Demand，對統計資料有疑問時查看 Data；必要時透過 Diagnostics 收集相關記錄。
  5. 恢復日常狀態。還原暫時使用的測試模式，關閉不再需要的詳細記錄，保留有效修改及原值說明，避免下次排查時重複嘗試。

若要確認取得方式，iPhone / iPad 請前往指定的 App Store 產品頁；系統需求以 App Store 頁面標示為準。Mac、Windows、Android、Linux 的安裝套件可由本站下載指南取得。其他狀況與處理範圍請參閱常見問題，不必因單次測試失敗而重設所有設定。