官方手冊 / 首次連線
Shadowrocket 匯入訂閱
與首次連線指南
從既有設定開始,依序完成新增、選擇 Global Routing、連線與驗證。確認每個步驟的結果後再進行下一步,避免同時變更多項設定。
01 / IMPORT
Add Server:新增伺服器或匯入訂閱
開啟 Shadowrocket,先停留在 Home。下方 SERVER 用於顯示可選的伺服器;尚未新增資料時,沒有可用項目是正常情況。先確認手邊資料的類型:一組 Host、Port 和認證參數屬於單一伺服器資料;用來取得一組伺服器的完整網址則是訂閱連結。兩種資料的匯入方式不同,不要把整個訂閱網址填入 Host。
已有訂閱連結:選擇 Subscribe
在 Home 點選 Add Server,進入新增頁面後點選 Type,選擇 Subscribe。將自己的完整訂閱連結填入 URL 對應的輸入框;若有備註欄位,可填寫方便辨識來源的名稱。貼上後檢查開頭與結尾是否含有空格或換行,尤其不要漏掉問號後的參數。參數可能用於辨識訂閱權限,缺少參數時,即使網址看起來相似,也可能回傳錯誤或空白內容。
儲存後返回 Home,等待訂閱內容取得完成,再查看 SERVER 是否出現項目。若只出現訂閱名稱,卻沒有伺服器,先依第五步檢查取得結果,不要立即重複新增同一個網址。之後更新訂閱時,請針對既有訂閱執行更新;重複匯入可能產生多個相似群組,讓後續難以辨識選取的是哪一項。
已有單一伺服器參數:依 Type 填寫
再次開啟 Add Server 時,Type 應與服務商提供的協定一致。以 Shadowsocks 為例,依資料填寫 Host、Port、Password 和 Method;Host 通常只填網域或 IP 位址,Port 則單獨填寫。不要將說明文字、網頁路徑或整段分享內容直接填入 Host。其他協定所需欄位可能不同,請以該 Type 實際顯示的欄位和原始資料為準,不要照抄截圖中的欄位組合。
若手邊有相容的 QR Code,可在新增頁面使用 Scan QR Code 掃描,再檢查辨識出的 Type 與位址是否正確。Import from Cloud JSON 用於匯入相應的 JSON,並非通用的訂閱連結入口。儲存成功後回到 Home,確認新項目可供選取。此時僅代表「資料已匯入 App」,尚未證明伺服器可用;下一步先確認流量的處理方式。
訂閱連結、QR Code 及認證欄位都可能包含存取權限。尋求截圖協助前,請遮住完整網址和認證內容;排查問題不需要公開整份設定。
02 / ROUTING
Global Routing:選擇設定、代理或直連
伺服器出現在 Home 後,點選 Global Routing 查看目前的處理方式。這裡決定流量採用哪種路徑,不會補齊伺服器資料,也不會自動修正認證錯誤。三種選項分別是設定(Config)、代理(Proxy)、直連(Direct)。初次操作時先確認目前選項,再開始連線,才能判讀後續的測試結果。
設定(Config):依目前設定逐條比對
設定(Config)會依目前啟用的設定,決定請求使用 DIRECT、代理策略或其他處理方式。開啟 Config 可查看設定檔;進入檔案後,General、Rule、Hosts 等區段分別管理不同設定。截圖中的 Add Rule 是新增規則的入口,不是新增伺服器的入口。初次使用時,先確認啟用的是哪一份檔案;若已有設定,請先儲存副本,不建議一邊測試伺服器一邊改寫整套規則。
例如 DOMAIN-SUFFIX,example.com,DIRECT 表示比對該網域及其子網域後使用 DIRECT。規則通常依序檢查,前面的比對結果會影響後續處理;FINAL 用於此前規則都未比對到時的最終策略。若設定使用了策略名稱,還需確認對應策略能找到有效目標。規則檔案存在,不代表其中參照的策略一定已正確關聯。
代理(Proxy)與直連(Direct):用於區分連線路徑
代理(Proxy)會將可代理的流量交由所選代理處理,適合短暫確認「這條伺服器路徑能否完成請求」。這不代表裝置上的所有流量都一定經過代理,實際情況仍受 App 功能與系統網路行為影響。直連(Direct)則使用直接連線;即使連線開關已開啟,也不能用 Direct 證明所選伺服器正在處理請求。
建議先記下目前選項。若既有設定的來源與用途明確,可維持 Config;若要排除規則的影響,可暫時切換至 Proxy 進行比較,測試結束後再切回 Config。不要將 Proxy 當成解決所有問題的方法。關於協定欄位與技術取捨,可繼續閱讀協定詳解;本頁先完成連線流程。
03 / CONNECTION
Home:選取伺服器並開啟連線
返回 Home,在 SERVER 群組中點選要使用的伺服器,確認該項目出現選取標記。訂閱名稱只是整理項目的方式;看到一個群組,不代表已選好實際伺服器。若清單較長,可先記下目前項目的備註,之後更換伺服器時才有明確的比較對象。然後再次確認 Global Routing 顯示的選項是否符合第二步的選擇。
點選 Home 頂端的連線開關。初次使用時,系統會詢問是否允許新增 VPN 設定;這是建立系統網路連線所需的授權。確認是目前操作後再允許,並依裝置提示使用密碼或系統認證完成操作。若中途取消,請先返回 App 查看狀態;不要因為清單中已有伺服器,就認為系統授權也已完成。
授權後回到 Home,觀察頂端狀態是否從 Not Connected 轉為已連線。若仍顯示 Not Connected,或開關很快又回到關閉狀態,應先檢查系統授權和 App 提示,而非直接修改 Rule。若裝置同時啟用了其他 VPN 連線,或受到裝置管理政策限制,系統可能無法依預期建立目前的連線;請先確認裝置允許使用此 VPN 設定,再重試。
連線狀態建立後,先不要立即切換多個項目,也不要同時啟用 On Demand。維持單一伺服器、單一選項和相同網路,接著進行驗證。頂端狀態主要表示系統連線已建立,並不能單獨證明遠端認證、目標服務與每條規則都正常;分開判斷「連線開關已開啟」和「請求成功」,可減少許多不必要的重複操作。
04 / VERIFICATION
Connectivity Test:分別驗證連線與規則
開啟連線後,在 Home 點選 Connectivity Test,等待測試完成。此功能適合檢查目前條件下的連線狀況,但測試目標不一定與實際使用的服務相同。測試成功一次,不代表所有網站和 App 都能存取;測試失敗也應搭配測試方式、目前網路和目標服務狀態判斷,不要只憑單一結果就刪除訂閱。
先確認目標請求能否完成
開啟瀏覽器或需要使用的 App,前往自己有權使用且明確知道預期行為的目標服務。盡量送出新的請求,不要只查看已快取的頁面。若測試成功但目標仍失敗,記錄是網域無法解析、連線逾時,還是服務已回傳登入或權限提示。這些現象發生在不同階段;服務回傳業務提示,通常不能簡單歸類為代理連線失敗。
再確認請求使用哪一種路徑
若要確認 Config 是否生效,請查看 App 可用的請求記錄,針對同一個目標確認網域、命中規則和最終策略。使用 DIRECT 的請求,不應只因頁面能開啟就認為經過伺服器;反過來,命中代理策略也不代表遠端目標一定會接受請求。若記錄中沒有預期的網域,請重新送出請求,確認是否命中快取,或 App 是否使用了其他網域。
若結果不明確,可在維持伺服器與網路不變的情況下,暫時將 Config 改為 Proxy,再前往同一個目標。若 Proxy 可用而 Config 不可用,優先檢查規則順序、策略參照與 DNS 相關設定;若兩者都不可用,則先重新檢查伺服器參數、遠端狀態和網路條件。比較完成後,請恢復原本選項,保留失敗現象與變更記錄,再進入下一步逐項排查。
05 / DIAGNOSTICS
Settings:依問題階段檢查設定
從最早出現問題的步驟開始排查。若第一步尚未取得伺服器,就不必先研究規則;若已連線但特定目標異常,則應觀察該目標的請求。Settings 中的 Test Method、On Demand 與 Diagnostics 分別涉及測試方式、隨選連線和診斷,不應一次全部切換成一組「通用修復設定」。修改前先記下原值,以便測試後還原。
匯入失敗:先確認資料類型與完整性
確認訂閱連結已填入 Subscribe 對應的輸入框,而不是 Host。檢查網址是否完整、是否含有多餘空格,以及自己的訂閱權限是否仍有效。在瀏覽器中能開啟某個網頁,不代表該網址就是 App 可讀取的訂閱內容;若回傳登入頁面或錯誤說明,請向自己的服務商重新確認資料。排查過程中不要清除仍可正常運作的既有項目。
連線失敗:分別檢查參數與系統授權
若開關無法維持開啟,先確認系統 VPN 設定是否新增成功,或是否被其他連線佔用。若開關能開啟但請求失敗,再逐項確認 Type、Host、Port 和認證欄位。透過 QR Code 匯入的資料也需要確認,尤其是資料已變更但 QR Code 仍是舊內容的情況。裝置日期與時間異常也可能影響安全連線,請保持系統時間正確。若認證遭拒或遠端無法使用,請向自己的服務商確認伺服器狀態。
測試結果與實際使用不同:檢查 Test Method
在 Settings 查看 Test Method,了解目前使用的測試方式。不同測試方式觀察的面向不同,某項測試失敗不一定代表實際服務請求也會失敗;同樣地,測得某個結果也不能證明目標服務可用。返回第四步,針對相同目標送出實際請求並比對記錄。若懷疑目前網路限制某種傳輸方式,可在獲得使用權限的其他網路環境重試,但維持伺服器和選項不變。
狀態反覆變動:檢查 On Demand 與診斷記錄
On Demand 用於依條件觸發連線。初次排查時先記下其狀態,必要時暫時關閉自動觸發,再手動完成一次完整的連線與中斷測試,避免自動行為影響觀察。之後可在 Diagnostics 查看可用資訊;提供問題描述時,請保留錯誤文字、觸發步驟和網路類型,並遮住訂閱網址、認證欄位及不必要的請求詳細資料。
完成後應能回答三個問題:資料是否成功匯入、系統連線是否建立、目標請求實際採用什麼策略。若其中一項仍不確定,請返回對應步驟重新驗證,而非繼續疊加設定。需要重新操作時,可返回新增與匯入步驟;若要了解協定欄位的意義與選擇方式,再參閱協定詳解。