官方手冊 · iPhone / iPad

Shadowrocket 使用教學

訂閱匯入、Global Routing 與首次連線,五個步驟完成設定。

以下從 Home 開始操作。iPhone 與 iPad 可用空間及版面配置可能不同,請以目前 App 顯示的英文介面用語為準。系統需求請以 App Store 頁面標示為準。

01 · Add Server / Subscribe

開啟 Shadowrocket,進入 Home。先確認手上的資料類型:可一次取得多筆伺服器記錄的完整連結是訂閱;單獨提供的位址、連接埠、密碼或其他驗證欄位則是伺服器資訊。兩種資料的輸入方式不同,請勿將訂閱連結當成伺服器位址,也不要把服務商的帳戶管理頁面網址填入訂閱欄位。

已有訂閱連結:選擇 Subscribe

在 Home 點選右上角的加號,進入 Add Server,開啟 Type 並選擇 Subscribe。返回填寫頁面後,將從服務商取得的完整訂閱連結貼到 URL。若頁面提供備註欄位,可填入方便自己辨識的名稱;備註只影響清單辨識,不會改變連結內容。確認無誤後,點選右上角的 Done 儲存,並等待訂閱取得完成。

貼上後先確認連結的開頭與結尾,尤其是問號後方的參數。有些連結包含身分驗證資訊,少複製一段,或連同換行、空格一起貼入,都可能導致取得失敗。連結應從訂閱資料提供的複製功能取得,不要自行拼接網頁網址。若系統詢問是否允許貼上,確認正在將自己的資料填入 Shadowrocket 後再繼續。

儲存成功後返回 Home,查看訂閱群組下是否出現伺服器記錄。只看到群組名稱但沒有任何記錄,不代表匯入已完成;請確認此次取得是否發生錯誤,以及訂閱內容是否包含可辨識的伺服器。若已有相同訂閱,請優先更新原有記錄,不必重複建立多個同名群組。更新可能改變清單內容,完成後請再次確認目前選取的伺服器。

已有單一伺服器資訊:依協定填寫

同樣從加號進入 Add Server,在 Type 中選擇資料明確標示的協定,再逐項填寫伺服器位址、連接埠與驗證欄位。不同協定所需欄位各異,例如密碼、UUID、加密方式、TLS 與 Server Name 不能互相替代。請依原始資料填寫,不要憑協定名稱猜測參數,也不要為了排除錯誤而任意關閉 TLS 或調整憑證相關選項。

如果手上有可供匯入的伺服器 QR Code,可使用 Scan QR Code,並在儲存前確認辨識出的協定與位址符合原始資料。QR Code 與原始連結同樣需要保密。無論使用哪種方式新增,儲存後都應在 Home 點選準備使用的伺服器記錄,確認該筆記錄已選取,再進行下一步。

完成此步的條件是:Home 中已出現可選擇的伺服器,而且你已選取其中一筆。清單中出現伺服器不代表一定能連線,後續還需要選擇路由模式並實際驗證。Subscribe、協定與設定檔的差異,請參閱術語手冊。

02 · Global Routing

伺服器決定連線使用的目標資訊,Global Routing 則決定由用戶端處理的請求採用何種策略。返回 Home,點選 Global Routing,確認目前選取的模式。首次操作時別只注意伺服器名稱而忽略這項設定:即使選取了可用伺服器,直連模式或設定規則仍可能讓部分存取不經過該伺服器。

配置(Config):依目前設定處理

選擇配置(Config)時,App 會依目前啟用的設定檔比對規則,再決定請求採用 DIRECT、PROXY 或其他已定義的策略。此模式適合日常使用規則分流,但前提是你清楚目前使用哪個設定檔。切換至 Config 頁面檢查目前啟用的項目;將檔案匯入清單後,還需確認它是否已設為目前使用的設定檔。

首次連線不必立刻編輯規則。若不確定設定來源、策略名稱與規則含義,請先保留現狀,透過下一種模式驗證基本連線。不要把網路上看到的幾行規則直接加到不明位置:規則有先後順序,設定中使用的策略也必須正確對應。需要了解 DOMAIN-SUFFIX、GEOIP 或 FINAL 時,再到術語手冊逐項查閱。

