Clash 訂閱連結匯入教學:URL 匯入、本機 YAML 檔案與常見訂閱格式比較

整理桌面用戶端匯入訂閱的三種方式,比較 Clash YAML、Base64 節點清單等常見格式,並說明格式不相容時的轉換方法。

匯入前:先分清訂閱網址、設定檔與節點連結

Clash 訂閱是否匯入成功,取決於網址回傳的內容是否符合目前核心的設定要求,而不是連結是否以 .yaml 結尾。含有存取權杖的 HTTPS 網址可以回傳完整設定;名為 config.yaml 的下載連結,也可能實際回傳登入頁面或錯誤訊息。

桌面用戶端負責儲存訂閱、下載更新及切換設定;Clash 或 mihomo 核心則負責解析設定、建立連線與套用規則。介面顯示「下載成功」,只代表用戶端收到回應,不一定表示核心接受了其中所有欄位。

  • 訂閱 URL:用來取得內容的遠端網址。內容可能是完整的 Clash YAML,也可能是其他格式的節點集合。
  • 完整設定:通常包含 proxies 或 proxy-providers,並搭配 proxy-groups、rules 等設定。
  • 節點連結:例如以 ss://、vmess:// 或 trojan:// 開頭的單筆連線資訊,通常不包含分流規則。

方式一:透過 URL 匯入遠端訂閱

長期使用建議選擇遠端訂閱。用戶端儲存網址後,可重新取得節點與規則;本機檔案則只是某個時間點的副本。如果服務商提供「Clash」、「Clash Meta」或「mihomo」等選項,請先確認目前用戶端使用的核心,再複製相應網址。

在訂閱頁面下載並啟用

以下以 Clash Verge Rev 常見的介面名稱為例。不同版本可能將「訂閱」標示為「設定」,請依功能判斷入口,不要到節點選擇頁尋找訂閱匯入欄位。

  1. 開啟用戶端,進入左側的「訂閱」頁面,將完整的 HTTPS 網址貼到上方的訂閱連結欄位。
  2. 檢查網址前後是否有空格、換行或聊天軟體附加的標點,再按下「匯入」。不必將連結改成以 .yaml 結尾。
  3. 等待訂閱卡片建立。若出現錯誤,先查看下載或解析訊息,不要連續重複新增相同網址。
  4. 點選對應的訂閱卡片,將其設為目前使用的設定。部分用戶端會將這項操作稱為「使用」或「啟用」。
  5. 前往「代理」頁面,確認策略組已顯示,再選擇要使用的節點。完成匯入不代表系統代理已啟用。

部分服務頁面提供「一鍵匯入」,實際上是透過自訂 URL 通訊協定開啟用戶端。這需要系統已註冊對應的通訊協定處理程式。點擊後沒有反應時,改用手動複製訂閱網址,比較容易判斷是系統未能開啟用戶端,還是訂閱本身無法下載。

逐項確認更新選項

在訂閱卡片的選單中開啟「編輯」或訂閱設定,確認更新間隔與下載時使用的代理選項。自動更新是用戶端功能,不由頂層 rules 決定。若介面單位是分鐘,360 代表 6 小時;若單位是秒,則應填入 21600。這只是設定範例,並非所有用戶端的預設值。

首次匯入時可能還沒有可用的代理;若強制讓訂閱下載透過代理,可能形成依賴循環。只有在確認直連無法取得內容,且已有可用出口時,再嘗試調整更新代理選項。頂層遠端訂閱的更新週期,也不可與 proxy-providers 中的 interval 混淆:後者是核心取得提供器內容的間隔,單位為秒。

方式二:匯入本機 YAML 設定檔

