官方手冊 · 設定參考

Shadowrocket 功能與設定

先確認 Global Routing，再檢查目前的 Config 與伺服器。連線方式、規則策略和自動連線各有不同用途，調整時別把它們當成同一個開關。

  • Home · 連線與伺服器
  • Config · 設定與規則
  • Data · 流量紀錄
  • Settings · 一般選項
先保存可正常使用的狀態，再逐項調整

本頁假設你已有自己的訂閱或伺服器資訊。Shadowrocket 是 Apple 平台上的閉源商業應用，唯一取得管道為 App Store。客戶端一次性買斷 ≠ 線路方案；本站不提供、不販售、不推薦節點或訂閱。購買與正版核驗請參閱下載說明，首次匯入請參閱使用教學。

連線模式

Global Routing：Config、Proxy、Direct

Global Routing 決定進入 Shadowrocket 的連線採用哪種整體處理方式。在 Home 開啟 Global Routing，可選擇 Config、Proxy 或 Direct，分別代表依設定處理、代理或直連。這與 Home 的連線開關是兩回事：選擇模式不代表已建立連線，也不能據此判定目前伺服器可用。

日常需要依網域或位址分流時，建議使用 Config。暫時確認問題是否來自規則時，可用 Proxy 進行比對；要檢查原有網路的連線情況時，可用 Direct。比對測試請使用同一個目標，結束後恢復原先模式，否則暫時設定可能繼續影響後續連線。

介面選項 處理方式 適用情境 優先檢查項目
Config · 設定 依目前啟用設定中的規則與策略處理連線。 指定網站使用 PROXY，其餘流量則依規則選擇 DIRECT 或其他策略。 確認目前選取的設定、規則順序，以及策略是否指向可用伺服器。
Proxy · 代理 受客戶端接管的流量主要經由所選代理路徑處理。 暫時測試伺服器連線，區分規則問題與連線問題。 檢查所選伺服器的參數與可用性；也要留意系統和 App 接管流量的範圍。
Direct · 直連 受接管的連線直接存取目標。 確認目前網路能否直接連線至同一個目標。 檢查原有網路、DNS 與目標服務是否正常。

Config 既是設定頁面的名稱，也可能是 Global Routing 中的選項。請依情境判斷：在 Config 頁面儲存檔案，不代表已啟用該檔案；選擇 Config 模式，也不代表每個目標都會經由 PROXY。實際連線路徑仍須查看命中的規則。

規則就是設定內容

Rule：比對條件與執行策略

規則分流是在 Config 模式下，依連線的網域、位址等條件選擇處理策略。通常可在 Config 頁面選取目前使用的設定，再進入編輯或規則檢視功能，確認 Rule 內容。修改前先匯出備份，每次只調整一條規則；若設定來自遠端網址，也要確認更新是否會覆蓋本機修改。

閱讀規則時，請將條件與結果分開看。DOMAIN 比對指定網域；DOMAIN-SUFFIX 比對指定網域及其子網域；DOMAIN-KEYWORD 檢查網域是否包含關鍵字，涵蓋範圍通常較廣。IP-CIDR 與 IP-CIDR6 依位址網段比對，GEOIP 則依位址歸屬資料判斷。USER-AGENT 需要能取得相應請求資訊的情境才能使用，不能假設適用於所有連線。

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

以下是規則語法範例，不包含可連線的伺服器。PROXY 代表交由代理策略處理，DIRECT 代表直接連線，REJECT 代表拒絕符合條件的連線。若設定使用自訂策略名稱，也要檢查相應策略群組的定義與選取結果；在規則末尾填入名稱，不會自動建立可用的連線路徑。

一般 Rule 會依序由上往下檢查，符合條件時便採用對應策略，因此較具體的例外規則應排在較廣泛的條件之前。FINAL 是前面規則都未命中時的預設處理項目，應放在規則末尾。若只想讓指定網站走代理，可先列出對應的 DOMAIN 或 DOMAIN-SUFFIX，再使用 FINAL,DIRECT；也要留意該網站是否會從其他網域載入內容。

連線成功，不代表規則設定正確

驗證時先重新連線至目標，再檢查連線紀錄中的目標、命中規則與策略。既有的長連線可能仍沿用先前的路徑。完整語法、設定結構與優先順序請參閱規則手冊。

管理既有資料

Subscribe 與 Add Server

伺服器紀錄儲存單一連線所需的參數；訂閱則用來集中取得並更新一組既有伺服器資訊。Home 主要用來檢視、選取伺服器及連線，Add Server 用來新增紀錄；Subscribe 相關功能用來管理訂閱來源，Config 頁面則負責設定檔。訂閱連結與規則設定網址用途不同，不能只因兩者都是網址就互相替代。

新增前先確認格式

手動使用 Add Server 時，先依照既有資訊選擇 Type，再填入位址、連接埠、驗證資訊及相應的傳輸選項。Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 等協定所需欄位各不相同，只填入伺服器位址並不代表已完成設定。使用 Scan QR Code 或從剪貼簿匯入可減少輸入，但匯入後仍應逐項確認內容。

