入門指南 預計閱讀 9 分鐘

訂閱連結匯入 Clash 客戶端:3 種方式與 YAML、Base64 格式比較

了解如何貼上 URL、匯入本機檔案或掃描 QR Code,並比較 Clash YAML 與 Base64 節點清單訂閱,以及更新間隔設定。

匯入前:確認拿到的是訂閱網址還是單一節點

Clash Verge Rev 的設定頁可用來管理設定檔。遠端訂閱是一個可回傳設定內容的網址;用戶端會存取該網址、下載設定,再交由核心載入。訂閱服務負責提供節點與相關設定,用戶端則負責取得、解析及使用,兩者並不相同。

先確認服務提供者提供的匯出類型。優先選擇標示為「Clash」、「Clash Meta」或「mihomo」的訂閱,並確認適用於目前使用的核心。Clash Verge Rev 使用 mihomo 核心,但這不代表它能自動將任意協定連結或其他用戶端的設定轉換成可用的 YAML。

  • 網址以 https:// 開頭:可能是訂閱網址,也可能只是帳戶頁面。是否可用,取決於請求實際回傳的內容。
  • 網址以 ss://、vmess:// 或 trojan:// 開頭:通常是單一節點分享連結,不等於完整的 Clash 設定。
  • 檔案以 .yaml 或 .yml 結尾:可能是設定檔,但僅憑副檔名無法確認內容完整或語法正確。
  • QR Code:只是承載文字的方式。內容可能是訂閱網址、單一節點連結,也可能是用來開啟其他用戶端的專用連結。

方式一:在設定頁貼上訂閱 URL

遠端 URL 適合長期使用:節點有變動時,可透過原網址重新取得。操作前請先複製完整網址,不要連同網頁按鈕旁的說明文字一起選取,也不要刪除問號後面的參數。

  1. 開啟 Clash Verge Rev,進入左側的「設定檔」頁面。
  2. 找到訂閱連結輸入欄位,貼上服務提供者提供的 Clash 或 mihomo 訂閱網址。
  3. 按一下「匯入」,等待設定卡片建立。按鈕位置可能因用戶端版本而異,請以目前介面上的名稱為準。
  4. 選取剛匯入的設定卡片,將它設為目前使用的設定。卡片出現不代表已完成切換。
  5. 進入「代理」頁面,確認策略群組與節點是否出現,再依需求選取節點或自動選擇群組。

匯入成功後,分別確認設定與流量

第一步,確認設定是否能載入:記錄中不應持續出現 YAML 解析錯誤,或策略群組引用不存在的節點。第二步,再確認流量入口:一般瀏覽器通常需要開啟「系統代理」;不遵循系統代理設定的應用程式,可能需要個別設定代理或使用 TUN 模式。不要把「網頁無法開啟」直接當成「訂閱匯入失敗」。

測試時可先只啟用一種流量接管方式,減少排查變因。在「連線」頁查看目標請求命中的規則及使用的策略群組。節點延遲測試有結果,只能代表該測試請求的狀況,不代表所有網站、協定和應用程式都正常。

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

本機檔案適合離線移轉、保留已知可用的設定,或測試手動撰寫的規則。在「設定檔」頁使用「新增」或檔案匯入功能,選擇本機類型並匯入檔案;實際入口名稱可能因版本而異。若目前版本支援拖放檔案,也可依介面提示操作,但不要假設所有版本都提供拖放入口。

  1. 請從可信任的來源取得 YAML 檔案,並用文字編輯器確認內容是設定文字,而非登入頁面、錯誤訊息或下載說明。
  2. 保留原始副本,並檢查檔案是否包含 proxies、proxy-groups、rules 等實際需要的設定區段。
  3. 匯入後選取該設定,再查看記錄與代理頁面。若遇到解析錯誤,請優先檢查縮排、冒號及策略群組名稱。

本機設定通常沒有可供定時擷取的遠端來源。服務商新增節點或變更密碼後,舊檔案不會自動更新,必須重新取得並匯入。若檔案內設定了遠端 proxy-providers,這些提供者可以依各自的設定更新;但這是更新檔案內的資源,不是替換整份本機檔案。

用最小設定範例理解 YAML 結構

以下是用來辨識欄位與縮排的最小範例,所有連線皆採直連,不提供代理節點。7897 是範例混合連接埠,實際監聽值請以用戶端「設定」中的連接埠設定及最終生效的設定為準。

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

proxies: []

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

rules:
  - MATCH,手動選擇

YAML 以縮排表示層級。此處使用兩個空格,不可用定位字元取代縮排。rules 中引用的「手動選擇」必須與策略群組名稱一致;若變更群組名稱卻未同步修改規則,就會造成引用錯誤。線上訂閱檔案也可能受到用戶端覆寫設定影響,編輯原始檔案前,請先確認修改是否會在下次更新時被覆蓋。

方式三:掃描 QR Code,辨識內容後再匯入

