官方手冊 / 首次連線

Shadowrocket 訂閱匯入與連線教學

從現有連線資訊開始,依序完成匯入、路由、連線、測試與排查。先完成一次可重複的連線測試,再調整規則與自動連線設定。

  • Home → Add Server
  • Global Routing
  • Connectivity Test

本頁目標是完成首次連線。介面名稱保留英文;按鈕位置可能因裝置與 App 介面而異,請依名稱找到入口。連線資訊備齊後,依序完成檢查即可,不必先熟悉所有設定參數。

步驟 01 / 建立伺服器清單

Add Server:新增伺服器或匯入 Subscribe

開啟 Shadowrocket,進入 Home。首次使用時,清單中可能還沒有伺服器;這表示尚未匯入連線資訊,不是安裝失敗。先確認手上的資訊類型:可更新一組伺服器的訂閱 URL、單一伺服器的分享連結,或包含位址、連接埠與驗證資訊的參數說明。這三種資訊的匯入方式不同,請勿將訂閱 URL 當成伺服器位址輸入。

已有訂閱 URL:使用 Subscribe

在 Home 點選右上角的新增按鈕,開啟 Add Server,進入 Type 並選擇 Subscribe。返回填寫頁面後,將完整訂閱網址貼到 URL,並在 Remarks 輸入方便辨識的名稱,接著儲存。貼上前後請確認沒有多出空格、換行或說明文字;網址中的查詢參數也要保留,不可只複製網域部分。

儲存後返回 Home,等待訂閱讀取完成,再確認是否出現訂閱群組及其中的伺服器項目。如果只儲存了訂閱名稱,卻沒有可選的伺服器,請先檢查讀取結果,不要重複新增相同網址。訂閱網址通常包含存取憑證,請像密碼一樣妥善保管;向他人描述問題時,切勿傳送完整 URL 或含有憑證的 QR Code。

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

如果拿到的是參數資訊,請在 Add Server 的 Type 中選擇與原始說明相符的協定,再填入伺服器位址、連接埠與驗證欄位。不要只憑名稱猜測協定,也不要自行將網域換成解析出的 IP;部分連線會依賴原本的網域與相關 TLS 設定。若包含傳輸方式、路徑或其他進階欄位,請逐項對照服務商提供的資訊;未提供的欄位不要自行填寫。

如果已有分享 QR Code,可使用 Scan QR Code 入口,並依系統提示授予相機權限。若已有分享連結,可依 App 顯示的剪貼簿匯入提示操作;若沒有提示,請先確認複製的是完整分享內容,而不是網頁標題。掃描或貼上匯入後,仍須檢查項目類型與位址。匯入成功只表示 App 能辨識資訊,不代表伺服器已可正常使用。

最後,在 Home 點選要使用的伺服器,確認它已成為目前選項。先選擇一台完成後續連線測試,不必馬上調整整份清單的排序。訂閱更新、重複項目與備份方式,請參閱訂閱與伺服器管理手冊;接著繼續設定 Global Routing。

完成條件:Home 中已有可選擇的伺服器,且已明確選定其中一台。

步驟 02 / 決定流量路由

Global Routing:選擇 Config / Proxy / Direct

伺服器決定「透過哪個連線出口」,Global Routing 則決定「哪些連線使用該出口」。在 Home 開啟 Global Routing,先了解三種模式:配置(Config)/代理(Proxy)/直連(Direct)。清單中有伺服器,甚至連線開關已開啟,都不能單獨證明所有要求一定經過所選伺服器;實際流量路由也會受到此處選項影響。

配置(Config):依目前配置逐條判斷

配置(Config)會依目前啟用配置中的規則處理要求;符合 DIRECT 的流量會直接連線,符合 PROXY 的流量則使用相應的代理策略。使用前請進入 Config,確認目前啟用的配置及其用途。匯入訂閱不代表也匯入了完整規則配置;Home 出現訂閱群組,也不表示 Config 已切換。

已有可信任且符合自身需求的配置時,可使用配置(Config)進行日常連線。不要為了完成首次操作就任意替換整份配置;配置檔可能還包含 DNS、策略群組等設定,替換後若出現問題,會增加排查因素。本頁不必一次學完所有規則細節,先記下目前配置名稱,確保之後能還原。