更新時留意資料來源

管理既有訂閱時，請為每個來源取容易辨識的名稱；更新後檢查伺服器數量變化、群組與目前選取項目。訂閱更新可能會取代該來源的紀錄，直接修改其中一台伺服器未必能永久保留。若需要保存個人調整，請先確認 App 是否提供複製或儲存至本機的方式，並與訂閱管理的紀錄區分。

刪除前先確認操作對象是單一伺服器、整個訂閱，還是 Config 檔案。它們彼此相關，但並非同一份資料。訂閱更新失敗時，先確認網址完整、存取憑證有效，且目前網路能取得內容；請勿將含有憑證的完整網址貼到公開回報中，也不要反覆匯入同一網址來取代問題排查。

連線觸發

On Demand：依條件建立連線

On Demand 會依預設的網路條件觸發連線，處理的是「何時連線」，而不是「某個網站採用哪條規則」。請在 App 的 On Demand 項目檢視或編輯條件；實際位置與可用條件請以目前 App 介面為準。啟用前，先確認手動連線、目前伺服器與 Config 都能正常運作。

設定前先想好一個具體情境，例如是否要在特定 Wi-Fi 環境下自動連線，再只加入完成該情境所需的條件。若介面提供網路類型或 Wi-Fi 名稱等選項，請確認名稱是否正確，並檢查條件的先後順序。不要一次加入太多重疊條件，否則切換網路後很難判斷是哪一項觸發了連線。

儲存後，請在實際使用的網路環境中測試，再切換至另一種網路重新確認。自動恢復連線可能受到系統排程、裝置狀態與網路變化影響；On Demand 無法讓不可用的伺服器恢復正常，也無法修正規則中的策略名稱。若需持續排查，可先暫停自動觸發並改為手動連線，避免測試期間狀態反覆變動。

VPN 授權與自動連線是兩回事

首次連線時，系統可能會要求允許新增 VPN 設定；這是系統授權流程。On Demand 則是在既有設定上配置連線條件。系統顯示 VPN 狀態，只代表相關連線正在運作，不表示所有目標都使用相同策略。

檢查流量

Data：流量統計與紀錄檢視

Data 用來檢視客戶端記錄的流量與連線資訊。進入 Data 後，先確認目前統計的範圍、時間或重設狀態，再查看上傳、下載等項目。這些數據反映客戶端在相應統計範圍內觀察到的流量，不應直接視為整台裝置的網路用量，也不等同於既有訂閱帳戶的計費明細。

驗證某條規則時，可先記下目前數據，或使用介面提供的清除功能，再只造訪一個目標，接著查看新增的連線。重點檢查目標網域或位址、實際採用的策略，以及可能顯示的比對資訊。不同頁面載入的圖片、介面與其他資源可能來自多個網域，因此單一頁面出現多筆連線是正常情況。

統計數值增加，只能表示有流量經過相應路徑，不能單憑此點確認頁面內容已完整載入。背景工作也可能產生流量；比較調整前後的結果時，請盡量使用相同網路、同一目標與相近的操作範圍。清除紀錄前先保留必要的故障線索，回報時請隱去私人網域、位址與驗證資訊。

網域解析

DNS：先分清解析與連線

DNS 負責將網域解析為連線所需的位址。DNS 與代理協定、規則策略相關，但屬於不同的設定層面：伺服器能建立連線，仍可能遇到目標網域解析失敗；網域成功解析，也不代表能連上對應服務的連接埠。排查時應分別確認這兩個階段，不要一看到頁面載入失敗就立刻更改所有參數。

檢查與修改的位置

先查看 Settings 中目前可用的 DNS 相關選項，再檢查已啟用的 Config 是否包含解析設定。設定檔中的 General、Host 等內容可能影響結果；只修改一項通用選項，不一定會改變目前設定的所有解析行為。設定檔層與通用層的實際作用方式，應搭配目前選項說明及診斷結果確認。

調整前先記下原值，確認要解決的是解析逾時、回傳位址異常，還是特定網路下無法連線。使用既有且適合目前網路的解析設定，每次只變更一項，再針對同一網域重新測試。不要同時更改 DNS、規則與伺服器，否則即使恢復連線，也無法判斷是哪項調整發揮作用。

留意快取與網域規則

變更解析設定後，既有快取與長連線可能讓結果暫時不變；請依 App 提供的方式清除快取或重新連線，再發出新請求。DOMAIN-SUFFIX 這類規則依據網域資訊比對，IP-CIDR 則檢查位址範圍；請一併檢視單次請求中觀察到的網域與位址。不要只根據一個回傳位址，就判定所有請求都採用相同策略。

Settings 常用選項

測試方法、元件與同步

Settings 集中管理測試、顯示、同步與診斷等一般選項。可用選項及其位置可能因裝置與目前 App 介面而異。以下依用途說明；調整時仍應閱讀選項旁的說明。不確定的進階選項請先保留原值，避免一次局部排查演變成整套設定重建。

Test Method：統一 Connectivity Test 的測試條件

