Shadowrocket 訂閱匯入教學:Subscribe、Add Server、掃描 QR Code 與剪貼簿匯入

說明 Config 中 Subscribe、Add Server 手動設定、掃描 QR Code 與剪貼簿匯入的位置,並介紹常見連結格式的辨識方式。

本文速覽

Shadowrocket(小火箭)的匯入方式取決於手邊資料的類型:節點訂閱、單一協定連結、QR Code 與遠端設定檔各不相同。本文以使用者已有自己的服務商與訂閱為前提,說明 Subscribe 和 Config 的差異、Add Server 的填寫順序、掃描與剪貼簿的檢查方式,以及匯入後的驗證和故障排除步驟。

先辨別訂閱連結、協定連結與設定檔

匯入前,先確認收到的是「可取得一組連線資訊的網址」,還是「描述單一連線的連結」。訂閱網址通常以 https:// 開頭,應用程式向該網址發出請求後才會取得內容;單一協定連結則常以 ss://、vmess:// 或 trojan:// 等協定標記開頭。僅憑網址副檔名無法判斷格式:沒有 .conf 副檔名的網址,也可能回傳設定檔。

資料類型辨識方式處理方式
節點訂閱通常是包含識別參數的 HTTPS 網址,會回傳多筆連線資料。使用 Home 中的訂閱新增入口,並將 Type 設為 Subscribe。
單一連線以協定標記開頭,包含伺服器、連接埠與驗證資訊。使用掃描 QR Code、剪貼簿匯入,或在 Add Server 手動填寫。
遠端設定內容可能包含 [General]、[Rule] 等段落。在 Config 管理遠端設定,下載後再確認啟用狀態。
網頁網址開啟後顯示登入頁面、說明頁或 HTML 內容。不能直接當成訂閱使用;請向原有服務提供者確認正確的匯入網址。

本文會用到 Home、Config、Settings 三個區域:Home 管理連線與選取狀態,Config 管理設定檔,Settings 管理應用程式行為。不同平台的按鈕位置可能因視窗配置而異;以下以行動裝置常見的英文介面名稱為定位依據,桌面版請按相同功能尋找,不必完全照搬畫面位置。

4 種
本文介紹的入口:Subscribe、Add Server、掃描 QR Code、剪貼簿
3 個區域
介面位置:Home / Config / Settings
2 種取得方式
iPhone / iPad:$2.99 一次性付費;Mac / Windows / Android / Linux:免費

Subscribe:節點訂閱與 Config 入口分開處理

搜尋「Config 頁面的 Subscribe」時,應先確認要匯入的資料類型。Config 中與 Subscribe 或遠端網址相關的操作用於管理設定檔,並非所有節點訂閱都要填入 Config。節點訂閱常見的操作路徑是 Home → 右上角「+」(Add Server)→ Type → Subscribe。兩者都可能使用 HTTPS 網址,但匯入結果不同:前者是設定檔,後者則是一組可供選取的連線資料。

  1. 確認網址

    從自己的服務管理頁面複製完整訂閱網址。確認沒有一併選取前後說明文字、空格或換行,並保留問號後的所有參數。

  2. 開啟匯入入口

    進入 Home,點選右上角「+」開啟 Add Server,並在 Type 中選擇 Subscribe。不要停留在一般單一節點的協定類型,直接貼上整個訂閱網址。

  3. 填入連結

    將完整網址填入 URL,並設定方便辨識的備註後儲存。不要把 token 拆開當成密碼,也不要將 HTTPS 網址填入伺服器主機名稱欄位。

  4. 更新清單

    返回 Home,確認是否出現訂閱群組。若內容未自動載入,請使用該訂閱的更新功能;支援下拉更新的清單可向下拉動以觸發更新,然後查看錯誤提示與項目數量。

  5. 確認匯入結果

    展開群組,確認至少一筆連線的協定、伺服器與連接埠符合原有資料。儲存了訂閱名稱,不代表已成功取得連線清單。

如果取得的是遠端 .conf 檔,請前往 Config,使用新增遠端 URL 的入口取得檔案,再確認目前啟用的是哪一份設定。檔案可能包含分流與 DNS 行為;檔案下載成功,不代表其中所有設定都適合目前的網路。訂閱更新與設定檔更新也要分開檢查:前者更新連線資料,後者更新設定內容。

Add Server:手動填寫單一連線

若手邊資料包含伺服器位址、連接埠、密碼或 UUID 等個別欄位,使用 Home →「+」→ Add Server 較方便逐項核對。先選擇 Type,再填寫欄位,因為各協定所需的驗證與傳輸參數不同。不要先填完再任意切換協定,以免舊欄位殘留,或未注意到必填項目已變更。

例如,伺服器端資料標示連接埠為 8443,就填入 8443;不要因為啟用了 TLS 就改成 443。伺服器欄位通常填寫主機名稱或 IP,而非以 https:// 開頭的網頁網址;路徑則應填入對應的傳輸設定。儲存前逐項比對,通常比儲存後反覆切換開關更容易發現錯誤。

依照現有資料選擇新增方式

只有單一連線資料
  • 透過 Add Server 選擇正確的 Type。
  • 逐項填寫伺服器、連接埠與驗證欄位。
  • 伺服器端變更參數後,手動同步本機設定。
已有可更新的訂閱
  • 透過 Subscribe 儲存原始訂閱 URL。
  • 更新後確認群組中的連線是否有變化。
  • 若要保留本機修改,請先另外備份。

兩種方式的差異在於資料的整理與維護方式,不代表連線速度或服務品質必然不同。

掃描 QR Code:先確認 QR Code 包含的內容

