先判斷連結承載的是伺服器參數,還是用來取得伺服器清單的網址,再選擇匯入方式。本文適合已取得服務商提供的連結,並想在 Shadowrocket 中確認匯入結果的使用者。讀完後即可分辨四種 URI、找出訂閱入口,並依欄位檢查匯入或更新失敗的原因。以下以 iPhone / iPad 介面為例,其他平台請以實際介面為準。
先看前綴:單一伺服器 URI 與訂閱 URL 的差異
ss://、vmess://、vless://、trojan:// 通常直接包含一筆伺服器設定所需的參數。複製完整連結後,客戶端會在本機解析位址、連接埠、驗證資訊與傳輸設定;解析出設定紀錄,不代表已成功連線,也不表示伺服器目前可用。
訂閱連結通常是 https:// 網址。Shadowrocket 必須連線至該網址、讀取回傳內容,再建立或更新伺服器清單。網址可能包含存取權杖;它不是一般公開網頁,也不是某種代理協定。僅憑 HTTPS 前綴無法判定它就是訂閱連結,還需確認連結用途與回傳格式。
結論:先辨識內容,再選擇匯入方式
看到協定前綴,就按單一伺服器參數處理;取得服務商明確標示的訂閱網址後,再使用 Subscribe。不要把訂閱 URL 的網域填入單一伺服器的 Address,也不要把整條協定 URI 當成訂閱下載網址。
ss://:驗證資訊可能經過 Base64 編碼
ss:// 用於分享 Shadowsocks 設定。常見的 SIP002 格式會將加密方法與密碼放在使用者資訊中,再接上伺服器位址與連接埠;使用者資訊通常採用 URL-safe Base64。較早期的分享格式也可能將「驗證資訊、位址、連接埠」整體進行 Base64 編碼,因此不能只看是否能直接看到伺服器網域,就判斷連結是否完整。
| 組成部分 | 確認方式 |
|---|---|
ss:// | 表示這是 Shadowsocks 分享格式,不是訂閱更新網址。 |
| 使用者資訊 | 解碼後通常包含加密方法、冒號與密碼;Base64 本身不具備保密功能。 |
| 伺服器與連接埠 | 例如示範位址 node.example.com:8388;8388 僅為範例,並非固定連接埠。 |
?plugin= | 選用的外掛程式參數;不能假設客戶端支援所有外掛程式,也不能為了匯入就直接刪除。 |
# 後方的內容 | 通常是備註名稱;包含空格或非 ASCII 字元時,可能會經過百分比編碼。 |
匯入後,在 Home 開啟該筆紀錄的編輯頁面,重點比對 Type、Address、Port、加密方法與 Password。加密方法和密碼必須分別對應,不能把整段 Base64 文字填入 Password。若原始內容已缺字,請重新複製來源連結,不要依編碼外觀自行補寫。
vmess://:先分辨編碼 JSON 與其他分享格式
常見的 vmess:// 分享格式是「前綴加上 Base64 編碼的 JSON」。解碼後的 JSON 通常包含 add、port、id、net、tls 等欄位。不同產生端可能採用不同的分享格式,因此不能假設所有 VMess 分享都有完全相同的外層結構。
以下 JSON 僅用於說明欄位,並非可用的伺服器設定,也不是可直接貼上匯入的完整連結。網域為示範網域,UUID 為全零示範值。只有實際服務設定中的對應值才能用於連線。
{
"v": "2",
"ps": "Example",
"add": "node.example.com",
"port": "443",
"id": "00000000-0000-0000-0000-000000000000",
"aid": "0",
"scy": "auto",
"net": "ws",
"type": "none",
"host": "edge.example.com",
"path": "/demo",
"tls": "tls",
"sni": "edge.example.com"
}
add與port是連線目標;443 是常見的 TLS 連接埠,但連接埠號碼本身無法證明已啟用 TLS。id是 UUID 驗證資訊,不能以訂閱 URL 中的 token 取代。net為ws時,還需要確認 WebSocket 的 Host 與 Path,不能只檢查位址和連接埠。tls與sni分別涉及 TLS 開關,以及交握時使用的伺服器名稱;Host、SNI 與連線位址可能各不相同。
若能解析出名稱但連線失敗,常見原因是缺少傳輸參數,而非名稱有誤。不要只因 Address 正確就忽略 Host、Path 或 TLS;也不要在無法確認原始設定時,任意將 ws 改成其他傳輸方式。
vless:// 與 trojan://:外觀相似,驗證欄位不同
這兩種連結常採用包含使用者資訊、位址、連接埠與查詢參數的 URI 結構。VLESS 的使用者資訊通常是 UUID;Trojan 的使用者資訊通常是密碼。兩者不能只改前綴就互相轉換。以下兩行僅展示結構,示範網域、全零 UUID 與示範密碼均不能用於連線。
vless://[email protected]:443?encryption=none&security=tls&type=ws&host=edge.example.com&path=%2Fdemo&sni=edge.example.com#Example
trojan://[email protected]:443?security=tls&type=tcp&sni=edge.example.com#Example
| 欄位 | 用途與檢查重點 |
|---|---|
@ 之前 | VLESS 通常使用 UUID,Trojan 通常使用密碼;特殊字元需依 URI 規則編碼。 |
security=tls | 表示 TLS 相關設定;必須與實際服務設定一致,不能只根據連接埠推斷。 |
type=ws / type=tcp | 表示傳輸方式;不同傳輸方式需要檢查的附加欄位也不同。 |
sni | TLS 交握時使用的伺服器名稱,應符合服務設定與憑證驗證要求。 |
host / path | 常見於 WebSocket 設定;%2Fdemo 解碼後為 /demo。 |
encryption=none 描述的是 VLESS 協定本身的加密欄位,不代表整條連線一定沒有加密;是否使用 TLS 需另外確認。Trojan 通常透過 TLS 傳輸;若出現憑證錯誤,請檢查裝置時間、SNI 與憑證,不應將關閉憑證驗證當成一般處理方式。
解析器對擴充參數的支援可能不同。若分享連結包含本文未列出的參數,請保留原始內容並檢查編輯頁;不要以為匯入成功,就代表所有擴充參數都已生效。
掃碼、剪貼簿與 Subscribe:依連結類型選擇操作
QR Code 只是承載文字的另一種方式。裡面可以放單一伺服器 URI,也可以放訂閱 URL;掃描不會自動將單一伺服器轉成可更新的訂閱。請先確認來源說明,再查看辨識結果。
Subscribe:保留訂閱更新關係
建議方式若已有訂閱且需要後續更新,請在 Home → + → Type 選擇 Subscribe,依頁面欄位填入訂閱 URL 並儲存。首次取得成功後,請檢查建立的紀錄與訂閱群組。
適用情況:已確認是訂閱網址,且需要持續同步自己的伺服器清單
從剪貼簿匯入:解析完整 URI
複製從協定前綴到末尾備註的完整文字,返回 Home;出現剪貼簿存取或匯入提示時,確認後再檢查解析結果。若沒有提示,可透過 + 依原始參數手動建立紀錄。
適用情況:已有一條或多條完整的單一伺服器分享文字
掃碼:讀取 QR Code 中的原始內容
在 Home 使用掃描功能,允許存取相機後掃描現有 QR Code。若辨識內容是網頁或一般文字,請先確認用途,不要直接儲存為伺服器紀錄。
適用情況:連結顯示在另一個螢幕上,不方便手動複製
訂閱網址的外觀範例為 https://example.com/sub?token=xxxx,僅用來說明 URL 格式,不提供可用內容。查詢參數中的 token 必須完整保留,不能以單一伺服器密碼取代,也不要將含有 token 的網址貼到公開討論區。
- 先保存現有紀錄與正在使用的參數,避免排查時遺失原本設定。
- 完成匯入後,檢查紀錄數量、Type、Address、Port,以及 TLS 和傳輸設定。
- 使用 App 內該筆訂閱的更新功能,確認更新成功後,再考慮自動更新設定。
- 若手動編輯訂閱中的紀錄,後續更新可能會重新寫入伺服器回傳的參數;請另外記下需要保留的修改。
訂閱回應可能包含一組分享 URI,也可能採用客戶端可辨識的其他格式。伺服器清單訂閱與 Config 中的設定檔不是同一種項目:匯入節點不會自動替你設定所有規則、DNS 或 Global Routing。
分別檢查匯入失敗、訂閱失敗與連線失敗
先依故障發生的階段定位。完全沒有建立紀錄時,優先檢查連結格式;紀錄已建立但訂閱無法更新時,檢查 URL 請求;紀錄可選取但網頁無法開啟時,再檢查連線與分流。尚未確認故障階段前,不要反覆刪除所有設定。
已複製連結,為什麼沒有辨識出來?
確認文字從 ss:// 等前綴開始,沒有混入引號、中文說明或通訊軟體插入的換行。確認複製的是完整內容,而非僅複製畫面上顯示的文字;若剪貼簿存取遭拒,請檢查系統對該 App 的貼上權限,或在 Home → + 手動填入已知參數。
掃描 QR Code 後看到 https://,可以直接當成節點使用嗎?
不能只看前綴就下定論。請先確認它是訂閱網址、設定網址還是一般網頁;只有明確用於伺服器清單的訂閱 URL,才能填入 Type 為 Subscribe 的紀錄。若掃碼後的預覽內容與來源說明不符,請先停止儲存。
訂閱可以儲存,但更新時失敗,該怎麼辦?
儲存只代表本機紀錄已建立,不表示遠端請求成功。請確認 URL 完整、token 仍有效,且網路可以連線至該網址。HTTP 401 或 403 通常與存取授權有關,404 通常表示路徑或資源有誤,逾時則需檢查網路與目標回應;不要試圖修改單一伺服器的 Port 來處理訂閱請求錯誤。
節點已匯入,為什麼網頁還是無法開啟?
在 Home 確認選取的紀錄與連線狀態,再檢查 Global Routing。Direct 不會透過所選代理轉送流量;Proxy 可用來暫時排除規則因素,Config 則依目前設定處理。請記下原本的模式,測試後再還原;同時確認 Address、Port、驗證資訊、TLS、SNI 與傳輸參數。
Settings → On Demand 用來管理依條件觸發連線的行為,無法將錯誤的分享連結修復為有效紀錄。排查匯入問題時,請先手動確認單筆紀錄並完成連線測試,再另外檢查 On Demand,避免自動連線行為與格式問題混為一談。
分享前檢查:連結中的編碼不等於去識別化
Base64、百分比編碼與 QR Code 都不是隱藏驗證資訊的安全措施。分享連結可能包含密碼、UUID、伺服器位址;訂閱 URL 也可能包含可讀取整份清單的 token。即使截圖中看不到明文密碼,QR Code 與整段編碼內容仍可能還原。
- 詢問問題時,只保留協定類型、傳輸方式、連接埠與錯誤提示等必要資訊。
- 請刪除完整密碼、UUID、訂閱 token 與 QR Code;只遮住備註名稱並不足夠。
- 需要展示格式時,請使用示範網域與明確標示的示範值,不要貼上真實連結。
- 若憑證資訊已公開,請透過自己的服務管理管道撤銷或更換,再更新本機紀錄。