服務商直接提供設定檔、需要離線備份,或正在排查遠端下載失敗時,適合使用本機匯入。透過檔案選擇器匯入後,用戶端通常會管理自己的設定副本;之後修改原始下載檔,不一定會同步到目前使用中的設定。

  1. 將設定檔儲存至容易找到的位置,例如 Windows 的「下載」資料夾,並確認副檔名為 .yaml 或 .yml,而不是隱藏副檔名後的 .yaml.txt。
  2. 進入用戶端的「訂閱」或「設定」頁面,選擇「匯入本機檔案」;支援拖放的版本也可以將檔案拖曳到該頁面。
  3. 選取檔案、儲存後啟用該設定。若出現解析錯誤,請用文字編輯器查看錯誤所在行及前一行。
  4. 開啟策略組與記錄,確認載入結果。若修改的是用戶端外部的檔案,請重新匯入,或使用用戶端明確提供的重新載入功能。

YAML 格式正確,不代表設定適用於代理連線

以下是用來理解結構的最小範例。它只有直連出口,沒有代理節點,也不能取代服務商提供的訂閱。這裡明確指定 mixed-port: 7890 作為 HTTP 與 SOCKS 共用連接埠,並非所有用戶端的出廠預設值。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info

proxies: []

proxy-groups:
  - 手動選擇
    type: select
    proxies:
      - DIRECT

rules:
  - MATCH,手動選擇

YAML 縮排請使用空格,不要使用 Tab。清單項目以 - 開頭,鍵和值之間須使用正確的冒號與空格。即使一般 YAML 解析器判定語法有效,核心仍可能因策略名稱不存在、協定欄位不支援或缺少驗證參數而拒絕載入。

方式三:從剪貼簿匯入設定或節點內容

已取得完整設定文字,或用戶端明確支援辨識單筆節點連結時,適合從剪貼簿匯入。各用戶端支援的功能差異很大:「貼上訂閱網址」與「從剪貼簿解析節點」是兩種不同功能,不能只因為都使用複製貼上就當成相同入口。

  • 完整 YAML 文字:若用戶端支援「新增本機設定」或設定編輯器,可先建立本機設定,再貼上內容、儲存並啟用。
  • 單筆節點連結:只有在選單明確提供「從剪貼簿匯入」且支援該協定時才使用。匯入後也要確認節點加入了哪個設定與策略組。
  • 多行節點清單:需要用戶端具備批次解析功能。若不支援,請先轉換為相容的設定,不要直接將節點清單貼到訂閱 URL 欄位。

如果目前版本沒有文字匯入入口,請先將完整 YAML 儲存為 UTF-8 編碼的本機檔案,再依本機檔案流程匯入。不要將 YAML 轉成單行,也不要手動刪除縮排。能辨識單筆節點,不代表用戶端會自動建立符合預期的 DNS、規則與策略組。

訂閱格式比較:Clash YAML、Base64 與提供器檔案

「訂閱」指的是取得與更新內容的方式,並非單一檔案格式。判斷是否相容時,應同時檢查內容結構、協定類型與核心支援範圍。副檔名和網頁上的按鈕名稱只能作為參考。

內容類型 常見特徵 匯入前判斷
完整 Clash YAML 包含節點或提供器,以及策略組、規則等設定項目 通常可作為設定匯入;仍須確認欄位與協定是否受核心支援
Base64 節點清單 外層是一段編碼文字,解碼後通常可見多行節點 URI 通常不能直接作為完整 Clash 設定載入,需由用戶端辨識或轉換
單筆節點 URI 以 ss、vmess、trojan 等協定名稱開頭 需透過用戶端的協定匯入功能,不包含完整的規則架構
代理提供器 YAML 常見頂層欄位為 proxies:,內容主要是節點清單 通常由 proxy-providers 引用,不應直接當作完整設定
其他用戶端設定 可能是 JSON 或採用另一套欄位結構 改副檔名不會讓格式相容,需確認轉換工具是否支援來源格式

Base64 是編碼方式,不是協定相容層

將 Base64 解碼只能還原編碼前的文字,不會自動把節點 URI 轉成 Clash YAML 欄位,也不會補上規則、DNS 與策略組。部分節點 URI 的某些片段也會使用 Base64;不能只因為看到一長串字元,就認定整個回應都是 Base64 訂閱。