掃描 QR Code 的重點是讀取其中的文字,並非另一種設定格式。若目前的桌面版本沒有掃描功能,可使用手機或本機 QR Code 辨識工具讀取文字,再透過可信任的方式將訂閱 URL 傳到電腦,回到「設定檔」頁面貼上並匯入。請勿將含有權杖的 QR Code 上傳至不明的線上辨識網站。

  • 辨識結果是 HTTPS 訂閱網址:確認網域與服務提供者相符,再依 URL 匯入流程操作。
  • 辨識結果是單一節點 URI:回到服務提供者處選擇 Clash 或 mihomo 訂閱匯出。請勿將單一節點網址當成完整 YAML。
  • 辨識結果是用戶端專用的啟動連結:確認目標用戶端及操作內容。若沒有對應的通訊協定處理程式,瀏覽器就無法啟動該用戶端,此時可改用原始訂閱網址。

從手機複製到電腦後,請確認網址未被聊天工具截斷,也沒有混入換行、中文標點或尾端空格。QR Code 辨識成功只代表文字可讀,不能證明訂閱仍有效,也不能確認回傳格式適用於 Clash Verge Rev。

YAML 與 Base64:設定結構和編碼方式的差異

Clash YAML 是具有欄位層級的設定文字,可描述節點、策略群組、規則及 DNS 等內容。Base64 則是一種編碼方式,並非代理協定,也不等於加密。常見的「Base64 訂閱」解碼後會是多行節點分享連結,通常不包含完整的 Clash 策略群組與分流規則。

比較項目Clash YAML常見的 Base64 節點清單
文字格式欄位、冒號、縮排與清單編碼文字,解碼後通常是多行 URI
節點定義通常位於 proxies 或代理提供者中通常由每條分享連結描述
策略與規則可包含 proxy-groups 與 rules通常需要另外產生
匯入方式確認核心支援相關欄位與協定後再載入優先向來源取得 Clash 格式的匯出內容
隱私風險可能包含節點密碼與遠端資源網址解碼後即可讀取,請勿公開分享

不要只改副檔名來轉換格式

將 Base64 文字存成 subscription.yaml,不會產生 proxies 和 rules。同樣地,把檔名從 .txt 改成 .yaml,也無法修正語法。判斷依據始終是檔案內容,而非檔名、下載按鈕上的圖示或 URL 結尾。

同一個訂閱服務可能依匯出選項、請求參數或 User-Agent 回傳不同內容。瀏覽器看到節點清單,而用戶端取得 YAML,不一定代表發生異常。請優先使用服務提供者明確提供的 Clash 匯出網址。若確實需要轉換,請選擇可信任且了解其資料處理方式的工具;轉換服務可能接觸訂閱中的敏感資訊,請勿隨意提交。

更新間隔:區分遠端設定與代理提供者

遠端設定的更新頻率可在設定卡片的編輯介面中設定。操作路徑通常是「設定檔」→ 對應卡片的選單或按右鍵開啟選單 →「編輯」,再找出更新間隔欄位。不同版本的欄位名稱與單位可能不同,填寫前請先確認標示:若單位是分鐘,360 代表六小時;若單位是秒,六小時應填入 21600。不要直接照抄其他版本截圖中的數值。

一般可先設為每六小時更新一次,再依服務提供者的建議調整。節點短時間內沒有變動,就不必每分鐘擷取;更新過於頻繁可能觸發請求限制。可先手動按一次「更新」並確認結果,再觀察自動更新是否正常運作。自動更新通常需要用戶端保持執行且網路連線正常;電腦關機或休眠時,無法將它視為一般的線上排程工作。

proxy-providers 的 interval 單位為秒

mihomo 設定中的 HTTP 代理提供者可用 interval 控制更新週期,單位為秒。例如 interval: 3600 表示每小時擷取一次提供者內容。這只會影響該提供者,並不等於用戶端每小時重新下載整份遠端設定。提供者的健康檢查另有獨立的間隔,用於測試節點,請勿與訂閱更新混為一談。

匯入失敗:從請求、內容與載入三個階段排查

  1. 先確認請求是否成功。連線逾時時,先檢查網路與訂閱網域解析;HTTP 401 或 403 時,確認權杖、授權狀態及伺服器端存取限制;429 代表請求過於頻繁,請稍候並降低更新頻率。不要連續按下匯入。
  2. 接著確認回傳內容。HTTP 200 也可能回傳登入頁面或錯誤頁面。若內容以 <!DOCTYPE html> 開頭,請檢查是否複製了帳戶頁面,或請求是否被重新導向至驗證頁面。
  3. 再確認設定解析狀況。若出現 YAML 行號錯誤,請檢查該行及上一行的縮排、引號與冒號。若節點類型不受支援,請確認匯出目標與目前核心支援的功能,不要反覆修改監聽連接埠。
  4. 最後確認設定是否已啟用。若代理頁面沒有預期的節點,請先確認目前選取的設定,再檢查它是否只引用了尚未成功下載的代理提供者。

匯入、更新與代理連線是三個不同階段。訂閱下載失敗時,啟用 TUN 不一定能解決問題;節點連線失敗時,重新匯入同一份設定也未必有效。請先記下失敗時間、當時的操作及記錄中的關鍵錯誤,再一次只變更一項設定,並比較前後結果。

完成後可簡單確認一次:已選取設定卡片、代理頁面顯示預期的策略群組、手動更新成功,且能在連線頁面看到實際請求的正確路由。新手也可參考用戶端入門教學,確認系統代理設定與首次連線步驟。

Clash 用戶端下載