官方手冊 · 操作教學

Shadowrocket 使用教學 匯入訂閱與連線檢查

依「準備資料 → 匯入 → 選擇路由 → 連線 → 驗證」的順序操作。先用一台伺服器確認完整流程,再整理訂閱與規則,避免同時修改多項設定。

首次操作建議從第一步開始。已有清單但無法瀏覽時,先跳到第四步確認狀況,再依第五步排查,暫時不要刪除既有設定。

STEP 01 / IMPORT

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

先判斷手上的資料類型:用來更新伺服器清單的訂閱連結,或是單一伺服器的位址、連接埠與驗證參數。兩種資料的填寫位置不同,不能將訂閱連結直接填入伺服器位址欄。開啟 Shadowrocket 後進入 Home,查看現有清單;如果已有相同來源的群組,先確認是否需要更新原有群組,避免重複新增項目。

已有訂閱連結:從 Add Server 選擇 Subscribe

在 Home 點選右上角的新增按鈕,進入 Add Server。開啟 Type 選項,選擇 Subscribe,再將完整訂閱連結貼到 URL 欄位。為連結設定容易辨識的名稱,儲存後返回 Home,等待訂閱內容載入。名稱僅供辨識,不會改變訂閱對應的連線參數。

貼上前請檢查連結是否完整,特別留意末尾參數是否被通訊軟體換行、截斷或加上空格。訂閱網址通常包含個人存取憑證,不能只因網域相同就認定兩條連結相同。需要重新取得時,請向自己的服務商索取完整連結,不要拼接他人提供的參數,也不要將連結提交到不熟悉的網頁測試。

返回 Home 後,應能看到群組及其中的伺服器項目。如果只出現群組名稱而沒有內容,先查看是否有更新失敗提示,再檢查目前網路能否取得訂閱內容。訂閱更新失敗與單一伺服器無法連線是不同階段的問題:前者尚未取得清單,後者則是在已有參數的情況下建立連線失敗,後續排查時請勿混為一談。

已有單一伺服器資料:逐項核對 Type 與參數

如果手上的是單一伺服器資料,同樣從 Add Server 開始,但 Type 應選擇資料中對應的協定,而不是 Subscribe。依原始資料填寫伺服器位址、連接埠及驗證資料。不同協定顯示的欄位可能不同;填寫密碼、加密方式或其他連線參數時,請以伺服器實際設定為準,不要用其他教學中的範例值代替。

只有在資料明確要求時,才填寫額外的傳輸與 TLS 相關選項。網域、路徑及其他欄位可能區分大小寫,缺少其中一項也可能導致連線失敗。如果取得的是可匯入的 QR Code,可以使用 App 提供的 Scan QR Code;匯入後仍應開啟項目,檢查協定與位址是否符合預期。QR Code 只是資料載體,不能證明伺服器有效。

儲存後返回 Home,點選準備使用的伺服器,確認它已成為目前選取的項目。先保留一個明確的測試對象,不要每次測試前都隨機切換。到這裡完成的只是「將連線資料加入 App」,還需要選擇流量處理方式,再建立系統連線。

STEP 02 / GLOBAL ROUTING

選擇 Global Routing 模式

在 Home 開啟 Global Routing。這裡決定流量的處理方式,與「目前選取哪台伺服器」是兩項不同設定。首次使用時先確認目前選取的項目,再依需求選擇設定(Config) / 代理(Proxy) / 直連(Direct)。選好後返回 Home,不要只停留在選項頁面而忽略實際生效狀態。

設定(Config):依目前設定中的規則處理

Config 會依目前使用的設定決定請求的路由。規則可能將部分請求交給 PROXY,另一部分交給 DIRECT,也可能使用 REJECT。因此,選取伺服器不代表每個請求都會經過它。如果已有可信任且適用於目前環境的設定,先前往 Config 查看目前啟用的設定,再返回 Global Routing 選擇 Config。

訂閱與設定不可混為一談:Subscribe 主要用於取得及更新伺服器資料,Config 則包含規則等設定。匯入訂閱不代表已匯入符合需求的分流規則。初次檢查時不必立即編輯 DOMAIN-SUFFIX、GEOIP 或 FINAL;先確認目前使用的設定及其用途,複雜的規則問題可再查閱分流常見問題。

