如果已有服務商提供的資料,請先確認拿到的是節點訂閱、單一節點連結,還是遠端設定檔,再選擇合適的匯入方式。本文以 iPhone / iPad 上的 Home、Config、Settings 介面為操作基準,介紹四種輸入方式、儲存後的檢查方法,以及發生問題時的排查順序;Mac、Windows、Android、Linux 使用者可依相同功能名稱核對,按鈕位置請以各平台實際介面為準。
先辨識連結類型
Shadowrocket(小火箭)的「新增訂閱」常被用來泛指新增連線資料,但節點訂閱和規則設定並非同一種內容。Home 用來管理連線項目及節點訂閱,Config 用來管理設定檔;Settings 則是應用程式設定。將節點訂閱貼到遠端設定檔入口,即使網址可以連線,也不代表能產生可用設定。
訂閱連結請向你的服務商取得。購買應用程式 ≠ 購買線路方案,安裝應用程式不會自動產生訂閱或連線憑證。本文只說明如何輸入已有資料,所有範例僅供格式示範,並非可用連線。
| 手上的資料 | 辨識依據 | 輸入方式 |
|---|---|---|
| 節點訂閱網址 | 通常是 HTTPS 網址,回傳一個或多個連線項目 | Home → + → Type → Subscribe |
| 遠端設定檔網址 | 內容包含 [General]、[Rule] 等設定區段 | 使用 Config 的遠端設定檔入口;Subscribe 用於更新相應的遠端設定檔 |
| 單一節點連結 | 常見前綴包括 ss://、vmess://、vless://、trojan://、hysteria2:// | 使用剪貼簿辨識,或掃描對應的 QR Code |
| 個別連線參數 | 分別列出協定、伺服器位址、連接埠及驗證資訊 | Home → + → Add Server 表單 |
網址以 https:// 開頭,並不足以判斷它是哪一類訂閱;檔案副檔名也不是可靠依據。請確認服務商對該網址用途的說明。如果開啟後出現帳戶登入頁面或錯誤訊息,代表它不是應用程式所需的連線資料。
方法一:Subscribe
先區分兩種使用情境:Config 頁面的 Subscribe 用於管理遠端設定檔的訂閱與更新,不等於在 Home 新增節點清單。如果要讓服務商提供的節點出現在 Home,請在 Add Server 將 Type 設為 Subscribe;如果拿到的是完整規則設定檔,則使用 Config 的遠端設定檔功能。
-
複製網址
向服務商取得節點訂閱網址,並完整複製,包含問號後方的查詢參數。不要連同「訂閱網址:」等說明文字一起複製,也不要漏掉結尾字元。
-
選擇類型
開啟 Home → 右上角的 +,進入 Add Server,將 Type 設為 Subscribe。不要保留預設協定,直接把整段訂閱網址填入伺服器位址欄位。
-
貼上並儲存
將網址貼到 URL,輸入方便辨識的名稱後儲存。名稱只供本機辨識,不會改變訂閱回傳的節點內容。
-
檢查更新
返回 Home,確認訂閱群組及項目已出現。如果儲存後沒有項目,請執行該訂閱的更新操作並檢查回傳錯誤,不要連續重複新增相同網址。
在 Config 新增遠端設定檔時,請使用已確認的設定檔網址,再透過該遠端項目提供的 Subscribe 功能管理更新。節點訂閱和設定檔的更新是兩回事;更新其中一項,不代表另一項也已更新。
例如 https://example.com/sub?token=xxxx 是明顯的假資料,僅用來說明 URL 結構。實際網址中的 token 通常具有帳戶存取權限,請勿上傳完整截圖或貼到公開討論區。需要排查時,保留錯誤訊息即可,並遮蔽網址路徑、查詢參數及帳戶識別資訊。
方法二:手動輸入參數
如果服務商只提供個別參數,或需要檢查單一連線的欄位,可使用 Add Server 手動輸入。這會建立單一連線項目,不會自動建立節點訂閱;伺服器位址或密碼變更時,通常需要自行修改該項目。
-
開啟表單
進入 Home → + → Add Server,先在 Type 選擇與伺服器相符的協定,再填寫其餘欄位。切換 Type 後,請重新核對已輸入的內容。
-
填寫位址
伺服器位址填入網域或 IP,連接埠則填在獨立欄位。例如資料標示連接埠為 443,就填 443;不要把 https://、路徑或「:443」一併填入位址欄位。
-
核對驗證資訊
Shadowsocks 請核對加密方法與密碼;VMess、VLESS 請核對 UUID 及相應的傳輸參數;Trojan、Hysteria2 請核對密碼及 TLS 相關參數。欄位顯示與否取決於所選的 Type。
-
儲存並測試
儲存後返回 Home,選取該項目並檢查連線狀態。如果失敗,請逐一比對原始資料,尤其留意密碼前後的空格、網域拼寫及連接埠數字。
使用相同的 443 連接埠,不代表不同協定可以互換。TLS 的 Server Name、傳輸層的 Host 與伺服器位址也可能不同,必須依照伺服器資料填寫。不要只為了排除錯誤而隨意關閉憑證驗證;這會改變連線的安全性,也不一定能解決參數錯誤。
- 連接埠只填數字;443 是常見範例,不是所有服務的預設值。
- UUID、密碼和金鑰屬於不同欄位,不應互相替代。
- WireGuard 使用金鑰、位址及對端參數,不能套用密碼型協定的填寫方式。
- 如果資料缺少必要欄位,請向原服務商確認,不要依照其他項目的值自行推測。
方法三:掃描 QR Code
QR Code 只是資料載體,可能包含單一節點連結、訂閱 URL,也可能只是一般網頁。掃描不會自動將網頁轉換成訂閱。匯入前請查看辨識結果,確認內容類型及來源符合預期。
-
準備原始圖片
在另一台裝置上顯示完整 QR Code,或將原始圖片儲存到目前裝置。避免裁掉邊緣、強烈反光或過度壓縮,圖片應能清楚辨識黑白方格。
-
開啟掃描功能
從 Home 的掃描入口進入;使用相機時請授予相機權限,使用相簿辨識時請選取原始圖片。若拒絕系統權限,請前往裝置的應用程式權限設定進行調整。
-
核對辨識結果
確認辨識內容是節點還是訂閱。如果只是帳戶網頁網址,請返回服務商頁面尋找明確標示的連線 QR Code,不要將登入頁面當成連線資料。
-
確認儲存
確認後返回 Home,檢查項目數量和名稱。如果匯入的是單一節點,請將它視為獨立項目檢查,不要預期它日後會隨遠端訂閱自動變更。
QR Code 可能直接包含完整驗證資訊,敏感程度與原始連結相同。截圖求助時,只遮住可見文字並不足夠,QR Code 本身也必須遮蔽。如果持續無法辨識,請優先索取原始文字並透過剪貼簿匯入,避免反覆轉存低解析度圖片。
方法四:從剪貼簿匯入
資料已在目前裝置上時,適合使用剪貼簿辨識。複製的內容應是完整連結,或應用程式可辨識的連線資料,不要複製包含連結的整段聊天內容。系統出現貼上授權提示時,必須允許存取,應用程式才能辨識剪貼簿內容。
-
只複製連結
選取完整的連線文字,移除前後的引號、項目符號及說明文字。不要手動修改連結中的百分比編碼、加號或等號。
-
返回應用程式
開啟 Shadowrocket,使用出現的剪貼簿辨識提示;如果沒有提示,請檢查新增選單是否提供從剪貼簿匯入,並確認系統允許貼上。
-
確認類型
檢查解析出的 Type、位址和連接埠。如果複製的是 HTTPS 節點訂閱網址,但未能自動辨識,請改用 Home → + → Type → Subscribe → URL 手動貼上。
-
清除剪貼簿副本
儲存並核對 Home 項目後,可以複製一段一般文字覆蓋剪貼簿,降低憑證之後被貼到其他位置的風險。
依資料所在位置選擇輸入方式
資料在目前裝置上
- 有完整節點連結:使用剪貼簿辨識。
- 有節點訂閱 URL:優先建立 Subscribe 項目。
- 只有截圖:使用掃描入口的相簿辨識功能。
資料在另一台裝置上
- 有 QR Code:使用目前裝置的相機掃描。
- 只有個別參數:透過 Add Server 手動輸入。
- 需要持續更新:取得節點訂閱網址,而不是只匯入單一節點。
輸入方式只會影響資料如何進入應用程式,不會改變伺服器協定、帳戶權限或線路狀態。
檢查匯入後的流量分流
「已出現項目」只代表資料已儲存,不表示流量已透過該項目傳送。請先在 Home 選取要使用的節點,再檢查連線開關與 Global Routing。首次建立系統網路連線時,請依裝置提示確認網路設定權限。
Config
建議在已準備好並選取合適設定的前提下,依規則比對結果決定策略。未符合規則的請求不一定會自動直連,最後的行為取決於 FINAL 等實際規則。
適用情境:已有明確的規則設定,需要依網域或位址分流。
Proxy
將交由應用程式處理的流量依 Proxy 策略轉送,用來比對檢查節點連線狀態。系統與設定中的特殊排除項目仍須另外考量。
適用情境:短時間進行對照測試,區分節點故障與規則比對問題。
Direct
依 Direct 策略直接連線。切換到此項目後可以開啟網頁,並不足以證明剛匯入的節點有效,因為請求可能未經該節點傳送。
適用情境:確認本機網路能否直接連線至目標。
規則檔案與訂閱需要分別驗證。例如以下片段表示規則比對關係,不是節點訂閱,也不會提供伺服器連線參數。規則由上而下比對,FINAL 放在最後作為備援;PROXY、DIRECT、REJECT 是策略關鍵字。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
延遲測試有結果,不代表網頁請求一定成功。DNS、TLS、目標網站狀態及規則比對都可能影響連線。驗證時一次只調整一個變數:先固定節點和目標,再比較策略或設定,避免同時更換節點、修改 DNS、變更規則,以致無法找出原因。
發生問題時逐層排查
將問題分為「無法辨識」、「無法更新」及「已匯入但無法連線」三類,比重新安裝更容易找出原因。保留原始錯誤文字,先檢查輸入內容及伺服器回傳資料,再檢查網路與帳戶狀態;不要重複建立相同訂閱來掩蓋更新失敗。
| 狀況 | 先檢查 | 接著處理 |
|---|---|---|
| 剪貼簿沒有辨識結果 | 貼上權限、文字是否完整,以及是否誤複製說明文字 | 如果是節點訂閱,改在 Subscribe 的 URL 欄位手動貼上 |
| 掃描後開啟網頁 | 確認 QR Code 是否指向帳戶頁面或說明頁面 | 向服務商取得相應的連線資料 |
| 更新回傳 401 或 403 | 驗證資訊、連結是否有效,以及伺服器端的存取限制 | 向服務商確認,不要自行刪除 token 參數 |
| 更新回傳 404 | 網址路徑、複製內容是否完整,以及舊網址是否已失效 | 重新複製目前有效的網址,避免手動拼接路徑 |
| 更新逾時 | 目前網路能否連線至訂閱伺服器,以及網域解析是否正常 | 改用其他可用網路重試,並記錄錯誤發生的階段 |
| 匯入成功但無法連線 | 已選取的項目、Global Routing、帳戶狀態、連接埠及驗證欄位 | 固定使用一個節點逐項檢查,區分連線失敗與規則問題 |
- 節點訂閱更新時可能會新增、刪除或重建項目;更新前請記下自行修改的內容,不要假設本機編輯一定會保留。
- 自動更新只會影響取得遠端內容的時機,無法修復已失效的訂閱網址。
- On Demand 用於管理依條件建立連線的行為,不負責取得訂閱;初步排查時請先驗證手動連線,再設定自動連線條件。
- 若仍需協助,請提供裝置平台、操作入口、錯誤文字及失敗階段;請勿提供密碼、UUID、金鑰或完整訂閱網址。