Clash 訂閱連結匯入教學:URL、Base64 與 YAML 格式差異
整理各平台匯入 Clash 訂閱連結的步驟,並比較完整 YAML 設定、Base64 節點清單與單一節點連結的差異及轉換方式。
先分清楚連結與回傳內容
匯入 Clash 訂閱前,先確認兩件事:取得的是下載網址,還是節點本身;網址回傳的是完整設定檔,還是只有節點清單。許多「連結開得了,卻無法匯入用戶端」的問題,原因就在這裡。
URL 是網址;YAML 和 Base64 描述的是內容格式或編碼方式,三者並非同一層概念。以 https:// 開頭的訂閱 URL,可能回傳 Clash YAML、Base64 編碼的節點清單,也可能是帳戶登入頁面。只看副檔名、連結長度或網頁能否開啟,都無法判斷是否相容。
| 取得的內容 | 辨識線索 | 適用的匯入方式 |
|---|---|---|
| 完整 YAML 設定 | 通常包含 proxies、proxy-groups、rules 等欄位,也可能透過 provider 引用節點 | 匯入遠端設定,或匯入本機設定檔 |
| Base64 節點清單 | 解碼後通常會看到多行 ss://、vmess://、trojan:// 等連結 | 使用支援該格式的匯入工具,或可信任的本機轉換流程 |
| 單一節點連結 | 以特定協定前綴開頭,通常描述單一連線 | 使用明確支援該協定的節點匯入或編輯功能 |
完整 YAML 與節點清單有何不同
完整設定不只是節點集合
一份可直接使用的 Clash 設定,除了連線參數,還要決定流量如何進入核心、規則要套用哪個策略群組,以及未符合規則時使用哪個出口。常見欄位包括 mixed-port、mode、proxy-groups、rules 和 dns。不同核心支援的欄位不盡相同;設定中出現某個欄位,不代表所有用戶端都能辨識。
以下 YAML 範例用來說明欄位,並非含有代理節點的訂閱。7890 是範例監聽埠,不能因此認定本機用戶端也使用這個埠;MATCH,DIRECT 則會讓符合這條規則的請求直接連線。
mixed-port: 7890
mode: rule
log-level: info
rules:
- MATCH,DIRECT
匯入時請保留原始檔案的層級與空格縮排,不要直接把網頁上顯示的格式化文字當成設定檔。YAML 縮排請使用空格,不要使用 Tab。剖析器顯示的行號可作為排查起點,但實際錯誤也可能出現在前一行,例如少了引號、冒號後分隔不正確,或清單項目縮排錯誤。
同樣是 YAML,也可能只是 provider 檔案
有些網址回傳的內容只有頂層 proxies: 和節點清單。這類檔案通常供 proxy-providers 使用,不代表它是含有策略群組與分流規則的完整設定。主設定檔需要宣告 provider,並透過策略群組的 use 引用;若把它當成完整設定匯入,雖然可能通過解析,卻不會有預期的策略群組與分流行為。
因此,服務提供者若同時提供「Clash 設定」與「節點提供者」兩種入口,新手應先選前者。只有打算自行維護主設定檔時,才需要使用後者。欄位用途可參考本站的設定欄位文件,不要只憑副檔名判斷用途。
各平台如何匯入訂閱 URL
以下說明常見用戶端的操作方式。選單名稱可能隨版本調整;若名稱不同,請優先尋找「訂閱」、「設定」或 Profiles 頁面,而不是連線清單中的節點搜尋欄。首次匯入前,請先保留目前可用的設定,不要刪除舊設定再嘗試。
Windows 與 macOS:以 Clash Verge Rev 為例
- 在服務提供者的訂閱頁面選擇 Clash,或明確標示支援 mihomo 的格式,複製完整的 HTTPS 訂閱網址,不要複製帳戶管理頁面的網址。
- 開啟 Clash Verge Rev 的「訂閱」頁面,在訂閱連結欄位貼上網址,點選「匯入」。若目前介面提供「新增」功能,可選擇遠端類型,再填寫名稱與 URL。
- 等候遠端設定下載完成,再選取該設定。項目加入清單,不一定代表它已成為目前使用中的設定。
- 開啟「代理」頁面,確認已出現預期的策略群組,再選擇群組中的出口。若要依規則分流,請將運作模式設為「規則」。
- 依需求啟用系統代理或 TUN,並檢查連線紀錄。首次測試時不建議同時修改 DNS、規則與 TUN 參數,否則很難判斷是哪項設定生效。
在 Linux 上使用同一個用戶端時,匯入訂閱的流程相同;主要差異在於系統代理與 TUN 的權限及服務安裝方式。成功下載訂閱,與系統流量是否進入代理,是兩件不同的事。
Android:分清楚匯入設定與啟動 VPN
舊版 Clash for Android 常見的操作路徑是「設定」→「+」→「從 URL 匯入」,接著填入名稱與 URL 並儲存。返回設定清單後,還要選取剛匯入的設定,再回到主畫面啟動;系統首次顯示 VPN 授權提示時,必須確認授權才能接管相應流量。此專案已停止維護,使用較新的協定與設定欄位前,請先確認相容性。
使用 FlClash 等仍有維護的用戶端時,可在「設定」頁面尋找新增或 URL 匯入功能,流程同樣是「新增網址 → 下載 → 選取設定 → 啟動」。不要把 Android 的 VPN 圖示當成訂閱已正確載入的證明;它只能表示 VPN 服務正在執行。
iOS:先確認用戶端支援的格式
iOS 用戶端沒有統一的 Clash 匯入選單。請先查看用戶端說明,確認它接受完整 Clash YAML、節點訂閱,還是只接受單一節點 URI,再使用相應的「新增訂閱」或「匯入設定」功能。兩個 App 都支援相同的代理協定,不代表它們也支援相同的設定檔。
若訂閱頁面提供「開啟用戶端」按鈕,開啟 App 後仍應確認匯入名稱與目標網址。系統分享面板中出現某個 App,也不代表它能解析目前的內容。需要更換用戶端時,可先到用戶端下載頁確認平台與核心類型。
如何處理 Base64 與單一節點
Base64 解碼不會產生分流規則
Base64 是編碼方式,不是加密。節點清單編碼後看起來像一長串字元,但解碼後通常仍只是一行行節點 URI,不會自動補上 proxy-groups、rules 或 DNS 設定。有些清單會省略末尾的填充字元,或採用 URL 安全變體,因此簡單的線上解碼工具也可能回報錯誤。
最簡單的做法是回到服務提供者頁面,選擇適用於 Clash 或 mihomo 的訂閱格式。只有在沒有原生格式時,才考慮轉換。不要隨意在 URL 後加上 format=clash 碰運氣;格式參數由伺服器定義,並沒有適用於所有訂閱服務的通用寫法。
單一節點匯入成功,不代表能持續更新
ss://、vmess://、trojan:// 等連結通常包含伺服器、連接埠、驗證資料與傳輸參數。匯入時,用戶端必須同時支援相應協定及 URI 參數格式。部分新協定需要 mihomo 等核心支援,舊版 Clash 核心不會只因更改協定名稱就取得相容能力。
手動匯入的節點通常只是一次性的快照。伺服器日後更換連接埠、驗證資料或傳輸參數時,原有節點不會因為「曾經來自訂閱頁面」而自動更新。若需要自動維護,應保留遠端訂閱項目,並使用用戶端提供的更新功能。
轉換前後應核對哪些欄位
- 協定與驗證資料:確認節點類型、伺服器連接埠、密碼或 UUID 都沒有遺失。不要只因節點名稱相同,就認定轉換成功。
- TLS 參數:核對 SNI、ALPN 與憑證驗證設定。不要為了讓轉換結果「連得上」就直接關閉憑證驗證。
- 傳輸參數:WebSocket 路徑、要求標頭及 gRPC 服務名稱都可能影響交握;遺漏其中任何一項,都可能導致連線失敗。
- 設定結構:轉換工具產生的策略群組與規則應能互相參照。規則指向不存在的群組名稱時,即使節點有效,整份設定也可能無法載入。
匯入失敗時,依回應內容排查
先分辨「要求未成功」與「要求成功但內容不正確」。前者檢查網路、網址與憑證;後者檢查格式及核心相容性。下載失敗時,不要反覆修改 YAML 縮排;解析失敗時,也不要只更換節點。
| 狀況 | 常見原因 | 下一步 |
|---|---|---|
| HTTP 401 或 403 | 權杖失效、權限受限或存取遭封鎖 | 重新複製訂閱網址,確認帳戶狀態與服務說明 |
| HTTP 404 或 410 | 網址錯誤、舊介面已移除或資源失效 | 前往服務提供者的管理後台重新取得入口 |
| HTTP 429 | 短時間內更新過於頻繁 | 停止連續重試,依伺服器提示等待後再更新 |
| 狀態為 200,但顯示解析失敗 | 回傳 HTML、JSON 錯誤訊息或不相容的節點清單 | 查看回應開頭,確認內容是否為預期的設定 |
| unknown proxy type 等類型錯誤 | 目前的核心不支援節點協定,或轉換結果有誤 | 確認核心類型與節點參數,不要只更新介面程式 |
| 匯入成功,但沒有預期的策略群組 | 設定尚未啟用,或取得的檔案只有節點清單 | 確認目前選取的項目與完整設定結構 |
瀏覽器能開啟,不代表用戶端也能下載
瀏覽器可能帶有登入 Cookie,但訂閱下載器沒有;伺服器也可能依據 User-Agent 回傳不同內容。因此,請以用戶端實際取得的回應為準。若記錄中出現憑證過期或憑證鏈錯誤,請先檢查裝置時間、系統憑證與伺服器憑證狀態,不要把略過憑證驗證當成一般修復方式。
若要求逾時,請檢查訂閱網域是否能解析,以及用戶端更新訂閱時使用直連還是既有代理。若必須透過代理下載,可在保留可用舊設定的前提下,使用用戶端提供的代理下載選項。若沒有可用設定,請勿選擇依賴「下載新訂閱後才會出現」的出口,否則會形成循環依賴。
匯入後再確認四件事
- 確認目前使用的設定。核對選取項目、最近更新時間與載入記錄,避免發生「新訂閱已下載,執行中的仍是舊設定」的情況。若更新失敗,請先保留舊副本,確認新設定有效後再替換。
- 確認策略群組引用。在「代理」頁面檢查群組中是否有預期的節點;使用規則模式時,查看連線符合的規則與出口。全域模式測試通過,不代表分流規則正確。
- 確認流量入口。系統代理主要適用於遵循系統代理設定的 App,其他程式未必會使用;TUN 的接管範圍則會受到路由與排除項目影響。訂閱本身不會自動讓所有 App 都走代理。
- 確認更新設定。完整遠端設定通常由用戶端管理更新;
proxy-providers的interval則以秒為單位,例如3600代表一小時。兩者是不同的設定,實際更新間隔也應符合服務提供者的要求。
最後記住這個順序:先確認回應格式,再完成匯入並啟用,接著確認策略群組,最後檢查系統代理或 TUN。將這幾個環節分開,遇到問題時就能判斷該檢查網址、設定還是流量入口,不必每次都從重新安裝用戶端開始。