官方手冊 · 首次連線

Shadowrocket 使用教學:匯入訂閱與首次連線

先將現有的伺服器資訊正確匯入 Shadowrocket,再選擇流量路徑、開啟連線並驗證結果。以下五個步驟以完成一次可供檢查的連線為目標,首次使用不必調整所有設定。

操作前提:已安裝 App,並備妥自己的連線資訊

請先安裝 Shadowrocket:iPhone / iPad 可從 App Store 取得,電腦與 Android 可從下載頁免費安裝。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。iPhone / iPad 的系統需求以 App Store 頁面標示為準。

本教學以 iPhone / iPad 介面為例。開始前請確認已有自己的訂閱連結或伺服器資訊;訂閱請向你的服務商取得,本網站不提供節點或訂閱服務。App 一次性買斷 ≠ 線路方案,安裝 App 本身不會自動取得可用伺服器。

建議先保留目前設定與服務商提供的原始參數,不要急著刪除舊項目。首次操作只使用一個明確的伺服器或一份用途已知的訂閱,並保持目前網路不變。如此一來,發生異常時才能分辨問題來自資訊匯入、伺服器連線,還是規則選擇。

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

先確認取得的是單一伺服器資訊、伺服器訂閱連結,還是設定檔連結。它們都可能是一段文字或一個 URL,但匯入後的顯示位置與用途不同:伺服器資訊決定連線到哪裡,設定檔主要決定如何處理請求。不要因為連結以 HTTPS 開頭,就直接認定應該放進 Config。

單一伺服器:從 Home 進入 Add Server

開啟 Shadowrocket 的 Home,點選右上角的新增入口進入 Add Server。先在 Type 中選擇服務商指定的協定,再依原始資訊填寫位址、連接埠及相應的驗證欄位。Shadowsocks、VMess、VLESS、Trojan 等協定的欄位各不相同,不應將某個協定的密碼或識別資訊填入另一個協定的表單。

填寫時請逐項核對,不要只檢查位址和連接埠。如果服務商也提供 TLS、Server Name、傳輸方式或路徑等參數,也要依照要求填寫;不能根據伺服器顯示名稱推測這些內容。儲存後返回 Home,在 SERVER 區域確認新增項目存在,再選取準備使用的伺服器。名稱只是方便辨識的備註,不能用來判斷參數是否正確。

伺服器訂閱:在 Add Server 中選擇 Subscribe

如果取得的是伺服器訂閱連結,請在 Add Server 的 Type 中選擇 Subscribe,將完整連結填入 URL,設定方便辨識的備註後儲存。訂閱連結請向你的服務商取得;複製時不要包含說明文字、換行或前後引號,也不要自行刪除問號後的參數。

匯入並取得內容後,返回 Home 檢查 SERVER 清單是否出現相應群組與伺服器。儲存訂閱記錄不代表已成功取得伺服器內容;如果清單仍為空,應先檢查訂閱是否成功取得,再繼續後續連線步驟。更新現有訂閱不代表需要重新新增一份,請先找到原訂閱的更新操作,避免相同項目重複堆疊而選錯。

Config 中的 Subscribe:用於設定檔訂閱

如果收到的是規則設定檔連結,請進入 Config,使用其中與 Subscribe 相關的入口新增或管理設定檔訂閱。匯入後核對檔案是否可用,以及目前啟用的是哪一份設定。伺服器訂閱與設定檔訂閱不能互相取代:Home 有伺服器,不代表 Config 已選好規則;Config 有檔案,也不代表 Home 已有可用伺服器。

如果手上的是 QR Code 或單一協定連結,可以使用 App 提供的掃描或剪貼簿匯入入口,但只處理來源明確、自己已有的資訊。訂閱 URL 可能包含存取憑證,請勿將完整連結、QR Code 或驗證欄位貼到公開頁面。想了解不同入口的差異,可閱讀Subscribe、Add Server、掃描與剪貼簿匯入說明。確認 SERVER 中已有可選項目後,再進入下一步。

選擇 Global Routing:Config / Proxy / Direct

返回 Home,點選 Global Routing,先決定這次連線要使用哪種模式。這裡控制的是請求的處理方向,不是伺服器參數,也無法修復失效的訂閱。初次使用時,請分別核對「選擇哪台伺服器」與「如何處理請求」,避免只修改其中一項,就以為整個連線條件都已改變。

設定檔、代理與直連的用途及檢查重點
模式 處理方式 初次使用的檢查重點
設定檔(Config) 依照目前啟用設定中的規則決定策略。 核對 Config 中啟用的設定,確認規則符合預期。
代理(Proxy) 透過代理路徑處理請求,用來檢查所選伺服器的連線能力。 核對 Home 目前選取的伺服器,不要將其視為設定規則已生效。
直連(Direct) 透過直連路徑處理請求。 適合用來建立對照,不適合用來驗證代理伺服器是否可用。