代理(Proxy)與直連(Direct):用於明確比對

代理(Proxy)會讓由 App 處理的流量走代理路徑,適合暫時確認所選伺服器能否正常連線,但不代表裝置上的所有通訊都一定經過這條路徑。直連(Direct)會讓受處理的流量直接連線,可用來比對基礎網路;它不是「代理連線更穩定」的另一種模式,也不會透過所選伺服器轉送這些要求。

首次排查時若不確定規則是否影響測試,可先記下原本的選項,暫時切換至代理(Proxy)完成一次連線,再恢復配置(Config)並重複相同測試。若兩次結果不同,請優先檢查配置與策略,不要立刻刪除伺服器。無論選擇哪種模式,設定後都要返回 Home,再進行下一步的連線操作。

完成條件:能說明目前選擇的模式及用途,並知道暫時測試後應恢復哪個模式。

步驟 03 / 建立系統連線

Home:開啟連線並完成首次 VPN 授權

返回 Home,再次確認目前伺服器與 Global Routing,確保瀏覽清單時沒有誤選其他項目,接著開啟頂端的連線開關。首次建立連線時,系統可能會提示 Shadowrocket 要求新增 VPN 配置。這是 App 管理相關網路流量所需的系統授權,不是重新購買 App,也不代表訂閱已生效。

在系統提示中確認要求的 App 是 Shadowrocket,閱讀提示後允許新增,並依裝置要求完成身分驗證。若取消或拒絕,App 可能無法建立連線;此時請返回 Home 再試一次,並依系統提示完成授權。若裝置受組織管理或設有使用限制,相關權限可能由管理政策決定;請先確認限制條件,不要反覆重置配置。

授權完成後返回 App,確認連線開關與狀態是否維持開啟。系統狀態列或控制中心中的 VPN 標示可協助確認系統連線已建立,但不同裝置的顯示位置可能不同。VPN 已連線不代表遠端伺服器、DNS 與目標網站都正常,仍須繼續測試實際連線。

首次測試期間,先不要啟用或調整 On Demand。按需連線條件可能在手動中斷後再次發起連線,讓測試前後的狀態難以比較。若之前已設定自動連線條件,請先記下設定,了解其作用後再暫時停用自動觸發。裝置上其他正在使用的 VPN 連線也應先中斷,避免連線狀態互相切換。

如果開關立刻關閉,請記下當時的系統提示與 App 錯誤訊息,直接前往問題排查檢查授權與配置;不要連續快速切換開關。若開關保持開啟,請維持目前狀態並進入測試步驟。要結束本次連線時,返回 Home 關閉開關並確認系統連線狀態;若連線自動恢復,請重新檢查 On Demand 條件。

完成條件:已完成系統授權,且連線狀態能維持;下一步要測試實際要求,而不只是確認開關。

步驟 04 / 以實際要求確認結果

Connectivity Test:分別檢查延遲與網頁連線

先確認裝置目前使用的 Wi-Fi 或行動網路本身可正常連線。如果基礎網路仍停留在登入驗證頁面,或暫時無法上網,請先完成驗證並恢復連線,再測試 Shadowrocket。否則,訂閱讀取、延遲測試與網頁連線可能同時失敗,容易誤以為伺服器參數有誤。

在 Home 使用 Connectivity Test 測試已匯入的伺服器,並等待本次測試完成。測試結果可用於初步判斷連線能力與回應狀況,但不同測試方式的檢查範圍並不完全相同。有延遲數值不代表驗證、DNS、規則與目標網站連線都正常;沒有測試結果時,也應一併考量測試方式與網路環境,不要只憑一次結果就刪除項目。

接著開啟 Safari,前往一個你有權存取且平時可正常使用的 HTTPS 網頁。等待網頁實際載入,再開啟同一網站的另一個頁面,避免把快取頁面誤認為目前連線成功。若目標 App 也需要使用此連線,請開啟該 App 進行相應操作;瀏覽器能連線只代表這次瀏覽器要求成功,不能取代 App 內的測試。