代理(Proxy):用於對照檢查代理連線

不確定是規則未匹配,還是目前伺服器無法使用時,可以暫時選擇 Proxy,保持同一台伺服器與同一個測試頁面不變,進行一次對照測試。此模式會依代理方式處理流量,但不應據此推斷所有系統流量一定會經過相同路徑。如果 Proxy 下可以瀏覽,而 Config 下失敗,排查重點應轉向目前設定、匹配策略及名稱解析,而不是立即刪除訂閱。

直連(Direct):檢查直接連線路徑

Direct 會以直接連線方式處理流量,不適合用來驗證代理伺服器是否有效。它可作為基礎網路檢查的一部分,但與關閉系統連線並不完全相同。測試結束後,返回 Global Routing 恢復所需模式,並記下目前設定;後續每次驗證都應說明是在 Config、Proxy 還是 Direct 模式下完成。

STEP 03 / CONNECT

開啟連線開關並完成系統授權

返回 Home,依序確認伺服器選取項目與目前的 Global Routing 模式,再開啟頂部的連線開關。首次建立連線時,系統可能會顯示新增 VPN 設定的授權提示。確認提示是在你剛主動連線 Shadowrocket 後出現,再選擇允許,並依裝置要求完成密碼或生物辨識驗證。這裡授權的是建立系統網路連線所需的設定,不會自動補齊伺服器缺少的參數。

如果剛才取消提示,App 可能無法繼續連線。返回 Home 再試一次,留意授權視窗是否重新出現。若仍無法完成,可在系統 Settings 中查看 VPN 相關設定與狀態;不同系統版本的選項名稱可能有所差異,請以裝置實際顯示為準。不要為了排查而任意刪除工作或學校管理的網路設定,受管理裝置應先確認相關限制。

完成授權後返回 App,觀察開關能否保持開啟,以及系統是否顯示 VPN 連線已建立。如果開關立即關閉,先記下 App 提示,再檢查授權狀態與目前的伺服器資料,不要持續快速重複點選。如果裝置已有其他 VPN 連線,應先確認目前由哪個項目管理連線,避免在切換過程中將舊狀態誤認為本次操作結果。

連線開關保持開啟,只代表連線流程進入下一階段,不能證明目標網站已可正常瀏覽。伺服器驗證、網域解析、遠端可用性與規則處理仍可能發生問題,因此接下來必須實際檢查瀏覽結果。此時先不要調整 On Demand 等自動連線選項;手動流程穩定後再考慮自動化,能減少排查變數。

STEP 04 / VERIFY

使用 Connectivity Test 與實際瀏覽結果進行驗證

先在 App 中使用 Connectivity Test,查看目前伺服器的測試結果。測試反映的是特定測試方法與目標的回應情況,適合作為初步線索,並不代表所有網站、App 或傳輸方式都能正常運作。即使收到回應,仍需繼續瀏覽目標頁面;沒有收到回應時,也應結合實際瀏覽結果與錯誤提示判斷,不要只根據單一結果修改所有設定。

保持連線開啟,切換到瀏覽器,開啟一個自己熟悉且能辨認內容是否正常的頁面。必要時重新載入或開啟新頁面,以減少舊快取的干擾。先觀察頁面能否載入,再確認登入、圖片或其他必要內容是否正常。如果只測試瀏覽器已儲存的頁面,即使網路已中斷也可能看到部分內容,不能據此認定連線成功。

接著選擇另一個用途不同的頁面進行對照。記錄目前使用的是 Wi-Fi 還是行動網路、Global Routing 選項、目前伺服器及瀏覽狀況。如果兩個頁面的結果不同,不要立刻將問題歸因於用戶端整體失效;可能是路由規則不同,也可能是目標網站狀態、DNS 或遠端連線條件不同。

