官方手冊 · 首次連線

Shadowrocket 入門指南

依序完成匯入、選路、連線、驗證與排查。首次使用先建立一條可驗證的連線,再調整規則與自動連線設定,避免一次變更多個條件。

備妥資訊後,先確認取得的是伺服器分享資訊,還是可更新多個項目的訂閱網址。兩者的填寫位置不同,不能只憑網址外觀判斷;不確定時,請向提供資訊的服務商確認類型。訂閱網址、密碼和 QR Code 可能包含存取憑證,請勿放入公開截圖或留言。

01 · Add Server / Subscribe:新增現有資訊

開啟 Shadowrocket,進入 Home。首次使用時,清單中可能還沒有伺服器項目,這是尚未匯入資訊的正常狀態。點選右上角的加號進入 Add Server,再依手上的資訊選擇匯入方式。先完成以下其中一種即可,不必為了開始使用而重複新增相同資訊。

已有訂閱網址:選擇 Subscribe

在 Add Server 的 Type 中選擇 Subscribe,將自己的完整訂閱網址填入 URL,設定容易辨識的名稱後儲存。貼上時留意網址前後是否混入空格、換行或說明文字;不要刪除網址問號後的參數,這些參數可能用於識別自己的訂閱。儲存並等待更新完成,再返回 Home 查看訂閱群組及其中的伺服器項目。

看到訂閱名稱不一定代表伺服器已成功匯入。請繼續展開或查看相應群組,確認是否實際出現可選的伺服器;若只有群組而沒有項目,應先檢查訂閱更新結果,不要立即開啟連線開關。更新失敗時,保留原網址以供核對,確認訂閱仍有效、目前網路可存取該網址,並向服務商確認輸出格式適用於 Shadowrocket。不要為了顯示內容而隨意替換網址中的參數。

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

如果取得的是伺服器參數,請先在 Add Server 選擇與資料一致的 Type,再填入位址、連接埠和驗證資訊。不同協定顯示的欄位不同,例如某些類型使用 Password,某些類型使用 UUID;這些值不能互換。伺服器位址、TLS 相關名稱與傳輸路徑也可能各有用途,應依原始資料逐項填寫,不要將看似相近的欄位合併成同一個值。協定欄位的詳細含義可另行參閱協定技術參考。

若已有服務商提供的 QR Code,可從 Home 的新增入口使用 Scan QR Code;匯入後仍須查看項目詳細資訊,核對類型和位址。掃描只能減少輸入步驟,不代表資訊仍然有效。儲存後返回 Home,點選準備使用的伺服器,確認其處於選取狀態。至此完成的是「將資訊放入客戶端」,下一步還要決定哪些連線交由它處理。

02 · Global Routing:決定連線路徑

在 Home 點選 Global Routing,選擇設定檔(Config)、代理(Proxy)或直連(Direct)。這三個選項決定連線如何選路,不是三種伺服器協定,也不代表不同速度等級。首次驗證時應清楚記下目前的選擇,否則同一伺服器在不同模式下出現不同存取結果,很容易被誤認為參數突然失效。

設定檔(Config):依現有規則分流

日常需要依規則分流時,選擇設定檔(Config)。它會依目前啟用的設定檔處理連線,因此選擇前先進入 Config,確認已有可用設定檔,且選取的是預期使用的設定檔。規則通常依由上而下的順序比對,命中後採用相應策略;DIRECT 代表直連,PROXY 交由代理策略處理,REJECT 則拒絕連線。設定檔若使用策略群組,還須確認群組內實際選擇的項目,不能只憑 Home 選取某個伺服器,就推斷所有策略群組都會使用該伺服器。

如果目前沒有自己的有效設定檔,不要只選擇 Config 就假定分流已完成。先使用下一種模式驗證伺服器,再回頭整理設定檔。不要在不了解內容時覆蓋現有 Config;若有舊設定檔,請先保留副本,之後只修改需要檢查的規則。如需進一步了解 Rule 比對範圍和設定檔復原方式,可參閱FAQ。

