官方手冊 首次使用流程

Shadowrocket 使用說明:
訂閱匯入、連線與驗證

依照五個步驟完成首次設定。先讓一台既有伺服器成功連線,再確認規則;遇到問題時,回到最早失敗的步驟,不要同時變更多項設定。

截圖為 App Store 官方展示圖,用於辨識頁面與欄位。實際排列可能隨 App 介面調整,請以裝置上顯示的英文介面詞為準。

01 新增伺服器與匯入訂閱

從 Home 開始,在 SERVER 分組附近找到 Add Server,也可以使用頁面上的新增入口開啟。接著只選擇一種匯入方式:持有完整訂閱連結時使用 Subscribe;持有單一伺服器的通訊協定、位址、連接埠與驗證資料時手動填寫;持有使用者自己的設定 QR Code 時使用 Scan QR Code。不要將三種資料混填在同一欄位中。

使用 Subscribe 匯入既有訂閱

  1. 先向自己的服務商取得完整訂閱連結。複製時保留路徑、查詢參數和結尾字元,不要只複製網域,也不要連同說明文字一起選取。
  2. 進入 Add Server,開啟 Type 並選擇 Subscribe。在 URL 欄位貼上連結,視需要填寫方便自己辨識的名稱,再儲存。
  3. 返回 Home,等待訂閱讀取完成。確認出現對應的訂閱分組或伺服器項目,再選取其中一個項目。若有顯示名稱但沒有可選伺服器,應先檢查訂閱讀取結果,而不是直接嘗試連線。

訂閱連結通常包含存取憑證,應視同密碼保管。不要將完整連結貼在公開截圖、文章留言或疑難排解紀錄中。更新訂閱會重新讀取遠端內容;若更新失敗,先保留現有項目,確認連結是否仍有效、目前網路是否能存取訂閱網址,再決定是否重新匯入。反覆新增相同網址容易造成清單重複,無法修正遠端回傳錯誤。

使用 Add Server 手動填寫參數

手動新增時,先設定 Type,再填寫該通訊協定所需欄位。截圖展示的是包含 Host / Port / Password / Method 的表單,其他通訊協定可能會顯示不同選項。Host 應填入服務資料提供的伺服器位址,Port 填入對應連接埠;不要將含有路徑的訂閱連結填入 Host。Password、Method 或其他驗證參數必須與伺服器端一致,不能只憑名稱猜測,也不要僅因某個選項看起來常見就替換它。

若資料是 QR Code,可在 Add Server 中使用 Scan QR Code,依系統提示允許相機存取,掃描後仍需確認 Type 與位址。Import from Cloud JSON 適用於相應格式的資料,不應用來取代一般訂閱 URL 的匯入方式。儲存後返回 Home,確認新項目存在且可供選取;完成這一步後再選擇 Global Routing。

Shadowrocket 的 Add Server 頁面,包含 Type、Host、Port、Password、Method,以及 Scan QR Code 和 Import from Cloud JSON
Add Server:先選擇 Type,再填寫對應通訊協定所需參數。

02 選擇 Global Routing

新增完成後返回 Home,點開 Global Routing。這裡決定請求如何選擇路徑,與「選取哪一台伺服器」是兩項獨立設定。首次使用時,應先確認目前要驗證的項目,再選擇模式。三種模式分別是設定(Config) / 代理(Proxy) / 直連(Direct),不要只根據頂端連線開關判斷是否正在使用代理。

模式處理方式與使用時機
設定(Config)依目前選取的設定檔比對規則,適合需要區分 PROXY 與 DIRECT 的日常使用。
代理(Proxy)透過所選代理處理請求,適合先確認伺服器基本可用;這與依網站比對規則並非相同的驗證方式。
直連(Direct)以直連方式處理請求,可用來比對基礎網路是否正常;不應用它檢驗伺服器的代理效果。

Config 檔案與 Config 模式的關係

