匯入前:先確認連結內容與用戶端核心

開啟用戶端的「訂閱」或「設定」頁面,再選擇透過 URL、剪貼簿或本機檔案匯入。這三種方式只是將設定檔載入用戶端的入口;能否正常使用,取決於回傳內容的格式、核心支援的協定,以及設定是否已啟用。取得服務商提供的連結後,優先選擇標示為「Clash」、「Clash Meta」或「mihomo」的訂閱。

  • 遠端 URL:適合長期使用。用戶端會儲存來源網址,之後可手動更新或依設定的間隔自動更新。
  • 剪貼簿:適合從瀏覽器複製內容後快速匯入。請先確認複製的是連結、完整 YAML,還是單一節點 URI。
  • 本機檔案:適合接收設定檔、離線檢查或保存快照。一般本機設定檔不會隨原訂閱網址自動更新。

本文以採用 mihomo 核心的桌面用戶端為例,Clash Verge Rev 的入口通常位於「訂閱」頁面。其他用戶端可能將類似入口命名為「設定」、「Profiles」或「遠端設定」,按鈕名稱也可能因版本而異。macOS、Windows 與 Android 的匯入原理相同,但系統代理與 VPN 權限屬於後續步驟,不必在貼上連結前一併開啟。

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

貼上網址、下載設定檔並啟用

  1. 在服務商的訂閱頁面選擇適用於目前核心的格式,再複製訂閱網址。請複製連結本身,而不是帳戶管理頁面的網址。
  2. 開啟用戶端的「訂閱」頁面。若頁面上有「訂閱連結」輸入欄位,直接貼上網址;若需透過新增視窗操作,請點選「新增」,選擇「遠端」類型後輸入 URL。
  3. 檢查網址開頭與結尾是否多了空格、換行或中文標點。請保留原始查詢參數,不要任意刪除問號後的內容。
  4. 點選「匯入」或儲存遠端設定,並等待設定卡片出現。匯入成功後,應能看到設定名稱或更新時間,而不只是空白的輸入欄位。
  5. 選取剛匯入的設定,再前往「代理」頁面查看策略組。匯入成功不代表已啟用;清單中出現設定卡片,也不代表核心已切換至該設定。

首次下載通常需要目前的網路能連線至訂閱伺服器。若用戶端的下載設定提供「直連」、「系統代理」或其他請求方式,請依實際網路狀況選擇。若現有代理已失效,強制透過該代理下載訂閱可能造成循環:更新需要代理,但代理本身又等待更新。可先嘗試直連更新,或改用能連線至訂閱伺服器的網路。

匯入後先查看記錄,再測試網頁

查看記錄是否出現設定解析錯誤,再確認策略組中是否有可選節點。執行模式先選擇「規則」,需要接管瀏覽器流量時再啟用系統代理。一般 HTTP 代理入口無法接管所有應用程式的 UDP 流量;是否啟用 TUN,建議等基本連線測試完成後再決定。

如果設定中指定了 mixed-port: 7890,HTTP 與 SOCKS 用戶端可以共用同一個本機連接埠,但圖形介面用戶端可能會以自身的連接埠設定覆寫它。請以設定頁實際顯示的監聽位址與連接埠為準,不要只憑網路上的範例就認定本機一定是 127.0.0.1:7890。

方法二:從剪貼簿匯入連結或設定文字

先確認剪貼簿中的內容,再使用相應的匯入入口。macOS 的複製與貼上快捷鍵分別為 ⌘C、⌘V;Windows 則是 Ctrl+C、Ctrl+V。快捷鍵只能傳遞文字,不會自動將節點連結轉換成完整的 Clash 設定。

複製的內容建議使用的入口檢查重點
以 https:// 開頭的訂閱網址遠端訂閱 URL 輸入欄位是否保留完整權杖與參數
包含 proxies: 等欄位的 YAML 文字本機設定編輯器或文字匯入功能縮排是否完整,以及是否混入說明文字
ss://、vmess:// 等節點 URI用戶端明確提供的節點匯入功能是否支援該協定及節點轉換
一長串 Base64 文字先確認來源與編碼內容不可直接假設內容是完整的 YAML
  1. 若複製的是 URL,請返回「訂閱」頁面貼上並匯入,之後仍依遠端訂閱方式管理。
  2. 若複製的是完整 YAML,請前往本機設定的新增或編輯入口。若用戶端沒有文字匯入功能,可使用純文字編輯器將內容儲存為 .yaml 檔案,再透過本機檔案匯入。
  3. 若只有單一節點 URI,請先確認用戶端是否支援該協定的節點匯入。完整設定通常還需要策略組與規則,節點參數無法取代這些內容。

從通訊軟體複製程式碼時,請勿連同程式碼圍欄、行號或「點擊複製」等介面文字一起貼上。YAML 使用空格縮排,Tab 字元容易導致解析失敗。文字編輯器的智慧引號或富文字格式也可能改動原始內容,儲存時請選擇 UTF-8 純文字。

方法三:匯入本機 YAML 檔案

在「訂閱」或「設定」頁面尋找「匯入檔案」,選取磁碟中的 .yaml 或 .yml 檔案;部分用戶端也支援拖放檔案。匯入後選取該設定,再檢查記錄與策略組。檔案選擇器支援哪些副檔名,請以用戶端介面提示為準。

先辨識檔案內容,再確認是否可用

檔名為 config.yaml 只能表示命名意圖,內容仍可能是下載失敗後取得的 HTML 網頁。請用文字編輯器開啟檔案;如果開頭是 <!doctype html>、登入提示或 JSON 錯誤訊息,應回到下載來源處理驗證與存取問題,而不是繼續修改 YAML 縮排。

