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 管理應用程式行為。不同平台的按鈕位置可能因視窗配置而異;以下以行動裝置常見的英文介面名稱為定位依據,桌面版請按相同功能尋找,不必完全照搬畫面位置。
Subscribe:節點訂閱與 Config 入口分開處理
搜尋「Config 頁面的 Subscribe」時,應先確認要匯入的資料類型。Config 中與 Subscribe 或遠端網址相關的操作用於管理設定檔,並非所有節點訂閱都要填入 Config。節點訂閱常見的操作路徑是 Home → 右上角「+」(Add Server)→ Type → Subscribe。兩者都可能使用 HTTPS 網址,但匯入結果不同:前者是設定檔,後者則是一組可供選取的連線資料。
-
確認網址
從自己的服務管理頁面複製完整訂閱網址。確認沒有一併選取前後說明文字、空格或換行,並保留問號後的所有參數。
-
開啟匯入入口
進入 Home,點選右上角「+」開啟 Add Server,並在 Type 中選擇 Subscribe。不要停留在一般單一節點的協定類型,直接貼上整個訂閱網址。
-
填入連結
將完整網址填入 URL,並設定方便辨識的備註後儲存。不要把 token 拆開當成密碼,也不要將 HTTPS 網址填入伺服器主機名稱欄位。
-
更新清單
返回 Home,確認是否出現訂閱群組。若內容未自動載入,請使用該訂閱的更新功能;支援下拉更新的清單可向下拉動以觸發更新,然後查看錯誤提示與項目數量。
-
確認匯入結果
展開群組,確認至少一筆連線的協定、伺服器與連接埠符合原有資料。儲存了訂閱名稱,不代表已成功取得連線清單。
如果取得的是遠端 .conf 檔,請前往 Config,使用新增遠端 URL 的入口取得檔案,再確認目前啟用的是哪一份設定。檔案可能包含分流與 DNS 行為;檔案下載成功,不代表其中所有設定都適合目前的網路。訂閱更新與設定檔更新也要分開檢查:前者更新連線資料,後者更新設定內容。
Add Server:手動填寫單一連線
若手邊資料包含伺服器位址、連接埠、密碼或 UUID 等個別欄位,使用 Home →「+」→ Add Server 較方便逐項核對。先選擇 Type,再填寫欄位,因為各協定所需的驗證與傳輸參數不同。不要先填完再任意切換協定,以免舊欄位殘留,或未注意到必填項目已變更。
- Shadowsocks:確認伺服器、連接埠、加密方式與密碼。加密方式必須與伺服器端一致,不要只因名稱相近就替換。
- VMess / VLESS:確認 UUID,以及伺服器端要求的傳輸方式、路徑、Host 和 TLS 參數。VLESS 和 VMess 的欄位不可直接照抄。
- Trojan:確認密碼與 TLS 相關設定,尤其是伺服器名稱。即使使用 IP 連線,也不能因此將憑證所需的名稱改成該 IP。
- Hysteria2:確認驗證資訊、連接埠、TLS 與伺服器端提供的相關傳輸參數;網路是否允許 UDP 也是後續排查項目之一。
- WireGuard:依完整資料核對金鑰、介面位址、Peer 與 Allowed IPs,不可當成一般密碼式連線處理。
例如,伺服器端資料標示連接埠為 8443,就填入 8443;不要因為啟用了 TLS 就改成 443。伺服器欄位通常填寫主機名稱或 IP,而非以 https:// 開頭的網頁網址;路徑則應填入對應的傳輸設定。儲存前逐項比對,通常比儲存後反覆切換開關更容易發現錯誤。
依照現有資料選擇新增方式
只有單一連線資料
- 透過 Add Server 選擇正確的 Type。
- 逐項填寫伺服器、連接埠與驗證欄位。
- 伺服器端變更參數後,手動同步本機設定。
已有可更新的訂閱
- 透過 Subscribe 儲存原始訂閱 URL。
- 更新後確認群組中的連線是否有變化。
- 若要保留本機修改,請先另外備份。
兩種方式的差異在於資料的整理與維護方式,不代表連線速度或服務品質必然不同。
掃描 QR Code:先確認 QR Code 包含的內容
QR Code 只是文字的編碼載體,可能包含單一協定連結、訂閱 URL,也可能只是一般網頁。進入 Home,使用頂端的掃描圖示開啟掃描畫面;首次使用相機時,依系統提示授權。辨識後先查看解析出的類型與欄位,再進行儲存;能辨識 QR Code,不代表連線參數一定有效。
- 在另一個螢幕上顯示現有的 QR Code,保持圖案完整,避免反光、遮擋或過度縮放。
- 開啟 Shadowrocket 的掃描入口,將鏡頭對準 QR Code。若目前介面提供從相簿讀取圖片的選項,也可以選擇原始圖片,避免使用經多次壓縮的聊天縮圖。
- 確認辨識結果。單一協定連結應對應一筆連線;訂閱 URL 應以訂閱方式處理;一般登入網頁不能直接轉成連線。
- 儲存後返回 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 則決定前面未匹配的流量去向。不要反覆重新匯入訂閱來修正規則問題。
- 確認 Config 中實際啟用的檔案,而不只是清單中最後下載的檔案。
- 查看連線記錄中的目標、匹配規則與最終策略,區分「未經代理」與「代理連線失敗」。
- 若手動中斷後又自動連線,請檢查 Settings → On Demand 的觸發條件;On Demand 控制依需求連線,不負責匯入訂閱。
匯入失敗排查:先確認結果,再檢查網路與格式
保留錯誤提示原文,並記錄失敗發生在「儲存網址」、「取得內容」、「解析內容」還是「連線測試」階段。這四個階段對應的問題各不相同。訂閱網址能在瀏覽器開啟,只代表瀏覽器取得了回應;若回傳的是登入頁面,Shadowrocket 仍無法將其解析為訂閱。
| 遇到的情況 | 優先確認 | 下一步 |
|---|---|---|
| 請求逾時 | 目前網路是否能連線至訂閱主機,以及 DNS 是否正常。 | 切換 Wi-Fi 與行動網路進行比較,避免同時變更連線參數。 |
| HTTP 401 / 403 | token、存取權限、伺服器端限制。 | 返回原有服務管理頁面確認網址與授權;不能只憑狀態碼判定已到期。 |
| HTTP 404 | 路徑是否完整,網址是否已變更。 | 重新複製實際訂閱網址,不要自行猜測路徑。 |
| 憑證相關錯誤 | 系統日期、時間與伺服器名稱。 | 先校正系統時間,再確認遠端憑證狀態;不要透過關閉驗證來掩蓋原因。 |
| 更新成功但沒有項目 | 回傳空清單、格式不符或使用了錯誤的入口。 | 確認回傳內容是節點訂閱,而非設定檔或網頁。 |
| 有項目但連線失敗 | 協定、連接埠、驗證資訊、TLS 與服務狀態。 | 逐項核對單一連線,不必先刪除整個訂閱群組。 |
訂閱更新可能會取代由訂閱管理的項目;本機重新命名或修改參數能否保留,取決於實際管理方式。若要保留獨立設定,請先備份再更新。排查用截圖應遮蔽伺服器敏感資訊、密碼、UUID 與 token,只保留入口、錯誤文字及必要的協定類型,以利定位問題且避免外洩完整憑證。