代理(Proxy):先驗證代理路徑

選擇代理(Proxy)後,由用戶端接管的連線會依代理策略處理。首次連線可暫時使用此模式,減少自訂分流規則對驗證的影響。這不代表伺服器一定可用,也不表示所有 App 的流量都能以單一測試結果概括。選好後返回 Home,確認伺服器仍是剛才選取的那一筆,再進行連線授權。

直連(Direct):不能用來證明伺服器可用

選擇直連(Direct)後,請求會依直連策略處理。此模式可用來確認直連行為,但不能證明代理伺服器已生效。若要驗證剛匯入的伺服器,就不應停留在此模式。需要比較基本網路時,直接關閉連線開關再測試,更容易判斷問題所在層級。

此步只需選擇符合目前目的的一種模式。驗證伺服器時使用代理(Proxy);確認連線成功且了解目前設定後,再切換至配置(Config)。請勿同時更換伺服器、修改設定並切換模式,否則發生問題時難以判斷是哪項變更造成的。

03 · Home 連線與系統授權

返回 Home,再確認兩個位置:伺服器清單中已選取預期記錄,Global Routing 顯示剛才選擇的模式。確認後,開啟頁面頂部的連線開關。首次建立連線時,系統可能詢問是否允許 Shadowrocket 新增 VPN 設定;這是 App 使用系統網路功能處理連線所需的授權流程,與匯入訂閱無關。

在系統彈出視窗中確認發起 App 為 Shadowrocket,閱讀提示後選擇允許,並依系統要求使用裝置密碼、Face ID 或 Touch ID 完成驗證。裝置密碼只應輸入系統驗證畫面,不要填入訂閱 URL 或伺服器密碼欄位。如果這次未完成授權,請返回 App 重新發起連線;只在伺服器清單中選取記錄,不會自動完成系統授權。

完成授權後返回 Home,查看連線開關是否保持開啟。若開關立即關閉或出現錯誤提示,請先在此步處理,不要直接將瀏覽器無法存取歸因於伺服器。可前往系統 Settings 中與 VPN 相關的位置,確認是否存在對應設定,並檢查裝置是否受到管理限制,或是否有其他 VPN 連線正在使用。若裝置受管理,請遵循相關管理規範。

系統出現 VPN 標示,或 App 開關保持開啟,只能代表連線機制已啟動,還不足以證明目標頁面採用了預期策略。不同裝置的狀態列顯示方式也可能不同,因此應以接下來的實際存取驗證作為完成依據,而不是只看單一圖示。

首次設定期間,先維持 On Demand 目前的狀態,不必同時啟用自動連線。如此一來,關閉開關後更容易觀察連線狀態。手動連線與中斷都符合預期後,再另外了解 On Demand 的觸發條件;它負責決定何時建立連線,不能取代伺服器參數、路由模式或設定規則。

04 · Connectivity Test 與實際存取

開啟連線後返回 Home,使用 Connectivity Test 測試伺服器。測試方法與目標可能受 App 設定影響,測試數值應視為目前測試條件下的結果,不代表所有網站的連線狀況。收到回應可作為繼續驗證的依據;若發生逾時,請搭配實際存取、目前網路與伺服器狀態判斷,不要只憑一次結果刪除所有設定。

接著開啟瀏覽器,造訪平時會使用,且你清楚預期連線方式的頁面。重新載入後,確認頁面主要內容能否完整顯示。只看到舊頁面、快取文字或先前已開啟的分頁,並不足以判斷此次連線是否有效。也不必使用要求提供帳戶或上傳訂閱資料的網站來驗證連線。

接著返回 Shadowrocket,查看 Data 中的流量變化。統計數值可協助判斷 App 是否正在處理流量,但不能單獨證明特定頁面一定經由目前伺服器連線:背景 App 也可能產生連線,而配置(Config)模式下也可能有直連請求。若目前 App 提供連線記錄,可搭配目標網域與匹配策略確認,不要只根據總流量增加就下結論。