QR Code 只是文字的編碼載體,可能包含單一協定連結、訂閱 URL,也可能只是一般網頁。進入 Home,使用頂端的掃描圖示開啟掃描畫面;首次使用相機時,依系統提示授權。辨識後先查看解析出的類型與欄位,再進行儲存;能辨識 QR Code,不代表連線參數一定有效。

  1. 在另一個螢幕上顯示現有的 QR Code,保持圖案完整,避免反光、遮擋或過度縮放。
  2. 開啟 Shadowrocket 的掃描入口,將鏡頭對準 QR Code。若目前介面提供從相簿讀取圖片的選項,也可以選擇原始圖片,避免使用經多次壓縮的聊天縮圖。
  3. 確認辨識結果。單一協定連結應對應一筆連線;訂閱 URL 應以訂閱方式處理;一般登入網頁不能直接轉成連線。
  4. 儲存後返回 Home,確認新項目或群組已出現,再進行連線測試。

若相機畫面沒有顯示,先檢查系統是否已授予 Shadowrocket 相機權限;若能拍到 QR Code 卻始終無法辨識,請先確認圖片是否完整,以及文字內容是否為應用程式支援的格式。QR Code 截圖可能含有密碼或 token,回報問題時不應直接將原圖張貼到公開討論區。

剪貼簿匯入:保留完整連結與原始編碼

若文字已在目前裝置上,使用剪貼簿通常比重新掃描更直接。先只複製連結本身,再返回 Home,依照應用程式辨識連結後顯示的匯入提示操作;必要時可從新增入口尋找剪貼簿匯入功能。系統詢問是否允許貼上時,只有允許後應用程式才能讀取相關內容。若未出現辨識提示,可將 HTTPS 訂閱網址手動貼到 Type 設為 Subscribe 的 URL 欄位。

訂閱網址格式示意:
https://example.com/sub?token=xxxx

常見單一連結前綴:
ss://
vmess://
vless://
trojan://

以上前綴僅用於辨識內容類型,並非可直接使用的完整連線。連結可能包含百分比編碼、Base64 文字,以及 # 後的備註;手動「整理」這些字元可能改變原意。不要將聊天軟體顯示的省略號當成原文,也不要連同含有「點選匯入」等說明的整段訊息一起複製。

匯入後驗證:分開檢查連線選取與 Global Routing

匯入只會儲存資料,不代表已建立連線。先在 Home 選取剛匯入的連線,進行延遲或連線測試,再開啟連線開關;首次建立系統 VPN 設定時,請依系統提示確認授權。延遲測試有結果,只能表示該測試方式成功,無法保證 DNS、TLS、UDP 或所有目標網站都正常。

接著檢查 Home → Global Routing。Proxy、Direct、Config、Scene 是不同的路由模式,不能將它們視為四種協定。若要確認問題出在哪一層,可暫時比較路由行為;測試結束後應還原原有設定。

Config

建議

依目前設定的規則決定流量去向。是否直連取決於匹配到的規則與最後套用的策略,並非「沒有匹配就一定直連」。

適用情況:已確認設定,且需要依規則分流。

Proxy

將路由模式設為代理,用來比對判斷目標流量未依預期經過代理,是否由規則選擇造成。

適用情況:短時間確認所選連線與分流規則之間的差異。

Direct

使用直連路徑。切換到此模式後能瀏覽某個網站,不能證明新匯入的代理連線有效。

適用情況:比對本機網路本身是否可連線。

Scene

依已設定的場景條件決定路由行為;實際採用的設定需視場景內容而定。

適用情況:已建立並確認場景條件的網路切換需求。

若 Proxy 模式可以連線、Config 模式卻不行,接著檢查目前設定中的 DOMAIN-SUFFIX、IP-CIDR、GEOIP 與 FINAL。規則通常由上而下比對,匹配後採用對應策略;結尾的 FINAL 則決定前面未匹配的流量去向。不要反覆重新匯入訂閱來修正規則問題。

匯入失敗排查:先確認結果,再檢查網路與格式

保留錯誤提示原文,並記錄失敗發生在「儲存網址」、「取得內容」、「解析內容」還是「連線測試」階段。這四個階段對應的問題各不相同。訂閱網址能在瀏覽器開啟,只代表瀏覽器取得了回應;若回傳的是登入頁面,Shadowrocket 仍無法將其解析為訂閱。

遇到的情況優先確認下一步
請求逾時目前網路是否能連線至訂閱主機,以及 DNS 是否正常。切換 Wi-Fi 與行動網路進行比較,避免同時變更連線參數。
HTTP 401 / 403token、存取權限、伺服器端限制。返回原有服務管理頁面確認網址與授權;不能只憑狀態碼判定已到期。
HTTP 404路徑是否完整,網址是否已變更。重新複製實際訂閱網址,不要自行猜測路徑。
憑證相關錯誤系統日期、時間與伺服器名稱。先校正系統時間,再確認遠端憑證狀態;不要透過關閉驗證來掩蓋原因。
更新成功但沒有項目回傳空清單、格式不符或使用了錯誤的入口。確認回傳內容是節點訂閱,而非設定檔或網頁。
有項目但連線失敗協定、連接埠、驗證資訊、TLS 與服務狀態。逐項核對單一連線,不必先刪除整個訂閱群組。

訂閱更新可能會取代由訂閱管理的項目;本機重新命名或修改參數能否保留,取決於實際管理方式。若要保留獨立設定,請先備份再更新。排查用截圖應遮蔽伺服器敏感資訊、密碼、UUID 與 token,只保留入口、錯誤文字及必要的協定類型,以利定位問題且避免外洩完整憑證。

下載 Shadowrocket