需要判斷規則是否依預期運作時,查看 App 目前提供的連線記錄或診斷資訊,重點確認目標網域對應的處理策略。Config 下出現 DIRECT 不一定是錯誤,應配合規則預期用途判斷;只有當原本應使用 PROXY 的請求實際採用其他策略時,才繼續檢查對應設定。Data 中的流量變化可協助觀察活動狀況,但不能單獨證明特定頁面經過指定伺服器。

如果剛才暫時改用 Proxy 或 Direct,現在請恢復原本需要的 Config,再重新測試相同頁面。只有在目標路由模式下也能重現正常結果,才算完成本次流程。若結果不一致,請保留現有設定與測試記錄,進入下一步逐層排查,不要以反覆重新安裝取代問題定位。

STEP 05 / TROUBLESHOOT

依序排查常見問題

排查時每次只變更一項條件,再重複第四步的相同測試。先記下問題屬於「訂閱無法載入」、「連線開關無法保持」、「已連線但所有頁面都失敗」或「只有部分頁面失敗」。這四種狀況對應不同環節;先釐清問題類型,通常比同時更換伺服器、設定與 DNS 更容易找出可行的處理方式。

先確認基礎網路,再檢查訂閱內容

關閉 Shadowrocket 的連線,檢查目前網路能否開啟平時可直接瀏覽的頁面。公共 Wi-Fi 可能需要先完成網路登入;基礎網路尚未可用時,請先處理網路問題。接著返回 App 更新已有的訂閱。更新失敗時,檢查連結是否完整、服務狀態與錯誤提示;更新成功但沒有項目時,請向自己的服務商確認連結內容與有效狀態。

不要連續重新新增同一條連結來嘗試修復,這只會讓清單更難辨識。也不要將「舊項目仍顯示」視為更新成功的證明,舊清單可能仍會保留。需要回報問題時,只描述錯誤提示與發生階段,不要在公開截圖或訊息中放入訂閱連結的個人參數。

連線失敗:核對參數與系統授權

如果伺服器已出現在 Home,但仍無法連線,請開啟該項目,逐項比對 Type、位址、連接埠、驗證資料及資料中要求的附加欄位。優先修正明確不一致的欄位,不要任意嘗試所有選項。手動新增時遺漏參數、匯入的資料已過期,以及裝置上的系統授權尚未完成,都可能造成連線失敗,但處理方式各不相同。

如果同一台伺服器只在某一種網路下失敗,可在條件允許時切換 Wi-Fi 與行動網路進行對照。保持其他設定不變,避免將切換伺服器造成的差異誤判為網路差異。遠端伺服器是否正在執行、帳戶是否有效及連線限制,應向自己的服務商或伺服器管理者確認。

部分頁面失敗:檢查 Config、DNS 與測試條件

如果 Proxy 下可用而 Config 下失敗,先確認 Config 中目前啟用的檔案,再檢查目標請求對應的策略。修改前請保留原設定;每次只修改一項相關設定,並在測試後記錄結果。如果網域無法連線但其他請求仍有回應,DNS 是可檢查的方向之一,但不能只根據這種狀況確定原因,更不應直接套用來源不明的整套設定。

如果只有單一網站無法瀏覽,也應考慮網站本身的服務狀態或瀏覽要求。測試同一頁面時,盡量使用相同的瀏覽器與網路條件;涉及登入的頁面,也要區分帳戶問題與網路錯誤。錯誤提示可提供線索,單純的「無法開啟」不足以判斷問題發生在哪個環節。

整理去識別化資料,再查詢具體問題

仍無法定位時,請整理裝置系統、目前的 Global Routing 模式、協定類型、基礎網路是否正常、Connectivity Test 狀況及具體錯誤訊息。可以說明修改過哪些設定,但不要包含完整訂閱網址、密碼或 QR Code。前往連線故障常見問題依照狀況繼續檢查;需要確認 App Store 取得方式、裝置復原或商店地區時,請閱讀取得指南,不要將安裝問題與連線問題混為一談。

完成後請記下三項資訊

確認目前選取的伺服器、Global Routing 模式與 Config 檔案名稱。下次瀏覽狀況改變時,先比對這三項與目前網路,再決定是否需要更新訂閱。準備調整設定或移轉裝置前,請先保留現有設定;更多問題可在常見問題中查閱。

返回第一步重新核對