若在代理(Proxy)模式下實際存取符合預期,切換至配置(Config)後只有部分頁面表現不同,請優先檢查目前設定與匹配規則。此時基本伺服器連線可能已正常,不必從頭重複匯入訂閱。反之,若兩種模式下都無法使用,請依序檢查基本網路、選取的伺服器與驗證參數。

最後關閉連線開關,確認 App 狀態隨之變更,再依需求重新開啟。若打算長期使用配置(Config),切換後請重新驗證剛才的同一個頁面,不要直接沿用代理(Proxy)模式的測試結果。完成的判斷標準是連線狀態、所選模式與實際存取結果彼此吻合,而不是測試清單中的某個數值夠低。

05 · 常見問題排查

排查時先記錄問題發生在哪個步驟:連結無法取得、伺服器清單為空、開關無法保持開啟,或連線開啟後只有部分頁面失敗。記下錯誤提示中的關鍵字,接著每次只修改一項條件,再使用相同目標重新測試。反覆刪除並重新匯入,容易覆蓋原始資訊,也會讓已確認的條件遺失。

訂閱無法匯入或更新

先關閉連線,使用瀏覽器確認基本網路是否正常,必要時完成目前 Wi-Fi 的網路驗證。接著檢查 URL 是否完整、前後是否有空格,以及它是否確實為訂閱連結,而非帳戶網頁。若提示驗證或有效狀態異常,請向服務商取得目前有效的連結;帳戶憑證與訂閱憑證不一定相同,不能自行替換使用。

若連結可以取得但清單為空,請確認回傳內容是否為 Shadowrocket 支援的訂閱格式,以及訂閱目前是否包含伺服器記錄。不要藉由修改檔案副檔名或任意替換協定名稱來處理格式問題。若清單中已有項目且需要更新,請在原訂閱對應的更新操作中重試;完成後再次確認選取項目,避免使用已變更或移除的舊記錄。

已有伺服器記錄,但測試逾時

先確認 Home 中實際選取的是準備測試的記錄,再檢查位址、連接埠與驗證參數。手動新增時,尤其要確認 UUID、密碼、TLS 與 Server Name 是否符合原始資料。若已有其他伺服器記錄,可在網路與模式不變的條件下切換另一筆進行比較;若沒有其他記錄,不需要為了排查額外尋找資料。

接著分別使用 Wi-Fi 與行動網路重新測試,留意是否只有其中一種網路失敗。切換網路後的結果只能協助找出路徑差異,不能直接證明伺服器端或裝置設定完全正常。若只有 Connectivity Test 逾時,但實際頁面可以使用,請先檢查測試條件,不必立刻修改伺服器參數。

開關立即關閉,或無法完成授權

遇到這類問題,請先檢查系統授權與 VPN 設定狀態。確認系統驗證已完成、目前裝置允許新增設定,並暫停可能占用連線的其他 VPN。不要一開始就刪除所有訂閱或重置全部網路設定;這些操作影響範圍較大,也不一定能解決授權限制。安裝、授權與購買相關問題,請參閱常見問題。

連線保持開啟,但個別頁面失敗

重新確認 Global Routing:直連(Direct)不能證明代理路徑已生效;配置(Config)則需檢查符合的規則及其對應策略。可暫時切換至代理(Proxy),使用同一台伺服器與同一個頁面進行比較。若只有配置(Config)模式失敗,請著重檢查設定;若所有模式都失敗,則繼續檢查伺服器、基本網路與目標頁面本身的狀態。

也請留意頁面是否沿用舊連線,或 App 是否需要重新開啟才能建立新請求。DNS、憑證與規則問題應依具體提示分別處理,不要把關閉驗證或清除所有設定當成通用步驟。需要了解規則關鍵字時,請閱讀術語手冊;需要重新確認取得方式、商店與已購項目還原時,請閱讀App Store 正版指南。

整理問題時,記錄裝置類型、網路類型、Global Routing 模式、失敗步驟與錯誤關鍵字即可。分享截圖或文字前,請遮住完整訂閱 URL、QR Code、伺服器密碼及其他驗證資訊。先恢復至最後一次正常運作的狀態再繼續調整,通常比同時修改多個項目更容易找出原因。