Clash 訂閱連結匯入教學:URL、YAML 與 Base64 格式差異
示範如何在用戶端貼上訂閱網址並設定自動更新,說明完整 YAML 設定與 Base64 節點清單的差異,以及格式不相容時的處理方式。
URL 是取得資源的網址,YAML 與 Base64 則是內容格式
Clash 訂閱匯入失敗時,請先分辨「網址是否能連線」與「回傳內容是否能解析」。URL 是遠端資源的網址;YAML 是設定檔格式;Base64 則是一種編碼方式。三者屬於不同層次,不能簡單視為三種互斥的訂閱類型。HTTPS 訂閱網址可能回傳完整 YAML、經 Base64 編碼的節點清單,也可能回傳登入頁面。
使用 mihomo 核心的用戶端,建議優先選擇服務提供商標示為 Clash Meta 或 mihomo 的訂閱入口。名稱僅代表目標相容範圍,實際上仍須確認回傳欄位是否受本機核心支援。用戶端能儲存 URL,不代表它能解析該網址回傳的內容。
| 收到的內容 | 通常包含項目 | 匯入位置與限制 |
|---|---|---|
| 訂閱 URL | 通訊協定、伺服器網址、路徑及驗證權杖 | 貼到遠端設定入口,由用戶端請求實際內容 |
| 完整 YAML 設定 | 節點或節點提供器、代理群組、規則及選用的 DNS 設定 | 可載入為設定檔,但仍須檢查欄位與策略參照 |
| 節點提供器 YAML | 常見格式是頂層的 proxies: 節點清單 |
通常由 proxy-providers 參照,並非完整的主設定檔 |
| Base64 節點清單 | 編碼後的多行節點 URI,例如 ss://、vmess:// |
必須由用戶端明確支援解析,或先轉換為目標核心支援的設定格式 |
匯入前先準備訂閱網址與相容的核心
- 確認用戶端核心。在「關於」或「設定」的核心資訊中,查看是否使用 mihomo。圖形介面用戶端版本與核心版本是不同的版本號,回報相容性問題時請分別記錄。
- 從服務管理頁面複製專用入口。選擇標示為 Clash、Clash Meta 或 mihomo 的網址;不要複製方案頁面、登入頁面或瀏覽器目前網址列中的網址。
- 保留查詢參數。網址中從
?開始的 token 或格式參數,可能用於驗證或選擇內容,不能只保留網域和路徑。 - 移除複製時附帶的字元。刪除前後空格、換行和中文引號。請勿任意修改網址中的百分比編碼、大小寫或參數順序。
訂閱網址通常沒有 .yaml 副檔名。伺服器可能根據路徑、查詢參數或請求標頭決定回傳格式,因此無法從檔名判斷相容性。瀏覽器能開啟管理後台,也不代表用戶端請求訂閱介面時會有相同的登入狀態。
如果網址已經外洩,請前往服務管理頁面重設訂閱權杖,再更新用戶端中的舊網址。只刪除聊天紀錄或本機設定,無法撤銷已被複製的憑證。
在用戶端貼上 URL 並啟用設定
不同用戶端的按鈕名稱可能不同,但整個流程可分為「新增遠端設定、下載內容、選取設定、選擇策略」四個步驟。以下以常見的「設定」頁面為例;如果介面使用「訂閱」或「Profiles」,請前往相應的遠端設定清單,而非節點貼上欄位。
首次匯入的操作步驟
- 開啟「設定」,在訂閱網址欄位貼上完整 URL;若沒有直接輸入欄位,請選擇「新增」,並將類型設為「遠端」。
- 設定容易辨識的名稱,例如「日常訂閱」,再按一下「匯入」或「儲存」。等待下載完成,請勿連續重複送出。
- 確認設定卡片上已顯示更新時間。按一下卡片或選擇「使用此設定」,將它設為目前使用的設定;只下載到清單中不一定會自動啟用。
- 前往「代理」頁面,確認是否顯示代理群組及節點清單。選擇目標節點,先測試一次延遲,再嘗試實際連線。
- 依實際需求啟用系統代理。只有需要接管不遵循系統代理設定的流量時,才另外設定 TUN 模式及相關權限。
「匯入成功」、「設定已啟用」和「流量經過代理」是三個不同的檢查項目。匯入成功只表示檔案已取得並經過相應處理,不能證明節點可連線。系統代理或 TUN 模式負責接入流量,規則與代理群組則負責後續分流;啟用 TUN 也無法修正錯誤的訂閱格式。
匯入後要檢查哪些欄位
proxies或proxy-providers:確認是否有節點來源,以及節點名稱是否正常顯示。proxy-groups:確認規則參照的策略群組是否存在,以及群組內是否有可選項目。rules:確認是否包含預期的分流規則,以及最後是否有處理其餘流量的策略。- 本機監聽連接埠:以用戶端目前顯示的設定為準,請勿直接套用其他教學中的
7890。
如何區分完整 YAML 設定與節點清單
YAML 描述的是資料結構,不代表內容完整。只有 proxies: 的檔案可能是供主設定檔參照的節點資源,也可能需要用戶端補上代理群組與規則。這不一定代表語法錯誤,但若直接作為主設定檔使用,可能缺少必要的代理選擇入口或分流行為。
以下是一份用來說明層級關係的最小設定。它只提供直連策略,沒有遠端節點,適合用來對照欄位,不應視為可用的代理訂閱。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
proxies: []
proxy-groups:
- name: 出口選擇
type: select
proxies:
- DIRECT
rules:
- MATCH,出口選擇
mixed-port: 7890 表示 HTTP 與 SOCKS 共用本機入口;mode: rule 表示依規則分流;最後一條規則會將其餘連線交給「出口選擇」。此處的群組名稱必須與規則中的名稱一致。實際用戶端可能透過執行階段設定覆寫連接埠與模式,因此也應檢查最終生效的設定。
若遠端資源要用於 proxy-providers,主設定檔必須定義提供器,並讓代理群組透過 use 參照它。更新提供器與更新整份 Profile 是不同層級的操作。不要將完整主設定檔網址任意填入節點提供器欄位,也不要假設目前的核心能直接讀取任何 Base64 清單作為提供器。
Base64 解碼後仍不是完整設定
常見的 Base64 訂閱解碼後會得到多行節點 URI。每一行描述一個節點的通訊協定、伺服器、連接埠及驗證參數,但通常不包含 rules、DNS 或代理群組。解碼只是還原文字,不會自動建立 Clash 所需的設定結構。
另一個容易混淆的地方是,vmess:// 節點 URI 本身也可能包含 Base64 編碼內容。這與「整份訂閱以 Base64 編碼」並非同一層次。反覆解碼整段文字,無法取代依訂閱格式進行解析。較穩妥的做法是重新取得服務提供商提供的 mihomo 專用入口。
設定自動更新並保留自訂規則
首次匯入並確認可用後,再啟用自動更新。在設定卡片的「編輯」或「設定」中尋找「自動更新」、「更新間隔」等選項。若欄位單位為分鐘,輸入 360 代表每 6 小時更新一次;若明確要求秒數,同一週期應輸入 21600。兩種單位不可混用。
- 先手動執行一次「更新」,確認訂閱網址仍有效,且更新時間已變更。
- 設定合理的更新週期,例如每 6 小時一次;若服務提供商有頻率限制,請依其規定設定。
- 確認是否支援「啟動時更新」或失敗重試。用戶端關閉時,通常不會繼續執行內部排程;裝置進入休眠時,更新也可能延後。
- 更新後請檢查目前選取的節點、代理群組與規則。節點更名或移除後,原先選取的項目可能無法保留。
不要長期直接修改遠端訂閱下載的 YAML 中的規則。下次更新時,這些修改可能會被覆蓋。如果用戶端提供覆寫、合併或指令碼功能,請將自訂內容放在對應位置,並確認更新後仍會納入最終生效的設定。各用戶端的合併順序不同,不能只因編輯器中有一段規則,就認定它已生效。
訂閱無法匯入時,依錯誤類型排查
| 提示或現象 | 優先檢查項目 | 處理步驟 |
|---|---|---|
| HTTP 401 或 403 | 權杖失效、存取權限或服務端限制 | 從管理頁面重新複製網址;確認帳號狀態,必要時聯絡服務提供商查明拒絕原因 |
| HTTP 429 | 更新請求過於頻繁 | 停止連續重試,依服務提供商的限制等待,並延長自動更新週期 |
| HTTP 200,但解析失敗 | 回應內容可能是 HTML 登入頁面、JSON 錯誤訊息或節點清單 | 在本機檢視回應內容的開頭,確認取得的是目標格式,不要只看狀態碼 |
| YAML 行號錯誤 | 縮排、定位字元、冒號或內容遭截斷 | 對照錯誤行及其上一行;使用空格縮排,並重新下載原始檔案比對 |
| 不支援的代理類型或欄位 | 設定目標與本機核心不相容 | 確認核心版本,改用相容的入口,或升級至支援該功能的用戶端與核心 |
| 下載逾時或 TLS 錯誤 | DNS、網路路由、系統時間與憑證信任 | 先校正系統時間,再檢查連線記錄與網路;不要長期關閉憑證驗證來規避問題 |
格式不相容時的處理順序
先回到服務頁面尋找正確的格式入口,再確認用戶端是否提供明確標示的節點清單匯入功能,最後才考慮轉換。轉換工具只能處理其支援的通訊協定與欄位;來源資料缺少的傳輸參數、TLS 設定或規則,無法憑空補齊。
優先使用服務提供商提供的轉換功能,或在本機執行可信任的工具。將含 token 的 URL 提交給公開轉換服務,等同將讀取訂閱的權限交給該服務。轉換結果仍須檢查代理類型、傳輸設定、代理群組與規則;不能以「檔案可以儲存」作為相容性判斷。
匯入完成後的三項驗證
- 驗證更新流程。手動更新一次並記錄成功時間;若更新失敗,請保留舊設定,先排除訂閱請求錯誤,避免設定仍可用時反覆刪除重建。
- 驗證策略流程。選擇明確的代理群組與節點,開啟目標網站,並在連線記錄中確認命中的規則、策略及連線結果。延遲測試有數值,不代表所有網站都能連線。
- 驗證流量入口。確認目標應用程式是否遵循系統代理設定;有需要時再設定 TUN。檢查出口資訊時,請搭配記錄判斷,不能只因某個請求命中直連規則,就推斷整份設定失效。
完成這三項驗證後,再安排定時更新與自訂規則。將訂閱取得、設定解析、節點連線及系統流量接入分開檢查,能縮小「匯入成功卻無法上網」的問題範圍。完整的連線與連接埠說明,請參閱使用指南;調整規則則可參考自訂規則說明。