Clash 與 mihomo 的相容範圍並不完全相同

mihomo 延續並擴充了 Clash Meta 的功能。為 mihomo 產生的設定,可能包含舊版 Clash 不支援的協定或參數。因此,服務商提供多種目標格式時,請依照用戶端目前使用的核心選擇。核心不支援某個節點時,只修改設定中的協定名稱也無法讓它運作。

格式不相容時:先選原生輸出,再考慮轉換

最直接的處理順序是:先確認服務商是否提供目標格式,再檢查用戶端核心,最後才考慮轉換。轉換工具只能調整設定的表達方式,無法改變遠端伺服器支援的協定,也無法補回原始資料中缺少的驗證資訊。

  1. 優先使用原生訂閱:在服務商頁面選擇符合目前核心的 Clash 或 mihomo 輸出格式,再重新複製完整網址。
  2. 確認來源內容:分辨節點 URI、Base64 清單、完整 YAML 與提供器檔案。不要將網頁 HTML 當成訂閱內容交給轉換工具。
  3. 選擇可信任的轉換環境:優先使用服務商提供的轉換入口,或在自己掌控的本機環境執行轉換工具。遠端轉換服務可能會接觸訂閱權杖與節點憑據。
  4. 確認目標格式與範本:確認輸出是完整設定還是節點提供器,並檢查產生的策略組名稱、規則出口與 DNS 設定。
  5. 匯入後逐項驗證:先確認設定能否載入,再檢查節點與策略組是否完整,最後測試實際連線。不要只看轉換頁面是否顯示成功。

轉換後的設定可能遺失來源格式專有欄位,也可能以範本中的規則取代原有規則。尤其要確認 UDP、TLS、傳輸層及憑證相關參數是否保留。遇到憑證錯誤時,請檢查裝置時間、伺服器名稱與服務商說明,不要把關閉憑證驗證當成通用的轉換步驟。

匯入錯誤與生效檢查:依下載、解析、路由順序排查

分開處理下載失敗與內容錯誤

  • HTTP 401 或 403:確認訂閱權杖是否失效、網址是否完整複製,以及服務商是否設有存取限制;不要只是不斷調整本機代理連接埠。
  • 要求逾時:檢查網路連線、訂閱網域解析與更新代理選項。瀏覽器能開啟服務商首頁,不代表一定能連上訂閱介面。
  • 回應內容以 HTML 開頭:可能取得的是登入頁面、驗證頁面或錯誤頁面。即使 HTTP 狀態碼為 200,也可能回傳這些內容;請檢查實際回應,而非只看狀態碼。
  • 提示找不到代理或策略:檢查 proxy-groups 中引用的名稱,以及規則結尾的出口名稱是否確實存在;大小寫與空格也必須一致。
  • 不支援的代理類型或欄位:確認實際使用的核心與訂閱目標格式。更換介面主題或重新命名檔案,都無法修復核心相容性問題。

設定已啟用,還要確認應用程式的流量是否經過用戶端

  1. 在用戶端確認目前設定名稱正確,並確認使用的是規則模式,而不是誤切換至直連模式。
  2. 開啟需要使用的策略組,選擇可用節點。延遲測試成功只代表測試請求收到回應,不保證所有網站與協定都能正常使用。
  3. 對於遵循系統代理設定的桌面應用程式,請啟用用戶端的「系統代理」。若手動設定代理,請確認實際監聽位址與連接埠;設定為 mixed-port: 7890 時,本機可使用 127.0.0.1:7890。
  4. 在瀏覽器重新發出一次請求,同時查看「連線」或「記錄」,確認目標網域、符合的規則與最終出口。必要時先關閉舊連線再重試。

不遵循系統代理設定的應用程式可能需要透過 TUN 模式接管流量,但這屬於匯入後的路由設定。TUN 能否運作也受服務權限、路由與 DNS 設定影響;它無法修復錯誤的訂閱格式,也不會替空白設定新增節點。

下載Clash依作業系統選擇安裝檔