官方手冊 · 首次連線
Shadowrocket 使用教學訂閱匯入、連線與規則分流
先讓一個既有伺服器正常連線,再核對規則是否依預期運作。以下以 iPhone / iPad 介面為例,依五個步驟完成,不必在首次連線時修改所有設定。
先確認資訊類型
Add Server:新增伺服器與訂閱匯入
開啟 Shadowrocket,先停留在 Home。下方的 SERVER 是檢視及選取伺服器的位置;首次使用時,應先將自己的資訊加入清單,而非直接開啟頂端開關。訂閱網址、單一伺服器分享連結和設定檔用途不同,不能只因為都能複製成文字就混用入口。先確認既有資料說明的是一組伺服器的更新網址,還是某一台伺服器的連線參數,再決定下方的匯入方式。
已有訂閱連結:選擇 Subscribe
在 Home 開啟 Add Server,進入 Type 後選擇 Subscribe,再返回填寫頁面,將完整的既有訂閱網址貼到 URL 欄位。備註可用來辨識這組伺服器,填寫自己容易區分的名稱即可。儲存前檢查網址前後是否夾帶空格、換行或聊天內容中的說明文字;網址中的參數是完整連結的一部分,不要只保留問號前的路徑,也不要把其中的認證參數改成範例文字。
儲存後回到 Home,等待訂閱內容讀取完成,檢查 SERVER 中是否出現對應的群組和伺服器項目。只儲存訂閱名稱但沒有伺服器,不代表匯入成功;此時先確認訂閱更新結果,再繼續連線。之後若要取得這組伺服器的變更,應更新原有的 Subscribe 項目,而不是每次都重複新增相同網址。訂閱連結通常含有存取憑證,截圖、求助或備份時都應注意保護。
已有單一伺服器資訊:依 Type 填寫
如果取得的是伺服器位址、連接埠和認證資訊,請先在 Add Server 中選擇資料對應的 Type。以 Shadowsocks 為例,再逐項核對 Host、Port、Password、Method;其他協定的欄位會隨 Type 改變,應依原始資料填寫。Host 是伺服器主機名稱或 IP,不要自行加上網頁路徑;Port 應與資料一致;Password 和 Method 也不能憑記憶替換。若選錯協定,即使位址和密碼看起來正確,也可能無法建立連線。
已有 QR Code 時,可使用 Scan QR Code 匯入,並依系統提示允許存取相機;已有單一分享連結時,可先複製,再返回 App,依匯入提示檢查內容。匯入完成後,仍須確認 Type、Host 與 Port 是否符合原始資料。Import from Cloud JSON 是另一種結構化匯入入口,不應將一般訂閱網址當作 JSON 使用。首次連線只需完成一種合適的匯入方式,不必把每種入口都操作一遍。
本步完成標準:Home 的 SERVER 下方已有可辨識的伺服器,輕點需要使用的項目後,該項目會呈現選取狀態。先記住所選項目的名稱,下一步選擇 Global Routing 時仍須保留這項選擇。多組訂閱整理、更新策略和刪除備份的詳細做法,請參閱訂閱與伺服器管理手冊。
決定流量處理方式
Global Routing:選擇分流模式
伺服器加入清單後,回到 Home,輕點 Global Routing 查看目前模式。這裡決定流量的處理方式,不會替你補齊伺服器資訊。日常若希望依設定檔區分代理與直連,請使用設定檔(Config);暫時確認所選伺服器是否能處理目標連線時,可用代理(Proxy)進行比對;需要讓流量直接連到目標時,則使用直連(Direct)。三種模式並非三台不同的伺服器,也不是速度等級。
| 模式 | 意義與用途 |
|---|---|
| 設定檔(Config) | 依目前設定檔中的規則和策略處理流量,適合日常依規則分流。 |
| 代理(Proxy) | 讓流量經由代理路徑,用於明確需要代理的情境或暫時比對檢查。 |
| 直連(Direct) | 讓流量直接連線至目標,可用來檢查目前網路直接存取的狀況。 |
選擇設定檔(Config)後,再進入 Config 確認準備使用的設定檔已啟用。Subscribe 管理伺服器清單,Config 管理設定;成功匯入訂閱,不代表已自動取得適用於所有目標的規則。開啟設定檔後,可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段。首次連線只需確認目前設定檔及 Rule 中的規則用途,不要為了照著教學操作而同時啟用重寫或解密功能。
以下三行僅供理解規則順序,並非要求覆蓋現有設定。DOMAIN-SUFFIX 會比對目標網域後綴,GEOIP 依目標 IP 的地區比對,FINAL 則處理前面未命中的流量。規則通常由上往下檢查,因此範圍較廣的規則若放在前面,可能會先命中。PROXY 和 DIRECT 是策略名稱;若自己的設定使用自訂策略群組,也應確認規則引用的名稱確實存在。
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
截圖中的 Add Rule 是新增規則的入口,但首次連線前不必立即新增規則。先用既有設定完成連線與驗證,發現某個目標的處理路徑不符預期後,再修改對應規則。修改前保留原設定,測試時一次只變更一處,方便還原。更多設定項目說明請參閱設定手冊;本頁後續的生效驗證會說明如何判斷模式與規則是否真正符合預期。
本步完成標準:Home 顯示預期的 Global Routing 模式;若選擇設定檔(Config),Config 中也有明確啟用的設定檔。接著回到 Home 建立連線,不要在伺服器尚未驗證前繼續累加規則變更。
完成系統連線授權
Home:開啟連線開關
回到 Home,再次確認 SERVER 中所選的項目。清單中有多台伺服器時,看到某個名稱不代表目前已選取該伺服器;先輕點要使用的項目,再確認 Global Routing。頂端顯示 Not Connected 時,表示目前尚未連線。準備好後開啟頂端開關,等待系統或 App 提供下一步回應,避免快速連續切換,以免難以判斷目前狀態。
首次連線時,系統會要求允許新增 VPN 設定。確認提示來自正在操作的 Shadowrocket 後,依系統步驟允許,並按照裝置要求完成密碼或生物辨識認證。這是讓用戶端接管相關網路流量的系統權限,與匯入訂閱無關。如果先前取消授權,伺服器清單仍可能保留,但頂端開關無法正常建立連線;請再次發起連線並完成授權,不必重新新增同一份訂閱。
授權完成後回到 Home,查看頂端狀態是否從 Not Connected 改變,並保持連線。系統介面也可能顯示 VPN 狀態標示,但這只能協助確認網路通道已啟用,不能單獨證明遠端伺服器可用,或每個目標都採用正確策略。先保持目前的伺服器與模式不變,進入下一步進行實際連線驗證。
如果開關剛開啟就恢復關閉,先記下提示內容。檢查是否已完成授權、是否有其他 VPN 連線正在啟用,以及剛才是否誤選資訊不完整的項目。處理連線衝突時,只保留本次要測試的連線,再重新操作。不要在這一步同時更換網路、伺服器、模式和設定,否則即使偶爾連線成功,也無法判斷是哪個條件發揮作用。
本步完成標準:App 連線狀態已變更且沒有立即中斷。此時先不要啟用 On Demand;自動觸發連線應等手動連線穩定後再設定,避免排錯時剛關閉連線又被條件重新觸發。
分開檢查連線狀態與存取結果
Connectivity Test:驗證是否生效
開啟連線後,在 Home 使用 Connectivity Test,先檢查伺服器是否可連線。測試結果應依據所用測試方式解讀:某次測試有回應,表示在該測試條件下取得回應,不代表所有網站、所有協定和所有時段都同樣可用;某個項目逾時,也需要配合實際連線和測試方式進一步確認。不要只根據清單中的單一測試數值反覆切換伺服器。
接著開啟瀏覽器,造訪自己原本要使用的目標,等待頁面載入完成,再進行一次正常操作,例如開啟同一網站的另一個頁面。為減少快取影響,可重新整理頁面或使用新的瀏覽工作階段重測。首次驗證應使用相同目標、相同網路和相同伺服器;只確認出現一個頁面標題,或只看到系統 VPN 標示,都不足以證明整個連線過程正常。
若使用設定檔(Config),還須區分「可以連線」和「分流正確」。在 Data 中查看相關連線記錄,依據目標網域、命中規則與策略判斷實際路徑。預期經由代理的連線應對應 PROXY 或自己的代理策略群組;預期直連的連線則應對應 DIRECT。記錄顯示直連不一定是故障,也可能正是規則的設計結果;反過來說,連線成功也可能只是直連成功,不能據此認定代理伺服器已通過驗證。
若某個目標只有在代理(Proxy)模式下能使用,在設定檔(Config)模式下卻失敗,優先檢查 Config 中的規則命中、策略名稱與目標解析結果。若兩種模式都失敗,再檢查伺服器欄位和目前網路。直連(Direct)可用於比對目標在目前網路中的直接連線狀況,但不同路徑的結果差異只代表排查線索,不應直接判定某個元件故障。比對完成後,恢復原本準備日常使用的模式。
到這裡可先維持目前設定使用。需要自動連線時,再前往 On Demand 設定條件,並分別測試條件觸發及離開條件後的行為。新增更多規則、整理多組訂閱或調整更新策略屬於後續管理工作,詳情請參閱訂閱與伺服器管理手冊;首次連線不必一次完成所有設定。
一次只變更一個條件
Settings:常見失敗原因排查
排查時先分辨問題發生在哪一層:訂閱無法取得、伺服器未選取、連線開關無法維持,或連線後無法造訪某個目標。不同狀況對應的檢查位置不同。先記錄目前網路、伺服器、Global Routing 和具體提示,再依下列順序檢查。每次變更一項後,就重新測試相同目標;確認沒有改善時還原原值,避免連原本可用的設定也一起改亂。
Subscribe 更新失敗或沒有伺服器
先確認複製的是完整訂閱網址,而不是用來開啟管理頁面的普通網頁連結。確認沒有空格、換行或遭截斷的參數,再檢查目前網路是否能正常連線。訂閱網址是否有效與用戶端是否安裝成功是兩回事;網址失效、認證條件變更或回傳內容格式不符,都可能導致清單沒有更新。需要核對網址時,請向自己既有服務的提供方確認,不要將含有憑證的完整連結貼到公開場合。
連線建立失敗或 Connectivity Test 逾時
手動新增的項目應優先核對 Type、Host、Port 和認證欄位;若有 TLS 或其他傳輸選項,也應以原始資料為準,不要為了測試連線而任意關閉驗證。接著確認系統授權是否完成,再使用同一項目於另一個自己可用的網路進行比對測試。如果只是測試結果異常,可前往 Settings 查看 Test Method,確認測試方式和目標條件適合目前連線;變更測試方式後,也應檢查實際連線,而非只比較顯示結果。
已連線但頁面無法開啟,或只有部分目標失敗
先依上一節在代理(Proxy)與設定檔(Config)之間短暫比對。如果只有設定檔(Config)失敗,應檢查目前啟用的檔案及 Rule 中的命中順序;若多個目標都失敗,則回頭檢查伺服器與網路。DNS 解析異常也可能造成頁面無法開啟,應配合連線記錄判斷是否取得目標位址。沒有明確線索時,不要一次新增大量網域規則,也不要把所有問題都歸因於訂閱更新。
開關自動變更或需要蒐集診斷資訊
前往 Settings 查看 On Demand 是否已啟用,以及觸發條件是否符合目前網路。排查期間可先暫停自動觸發,改用手動開關重現問題;確認基準狀態正常後,再逐項恢復。需要進一步定位時,可使用 Diagnostics 蒐集線索,重點記錄問題發生時間、錯誤提示與重現步驟。分享診斷記錄前,請遮蔽訂閱網址、認證參數和個人存取內容,只提供排查所需資訊。
Settings 中也可能會看到 Proxy、TCP、UDP 等選項。這些項目並非首次連線必須調整的清單,不應只因目標連線失敗就逐項任意切換。如果還原原設定後仍能穩定重現問題,請帶著明確的失敗狀況參閱設定說明;若涉及訂閱群組、伺服器欄位或更新管理,再前往伺服器管理手冊繼續排查。
本步完成標準:能說明問題發生在哪個步驟、哪些條件已經驗證,以及接下來準備檢查什麼。保留可還原的設定並記錄每次只變更一項,比反覆刪除重裝更有助於縮小問題範圍。