匯入 Shadowrocket(小火箭)時,請依內容類型選擇入口:伺服器訂閱請從 Home 的 Add Server → Type → Subscribe 新增;Config 頁面的 Subscribe 則用於遠端設定檔。單一伺服器參數可手動輸入,也可透過 QR Code 或剪貼簿讀取。本文以使用者已有服務商與訂閱為前提,說明輸入、儲存、更新及連線驗證的步驟,避免把「匯入成功」誤認為「已能連線」。
一、先辨別連結:伺服器訂閱不等於設定檔
匯入前,先確認取得的是訂閱網址、單一伺服器分享連結,還是設定檔網址。三者看起來都可能是一段文字,但儲存位置及更新後的作用各不相同。網址以 https:// 開頭,不代表就能判斷該放在 Home 還是 Config;請依照既有服務提供的用途說明及實際回傳內容確認。
| 內容類型 | 辨別方式 | 匯入位置 |
|---|---|---|
| 伺服器訂閱 | 遠端回傳一組伺服器資訊,通常包含存取憑證 | Home → Add Server → Type → Subscribe |
| 單一分享連結 | 常見前綴為 ss://、vmess://、vless:// 或 trojan:// | Home 的 QR Code 掃描或剪貼簿匯入入口 |
| 遠端設定檔 | 包含設定分節、規則及相關設定,而不只是伺服器清單 | Config → 右上角「+」→ 下載設定檔,之後透過 Subscribe 管理 |
| 獨立連線參數 | 分別提供通訊協定、位址、連接埠及驗證資訊 | Home → Add Server → 選擇對應的 Type |
本文以 https://example.com/sub?token=xxxx 作為明顯無效的訂閱範例,僅用來說明網址結構,不能用於實際連線。真實網址中的 token 通常是存取憑證;請勿將完整連結貼到公開截圖、留言或診斷紀錄中。QR Code 也可能包含相同憑證,請妥善保管。
二、Subscribe:分別管理伺服器訂閱與 Config 設定
新增伺服器訂閱時,請從 Home 開始,而不是直接把網址放進 Config。匯入訂閱會建立可更新的伺服器來源;遠端內容變更後,需再次更新,Home 中的清單才會同步變動。首次操作前,可先記下現有群組及目前選取的項目,以便確認是否重複新增來源。
-
開啟新增頁面
進入 Home,點選右上角「+」開啟 Add Server。先確認手上的連結標示為伺服器訂閱,再選擇類型。
-
選擇訂閱
在 Type 中選擇 Subscribe,將完整的訂閱網址貼到 URL;不要刪除問號後的參數,也不要一併貼上說明文字。
-
命名並儲存
填入方便辨識的 Remarks,確認 URL 前後沒有空格或換行,再點選 Done。名稱僅供辨識,不會改變遠端訂閱內容。
-
更新並確認
返回 Home,下拉以觸發更新,確認對應訂閱是否已出現伺服器項目;再檢查其中一個項目的 Type、Address 和 Port 是否符合既有服務說明。
如何使用 Config 頁面的 Subscribe
如果取得的是適用於 Shadowrocket 的遠端設定檔網址,請進入 Config,點選右上角「+」,輸入網址並下載。檔案出現後,先檢視內容再決定是否啟用;在設定檔的操作選單中,可透過 Subscribe 管理遠端更新。這裡訂閱的對象是設定檔,不是 Home 中的伺服器訂閱入口。
三、Add Server 手動設定:依通訊協定核對參數
手上已有獨立連線參數時,適合採用手動設定。進入 Home →「+」→ Add Server,在 Type 中選擇實際使用的通訊協定,再逐項填寫。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的驗證及傳輸欄位各不相同,不要只為了讓表單成功儲存,就把參數填進名稱相似的欄位。
- Address 與 Port:填入服務提供的主機位址與連接埠。Address 通常只填網域名稱或 IP,不要連同
https://、路徑或訂閱 token 一起填入;Port 也不能只因啟用 TLS 就自行改成443。 - Shadowsocks:確認 Method 與 Password,兩者都必須符合伺服器設定。密碼或加密方法錯誤,都可能造成無法連線。
- VMess / VLESS:確認 UUID、傳輸方式,以及服務明確要求的 Host、Path 和 TLS 參數。Host、SNI 與 Address 的用途可能不同,不要預設要填入相同內容。
- Trojan / Hysteria2:確認驗證資訊及 TLS 相關參數;服務若提供 SNI,請照原值填寫。不要以關閉憑證驗證來取代參數核對。
- WireGuard:依設定分別核對金鑰、介面位址、Peer 與 Endpoint 等欄位;不要把一般訂閱 URL 當成金鑰或 Endpoint。
點選 Done 儲存後,返回 Home 選取該項目。手動輸入的項目通常不是可自動更新的訂閱來源;既有服務若變更密碼、連接埠或傳輸設定,需同步修改這筆資料。即使手動輸入的項目與訂閱項目名稱相同,也不代表兩者共用更新關係。
四、掃描 QR Code 與剪貼簿匯入:先解析,再確認儲存結果
QR Code 與剪貼簿只是輸入方式,不是新的通訊協定。當中可能包含單一伺服器分享連結,也可能是訂閱網址。匯入後仍須確認實際儲存的是哪一種項目;QR Code 辨識成功,只表示內容已讀取,不代表伺服器驗證已通過。
依內容所在位置選擇讀取方式
QR Code 顯示在另一個螢幕上
- 在 Home 點選掃描圖示;首次使用時,依系統提示允許存取相機。
- 將相機對準完整的 QR Code,避免反光、裁切或過度縮放。
- 辨識後檢查通訊協定類型與位址,再確認儲存。
- 如果是一般網頁網址,請先確認用途,不要把網頁當成伺服器項目。
連結已在目前裝置上
- 只複製完整連結,不要包含前後的說明文字或引號。
- 返回 Shadowrocket;出現剪貼簿匯入提示時,先核對內容再確認。
- 系統詢問是否允許貼上時,依本次匯入需求授權。
- 若沒有出現辨識提示,可返回 Add Server → Type → Subscribe,手動貼上訂閱 URL。
結論:掃描 QR Code 和剪貼簿都只負責傳遞原始內容;儲存後請返回 Home 確認項目。重複匯入可能會建立重複項目。
像 ss:// 這類分享連結,編碼內容通常包含必要參數,不可只複製末尾可讀的名稱。也不要自行將一種通訊協定的前綴改成另一種;改了前綴並不會轉換驗證方式及傳輸格式。若辨識失敗,請優先從原始來源重新複製完整內容,不要嘗試修改編碼文字中的字元。
五、匯入後驗證:先檢查伺服器,再選擇 Global Routing
儲存項目後,先在 Home 選取一台伺服器,再使用 Connectivity Test 查看結果。測試有回應,只能表示在相應的探測條件下可以連線,不能單憑這點認定所有網頁、UDP 流量或 DNS 查詢都正常。首次開啟連線開關時,請依系統提示允許加入 VPN 設定;接著使用相同的目標網頁再次測試,避免頻繁更換測試對象而造成判斷混亂。
Config
建議使用目前啟用的設定中的規則與策略。規則可能指向 DIRECT、代理策略或其他已定義的策略,並不代表「未命中就一定直連」;請檢查 FINAL 所設定的兜底結果。
適用情況:已有確認無誤的設定,日常需要依目標進行分流
Proxy
暫時使用代理模式進行測試,有助於區分伺服器連線問題與設定規則問題。測試完成後,請恢復原本模式,並繼續檢查 DNS 及目標網站的連線結果。
適用情況:已選取伺服器,需暫時排除規則影響以進行檢查
Direct
使用直連模式觀察本地網路的存取情況。Direct 模式下網頁可以開啟,不代表剛匯入的代理伺服器可用,因為這項測試沒有驗證相同的代理連線路徑。
適用情況:確認本地 Wi-Fi 或行動網路是否具備基本連線能力
Global Routing 中的 Scene 用於依照已設定的情境決定路由行為,不是匯入通訊協定,也不是訂閱格式。初次排查時,不要同時修改 Scene、DNS 及伺服器參數。若已設定 Settings → On Demand,測試時也要留意自動連線行為;確實需要暫停時,請先記下原設定,完成後再恢復。
Config 中需要核對的規則順序
[Rule]
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
以下內容僅用來說明語法,不應直接取代現有設定。DOMAIN-SUFFIX 依網域後綴比對,IP-CIDR 依 IP 位址網段比對,GEOIP 依 IP 地理位置比對,FINAL 提供最終兜底策略。規則會依序判斷;範例中的 PROXY 必須能在實際設定中解析為有效策略。匯入伺服器清單不會自動確保這些規則及策略參照正確。
六、訂閱更新與常見匯入問題
訂閱 URL、訂閱內容及伺服器連線是三個獨立的檢查項目。更新失敗時,先確認網址是否仍有效,以及網路能否連上訂閱端點;更新成功但無法連線時,再檢查選取的伺服器與路由設定。排查過程中不要反覆刪除所有項目,否則會失去比較依據。
訂閱更新逾時,應該先檢查哪裡?
先確認本地網路能正常瀏覽網頁,再到 Home 重新更新對應的訂閱。若訂閱網址確實需要透過代理才能存取,而且已有可用連線,可前往 Settings → Subscribe 確認 Update via Proxy 後再試一次;若所有伺服器都無法使用,只啟用這個選項也無法建立可用的代理連線。
顯示更新完成,為什麼沒有伺服器?
返回訂閱編輯頁面檢查 URL 是否完整複製,尤其是 ? 後的參數。確認回傳內容不是登入頁面、錯誤頁面或設定檔;如果實際取得的是設定檔,請依 Config 流程處理,不要繼續重複新增伺服器訂閱。
貼上連結後,為什麼沒有出現匯入提示?
重新從原始來源複製純文字連結,確認沒有引號、空格,也沒有被通訊軟體截斷。訂閱 URL 可直接貼到 Home → Add Server → Type → Subscribe;單一分享連結則應確認前綴及編碼內容完整,並留意系統是否允許此次貼上。
更新後,手動修改的內容又還原了?
訂閱項目會以遠端內容作為更新來源,下次更新時可能重新寫入參數。需要長期保留的獨立測試項目,應另外手動輸入並清楚命名;不要把遠端訂閱中的臨時修改當成固定設定。
匯入完成、開啟連線開關後,還是無法存取?
先在 Home 確認目前選取的伺服器,再執行 Connectivity Test;接著檢查 Global Routing,使用 Proxy 暫時對照,最後檢查 Config 中的 DNS、策略參照及 FINAL。每次只修改一個項目,並記錄變更前後的情況。
七、儲存前後的基本檢查清單
完成匯入後,應能清楚說明內容來源、儲存頁面、更新方式,以及實際連線使用的項目。記下這四點,比只憑名稱判斷更可靠。涉及服務期限、連線數量或驗證方式變更時,請依自己既有服務的說明確認;本文僅介紹設定操作。
- 匯入前:確認內容屬於伺服器訂閱、遠端設定檔或單一參數,並保留目前可用的設定。
- 儲存後:在 Home 確認 Type、Address、Port;在 Config 確認已下載的檔案是否實際啟用。
- 更新後:確認對應來源沒有錯誤,並檢查遠端清單變更後是否需要重新選取項目。
- 連線後:確認 Global Routing,使用固定目標進行測試,並分別記錄訂閱更新問題與伺服器存取問題。
- 分享紀錄時:遮蔽 token、密碼、UUID、金鑰及 QR Code,只保留排查所需的欄位名稱與錯誤情況。