Home 的 Config 模式負責選擇「依設定處理」,底部的 Config 頁面則用於管理設定檔。進入 Config,先確認準備使用的檔案已選取;開啟檔案時,可以看到 General / Rule / Hosts / URL Rewrite / HTTPS Decryption 等區段。初次連線只需確認檔案來源可信任、Rule 中的策略指向明確,不必為了完成基本連線而逐一啟用其他功能。

規則會依順序比對,前面的條件命中後會影響實際路徑;FINAL 用於前面的條件都未命中時作為預設策略。以下僅用於理解順序,不是可直接取代現有檔案的完整設定。它表示 example.com 及其子網域使用 PROXY,其他請求交由 DIRECT。修改實際檔案前先儲存副本,也不要未經確認就將自己的業務網域大量套用到範例中。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

若不確定現有規則是否正確,可先使用 Proxy 模式驗證已選取的伺服器;伺服器可用後,再返回 Config 驗證分流。若 Proxy 可以存取而 Config 不符合預期,優先檢查已選取的檔案、規則順序及目標策略,不要立刻重新填寫伺服器密碼。規則細節可繼續閱讀指定網站的 DOMAIN-SUFFIX 與 FINAL 設定;App Store 取得方式與帳號問題另請參閱App Store 指南。

Shadowrocket 的 Config 設定檔編輯頁面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule
Config:確認目前檔案與 Rule 內容。Add Rule 用於新增規則,不是新增伺服器。

03 選取項目並開啟連線

返回 Home,在 SERVER 清單中點選準備使用的伺服器,確認選取標記位於預期項目上。訂閱分組名稱只是管理線索,不能取代實際項目的選取。接著再次確認 Global Routing:若剛才切換到 Direct 進行比對,現在需要切回本次驗證所用的 Proxy 或 Config,否則即使開啟連線開關,也無法驗證預期的代理路徑。

  1. 點選 Home 頂端的連線開關。尚未建立連線時,頁面可能顯示 Not Connected;開啟後觀察狀態是否改變。
  2. 首次使用時,系統可能會要求新增 VPN 設定。閱讀系統提示,確認此操作是由自己在 Shadowrocket 中發起,再允許新增,並依提示完成裝置驗證。
  3. 返回 Shadowrocket,確認頂端開關維持開啟、狀態沒有立即恢復為未連線,再進行下一步實際驗證。若開關自動關閉,應先處理系統授權或設定問題,不要略過。

此處的系統 VPN 授權用於建立用戶端所需的網路處理通道,不會替使用者補齊訂閱或伺服器資料。連線狀態改變也只代表通道狀態變化,無法單獨證明遠端伺服器、DNS 和目標網站都正常。不要將系統狀態列中的 VPN 標示當作唯一驗收結果,仍須執行測試並開啟實際頁面。

若裝置上另有正在使用的 VPN 設定,請先停止其他連線,避免同時爭用系統網路通道。受管理的裝置可能限制新增 VPN 設定;遇到此類限制時應確認裝置管理政策,不要反覆刪除所有網路設定。首次連線前也不必啟用 On Demand,維持手動開關更容易看清每次操作與狀態變化的關係。

Shadowrocket 的 Home 頁面,顯示頂端 Not Connected 開關、Global Routing 的 Config、Connectivity Test、SERVER 分組和 Add Server
Home:依「選取項目 → 確認 Global Routing → 開啟開關」的順序操作。

04 驗證連線與分流是否生效

連線後先在 Home 執行 Connectivity Test,觀察目前測試方法的回傳結果,再開啟瀏覽器造訪自己確實需要使用的網站。測試成功代表受測路徑在目前方法下有回應,不代表所有通訊協定、所有網站都可用;測試失敗也不一定表示驗證參數錯誤。測試目標暫時無法連線、測試方法不同或基礎網路異常,都可能影響結果。

分開驗收「伺服器可用」與「規則正確」

  1. 先檢查基礎網路:暫時停止連線,確認裝置本身可以正常瀏覽日常網站。若基礎網路無法連線,應先處理 Wi-Fi、行動網路或網路登入頁面。
  2. 再檢查伺服器:使用已確認參數的項目,在 Proxy 模式下連線,造訪預期可透過該伺服器存取的目標。若失敗,先記錄具體狀況,不要立即修改規則。
  3. 最後檢查分流:切回 Config,分別造訪一個預期使用 PROXY 和一個預期使用 DIRECT 的目標。若目前介面提供請求或連線記錄,再比對目標網域、命中規則與策略。