代理(Proxy)與直連(Direct):明確指定路徑

代理(Proxy)適合用來短暫檢查所選伺服器能否處理實際請求。它通常會將由客戶端處理的連線交由代理路徑處理,方便先將規則因素與伺服器因素分開;但伺服器是否可用仍取決於位址、參數和網路。驗證結束後,若要依規則使用,應切回設定檔(Config)並再次驗證,而不是把一次 Proxy 測試結果當成分流設定正確的證明。

直連(Direct)會讓由客戶端處理的連線採用直連路徑,不能用來證明代理伺服器已可使用。需要對照網路基準時可以使用,但變更後請記得恢復預期模式。選好 Global Routing 後返回 Home,確認伺服器仍處於正確的選取狀態,再進行首次連線。

03 · Home:開啟開關並允許 VPN 設定

返回 Home,再次確認所選伺服器與 Global Routing,接著開啟頂端的連線開關。首次連線時,iPhone / iPad 可能會顯示新增 VPN 設定的系統提示。確認操作是由剛才開啟的 Shadowrocket 發起後,允許新增,並依系統提示使用裝置密碼或生物辨識完成驗證。這裡授權的是裝置建立本機 VPN 設定的權限,不是購買或啟用伺服器。

完成授權後返回 Shadowrocket,確認連線開關能否維持開啟,以及客戶端是否顯示已連線。若系統設定中出現 VPN 狀態,也只能表示系統端的連線設定已啟用,並非伺服器可用性的報告。伺服器密碼錯誤、目標網域解析異常或規則路徑不符時,連線狀態仍可能保持,因此還要完成下一節的實際存取驗證。

如果開啟後立即關閉,先確認是否取消了首次出現的系統提示。可以開啟系統 Settings,搜尋 VPN,檢查是否存在相應設定,以及裝置是否受到管理限制。若裝置由學校或單位管理,請遵循其管理要求;不清楚作用時,不要刪除其他 VPN 設定或描述檔。另一個正在運作的 VPN 也可能影響連線,測試前先確認目前由哪個設定負責連線。

初次使用建議先維持手動連線,不必急著啟用 On Demand。自動連線會在網路變更後讓裝置再次建立連線,容易干擾「關閉後進行對照」的判斷。手動驗證通過後,再了解 On Demand 的適用條件。連線過程中也不必反覆快速切換開關;等待狀態穩定並記下實際錯誤,再進行下一步,比連續重試更容易保留故障線索。

04 · Connectivity Test:測試並驗證實際存取

先在 Home 使用 Connectivity Test 檢查伺服器項目的可連線性,觀察所選項目是否回傳結果。這項測試適合快速發現明顯逾時,但測試方式和目標會影響結果,因此不要將單次顯示的數值當成完整使用體驗,也不要把某次測試逾時直接等同於所有請求都會失敗。測試完成後,保持目前的伺服器與 Global Routing 不變,再使用瀏覽器實際存取網站。

開啟一個平時熟悉且目前應可正常使用的網頁,先確認是否能完整載入,再換另一個不同網站確認。只測試一個頁面時,目標網站本身故障、快取內容或登入狀態都可能干擾判斷。看到頁面不代表已驗證代理路徑;需要搭配 Global Routing 與目前 Config 的 Rule,確認這次請求原本應採用 DIRECT 還是 PROXY。

若客戶端的連線記錄提供該請求的比對資訊,可核對目標網域、命中的規則與策略。使用設定檔(Config)時,某個網站正常直連可能正是規則預期的結果;不能因為流量沒有經過代理,就認定連線未生效。相反地,若預期交由 PROXY 處理的請求未依計畫執行,應檢查規則順序、設定檔選擇及策略群組,而不是立即更換伺服器資料。