已有適用的規則設定,且希望依網域或位址分流時,請選擇設定檔(Config),再到 Config 核對目前啟用的檔案。只看到一份檔案列在頁面中,不代表它正在使用。如果暫時不確定規則是否正確,可以先記下原本的模式,暫時選擇代理(Proxy)測試伺服器;確認基本連線後,再切回設定檔(Config),比較同一個目標的存取結果。

直連(Direct)主要用來對照目前網路的直接存取情況。切換到直連後網頁可以開啟,不代表先前選取的伺服器已恢復,也不代表連線開關一定會關閉。完成對照後,應切回原本需要的模式,並再次查看 Home 顯示的 Global Routing 值。

首次操作只切換模式,不同時修改規則

先保留設定檔原樣。如果代理(Proxy)正常、設定檔(Config)異常,下一步應檢查啟用中的設定與比對結果,而不是立即重新填寫所有伺服器參數。規則關鍵字、策略與比對順序請參閱規則與設定參考。

本頁不要求建立一套新規則。先確認目前模式、所選伺服器與啟用中的設定這三項條件,再開啟連線,後續驗證結果才有比較基準。

開啟 Home 連線開關並允許 VPN 設定

在 Home 的 SERVER 區域選取剛才核對過的伺服器,再確認 Global Routing 的值,最後開啟頁面頂端的連線開關。首次連線前可能會看到 Not Connected;操作後請觀察狀態是否改變,不要連續多次點擊開關。反覆切換會中斷目前流程,也容易混淆系統授權提示與 App 狀態。

首次出現系統授權提示時的處理方式

首次使用時,系統會要求允許 Shadowrocket 新增 VPN 設定。核對提示對應的 App 後選擇允許,並依系統要求使用裝置密碼或生物辨識完成確認。這一步是在裝置上建立承載連線的系統設定,不是新增伺服器,也不會修改服務商提供的訂閱內容。如果先前拒絕了請求,可以返回 App 再次發起連線,並依系統提示處理。

完成授權後返回 Shadowrocket,查看頂部開關與連線狀態。系統設定中存在 VPN 設定,只能表示設定已建立,不能單獨證明伺服器可連線、驗證成功或網頁存取正常。即使系統顯示 VPN 已連線,仍須完成下一步的實際請求驗證。

開關立即關閉或狀態沒有變化

先確認 Home 中確實選取了一台伺服器,而不只是新增了訂閱記錄。接著檢查系統授權是否完成,以及是否有其他 VPN 連線或裝置管理政策影響目前連線。請勿直接刪除用途不明的系統設定;受管理的裝置應遵循裝置管理要求。

初次排查時可以先不啟用 On Demand。它用於依條件觸發連線,不是手動連線的必要條件;若將自動觸發與手動開關混在一起,「為什麼剛關閉又連線」會更難判斷。如果先前已啟用 On Demand,請先記下原設定,再暫時關閉自動觸發進行一次手動測試。

當開關能維持開啟,且 App 狀態已更新後,請進入驗證步驟。此時不要急著更換伺服器或調整 DNS,先檢查目前這組條件能完成哪些請求。

使用 Connectivity Test 與實際存取驗證是否生效

判斷連線是否生效時,應分三個層面檢查:系統連線是否建立、所選伺服器是否能完成測試,以及目標請求是否依預期處理。任何一個層面的成功都不能取代另外兩個。建議先在目前的 Wi-Fi 或行動網路下完成整組檢查,再決定是否更換網路,避免測試條件不斷變動。

先執行 Connectivity Test,再送出實際請求

在 Home 使用 Connectivity Test,觀察所選伺服器的測試結果。不同測試方式檢查的環節可能不同,因此測試回應只能說明該次測試結果,不能保證所有網頁和 App 都能使用。也不要只根據清單中一次顯示的回應時間就連續切換伺服器;先確認目前使用的項目與剛才測試的項目相同。

接著開啟瀏覽器,造訪平時確認可正常開啟的 HTTPS 網頁,並重新載入一次。如果頁面已經快取,看到舊內容不一定代表有新的網路請求。也可以檢查另一項正常的網路操作,例如開啟頁面中尚未造訪的連結,但不要只用來源不明的檢測頁面作為判斷依據。

使用設定檔(Config)時還要核對實際策略

若要確認規則分流,請在設定檔(Config)下造訪一個已知預期策略的目標,再返回 App 的 Data 或連線記錄相關頁面,依目標網域與請求時間找出對應記錄,核對實際採用的策略。不能因為某個網頁可以開啟,就斷定它一定經過代理;DIRECT 路徑同樣可能正常傳回頁面。