同一個網頁可能會載入多個網域的資源。首頁可以開啟但圖片或登入失敗,可能是不同資源套用了不同規則,不能只替主網域新增一條規則就認定問題已解決。瀏覽器快取和已建立的連線也可能延續舊結果;修改規則後應重新發出請求,必要時關閉原頁面再開啟,避免把快取頁面當成新連線的證據。

若要查看網路使用情況,可以進入 Data 檢查可用統計,但流量變化不代表目標請求一定命中 PROXY。驗收時應同時記錄「目前伺服器、Global Routing 模式、測試目標、實際結果」四項。完成這四項比對後,再考慮自動連線或更細緻的分流規則;首次設定到此即可停止延伸設定。

05 Settings 與常見問題

從最早發生問題的階段開始排查:匯入時就失敗,先檢查訂閱;項目已儲存但測試失敗,先檢查伺服器;開關無法維持開啟,先檢查系統授權;Proxy 可用但 Config 異常,先檢查規則。進入 Settings 後可以查看 Test Method / On Demand / Diagnostics / Proxy / TCP / UDP 等項目,但不要只因為「可能有效」就把所有選項都切換一遍。

訂閱無法讀取或清單為空

重新確認 Subscribe 的 URL 是否完整,尤其是問號後的參數,以及複製時混入的空格和換行。確認填入的是訂閱網址,而不是網頁控制台網址。訂閱回傳空內容、驗證失敗或格式不相容時,重複儲存通常不會改變結果;應向自己的服務商確認網址有效性、存取條件及內容格式。排查時保留錯誤文字,分享截圖前遮蔽 URL、帳號與驗證欄位。

項目存在,但 Connectivity Test 失敗

先確認 Home 中實際選取的項目,再比對 Type、Host、Port 及該通訊協定所需的驗證欄位。進入 Settings 查看 Test Method,了解目前使用的測試方式;不同方式測試的目標與能力各不相同,不要把單一測試失敗等同於所有請求都失敗。若使用者另有已確認可用的項目,可以保持其他設定不變進行比對。若沒有可供比對的項目,先確認原始參數,不要自行猜測替代連接埠或加密方式。

開關恢復關閉,或關閉後又自動連線

開關無法維持開啟時,檢查系統 VPN 設定要求是否已完成、是否有其他作用中的 VPN 連線,以及裝置是否受到管理政策限制。關閉後又自動連線時,檢查 Settings 中的 On Demand 是否符合自己的預期。建議先暫時關閉自動連線條件,完成手動連線與中斷的重新測試,再依實際需求設定 On Demand;它無法修復無效的伺服器資訊。

可以連線,但特定網站或部分功能失敗

先比較 Proxy 與 Config 下的結果。若只有 Config 異常,檢查目前選取的檔案、Rule 排列順序及 FINAL;若兩種模式都失敗,再區分是目標網站、DNS、伺服器能力還是通訊協定參數問題。Settings 中出現 TCP、UDP 不代表必須同時修改,只有確認受影響功能使用相應傳輸方式後,才檢查伺服器端是否支援及相關設定是否一致。

保留可供複查的診斷紀錄

需要進一步定位時,再使用 Diagnostics 中適用的診斷功能,記錄故障環節、網路類型、目前模式及可重現的操作。每修改一項就重新執行第四步;無效的變更應及時還原,避免最後無法判斷哪一份設定仍可信任。傳送任何紀錄前,請檢查伺服器位址、密碼、訂閱參數及個人瀏覽內容,並依需要遮蔽敏感資訊。設定檔各區段的說明請參閱.conf 結構詳解,不要為了排查問題直接覆蓋整份設定。

Shadowrocket 的 Settings 頁面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:依問題選擇相關設定。首次連線不需要逐一調整所有選項。