本文摘要

本文適合已取得服務商資料,準備在 Shadowrocket(小火箭)首次匯入的使用者。先分辨伺服器訂閱、單筆分享連結與遠端設定,再依資料類型選擇 Subscribe、Add Server、掃描 QR Code 或從剪貼簿匯入;最後檢查訂閱更新、Global Routing 與連線結果,避免把「成功儲存」誤認為「已可使用」。以下以 iPhone / iPad 介面用語為例,其他平台請對照相應入口操作。

一、匯入前先辨別資料類型

訂閱網址與網站網址可能都以 https:// 開頭,但用途不同。伺服器訂閱會傳回可解析的伺服器項目;遠端設定包含設定區段、規則或策略;服務商帳戶頁面則會顯示網頁。將帳戶頁面貼到 Subscribe,通常無法取得可用的伺服器清單。請先查看服務商對連結用途的說明,不要只看網址外觀判斷。

Home 主要用於檢視伺服器清單、選取伺服器與連線;Config 用於管理設定檔;Settings 用於應用程式設定。Config 頁面的 Subscribe 與 Home →「+」→ Type → Subscribe,須依資料類型區分:前者用於設定訂閱入口,後者用於新增伺服器訂閱。匯入伺服器清單不代表也已匯入規則檔,也不代表 Global Routing 已切換為 Config。

伺服器資料

訂閱網址
https://example.com/sub?token=xxxx,僅為虛構範例。
單筆分享連結
ss://、vmess://、vless://、trojan:// 等協定連結。
主要入口
Home →「+」→ Type → Subscribe;單筆資料也可透過掃描 QR Code 或從剪貼簿匯入。
匯入結果
Home 中會出現訂閱群組或獨立的伺服器項目。

連結前綴只能說明格式;能否解析仍取決於完整內容及目前應用程式的支援情況。

設定資料

遠端設定
服務商明確提供的 Shadowrocket 設定檔網址。
主要入口
在 Config 中使用新增遠端設定或 Subscribe 入口,依頁面欄位填入 URL。
設定內容
可能包含 [General]、[Rule] 等區段;請先檢查實際檔案內容。
套用方式
下載後,在 Config 中選取目標設定檔,再確認 Global Routing。

檔案副檔名不是可靠的判斷依據;遠端網址也可能透過沒有副檔名的介面傳回設定。

二、Subscribe:匯入訂閱並確認更新結果

如果你持有伺服器訂閱 URL,建議新增為 Subscribe,不要拆成多筆手動項目。服務商調整伺服器位址、連接埠或項目數量後,仍可透過同一份訂閱更新。訂閱更新是重新取得資料,不是測試線路速度,也不會延長服務效期。

  1. 確認資料

    從自己的服務商帳戶頁面複製適用於 Shadowrocket 的伺服器訂閱 URL,並確認沒有一併複製說明文字、換行或前後空白。

  2. 選擇類型

    前往 Home → 右上角「+」開啟 Add Server,將 Type 設為 Subscribe。請勿把訂閱 URL 填入一般協定的 Server 欄位。

  3. 儲存訂閱

    在 URL 欄位貼上完整網址;可在 Remarks 填入方便辨識的名稱,再完成儲存。名稱僅供本機辨識,不會改變訂閱傳回的內容。

  4. 取得項目

    返回 Home,使用訂閱的更新功能;支援下拉更新的清單也可以下拉重新整理。等待請求完成,確認目標訂閱群組中是否出現伺服器項目。

  5. 檢查設定

    如果服務商另有提供設定 URL,請前往 Config → Subscribe 或新增遠端設定的入口匯入。確認設定可讀取後再選取使用,不要用伺服器訂閱 URL 取代設定 URL。

更新後項目變少,不一定代表匯入失敗:服務商可能刪除或調整了傳回內容。請先比對帳戶中的有效期限與訂閱說明,再查看是否有錯誤訊息。手動修改訂閱產生的伺服器項目,之後更新時可能會被遠端內容覆蓋;需要長期保留的本機調整應另行記錄,不能假設一次編輯會一直生效。

三、Add Server:依協定手動填寫欄位

如果資料分別列出 Server、Port、Password 等欄位,而不是可複製的訂閱或分享連結,請使用 Home →「+」→ Add Server。先確認 Type,再逐項填寫。伺服器網域與連接埠相同,並不能據此判斷協定;即使選錯 Type 後仍能儲存,也無法建立正確連線。

協定或欄位需核對的資料常見錯誤
Server / Port分別填入主機名稱或 IP 與連接埠。若資料標示連接埠為 443,就填入 443,不要自行依協定決定。把 https://、路徑或連接埠一併貼進 Server。
Shadowsocks核對 Method、Password;若資料要求使用外掛程式,也須依原始資料填寫相關設定。只填 Password,卻忽略 Method 不一致。
VMess / VLESS核對 UUID、傳輸方式及 TLS 相關欄位;不同協定的附加參數不可混用。只複製 UUID,漏掉 WebSocket Path 或 Host。
Trojan / Hysteria2核對驗證資訊與 TLS Server Name;Hysteria2 另須留意 UDP 是否可連通及伺服器端要求。把連線 IP 當成必然正確的 TLS Server Name。
WireGuard依現有設定核對 Private Key、對端 Public Key、Endpoint、位址等必要資訊。把一般訂閱 URL 當成 WireGuard 設定內容。

例如,服務商明確提供 Server 為 example.com、Port 為 443,而 TLS Server Name 是另一個網域時,應分別保留各欄位的原始值。443 只是連接埠號碼,不代表可以省略 TLS、驗證或傳輸設定。請勿以關閉憑證驗證取代網域與憑證檢查。

