官方手冊 · 入門指南

Shadowrocket
訂閱匯入與連線教學

先將既有伺服器儲存到 Home,再選擇 Global Routing,最後開啟連線並驗證實際請求。本頁以完成一次可重複檢查的連線為目標,不必先熟悉整份設定檔。

已完成的步驟可以略過;遇到問題時,回到最後一個確認正常的步驟繼續檢查。不同系統版本的入口位置可能略有差異,請依目前介面的英文名稱辨識功能。

STEP 01 · Home / Add Server / Subscribe

新增伺服器或匯入既有訂閱

開啟 Shadowrocket 後,先停留在 Home。這裡可查看已儲存的伺服器、選擇目前的連線目標,以及開啟連線開關。此時先不要連線:如果清單中還沒有項目,應先完成匯入;如果已有項目,也要確認它來自自己的有效訂閱,而非只憑名稱選取。訂閱是取得一組伺服器資訊的網址,單一伺服器則是一筆具體的連線記錄,兩者的填寫方式不同。

已有訂閱連結:使用 Subscribe

在 Home 點選右上角的新增按鈕,進入 Add Server,開啟 Type 並選擇 Subscribe。將完整訂閱連結貼到 URL,視需要填寫方便辨識的備註,再點選右上角的儲存按鈕。貼上時請檢查連結前後是否帶入空格、換行或聊天文字;不要只複製網域,也不要刪除問號後的參數。這些參數通常屬於訂閱識別資訊,缺少其中一部分就可能無法取得內容。

儲存後返回 Home,等待訂閱內容載入。正常情況下會出現對應的訂閱群組及伺服器項目。點選其中一項,確認選取標記位於預期的伺服器上。只看到訂閱名稱,但其中沒有伺服器,不代表已完成匯入,應先檢查取得結果。需要更新時,使用該訂閱項目的更新操作;具體入口可能出現在項目操作選單中,更新後再查看清單是否有變化。

不要為了更新而反覆新增相同訂閱。重複的群組會讓後續選擇與排查變得混亂,也可能讓你誤用舊項目。更新會重新讀取服務供應商傳回的資料,手動修改過的訂閱項目可能會被新內容覆蓋。若確實需要保留個別修改,請先確認儲存方式,再進行更新。

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

如果取得的是單一伺服器參數,仍從 Add Server 開始,但 Type 應選擇服務供應商提供的協定,而不是 Subscribe。依序填入伺服器位址、連接埠、驗證資訊,以及該協定要求的其他欄位。例如需要 UUID、TLS 或 Server Name 時,應逐項對照原始資料;不能將不同協定的欄位互相套用,也不要只憑位址外觀推測協定。

儲存後返回 Home,選取剛新增的項目。若有現成的 QR Code,也可透過 Scan QR Code 匯入,但仍需確認辨識後的 Type 與位址。訂閱 URL、QR Code 與驗證欄位都可能包含存取憑證,不應公開截圖或轉傳。完成這個步驟後,你應能明確指出「接下來要連線的是哪一台伺服器」,再進入路由選擇。

STEP 02 · Global Routing / Config

選擇 Global Routing 模式

伺服器決定代理連線使用哪個目標,Global Routing 則決定如何處理請求。在 Home 點開 Global Routing,先辨識 Config、Proxy、Direct 三種模式。本教學使用這三種模式完成基本檢查;如果介面還顯示其他選項,請先專注於目前的操作,不必同時設定所有功能。

Config:依目前規則處理

已有適用的設定檔時,日常使用可選擇 Config。接著進入 Config,確認實際啟用的是預期檔案,而不只是檔案出現在清單中。訂閱匯入與 Config 並非同一件事:訂閱主要更新伺服器資料,Config 則控制規則、DNS 等行為。成功匯入訂閱,不代表已取得符合自身需求的分流規則。

規則通常依序比對,第一條符合的規則會決定請求使用的策略。例如,以下片段表示範例網域使用 PROXY,其餘由 FINAL 作為後備規則。這段內容僅用於說明比對關係,並非可直接取代現有檔案的完整設定;其中的 PROXY 也必須在實際設定中有有效的策略定義。

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