為了進行清楚的對照,可以記下三項結果:目前模式、Connectivity Test 是否回傳結果、瀏覽器的實際請求是否成功。必要時只切換一次代理(Proxy),重新測試相同目標:Proxy 正常但 Config 異常,優先檢查規則或策略設定;兩者都失敗,則繼續檢查伺服器參數和網路。重新測試完成後,恢復日常所需的模式,避免將臨時診斷狀態留作長期設定。

最後,先關閉再重新開啟瀏覽器中的目標頁面,減少舊快取造成的誤判。不要藉由連續重新整理同一頁面,推斷所有 App 的連線狀態;不同 App 可能會保留既有連線,需要重新發起請求才能觀察設定變化。能說明「選了什麼、請求經過哪裡、結果如何」,才算完成這次首次驗證。

05 · 常見問題:分層檢查,避免同時變更多項

連線失敗時,從最先未達預期的步驟開始檢查。尚未成功匯入,就先修復匯入;伺服器測試持續逾時,就先確認參數;只有設定檔(Config)結果不符預期時,再檢查規則。將問題分層處理,可以避免在原本正確的地方繼續修改,讓一個錯誤變成多個錯誤。

  1. Home 沒有可選伺服器:檢查訂閱下方是否實際產生項目、更新時是否出錯,以及是否誤將單一伺服器資訊填入 Subscribe。只有訂閱名稱不代表內容已完成解析。請向自己的服務商確認格式與有效狀態,不必先變更 Global Routing。
  2. 有項目,但 Connectivity Test 逾時:進入項目詳細資訊,逐一核對位址、連接埠、Password 或 UUID,以及 TLS 和傳輸參數。字元大小寫、路徑開頭的斜線、複製時遺漏的尾端內容都值得檢查。不要憑印象將連接埠改成常見值,務必以自己的原始資料為準。
  3. 測試與請求都失敗:檢查裝置日期、時間和時區是否正確,先啟用系統自動設定後重試。時間偏差可能影響憑證或驗證。接著在條件允許時分別使用 Wi-Fi 與行動網路測試,同一輪測試保持伺服器和參數不變;只有一種網路失敗時,記下網路差異,不要急著重建所有設定。
  4. 連線開關無法維持開啟:返回系統 VPN 設定,確認新增權限與目前連線設定,再檢查是否有其他 VPN 正在接管連線。如果系統受到裝置管理限制,請聯絡裝置管理方確認。只有在了解影響並保留原設定的前提下才處理衝突,不要任意刪除憑證或重設整台裝置的網路。
  5. Proxy 可用,但 Config 不如預期:確認 Config 啟用的是正確檔案,檢查目標請求命中的 Rule 和相應策略。較早命中的廣泛規則可能讓後面的細分規則沒有機會執行;策略群組指向失效項目時,也可能出現伺服器單獨測試正常、實際連線卻失敗的情況。
  6. 只有某個網頁或 App 異常:先區分目標服務故障、網域解析失敗和連線路徑錯誤。不要立即關閉 TLS 驗證或大幅變更 DNS。記下異常網域、錯誤提示、目前網路與路由模式,再參閱FAQ 的規則與故障排除說明,依照相應狀況繼續處理。

每完成一項變更,都回到相同的驗證目標重新測試,並記錄結果是否改變。向服務商確認時,只提供必要的錯誤狀況、協定類型和已遮蔽敏感資訊的參數,不要公開完整訂閱網址、驗證資訊或 QR Code。若需要了解協定欄位為何不同,可參閱協定技術參考;初次使用不必先學完所有協定才能建立連線。

完成後保留清楚的使用記錄:已匯入現有資訊、選取了哪個項目、Global Routing 採用哪種模式,以及測試與實際存取各自的結果。之後更新訂閱或調整 Config 時,每次只變更一個部分並重複驗證。即使網路環境改變,也能從上次成功的狀態開始檢查。