Test Method 用來選擇連線測試方式，通常可在 Settings 的測試相關選項中找到。先確認要測試的是基本連線能力，還是透過代理存取測試目標的能力，再依介面提供的方式選擇。接著回到 Home，對既有伺服器執行 Connectivity Test；比較結果時，請使用相同的測試方式與目標。

測試結果僅反映當下採用該方法時的狀況，不代表長期速度保證。某種測試失敗但網頁實際上能正常使用，可能是測試方式或目標不適用；測試成功但某個網站無法使用，也可能與該網站的規則、解析或服務狀態有關。不要只根據單次測試數值重新排列所有伺服器。

Today Widget：快捷入口不是策略設定

Today Widget 相關設定可搭配系統元件顯示資訊或提供快捷操作；可在 Settings 查看 App 提供的選項，並在系統允許的位置加入對應元件。元件的顯示方式與更新狀況取決於裝置及系統支援，不能假設每種裝置都有完全相同的入口。

使用元件操作後，必要時返回 Home 確認連線狀態與選取的伺服器。元件不能取代 Config 中的規則，也不會自動補齊伺服器參數。若元件顯示與主畫面暫時不一致，請先確認主畫面，再檢查系統元件是否已更新。

iCloud 同步：先確認同步範圍

iCloud 同步可在符合條件的裝置間同步 App 支援的資料。查看 Settings 中的相關開關前，先確認系統已登入自己的 Apple 帳號、iCloud 相關權限可正常使用，並了解選項說明中的同步範圍。不要假設連線紀錄、所有憑證與本機檔案都會一併同步。

更換裝置前，除了確認同步狀態，也應另外匯出重要設定作為備份。新裝置還原後，依序檢查訂閱、伺服器、Config、Global Routing 與 On Demand；先手動確認連線正常，再恢復自動連線條件。App 購買紀錄與設定同步是不同機制；還原購買項目不會自動還原設定。

依現象逐步排查

Diagnostics：一次確認一個環節

Diagnostics 可用來收集並檢查連線問題的線索；可從 Settings 中與診斷相關的項目進入，實際工具請以目前 App 顯示為準。開始前先描述可重現的現象：是所有目標都無法連線、只有一個網域異常，還是切換網路後才出現問題。描述越具體，越容易判斷下一步要檢查什麼。

  1. 記錄目前狀態。記下 Global Routing、選取的伺服器、啟用的設定與網路類型。先保留原始設定，測試期間暫停可能改變狀態的自動連線條件。
  2. 檢查基本網路。確認裝置目前的網路能正常連線；若原有網路本身異常，請先處理這一層，避免誤判為規則問題。
  3. 檢查伺服器參數。對照既有資訊，確認 Type、位址、連接埠與驗證欄位，再執行合適的 Connectivity Test。手動填寫時，尤其要留意多餘空格或欄位遺漏。
  4. 檢查網域解析。針對同一個無法連線的網域查看解析結果。網域無法解析與位址無法連線是不同問題，應分別處理。
  5. 檢查比對路徑。在 Config 模式下發出新請求，搭配紀錄確認命中的規則與策略；必要時短暫切換至 Proxy 進行比對，之後再恢復原模式。
  6. 整理結果並還原設定。記錄哪些變更影響結果，撤銷無效調整，並確認日常設定與 On Demand 已恢復至預期狀態。

紀錄可能包含訂閱網址、伺服器資訊、造訪網域或驗證內容。匯出或分享前請先檢查並遮蔽敏感欄位，只保留排查問題所需的部分。診斷工具提供的是線索，不是自動修復結論；單次測試未重現，也不能直接認定問題已經消失。

常見設定疑問

切換至 Config 後，為什麼仍有連線使用 DIRECT？

Config 代表依設定進行判斷，不表示所有連線都會使用 PROXY。先查看目標命中了哪條規則，再檢查是否由 FINAL,DIRECT 作為預設處理，並確認目前使用的設定確實是剛才編輯的那一份。

開啟 On Demand 後，還需要設定規則嗎？

兩者需要分開設定。On Demand 決定連線的觸發條件；Global Routing 與 Config 則決定連線建立後的處理方式。先確認手動連線與分流正常，再啟用自動觸發。

訂閱更新後，為什麼本機調整會改變？

由訂閱管理的伺服器紀錄，更新時可能會依來源內容重新產生。請先區分本機紀錄、訂閱紀錄與規則設定，重要調整應另外保存，並在更新後確認目前選取的項目。

完成功能設定後，要在哪裡確認系統相容性？

Shadowrocket 主要供 iPhone 與 iPad 使用；Mac、Apple TV、Apple Vision 的相容性及所有系統需求，請以 App Store 頁面標示為準。取得方式與正版三要素核對，請參閱App Store 正版核驗說明。

若要從首次匯入開始操作，請繼續閱讀使用教學；若要檢查完整規則結構與關鍵字，請前往規則手冊。兩類操作都建議遵循同一原則：先備份、一次只修改一處、用新請求驗證，再決定是否保留變更。