使用配置(Config)時,某個頁面能開啟,不代表流量一定經過代理:該網域可能符合 DIRECT 規則。若要確認流量路由,請查看 App 中的要求記錄或日誌,依目標網域尋找相關要求,確認是否符合目前配置的策略。僅在自己的裝置上檢查必要資訊;日誌可能包含瀏覽過的網域,不應整份公開。

若要讓結果可供比較,每次只變更一個條件。例如保持網路、伺服器與測試頁面不變,只暫時將配置(Config)改為代理(Proxy),重新載入相同頁面後再恢復原選項。若代理(Proxy)可用、配置(Config)失敗,應優先檢查規則、策略選擇與 DNS;若兩者都失敗,再檢查伺服器與網路。

測試完成後,保留一台已確認可用的伺服器與一份目前配置,作為基準。日後更換伺服器、更新訂閱或修改規則時,都可使用相同頁面重複測試。不要只以延遲最低作為選擇依據;實際連線穩定且能完成目標操作,才是本次測試要確認的結果。

完成條件:測試頁面能正常載入、目標操作可完成,且流量路由符合目前 Global Routing 的預期。

步驟 05 / 依問題發生階段縮小範圍

Shadowrocket 無法連線:先找出失敗步驟

遇到問題時,先記下「哪個步驟未達成完成條件」,再依照以下順序檢查。匯入失敗、開關無法維持開啟與網頁無法連線,屬於不同階段,處理方式也不同。保留目前配置與原始連線資訊,每次只變更一項,並在變更後重複相同測試,才能判斷問題是否確實解決。

訂閱沒有伺服器項目,或更新後仍無法使用

回頭檢查訂閱資訊,確認 URL 完整,特別留意結尾參數、大小寫與貼上時夾帶的空白。確認目前基礎網路能存取訂閱網址後,再更新現有訂閱,不要重複建立多個群組。如果回傳內容是帳號登入頁面、說明頁面或其他無法辨識的內容,App 就無法依預期建立伺服器清單。

訂閱的存取權限、有效狀態與伺服器可用情況,請向服務商確認。回報問題時,只需提供錯誤訊息、發生階段與必要的去識別資訊。排查時不要將完整訂閱 URL 貼到公開網頁或聊天截圖中。更多更新與整理方式請參閱訂閱更新說明。

伺服器項目已存在,但測試失敗或連線中斷

先確認目前選取的伺服器,再檢查協定、位址、連接埠與驗證資訊。手動填寫的項目尤其要檢查 TLS 與傳輸相關欄位;各項連線參數必須互相吻合,位址與連接埠正確仍不一定足夠。若服務商已更新資訊,請依最新有效資料修改,不要只改項目名稱。

若系統授權尚未完成,或開關立刻關閉,請先處理裝置顯示的權限提示。若連線狀態能維持但實際要求失敗,再測試另一台現有伺服器,並維持相同網路與測試頁面。一次切換多台伺服器,又同時更改 DNS 和規則,會讓結果失去比較基準。

延遲正常,但網頁無法開啟

先確認是否誤選直連(Direct),再依前述方式比較配置(Config)與代理(Proxy)。若只有配置(Config)無法連線,請檢查目前啟用的配置及相關規則;兩種模式都無法連線時,再檢查伺服器功能、基礎網路與 DNS。測試另一個平時可正常開啟的網頁,有助於判斷是特定網站問題,還是普遍無法連線。

DNS 負責將網域名稱解析為位址;延遲測試成功,不代表每個網域都能正常解析。檢查前先儲存配置,並確認是否曾修改 dns-server 等參數;不要隨意填入不熟悉的位址。優先還原先前已驗證可用的設定,再重複測試。詳細排查順序請參閱延遲正常但網頁無法開啟:DNS 檢查說明。

排查完成後,恢復日常設定

確認在相同網路、相同伺服器與相同頁面下能穩定重現測試結果後,請恢復日常使用的 Global Routing,並確認暫時測試沒有停留在代理(Proxy)或直連(Direct)。若需要 On Demand,再另外設定觸發條件並測試。接著可閱讀訂閱與伺服器管理手冊,整理群組、更新與備份;首次連線時不必同時變更所有進階選項。

完成條件:能明確指出失敗階段、已檢查項目與重新測試的結果,而不只是知道「開關已開啟」。