Proxy:檢查所選代理連線

尚未有合適的 Config,或正在判斷問題是否來自規則時,可以暫時選擇 Proxy,測試透過所選伺服器處理的請求。這不是「自動修復」選項,也不會替你補齊錯誤的驗證參數。系統本身的流量與受系統限制的請求仍可能有例外,不應將此模式理解為對裝置每一個封包的絕對保證。

Direct:建立本機網路對照

Direct 會讓請求使用直連路徑,可用於判斷目前的 Wi-Fi 或行動網路本身是否正常。它不適合用來驗證代理伺服器。如果 Direct 可以存取某個頁面而 Proxy 不行,才有理由繼續檢查代理連線;若兩種方式都不行,也需要考慮目標網站、本機網路或 DNS,而不是立刻重建所有設定。

先記下這次選擇的模式。首次排查時,不要同時修改規則、更換伺服器又切換模式,否則無法判斷是哪項調整產生效果。規則結構與設定說明可繼續參閱設定參考;目前只需確認伺服器與路由模式,接著開啟連線。

STEP 03 · Home / VPN

開啟開關並確認系統連線狀態

返回 Home,再檢查一次伺服器的選取標記與 Global Routing。確認無誤後,開啟頂端的連線開關。首次啟動時,iPhone 或 iPad 會顯示新增 VPN 設定的系統提示。閱讀提示,確認這是剛才由 Shadowrocket 發起的操作後,允許新增並依照系統要求完成裝置驗證。這是建立系統網路通道所需的授權,並非匯入訂閱的步驟。

如果先前取消了授權,請返回 App 重新發起連線,不要透過重複新增訂閱來解決。系統授權尚未完成時,即使 Home 已列出多台伺服器,也不能據此認定連線已建立。完成提示後返回 Shadowrocket,查看開關是否維持開啟、連線狀態是否已更新;必要時在系統設定中查看 VPN 狀態,兩者應能相互對應。

如果開關剛開啟就關閉,先查看 App 或系統是否提供錯誤說明。檢查是否有另一個 VPN 連線正在使用系統通道,必要時先停用另一個連線,再返回 Shadowrocket 重試。不要在沒有記錄目前狀況時直接刪除系統設定;刪除可能導致下次連線需要重新授權,也會增加判斷問題的變數。

如果連線總是在手動關閉後重新出現,請檢查是否啟用了 On Demand,或是否存在其他系統自動連線條件。入門階段可先記錄這些設定,暫時停用相關的自動連線條件,再進行一次手動連線測試。如此可區分「App 主動連線」與「系統依條件重新連線」,避免誤以為開關沒有反應。

開關維持開啟,只能表示連線流程已進入運作狀態,不能保證所選伺服器、網域解析與規則都符合預期。接下來不要立刻連續切換多台伺服器,先使用同一台伺服器完成下列測試,分別記錄連線狀態與實際存取結果。

STEP 04 · Connectivity Test

分別驗證伺服器、存取結果與規則

連線後先執行 Connectivity Test,查看所選伺服器的測試結果。測試入口可能位於 Home 的工具或操作選單中;如果目前介面可以選擇測試方式,比較不同伺服器時應使用相同方式。測試成功表示在該測試條件下收到預期回應,不代表每個網站、每種協定或每個 App 都已驗證通過。

如果測試結果只反映網路探測回應,也不能直接據此確認驗證與完整代理存取一定正常。不同的測試方式,檢查的連線範圍也可能不同。因此下一步需要開啟瀏覽器,造訪一個你確認可用、且符合目前路由預期的頁面。主動重新整理或再次發出請求,避免將先前載入的頁面或快取內容當成這次連線的結果。

驗證 Config 時,要區分「能開啟」與「依規則連線」。頁面能開啟,可能是因為它符合 DIRECT,而不是透過 PROXY。進入 App 提供的請求記錄或 Log,找到剛才造訪的網域,查看符合的規則與最終策略。若記錄中沒有對應請求,先確認時間、網域及目前連線是否一致,不要只靠頁面開啟速度推測連線路徑。

