Shadowrocket 使用教學:
匯入訂閱與連線驗證
依照「匯入 → 選擇模式 → 連線 → 驗證 → 排查」的順序操作。首次設定時,先建立一條可驗證的連線,再調整規則與自動連線條件。
01 / 新增與匯入
Add Server:匯入既有訂閱或填寫伺服器資訊
開啟 Shadowrocket,進入底部的 Home。先確認手上的資料類型:訂閱連結通常用於一次匯入並持續更新一組伺服器;單一伺服器資料則包含協定類型、位址、連接埠及驗證參數。兩者用途不同,不要將整段訂閱連結填入伺服器的 Host 欄位。
已有訂閱連結:選擇 Subscribe
在 Home 點選右上角的新增按鈕,或點選 SERVER 群組中的 Add Server,進入新增頁面。點選 Type,選擇 Subscribe,再將向服務提供者取得的完整訂閱連結填入 URL。可填寫方便自己辨識的備註,檢查連結前後沒有空格、換行或通訊軟體附帶的標點,再儲存。
儲存後回到 Home,等待訂閱內容取得完成。成功時,應能在相應群組中看到匯入的伺服器項目;先展開群組確認實際內容,而不是只看訂閱名稱是否出現。如果只看到群組名稱,裡面沒有可選項目,表示匯入尚未成功,應先檢查更新結果,不要直接進入連線步驟。
後續需要更新時,在訂閱項目的操作選單中執行更新,完成後重新檢查目前選取的伺服器。訂閱更新可能變更名稱、增刪項目,也可能變更原先選取的項目。訂閱連結含有存取憑證,應只保存在自己的裝置中,不要將完整連結放入公開截圖或診斷留言。
已有單一伺服器資料:依 Type 填寫
如果服務提供者提供逐項參數,請在 Add Server 的 Type 中選擇與資料相符的協定,再依序核對 Host、Port 及驗證欄位。Host 通常填寫伺服器網域或 IP,不要附加網頁路徑;Port 依提供的數字填寫。變更協定後,頁面欄位也可能改變,不要將某種協定的密碼、識別資訊或傳輸設定直接套用到另一種協定。
截圖展示包含 Password、Method 的新增頁面,這些欄位適用於相應的 Type,並非每種協定都需要填寫。需要 TLS、Server Name 或其他傳輸參數時,請依照服務提供者的資料填寫;沒有提供的值不要自行推測。若有提供 QR Code,可使用 Scan QR Code;Import from Cloud JSON 用於匯入相應格式,並非所有訂閱連結的通用入口。
儲存後回到 Home,點選剛新增的項目,確認選取標記位於預期項目上。至此只是完成「資料匯入用戶端」,尚未驗證伺服器是否可連線。下一步先確認請求採用哪一種 Global Routing,再開啟連線,方便後續判讀測試結果。
02 / 模式與規則
Global Routing:選擇配置、代理或直連
返回 Home,點選 Global Routing 查看目前模式。此處決定請求如何選擇處理路徑,與「選取了哪個伺服器」是兩件事:前者控制路由方式,後者指定需要代理時使用的伺服器。剛完成匯入就遇到存取結果不符時,先查看這項設定,比不斷更換伺服器更容易找出原因。
三種模式各自要檢查什麼
配置(Config):依目前啟用的設定檔比對規則,不同請求可能採用不同策略。要日常依規則使用時選擇此項,但必須先確認 Config 中實際啟用的檔案,不要只憑模式名稱推斷已有合適規則。
代理(Proxy):透過代理路徑處理請求,可用於對照排查伺服器連線是否正常。這不代表某條規則已命中,也不表示所有系統流量都一定經過相同路徑。測試結束後,如果原本需要依規則分流,應恢復為 Config,再進行一次實際驗證。
直連(Direct):透過直連路徑處理請求,不使用所選的代理伺服器轉送。這有助於比較本地網路能否直接存取目標,但不能用來證明所選伺服器正常運作。若一直停留在 Direct,單純切換伺服器通常不會改變存取路徑。
使用 Config 前確認目前檔案
進入底部的 Config,確認目前啟用的是哪一份設定,再開啟相應檔案查看內容。編輯頁中的 General 管理一般參數,Rule 用於規則比對,Hosts 涉及位址對應;URL Rewrite 與 HTTPS Decryption 屬於進階的請求處理設定,首次連線不必為了「設定完整」而逐項啟用。
Rule 通常依照由上而下的順序判斷,命中後交由相應策略處理。查看規則時,既要看比對條件,也要看末尾策略;存在一條網域規則,不代表它一定使用 PROXY。使用 Add Rule 前,先保留原始檔案副本,避免將連線驗證問題與修改規則的問題混在一起。
此階段只需確認「目前使用哪份 Config、目標大致應採用哪條路徑」。暫時沒有把握時,不要一次加入大量規則。協定欄位、比對順序與策略的進一步說明請參閱協定參考;常見的全域模式問題請參閱常見問題。
03 / 連線與授權
Home:選取伺服器並開啟頂端開關
回到 Home,展開已匯入的 SERVER 群組,點選預計使用的伺服器。再次確認 Global Routing 與上一步的選擇一致,再開啟頂端的連線開關。分開確認這兩項操作,可以避免「切換了項目,卻仍沿用上次測試模式」的情況。
首次連線時,系統可能會顯示新增 VPN 設定的授權提示。確認這是剛才在 Shadowrocket 中主動發起的操作,再依照系統提示允許,並使用裝置驗證方式確認。這裡建立的是用戶端處理網路請求所需的系統設定,不是在購買新的連線服務;若取消授權,請返回用戶端重新開啟開關,再完成確認。
完成授權後回到 Home,觀察頂端原本的 Not Connected 是否轉為已連線狀態。如果仍未連線,先停留在目前頁面,確認系統提示是否已處理、所選項目是否仍在,不要連續點擊開關。開關顯示連線狀態,只能說明連線流程目前的階段,不能取代對目標網站的實際請求測試。
首次驗證建議保持應用程式在前景,先不要啟用複雜的自動連線條件,也不要在同一輪測試中同時切換 Wi-Fi 與行動網路。若裝置上已有其他正在運作的 VPN 連線,先在系統設定中確認目前生效的連線,避免測試對象與預期不一致。
本步驟的檢查點是:已明確選取伺服器、已確認 Global Routing、已完成系統授權、Home 顯示連線已建立。確認四項後再進入驗證步驟。如果頂端狀態短暫改變後立即恢復 Not Connected,請直接前往第五步,從連線層檢查參數與網路。
04 / 驗證結果
Connectivity Test:先測試,再驗證實際請求
建立連線後,在 Home 點選 Connectivity Test,等待結果返回。此功能適合檢查目前測試目標是否能完成相應的連線流程,但一次成功只涵蓋這次測試涉及的條件。測試目標、目前網路及測試方式不同,結果也可能不同,不要將單一數值當成所有應用程式的存取結論。
接著開啟瀏覽器,瀏覽一個你有權使用且能判斷預期結果的網站。如果選擇 Config,請分別檢查預期直連和預期代理的目標;如果只是使用 Proxy 進行連線對照,完成後切回 Config,再對同一目標重複請求。比較時保持伺服器與本地網路不變,每次只變更一個因素,結果才有參考價值。
需要進一步確認分流時,返回 Shadowrocket 查看目前版本提供的請求記錄或診斷資訊,尋找剛才瀏覽的目標及實際採用的策略。Data 中的流量變化可作為請求發生的線索,但流量增加本身不能證明某條 Rule 已命中;還要結合目標、目前的 Config 與具體策略一併判斷。
如果瀏覽器仍顯示舊內容,先重新整理頁面或重新開啟目標,再觀察新請求。網頁快取、應用程式本身的連線重用和 DNS 快取,都可能讓切換後的狀況不夠明確。不要只憑瀏覽器中已載入的頁面,就判斷剛才切換伺服器已成功或失敗。
如果 Connectivity Test 成功,但某個網站無法使用,請保留目前可用的設定,優先排查與目標相關的規則、解析及伺服器端條件。如果所有目標都失敗,則返回檢查連線與伺服器資料,不要先大幅修改 Rule。以下依照問題發生的位置整理檢查順序。
05 / 設定與排查
Settings:依問題發生的位置逐層檢查
排查時先記錄三件事:問題發生在匯入、連線還是實際存取階段;發生時使用 Wi-Fi 還是行動網路;剛才修改了哪項設定。保留這些條件,再依照以下順序檢查,比同時更換訂閱、修改協定和重新安裝應用程式更容易找出原因。
訂閱無法匯入,或更新後沒有項目
返回訂閱設定,核對 URL 是否完整、是否過期,以及取得的內容是否仍為服務提供者提供的訂閱。連結能在瀏覽器開啟,不一定表示返回的內容受到用戶端支援;如果實際返回登入頁面、提示文字或空白內容,仍無法產生伺服器清單。先確認裝置的基本網路正常,再向服務提供者確認連結狀態與格式。
若更新後只缺少原本的某個項目,先檢查群組是否收合、名稱是否變更,再重新選取可用項目。不要為了找回名稱而反覆還原舊訂閱內容;伺服器是否仍在服務範圍內,應以服務提供者提供的資訊為準。
開關無法維持連線,或測試持續逾時
先確認系統 VPN 授權,再逐項核對 Type、Host、Port 與驗證參數。連線逾時可能與位址、連接埠、目前網路或伺服器端狀態有關,不能只憑逾時判斷密碼錯誤;出現驗證相關提示時,再優先核對對應欄位。需要比較 Wi-Fi 與行動網路時,完成一次測試後再切換,並記錄結果。
進入底部的 Settings,可查看 Test Method 與 Diagnostics。不同 Test Method 測試的流程不同,切換測試方式後的結果不應直接當作相同條件比較。Diagnostics 用於蒐集線索,不是自動修復按鈕;請閱讀與剛才測試時間接近的記錄,避免受到歷史錯誤影響。
連線正常,但部分請求不符合預期
先核對 Global Routing,再核對啟用的 Config。在 Config 中檢查相關 Rule 是否被更前面的規則命中、策略是否符合預期,以及最後一條規則如何處理未命中的請求。只有某個網域異常時,也要檢查 Hosts 與 DNS 相關設定;不要立刻修改所有 TCP、UDP 參數,以免增加其他變因。
如果手動中斷後又自動連線,請查看 Settings 中的 On Demand 條件。為了重現手動測試,可先記錄目前條件並暫時關閉自動觸發,等基本連線確認後再逐項恢復。On Demand 的觸發範圍和規則順序屬於進階內容,請參閱On Demand 隨選連線說明。
需要向服務提供者回報時,提供問題階段、網路類型、所選協定及已執行的對照步驟即可。傳送 Diagnostics 記錄或截圖前,請移除訂閱 URL、密碼、識別資訊、金鑰等敏感內容。更多訂閱更新與連線問題請繼續閱讀常見問題;協定參數說明請參閱協定參考。