四、掃描 QR Code 與剪貼簿:匯入的是編碼內容

掃描 QR Code 和使用剪貼簿是兩種輸入方式,不是額外的協定。QR Code 可能包含單筆分享連結,也可能只有網頁網址;剪貼簿也可能混有網頁標題、說明文字或多段不完整內容。辨識成功後,仍須確認最後建立的是單筆伺服器、訂閱群組,還是設定資料。

掃描 QR Code 匯入

  1. 在 Home 找到掃描圖示並開啟掃描功能;首次使用時,請依系統提示授予相機權限。
  2. 對準服務商提供的 QR Code,確保內容完整。若 QR Code 顯示在另一台裝置上,請避免反光或裁切四角。
  3. 如果 QR Code 儲存在本機相簿,請使用掃描頁面提供的相簿入口;若無法使用該入口,可改為複製同一份資料的文字連結。
  4. 辨識後查看 Type、Server、Port 等結果,再儲存。若只辨識到一般網頁 URL,請勿將它當成已匯入伺服器。

從剪貼簿匯入

  1. 先完整複製單筆分享連結,例如以 ss://、vmess://、vless:// 或 trojan:// 開頭的資料。
  2. 返回 Home,開啟「+」新增選單中的 Import from Clipboard;若應用程式提示確認讀取剪貼簿,請依這次匯入的需要允許。
  3. 檢查辨識出的項目後再儲存。若目前介面沒有該選單,可在 Add Server 的相應欄位貼上資料,或使用服務商提供的 QR Code。
  4. 對於 https:// 訂閱 URL,建議回到 Type → Subscribe → URL 貼上,明確告知應用程式這是訂閱,避免把一般網址誤認為單筆分享連結。

五、匯入後檢查 Global Routing 與連線

Home 出現伺服器,只代表資料已儲存。接著選取一台自己已有的伺服器,開啟連線開關;首次建立 VPN 設定時,請依系統提示授權。接著確認 Home → Global Routing。不同模式會改變請求的處理方式,不能只看開關是否已開啟。

Config

建議

依目前選取的設定規則處理請求。符合規則時,使用該規則指定的策略;未符合的請求則依後續規則及 FINAL 等預設處理方式執行,不一定會直連。

適用情境:已檢查設定內容,需要依規則分流的日常使用。

Proxy

將接管的請求交由代理處理,可用來判斷問題是否與分流規則有關。仍須確認伺服器驗證資訊正確、傳輸可連通,且應用程式與系統允許接管該請求。

適用情境:暫時進行對照測試,區分規則問題與伺服器連線問題。

Direct

將接管的請求以直連方式處理。選取伺服器但停留在 Direct,不能據此驗證該伺服器是否能轉送請求。

適用情境:確認目前網路的直連狀況,或暫時明確使用直連。

Global Routing 中的 Scene 會依已設定的場景條件套用相應設定,不是協定類型。未確認場景條件及對應行為前,不要把 Scene 當成固定的 Proxy 或 Config。首次測試建議先使用一種明確模式完成驗證,再設定自動切換。

六、訂閱失敗與匯入異常的排查順序

先確認問題發生在哪個階段:未能下載訂閱內容、下載後無法解析,或已有項目但連線失敗。反覆刪除再新增會讓排查線索消失。請保留錯誤訊息,並在不洩露 token 和驗證資訊的前提下檢查 URL、網路及傳回內容。

訂閱更新一直逾時,該先檢查什麼?

先確認目前網路能否連上訂閱網址。若已有可用連線,可先連線再更新;若訂閱網址確實需要透過代理存取,請前往 Settings → Subscribe 檢查 Update via Proxy。新安裝的應用程式若沒有可用伺服器,這個選項無法憑空建立代理通道。

顯示解析失敗,但網址能在瀏覽器開啟?

確認開啟後顯示的是訂閱內容、帳戶登入頁面還是錯誤頁面。HTTP 200 只表示請求收到回應,不代表內容格式正確。請確認複製的是服務商標示適用於 Shadowrocket 的訂閱,而非管理介面網址;不要將完整回應內容傳到公開平台。

QR Code 掃描成功,Home 卻沒有新增項目?

查看辨識結果是否只是網頁、設定 URL 或不完整連結,再從相應入口重新操作。相簿中的小圖可能因壓縮而遺失資訊,可重新取得原始清晰的 QR Code,或改用完整文字連結匯入。

訂閱已有項目,網頁還是無法開啟?

先在 Home 選取項目並執行 Connectivity Test,再確認 Global Routing 是否為預期模式。只有單一項目失敗時,請檢查該項目的驗證及傳輸欄位;全部失敗時,則檢查目前網路、服務效期,以及伺服器位址是否已變更。

更新後,修改過的名稱或參數又還原了?

訂閱更新會依遠端內容重新整理產生的項目,本機修改可能遭到覆蓋。若要保留獨立資料,可另外建立手動項目並註明用途;下次更新時仍須檢查原訂閱是否有變動,不要用舊參數取代服務商提供的新資料。

首次匯入完成後,請保留一份不含敏感憑證的操作記錄:資料類型、使用的入口、Global Routing 模式及錯誤訊息即可。之後遇到問題時,先更新資料並重現相同測試,再考慮修改設定;每次只調整一個項目,才能判斷是哪個步驟影響結果。

取得 Shadowrocket 並繼續設定

iPhone / iPad 版需在 App Store 一次性付費 $2.99;Mac(Apple 晶片 / Intel)、Windows、Android、Linux 版免費。iPhone / iPad 的系統需求以 App Store 頁面標示為準,開發者為 Shadow Launch Technology Limited。購買用戶端不等於購買線路方案,匯入時仍須使用自己已有的服務商資料。