若結果不符合預期,請保持相同目標、同一台伺服器與同一個網路,暫時切換到代理(Proxy)再測一次。代理(Proxy)正常而設定檔(Config)異常,通常應先檢查規則與設定;兩者都失敗時,則優先檢查伺服器、驗證資訊或目前網路。測試完成後請恢復需要的模式,不要將臨時排查設定留作日常設定。

  1. Home 頂部的連線狀態已改變,目前伺服器與預定使用的項目一致。
  2. 已查看 Connectivity Test 結果,並分別記錄實際網頁存取結果。
  3. 已確認目前的 Global Routing 模式;使用設定檔(Config)時,也已核對啟用中的設定。
  4. 如需驗證分流,已檢查目標請求記錄,而不只是查看系統 VPN 標示。

完成以上檢查後,首次連線便有可供後續比較的基準。之後修改規則、DNS 或 On Demand 時,每次只調整一類設定,再重複這組檢查,就能找出變化的原因。

常見問題:依問題發生的環節逐步檢查

遇到異常時,請從最早失敗的環節開始檢查,不要一次執行重新安裝、修改 DNS、更換伺服器與修改規則。先記下目前網路、伺服器、Global Routing 模式,以及發生問題的具體操作。描述「儲存訂閱後清單為空」,比籠統地說「無法連線」更容易縮小問題範圍。

匯入後 SERVER 為空,或訂閱無法更新

返回匯入步驟,核對使用的是伺服器訂閱入口還是設定檔入口。檢查連結是否遭截斷、包含空格或缺少參數,再確認目前網路能否成功取得訂閱。取得訂閱失敗與代理連線失敗是兩個不同問題;即使舊伺服器仍可使用,也不能因此斷定訂閱更新網址一定可連線。

如果網址回傳登入頁面、提示失效或沒有預期內容,請向你的服務商確認連結狀態與格式,不要自行拼接驗證參數。需要保留排查資訊時,只記錄錯誤提示即可;公開截圖應遮住完整 URL、QR Code、密碼及其他驗證資訊。

連線開關無法維持開啟,或伺服器測試失敗

先重新檢查系統授權與連線步驟,再核對伺服器位址、連接埠、驗證資訊與傳輸參數。尤其要分清備註名稱與實際位址,並確認協定類型沒有選錯。接著在允許的情況下,使用另一個正常網路進行相同測試;更換網路後結果有差異,只能表示網路條件會影響結果,不能直接判定是哪一端故障。

如果多台伺服器來自同一份訂閱,同時失敗時還應確認服務狀態與驗證資訊是否有效;若只有單一伺服器失敗,則先檢查該項參數或可用狀態。不要為了試錯而隨意更改 TLS、Server Name 或路徑,這些參數應符合伺服器端要求。

測試有回應,但網頁仍無法開啟

先確認是否只有單一目標網頁異常,再比較代理(Proxy)與設定檔(Config)的表現。如果只有部分網域失敗,應檢查對應請求記錄、實際策略與 DNS 解析狀況。DNS 負責將網域解析為位址,修改 DNS 無法修復錯誤的伺服器密碼,也不應將每次存取失敗都歸因於解析問題。

暫時保留系統 DNS 作為對照,調整前先記錄原設定。若要比較系統 DNS、自訂 DNS 與 DNS over HTTPS,請閱讀DNS 設定與解析排查說明。這次排查只修改一項解析設定,接著重複存取同一個目標,避免變更後無法判斷效果。

代理(Proxy)正常,設定檔(Config)不符合預期

進入 Config 檢查啟用中的設定,再查看目標請求符合了哪條規則。規則通常依序比對,較寬泛的規則若排在較具體的規則之前,可能會先決定處理結果;FINAL 則負責處理前面規則都未符合時的最終策略。也應檢查是否符合 REJECT,而不是把所有失敗都當成伺服器中斷連線。

首次連線教學到這裡先掌握基本操作即可,不必立即重寫整份檔案。關於 General、Rule、Host、URL Rewrite 的結構,以及 DOMAIN-SUFFIX、IP-CIDR、PROXY、DIRECT、REJECT 的具體含義,請繼續參閱Shadowrocket 規則與設定參考。需要重新建立測試基準時,返回本教學的 Global Routing 步驟,依照固定條件重新測試。

排查完成後恢復日常設定

恢復預定使用的 Global Routing 模式,確認所選伺服器與啟用中的設定,再決定是否恢復 On Demand。保留能重現問題的錯誤描述,不要保留臨時試錯參數;未確認原因前,請勿刪除仍可使用的原設定。