驗證 Proxy 時,請使用同一個目標頁面與同一台伺服器,比較連線前後的實際存取結果;驗證 Direct 時,則用來確認基本網路。不同模式負責不同的檢查項目,不必要求所有模式都得到相同結果。尤其不要只以狀態列的 VPN 標示作為結論:系統標示說明通道狀態,並不會直接顯示每個請求最後採用的策略。

最後進行一次日常使用檢查:如果剛才為了排查暫時切換到 Proxy,現在請恢復預定使用的 Config,再次發出目標請求並查看記錄。可以記下目前的設定檔名稱、伺服器名稱、Global Routing 選擇和測試現象,但不要將驗證資訊寫入公開記錄。恢復日常模式後仍符合預期,才算完成這次入門操作。

STEP 05 · 依失敗階段定位

常見失敗原因與後續檢查

先確認失敗發生在哪個步驟,再決定要修改什麼。建議記錄「訂閱能否更新、伺服器能否測試、連線開關能否維持開啟、目標請求是否成功」四項結果。每次只修改一項,並重新測試相同目標;恢復正常後,再還原為診斷而進行的臨時調整。這樣比反覆解除安裝再安裝更容易保留有效資訊。

訂閱沒有內容或更新失敗

先回到訂閱編輯頁面,確認 URL 是否完整、Type 是否為 Subscribe,以及連結是否仍在有效期限內。如果傳回的是登入頁面、提示文字或空白內容,用戶端便無法將它當作伺服器清單使用。此時應向自己的服務供應商確認訂閱網址與回應格式,不要自行猜測參數。取得訂閱發生在連線之前,不能把「更新失敗」直接等同於「所有伺服器都無法使用」。

已有伺服器清單,但這次更新失敗時,先保留現有群組,確認舊項目是否仍能正常運作,再判斷是取得訂閱的問題還是伺服器連線問題。不要公開完整訂閱網址以尋求排查協助;提供錯誤現象、發生階段與已進行的檢查通常更有幫助。訂閱含有存取憑證時,應依憑證的敏感程度妥善處理。

伺服器測試失敗或連線後無法存取

逐項確認位址、連接埠、協定與驗證欄位;啟用 TLS 的項目也需要檢查相應名稱是否符合伺服器要求。不要只改連接埠碰運氣。若資料原本由訂閱產生,請優先確認訂閱是否正確更新,再向服務供應商確認伺服器狀態。切換 Wi-Fi 與行動網路可用於比對,但每次切換後都要重新執行測試,而不是沿用舊結果。

如果所有目標在 Direct 下也無法使用,請先處理本機網路,例如確認是否需要完成 Wi-Fi 登入,或網路是否已連線。如果開關無法維持開啟,先檢查系統 VPN 授權與連線衝突;如果開關正常但請求失敗,再檢查伺服器、解析與策略。區分這些階段,能避免在系統授權問題上浪費時間修改規則。

只有部分頁面或 App 無法使用

先用同一個目標比較 Config 與暫時使用 Proxy 的結果。如果 Proxy 正常但 Config 異常,請著重檢查實際符合的規則、策略指向與規則順序;如果只有網域解析失敗,而其他請求正常,再檢查 DNS 記錄與設定。不要只憑單一現象就替換所有 DNS 參數,也不要在沒有備份時覆蓋整份 Config。

涉及 DNS、On Demand、Log 或還原設定的進階操作,請前往設定參考逐項閱讀。更多依現象分類的說明,請參閱常見問題。提供排查資訊前,請隱藏訂閱 URL、密碼、UUID 等敏感欄位,只需保留介面用語、錯誤文字與操作順序。

完成後保留可用的伺服器選擇與 Config,後續每次只調整一項設定。需要更新訂閱時,請更新原有群組;需要修改規則時,先儲存現有設定。每次變更後,依照「連線狀態 → Connectivity Test → 實際請求 → 符合的策略」順序檢查。