Shadowrocket 使用指南:
匯入、分流與連線驗證
依照完成一次連線的順序操作:先準備可用的伺服器項目,再選擇 Global Routing,最後以實際存取結果驗證。首次操作先完成一條連線,不要同時調整多組設定。
STEP 01 / INPUT
Add Server:新增伺服器或匯入訂閱
先確認手上的資料是哪一種:一組伺服器位址、連接埠與驗證參數,或是用來取得多個項目的訂閱連結。兩者的匯入方式不同,不能將訂閱網址當成 Host,也不能把一般網頁網址當成訂閱。資料不完整時,應先向原服務提供者確認,而不是反覆更換 Type 嘗試。
手動填寫一筆伺服器資料
- 開啟 Shadowrocket,在 Home 的 SERVER 區域找到 Add Server,進入新增頁面。先點選 Type,選擇資料標示的協定,例如 Shadowsocks 或 Trojan;選擇後,頁面會顯示對應欄位。
- 依資料填入 Host 和 Port,再填寫 Password 以及該協定要求的其他參數。Host 通常是網域或 IP 位址,連接埠填入數字,不要將包含路徑的整個網頁連結填入 Host。
- 如果所選協定顯示 Method,必須與伺服器端一致。涉及 TLS、SNI 或其他傳輸參數時,也要逐項對照原始資料;不要為了讓測試通過而任意關閉憑證驗證。
- 確認後使用頁面上的儲存操作,返回 Home。確認 SERVER 下方出現剛新增的項目,並點選它作為接下來連線時使用的伺服器。
右側官方截圖展示的是包含 Type、Host、Port、Password、Method 的 Add Server 頁面,並不表示所有協定都使用相同欄位。判斷依據是目前選取的 Type 和你的伺服器資料。名稱備註可協助辨認用途,但備註內容無法修正位址、連接埠或驗證錯誤。
使用 Subscribe 匯入既有訂閱
如果已有完整訂閱連結,在 Add Server 的 Type 中選擇 Subscribe,貼到對應的 URL 欄位,再儲存並返回 Home。複製時請保留完整網址,包括問號後的參數;檢查開頭與結尾是否多出空格、換行或中文標點。訂閱網址可能包含個人存取憑證,不應貼到公開討論區,也不應放在截圖中公開。
儲存後等待內容取得完成,再查看 Home 中對應的分組與項目。只有分組名稱、沒有伺服器項目時,先檢查訂閱更新是否成功;只儲存網址不代表已取得可連線的伺服器。既有訂閱需要更新時,使用對應分組的更新操作即可,避免為同一網址反覆新增分組。多個訂閱的整理方式請參閱FAQ 的訂閱與節點匯入說明。
Add Server 底部還有 Scan QR Code 與 Import from Cloud JSON。只有在你已有對應的 QR Code 或符合要求的資料時才使用;掃描前確認來源,匯入後仍要檢查協定與位址。本步完成的標準是:Home 中有一筆參數完整、可供選取的伺服器,而不只是出現一個名稱。
STEP 02 / ROUTING
Global Routing:選擇設定、代理或直連
準備好伺服器項目後,返回 Home 並開啟 Global Routing。這裡決定建立連線後採用哪一種路由模式。選取伺服器只回答「需要代理時使用哪個項目」,Global Routing 則回答「哪些連線要以何種方式傳送」;兩項都需要分別確認。
- 設定(Config):依目前設定檔中的規則決定路徑,可將不同請求分別交由 PROXY、DIRECT 或其他已定義的策略處理。日常需要規則分流時使用此模式,但前提是已確認設定內容。
- 代理(Proxy):讓用戶端處理的連線採用代理路徑,適合在排除問題時對照伺服器是否可用。這不保證每個 App、每種協定或每個目標都一定可連線。
- 直連(Direct):讓用戶端處理的連線採用直連路徑,可用來對照本機網路的存取情況。看到開關開啟,不代表目前的請求一定經過所選伺服器。
使用設定(Config)前檢查 Config
如果選擇設定(Config),請再進入底部的 Config,確認目前實際使用的是哪份設定。開啟對應檔案並檢查 Rule 區段;官方截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是設定編輯區段,Add Rule 是新增規則的入口。快速入門階段先了解現有規則,不必逐一修改所有區段,也不必為一般連線額外啟用 HTTPS Decryption。
以下兩行是閱讀規則語法的範例,不是要你直接覆寫現有設定。第一行會讓指定網域後綴符合代理路徑;第二行則在前面的規則都未符合時使用代理路徑。規則由上而下比對,順序會影響結果;單獨一行的意義需放回完整設定中判斷。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY
沒有可信的設定或暫時不理解現有規則時,可先使用代理(Proxy)對一筆既有伺服器進行連線驗證,再回到設定(Config)檢查分流。不要把「切換至代理後可以存取」直接視為問題已完全解決:這比較可能表示伺服器可用,而原本的規則、策略選擇或 DNS 設定仍需檢查。設定欄位的深入問題請參閱規則分流與故障排除 FAQ,本頁先完成一次可重複的連線流程。
STEP 03 / CONNECT
Home:開啟開關並確認連線狀態
完成路由選擇後返回 Home,再次確認 SERVER 中選取的項目。訂閱更新、刪除項目或切換分組後,實際選取的項目可能與之前不同;不要只根據清單最上方的名稱判斷。如果準備切換至另一台伺服器,先記下原本的項目,方便之後在相同條件下進行對照。
- 找到 Home 頂部的連線開關。尚未連線時會顯示 Not Connected;開啟開關,開始建立連線。
- 首次使用時,系統可能會要求允許新增 VPN 設定。閱讀系統說明,確認操作來自剛開啟的 Shadowrocket,再允許新增,並依提示使用裝置密碼或裝置驗證完成授權。
- 返回 Home 等待狀態變化。確認開關保持開啟,而不是剛開啟就自動關閉。如果仍顯示 Not Connected,先停止存取測試,前往本頁的失敗階段排查找出原因。
允許新增 VPN 設定,是授權用戶端透過系統提供的網路功能處理連線,並不代表訂閱中的伺服器已通過可用性驗證。開關能保持開啟,也不代表所有目標都可存取。因此,本步僅確認系統連線狀態正常;是否確實符合預期,還要繼續進行下一步的網頁存取與路徑檢查。
如果裝置上已有其他 VPN 連線或由公司管理的網路設定,請先確認目前使用的連線及裝置管理要求。不要同時啟動多個互相競爭的連線進行測試,也不要刪除用途不明的管理設定。如果取消了系統授權提示,可返回 Home 再試一次,觀察提示是否重新出現;若持續失敗,再檢查系統中的 VPN 設定狀態。
初次驗證期間,先保持 On Demand 狀態不變,並記下它原本是否已啟用。尚未了解自動連線條件就修改 On Demand,可能導致開關在切換網路後重新啟動,增加排除問題的難度。測試完成並確認手動連線穩定後,再決定是否需要按需連線。
STEP 04 / CHECK
Connectivity Test:區分測試結果與實際存取
開關保持開啟後,先在 Home 使用 Connectivity Test 檢查既有項目,再開啟瀏覽器瀏覽平時確認可用的頁面。前者提供測試條件下的連線線索,後者則檢查實際請求是否能完成。兩種結果需要一起參考:延遲數字較低,不代表網頁解析、TLS 協商、資料傳輸或其他 App 存取一定正常。
- 記錄基準。記下目前的本機網路、所選伺服器和 Global Routing 模式,使用同一頁面完成一次存取。不要在切換 Wi-Fi 與行動網路的同時更換伺服器,否則無法判斷哪項變化影響結果。
- 檢查實際路徑。如果需要確認分流,請在用戶端可用的連線記錄或 Data 相關檢視中尋找對應請求,檢查命中規則及實際路徑。只看到流量累計增加,無法證明特定請求經過代理。
- 一次只變更一個條件。若在設定(Config)下失敗,可保持同一台伺服器,暫時切換成代理(Proxy)再存取一次;若需要了解本機網路本身的狀況,再以直連(Direct)對照。每次都記下結果,測試完恢復預定使用的模式。
若代理(Proxy)可以完成存取、設定(Config)卻失敗,優先檢查目前設定中的符合規則、實際策略與 DNS 相關設定;若兩者都失敗,再檢查伺服器參數與本機網路。若只有一個 App 失敗、瀏覽器正常,問題可能與該 App 的連線方式、快取或協定需求有關,先重新開啟 App 並重複相同操作,不要立即清除整份設定。
驗證完成的標準不是出現某個圖示,也不是所有測試項目都有延遲,而是目標工作能穩定重複完成,且使用的路徑符合預期。可以再切換回平時使用的網路進行相同檢查;如果結果有變化,記錄「在哪種網路下、使用哪種模式、哪個項目失敗」,之後排除問題會比單純描述「無法連線」更準確。
STEP 05 / DIAGNOSE
Settings:依失敗階段檢查,不要全部重設
從最早發生失敗的環節開始排除問題:未能成功取得項目,就先處理匯入;有項目但無法建立連線,再核對伺服器;連線穩定但存取結果不符預期,才檢查規則。將問題分成這些階段,可避免訂閱尚未成功取得時就反覆調整 DNS,或在取消系統授權後不斷更換密碼。
匯入後沒有項目,或訂閱更新失敗
先重新核對完整訂閱網址,確認仍然有效且沒有遺漏參數,並檢查目前網路是否能連線至提供訂閱網址的伺服器。取得訂閱與連線至節點是兩個不同的流程:既有項目可能仍可連線,但訂閱伺服器暫時無法存取;反過來說,成功更新出項目也不表示每台伺服器都可用。不要連續新增相同訂閱,保留原有分組,依更新時的實際錯誤繼續檢查。
有項目,但測試失敗或開關無法保持開啟
手動項目請優先核對 Type、Host、Port、Password,以及協定專屬的 Method、TLS 或傳輸設定。複製參數時注意大小寫與開頭、結尾的空格。系統時間明顯不正確時,也可能影響憑證相關連線。如果開關無法保持開啟,先檢查系統 VPN 授權及其他啟用中的連線;如果開關穩定但伺服器測試失敗,再著重檢查伺服器資料與可連線性。
測試有結果,但網頁或 App 仍無法開啟
前往 Settings 查看 Test Method,確認目前的測試方式,再解讀 Connectivity Test 的結果;不同測試方式的檢查範圍並不相同。接著依上一步的方法對照設定(Config)與代理(Proxy)。如果只有規則模式失敗,請檢查命中規則;如果只有特定 App 失敗,記錄該 App 的具體操作與失敗情況,不要將單一 App 的問題直接歸因於整條連線。
切換網路後自動連線,或需要進一步診斷
在 Settings 中檢查既有的 On Demand 設定,確認是否有符合目前網路條件的自動連線行為。需要手動對照時,可先記下原設定,再暫時停用,測試完成後恢復。Settings 中還有 Diagnostics、Proxy、TCP、UDP 等項目;不要因為名稱與網路有關就全部修改,只有在錯誤訊息或資料明確指向特定項目時才調整。
需要使用 Diagnostics 或連線記錄進一步找出問題時,先重現一次問題,再保留與該次操作相關的內容。分享前隱藏完整訂閱網址、驗證參數、伺服器密碼及可識別個人身分的資訊。有效的問題描述應包含失敗階段、Global Routing 模式、網路類型與已進行的單項對照;不必公開參數本身。
仍無法找出原因時,請前往FAQ查閱對應類別。如果問題發生在 App Store 取得、商店地區、換機或已購項目復原階段,請閱讀安裝指南;這些屬於取得流程,不需要透過修改 Add Server 或 Config 處理。排除問題後,刪除暫時測試項目、恢復預定的 Global Routing,並確認在一般網路下仍能重複完成一次存取。