先分清「連線參數」與「取得清單的網址」:ss://、vmess://、vless://、trojan:// 通常包含單一連線的參數,訂閱網址則用來取得並更新一組項目。本文適合已持有服務商設定的使用者,說明欄位、編碼、Shadowrocket 匯入入口與更新方式。範例皆為無法實際連線的示範資料,不提供服務。
先看前綴:協定連結與訂閱網址並非同一類
Shadowrocket(小火箭)收到一段連結時,首先要判斷它描述的是連線本身,還是從遠端取得內容的方法。協定連結通常會在同一段文字中包含伺服器位址、連接埠、認證資訊與傳輸選項;訂閱網址通常使用 HTTPS,應用程式向該網址發出請求後,才會取得項目清單。兩者都能透過 QR Code 或剪貼簿傳送,因此不能只憑「由掃描取得」來判斷類型。
訂閱網址可以採用以下形式。token 是查詢參數名稱,可能用作存取憑證;實際網址的路徑與參數取決於使用者既有的服務。以 HTTPS 開頭的網址也可能只是網頁,只有回應內容符合應用程式支援的格式,才能解析為訂閱。
https://example.com/sub?token=xxxx
- 協定前綴:告訴解析器如何解讀後續參數,不代表伺服器一定可用。
- QR Code:只是文字的載體,可以包含單一協定連結,也可以包含訂閱網址。
- 訂閱回應:可能包含多筆連結,也可能經過 Base64 編碼;並非所有訂閱都採用相同的本文格式。
- Config:用來管理設定檔,與 Home 中的伺服器項目並非同一類。包含規則的設定檔也不能直接視為伺服器訂閱。
ss://:先確認加密方法,再檢查密碼與位址
ss:// 對應 Shadowsocks。常見的 SIP002 格式會先將「加密方法:密碼」編碼,放在 @ 前方,後方則是伺服器位址與連接埠。以下示範連結中的認證欄位解碼後為 aes-128-gcm:password,伺服器使用示範網域,連接埠為 8388。
ss://[email protected]:8388#SS-demo
| 位置 | 說明 | 檢查方式 |
|---|---|---|
ss:// | Shadowsocks 分享格式標記 | 匯入後檢查 Type |
@ 前方 | 加密方法與密碼的編碼內容 | 加密方法與密碼都必須符合伺服器設定 |
edge.example.com:8388 | 伺服器位址與連接埠 | 不要將連接埠填入位址欄位 |
#SS-demo | 顯示備註 | 修改備註通常不會變更連線參數 |
部分舊格式會將更多內容一併以 Base64 編碼,不能只用「是否有明文 @」來判斷格式。含外掛程式的連結也可能帶有 plugin 查詢參數。若複製時遺失參數,即使伺服器、連接埠和密碼都還在,也不代表連線資訊完整。
vmess://:常見載荷是編碼後的 JSON
vmess:// 對應 VMess。常見分享格式會在前綴後放入 Base64 編碼的 JSON,而不是直接寫成「使用者@主機」。因此,看不到明文伺服器位址不代表連結內容是空的。下方展示的是解碼後的示範載荷,並非可直接貼上匯入的完整連結。
{
"v": "2",
"ps": "VMess-demo",
"add": "edge.example.com",
"port": "443",
"id": "00000000-0000-4000-8000-000000000000",
"aid": "0",
"scy": "auto",
"net": "ws",
"type": "none",
"host": "edge.example.com",
"path": "/demo",
"tls": "tls",
"sni": "edge.example.com"
}
add、port、id分別表示伺服器、連接埠與使用者 UUID;UUID 並非顯示備註。ps是備註,v是分享載荷的格式欄位,不是 Shadowrocket 的應用程式版本。net=ws表示使用 WebSocket 傳輸;host與path用於對應的傳輸參數,不要任意刪除。tls與sni和 TLS 有關;即使範例中的位址、Host 與 SNI 相同,實際服務也可能分別指定不同值。aid是舊版相容欄位;排查問題時不要憑猜測修改數值,應依實際服務設定核對。
成功匯入只代表應用程式辨識了這段資料,並不表示網路連線正常、使用者認證有效或 TLS 參數相符。若遇到「清單中已有項目,但無法連線」,請進入項目編輯頁面逐一檢查,不要反覆匯入同一段連結。
vless:// 與 trojan://:格式相似,認證欄位不同
這兩類連結常見的格式都是「認證欄位@伺服器:連接埠」,並以查詢參數補充傳輸設定。VLESS 的認證欄位通常是 UUID,Trojan 則使用密碼。以下範例僅供了解結構;示範 UUID、密碼與網域皆不對應實際服務。
vless://[email protected]:443?encryption=none&security=tls&type=ws&host=edge.example.com&path=%2Fdemo&sni=edge.example.com#VLESS-demo
trojan://[email protected]:443?security=tls&sni=edge.example.com#Trojan-demo
| 欄位 | VLESS | Trojan |
|---|---|---|
@ 前方 | 通常為 UUID | 密碼 |
security=tls | 宣告使用 TLS 的常見參數 | 常見分享格式中的 TLS 參數 |
type=ws | 範例使用 WebSocket | 是否使用額外傳輸方式,請以實際連結為準 |
sni | TLS 使用的伺服器名稱 | TLS 使用的伺服器名稱 |
# 後方 | 備註 | 備註 |
encryption=none 不能解讀為「整條連線完全沒有保護」。這個欄位與 VLESS 本身有關;外層是否使用 TLS,仍須另外檢查安全性參數。反過來說,連接埠寫成 443 也不能證明 TLS 已正確啟用,連接埠只是連線目標的一部分。
查詢參數中的 %2F 是斜線的百分比編碼;密碼、備註與路徑中的特殊字元也可能經過編碼。請勿先反覆解碼整段連結再複製,否則原本屬於密碼的 @、# 或 & 可能被誤認為結構分隔符號。不同分享格式對擴充參數的規範並不完全相同,匯入後仍須檢查應用程式實際儲存的欄位。
在 Shadowrocket 中選擇匯入入口與更新方式
先確認手上的資料類型,再選擇匯入入口。Home 用於管理伺服器與訂閱項目,Config 用於管理設定檔,Settings 用於調整應用程式設定。不要因為複製的是 HTTPS 網址,就直接放進 Config 當作規則設定;也不要把單一協定連結當成可自動更新的訂閱網址。
Subscribe:管理既有訂閱
清單更新若要持續同步清單,請在 Home 點選「+」進入 Add Server,將 Type 設為 Subscribe,輸入完整訂閱 URL 後儲存。之後更新該訂閱,即可重新取得遠端清單。
適用情況:已持有訂閱網址,且需要同步清單變更
剪貼簿或掃描:匯入單筆參數
複製完整協定連結後返回應用程式,依照剪貼簿辨識提示新增;也可以使用 Home 的掃描入口讀取 QR Code。若系統提示允許貼上,請授權此次讀取。匯入後仍應檢查 Type 與伺服器欄位。
適用情況:已持有完整分享連結或對應的 QR Code
Add Server:手動逐項輸入
在 Home 點選「+」進入 Add Server,選擇對應的 Type,依照既有參數填入位址、連接埠與認證欄位,再設定必要的 TLS 和傳輸選項。手動新增不會自動建立遠端訂閱關係。
適用情況:只有欄位清單,或需要檢查匯入時遺漏的參數
結論:需要更新清單,就保留訂閱關係
輸入的是單一協定連結時,參數變更後通常需要重新匯入或編輯;輸入的是訂閱網址時,則應更新對應訂閱。不要把「重新貼上舊連結」當成從遠端取得新參數。
- 匯入前:確認來源是自己已有的設定,並保留可供還原的原始紀錄;不要先刪除仍可用的項目。
- 儲存後:檢查 Type、伺服器、連接埠與備註,不要只看名稱來判斷是否匯入正確。
- 測試前:檢查 TLS、SNI、Host、Path 等必要欄位。不同協定顯示的欄位各異,並非每條連線都需要填寫所有項目。
- 更新後:檢查訂閱群組中的項目是否變更;遠端更新可能會取代手動修改過的項目,重要修改請另行記錄。
常見問題:分別檢查辨識、更新與連線狀態
排查問題時,請分成三個層面:文字能否解析、訂閱請求能否取得內容,以及儲存後的連線是否可用。Global Routing 決定流量採用的路由方式,無法修復不完整的分享文字;切換 Proxy 或 Config,也無法補上連結中缺少的密碼。
複製連結後,為什麼沒有出現新增提示?
先檢查文字是否以 ss://、vmess://、vless:// 或 trojan:// 開頭;移除聊天軟體附加的說明文字與程式碼框線,再重新完整複製。確認系統允許 Shadowrocket 讀取此次剪貼簿內容;如果只有欄位清單,請改用 Home →「+」→ Add Server 手動填寫。
HTTPS 網址能在瀏覽器開啟,為什麼不能當作訂閱?
如果開啟的是登入頁、說明頁或錯誤頁,就不代表已取得清單。檢查 URL 是否完整,尤其是問號後方的 token 參數;並向自己既有的服務商確認網址用途。不要將含有認證資訊的網址交給第三方網頁檢測。
訂閱已更新,手動新增的項目為什麼沒變?
手動新增的項目不一定屬於該訂閱。返回 Home 確認項目所屬的群組與來源,再更新對應訂閱。若項目最初是透過單一協定連結新增,則須取得新連結重新匯入,或依照新參數編輯原項目。
連接埠是 443,為什麼仍然無法連線?
進入項目編輯頁面,檢查位址、連接埠、認證欄位,以及 TLS、SNI 與傳輸參數。443 只是連接埠號碼,不會自動補上這些設定。若有憑證問題,請檢查伺服器名稱與憑證設定,不要將關閉憑證驗證當成通用修復方式。
提供截圖請他人協助排查時,哪些內容需要遮蔽?
請遮蔽密碼、UUID、完整訂閱 URL、token 與 QR Code,並避免洩漏其他認證參數。可保留 Type、連接埠、傳輸類型與錯誤提示供判斷;若認證資訊已公開,請透過原有服務管道更換相關憑證。
完成欄位檢查後,再分別確認伺服器連線狀態與規則行為。連線參數決定如何建立連線,Config 中的規則則決定哪些請求採用哪種策略。訂閱更新成功、連線測試通過,以及目標請求依預期分流,是三項需要分別確認的結果。