以下是用來辨識設定結構的最精簡直連範例。這份設定沒有代理節點,只適合觀察欄位與解析行為;用它取代訂閱設定並不會建立代理連線。

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

rules:
  - MATCH,DIRECT
  • mixed-port 是 HTTP 與 SOCKS 共用的本機監聽連接埠;若連接埠已被占用,請調整設定或用戶端選項。
  • allow-lan: false 會限制區域網路存取。確實需要共用時,再檢查監聽位址、防火牆與驗證設定。
  • MATCH,DIRECT 會讓其餘流量直接連線,不代表已選取任何代理節點。

本機檔案是快照,遠端資源仍可能需要網路

一般本機設定不會透過訂閱 URL 自動更新。服務商變更節點密碼或伺服器位址後,需要重新匯入或手動維護本機設定。不過,若檔案內宣告了遠端 proxy-providers 或 rule-providers,這些資源仍可能各自透過網路更新;「從本機檔案匯入」不代表執行時完全離線。

需要長期保留的分流修改,建議優先使用用戶端提供的覆寫、合併或指令碼機制。直接編輯遠端訂閱下載的內容,下一次更新時可能會被覆寫。套用覆寫後也應檢查最終生效的設定,確認策略組名稱與規則引用仍相符。

格式比較:Clash YAML、Base64 與節點 URI

訂閱 URL 是取得內容的網址;YAML 與 Base64 則描述內容結構或編碼方式。即使兩個網址都以 HTTPS 開頭,回傳內容也可能完全不同。排查「訂閱網址能開啟,但匯入失敗」時,請先查看回傳本文,而不是只看副檔名。

格式常見內容匯入注意事項
完整 Clash YAML節點、策略組、規則等設定欄位核心必須支援其中的協定與欄位
節點提供者 YAML以 proxies: 為主的節點清單通常透過 proxy-providers 加入主設定
Base64 訂閱常見內容為編碼後的多行節點 URI需依賴用戶端的轉換功能,不能只改副檔名
單一節點 URI單一伺服器的協定與連線參數通常還需要建立策略組與分流規則

Base64 是編碼,不是加密,也不是統一的代理設定規範。解碼後可能是多行節點連結,也可能是其他文字;能否使用取決於實際內容與用戶端支援情況。將檔名從 .txt 改為 .yaml,不會完成格式轉換。

Clash Meta(現稱 mihomo)支援的協定與欄位範圍,和舊版 Clash 核心並不完全相同。遇到不支援的節點類型時,請先確認目前執行的核心,再向訂閱來源選擇相應格式。若服務商同時提供 Clash 與 mihomo 入口,使用 mihomo 核心時,優先選擇明確標示相容的入口。

自動更新間隔:分別設定訂閱與 provider

在遠端訂閱卡片的選單中開啟「編輯」或更新設定,尋找「更新間隔」。先確認輸入欄位旁的單位:若是分鐘,輸入 360 代表每 6 小時;若是秒,則應輸入 21600。兩個數值代表相同時長,請勿忽略單位直接照填。

  1. 先手動更新一次,確認目前 URL 可連線且解析正常。
  2. 依服務商建議設定更新週期。若沒有特別要求,可先設為每 6 小時,再依節點變更頻率調整。
  3. 查看卡片上的更新時間與更新記錄,確認排程確實執行,而非只儲存了間隔數值。
  4. 電腦進入睡眠或用戶端關閉期間,圖形介面的排程工作通常不會持續執行。喚醒後是否立即補更新取決於實作方式;有需要時請手動更新一次。

mihomo 設定中的 HTTP 類型 proxy-providers、rule-providers 各自使用 interval 欄位,單位為秒。例如 interval: 21600 代表 6 小時。這些欄位更新的是節點清單或規則清單,不等於重新整理用戶端儲存的整份遠端訂閱;節點健康檢查的 health-check.interval 則是另一個週期。

不要假設所有用戶端都以 0 表示關閉自動更新。關閉方式、允許的最短間隔與重試策略,請以介面說明為準。訂閱流量與到期時間通常取自伺服器回傳資訊,並非每個來源都會提供;沒有顯示這些資訊,不代表設定無效。

常見錯誤:依序檢查請求、解析與啟用

下載失敗:先查看 HTTP 狀態碼與網路

  • 401 或 403:確認權杖是否失效、訂閱是否到期,以及伺服器是否限制存取。403 也可能由存取政策造成,不能只憑狀態碼判定原因。
  • 404:確認路徑是否完整複製,以及服務商是否更換了訂閱入口。
  • 逾時或憑證錯誤:檢查網路、系統時間與請求路徑。不要長期關閉憑證驗證來掩蓋問題。

解析失敗:查看錯誤行附近的原始內容

出現 YAML 錯誤時,請檢查縮排、冒號後是否有空格,以及內容是否混入 HTML。若出現未知代理類型或欄位錯誤,請確認核心相容性。伺服器可能會依請求中的 User-Agent 回傳不同格式;瀏覽器開啟正常,不代表用戶端取得的內容相同,請一併查看用戶端下載記錄。

設定有效但無法連線:檢查生效設定與流量接管方式

確認已選取新設定,且策略組指向實際可用的節點,再檢查系統代理或 TUN 是否依預期接管流量。匯入訂閱、解析設定、連線至節點與 DNS 解析是不同環節;單一節點的延遲測試結果,不能代表所有網站都能連線。使用連線面板查看目標網域、比對規則與輸出策略,比反覆重新匯入更容易找出問題範圍。

建議保留一份已知可用的設定,並在更新前後記錄設定名稱、更新時間與錯誤訊息。需要尋求協助時,提供用戶端名稱、核心類型、匯入方式與已遮蔽敏感資訊的記錄即可;請勿在問題描述中公開完整訂閱網址或節點密碼。