Clash 訂閱連結匯入方法:設定格式辨識、更新與常見錯誤

逐步說明訂閱入口、設定更新與格式辨識方法,整理連結失效、內容空白及設定不相容等問題的排查方向。

匯入訂閱前,先確認連結與用戶端狀態

Clash 訂閱連結通常是一個帶有存取憑證的 HTTPS 位址。用戶端向該位址發出請求後,伺服器會回傳 Clash 設定檔、節點清單,或依請求特徵轉換後的設定內容。匯入並不只是把網址儲存到軟體中:用戶端還必須完成網路請求、讀取回應、辨識文字格式、解析代理欄位,並將結果交由 Clash Meta(mihomo)核心載入。因此,連結能在瀏覽器中開啟,不代表目前的用戶端一定能辨識。

開始操作前,先確認使用的訂閱位址仍然有效。複製時不要帶入通訊軟體產生的省略號、換行或連結兩側的空格,也不要只複製到問號之前。部分訂閱會將授權資訊放在路徑或查詢參數中,少一個字元就可能回傳登入頁、錯誤頁面或空白內容。訂閱位址等同於設定存取憑證,不適合放在截圖、日誌分享頁面或公開程式碼儲存庫中。

還要檢查 Clash Verge Rev 與 mihomo 核心是否能正常啟動。若用戶端本身停留在核心啟動失敗、連接埠遭占用或設定目錄無法寫入的狀態,即使下載成功,設定也可能無法套用。建議先開啟用戶端設定或執行狀態區域,確認核心正在執行,再進行遠端設定匯入。

如何辨識 Clash 訂閱格式

最適合直接匯入 Clash Verge Rev 的內容,是結構完整的 Clash YAML 設定。通常會包含連接埠、執行模式、DNS、代理節點、策略群組與規則等欄位。不同服務產生的欄位數量不盡相同,但常見結構如下:

mixed-port: 7890
mode: rule
proxies:
  - name: Example-HK
    type: ss
    server: edge.example.net
    port: 443
    cipher: aes-128-gcm
    password: sample-password
proxy-groups:
  - name: Proxy
    type: select
    proxies:
      - Example-HK
      - DIRECT
rules:
  - MATCH,Proxy

以上內容僅用於展示 YAML 結構。實際設定中的節點類型、驗證欄位與傳輸參數,必須由伺服器正確產生。YAML 對縮排相當敏感,層級通常以空格表示;將 Tab、錯誤縮排或未完整閉合的引號混入檔案,都可能造成解析失敗。

完整 Clash 設定

完整設定通常會同時提供 proxiesproxy-groupsrules,匯入後即可建立可選取的策略群組。較新的設定也可能包含 rule-providersproxy-providersdnstunsniffer 等欄位。mihomo 對 Clash Meta 擴充欄位的支援較完整,但設定仍須符合對應版本的欄位定義。

Base64 編碼的節點清單

另一類訂閱會回傳經 Base64 編碼的 URI 清單,解碼後可能看到多行 ss://trojan://vmess://vless:// 位址。這類內容是通用節點訂閱,不一定是完整的 Clash 設定。通常缺少策略群組、規則與 DNS 設定,能否直接匯入取決於用戶端版本、訂閱轉換能力及伺服器的回傳方式。若匯入後顯示格式無效,應在訂閱服務提供的格式選項中選擇 Clash 或 Clash Meta,而不是反覆提交同一個通用連結。

單一節點 URI 與網頁內容

單一協定 URI 只描述一個連線節點,不等同於完整訂閱。某些用戶端可透過專用入口新增單一節點,但遠端設定入口通常期待收到可儲存及更新的設定內容。如果開啟連結後顯示帳戶中心、驗證碼頁、登入頁面、JSON 錯誤物件或 HTML 文件,表示回傳內容不是 Clash YAML。常見原因包括位址複製錯誤、授權過期、需要登入,或請求被中間頁面重新導向。

Proxy Provider 遠端節點集合

proxy-providers 是 Clash 設定中的遠端節點提供者機制。主設定可以引用遠端 YAML 節點集合,並按照指定間隔更新。它與在 Clash Verge Rev 設定頁面新增整份遠端訂閱並非同一個層級:前者由正在執行的核心依據主設定擷取節點集合,後者則由用戶端管理整份設定檔。排查時應先確認錯誤來自用戶端下載設定,還是來自核心載入後的 provider 更新。

在 Clash Verge Rev 中匯入訂閱連結

不同版本的介面文字可能略有差異,但操作路徑通常集中在「訂閱」或「設定」頁面。匯入後不要立即將所有網路異常歸咎於節點,先確認設定是否已選取、核心是否成功重新載入,以及代理入口是否已開啟。

  1. 複製完整的訂閱位址。

    從訂閱服務的設定頁面複製適用於 Clash 或 Clash Meta 的位址。若服務同時提供多種格式,優先選擇與 mihomo 相容的設定,不要將 QR Code 圖片位址或網頁分享位址當成訂閱連結。

  2. 開啟設定管理頁面。

    進入 Clash Verge Rev 的設定或訂閱區域,找到新增、匯入 URL 或遠端設定入口。遠端訂閱應使用 URL 輸入欄位;已下載到本機的 YAML 檔案則使用本機檔案匯入,兩者的更新方式不同。

  3. 貼上連結並提交。

    確認位址以正常協定開頭,通常是 https://。提交後等待用戶端完成下載與解析。網路速度較慢時,不要連續建立多個相同項目,以免之後難以判斷目前使用的是哪一份設定。

  4. 查看名稱與更新時間。

    成功匯入後,設定清單通常會出現新的遠端設定項目。檢查是否顯示合理的名稱、更新時間與可用狀態。若名稱只是隨機字串,可以改成容易辨認的名稱,但不要修改遠端位址本身。

  5. 選取並啟用設定。

    僅將設定加入清單,不代表它已成為目前使用的設定。選取新項目,等待核心載入完成,再進入代理頁面查看策略群組。若設定包含大量規則集,首次載入可能還需要下載 rule provider 檔案。

  6. 選擇策略並開啟代理入口。

    在代理頁面為主要策略群組選擇節點,接著依使用情境開啟系統代理或 TUN 模式。系統代理主要影響遵循作業系統代理設定的應用程式;TUN 模式透過虛擬網路介面接管更多流量,通常需要額外的系統權限。

訂閱更新、自動重新整理與本機修改

遠端訂閱的優點是可以重新請求原始位址,取得節點、策略群組與規則的最新版本。手動更新通常從設定項目的更新按鈕發起;自動更新則依用戶端或設定指定的時間間隔執行。更新成功後,用戶端通常會儲存新內容,並通知核心重新載入。

更新前應確認目前網路可以連到訂閱伺服器。如果現有代理節點已失效,而訂閱位址又必須經過代理才能存取,就可能形成「需要先連線才能更新,但必須先更新才能連線」的循環。此時可以暫時關閉系統代理後直接連線更新,切換到仍可用的舊節點,或在確認來源可靠的前提下,透過瀏覽器測試訂閱位址是否能夠存取。

直接編輯遠端設定通常會遇到覆寫問題。對下載後的 YAML 手動新增規則、修改 DNS 或調整策略群組,下一次遠端更新可能會以伺服器版本取代這些變更。需要長期保留的本機調整,應使用用戶端支援的覆寫、合併設定或腳本機制,並明確處理套用順序。簡單複製為本機設定可以保留修改,但複本不會自動繼承遠端訂閱更新。

更新後節點名稱改變,也可能影響本機覆寫。若自訂規則指定了某個策略群組名稱,而伺服器改名或刪除該群組,核心會回報策略目標不存在。穩定的覆寫應盡量引用長期存在的策略群組,並在每次大幅更新後檢查日誌。

更新成功不代表節點可用

訂閱更新只代表設定內容能夠取得並解析。節點連線還會受到伺服器狀態、網域名稱解析、傳輸參數、系統時間及目前網路環境影響。設定清單顯示「更新成功」,但策略群組測速全部逾時時,應繼續檢查節點連線日誌,而不是反覆刪除並重新匯入訂閱。

常見匯入錯誤與排查順序

連結無效或請求回傳 404、403

404 通常表示路徑不存在,可能是連結遭截斷、訂閱已重設,或複製了舊位址;403 表示伺服器拒絕目前請求,常見於授權失效、存取策略限制或請求條件不符合要求。先從訂閱管理頁面重新複製對應格式的位址。不要自行猜測並修改 token、檔案副檔名或查詢參數,因為這些部分往往參與授權與格式選擇。

回應內容空白

空白回應可能來自伺服器暫時異常、帳戶狀態變更、節點清單尚未產生,或中間網路設備提前關閉連線。在不洩露連結的前提下,可以記錄發生時間、HTTP 狀態與用戶端日誌,再到訂閱服務後台確認方案與訂閱狀態。若瀏覽器下載到零位元組檔案,問題通常發生在用戶端解析之前。

顯示 YAML 解析失敗

這類錯誤應查看日誌中提供的行號與欄位名稱。常見問題包括縮排不一致、冒號後缺少空格、字串引號未閉合、清單層級錯誤,以及伺服器產生了目前核心無法辨識的欄位。若內容由訂閱伺服器自動產生,優先重新選擇 Clash Meta 格式並更新,不要直接在遠端檔案中逐行修補。

下載到的是 Base64 文字或一串 URI

這表示伺服器回傳的是通用訂閱。先檢查訂閱後台是否有用戶端類型或設定格式選項,再產生對應 Clash、Clash Meta 或 mihomo 的連結。有些服務會依據請求的 User-Agent 回傳不同格式,因此瀏覽器看到的內容可能與用戶端請求結果不同。此時應以用戶端日誌與實際儲存的設定為準。

設定可以解析,但核心載入失敗

解析 YAML 只是第一步。核心還會驗證策略群組引用、規則目標、provider 路徑、監聽連接埠及功能欄位。例如規則指向不存在的策略群組、兩個入站監聽使用同一連接埠、provider 檔案格式錯誤,都可能導致載入失敗。開啟日誌,定位第一條明確錯誤,不要只看後續連續出現的重新載入失敗提示。

憑證錯誤或連線逾時

憑證錯誤可能與系統時間不準確、憑證鏈異常、網域解析到錯誤位址,或網路中間設備介入有關。先校正系統日期、時間與時區,再測試同一網路下的存取情況。連線逾時則要區分 DNS 查詢逾時、建立 TCP 連線逾時與 TLS 交握逾時;發生階段不同,處理方向也不同。

更新後策略群組為空

如果設定可以載入,但策略群組沒有節點,可能是節點 provider 更新失敗、篩選運算式排除了所有節點,或伺服器回傳的節點名稱與策略群組引用不相符。查看 proxy-providers 的健康狀態與更新日誌,並檢查群組內使用的是靜態 proxies,還是動態 use 引用。

匯入完成後的連線驗證

設定成功載入後,先進入代理頁面確認策略群組不是空白,並為主要選擇群組指定一個節點。可以執行一次延遲測試,但延遲結果只表示測試位址當時是否能回應,不代表所有網站和所有協定都一定可用。接著開啟系統代理,使用遵循系統代理設定的瀏覽器存取一般網頁,觀察日誌中是否出現對應網域與規則匹配結果。

日誌應能說明請求命中了哪條規則、被分配到哪個策略群組,以及最後使用哪個節點。如果連線被規則送往 DIRECT,表示採用直接連線;如果命中 REJECT,則會被設定主動攔截;如果進入代理群組但連線失敗,則需要繼續查看節點交握或 DNS 相關錯誤。這比只觀察網頁是否開啟更容易定位問題。

系統代理正常但某些應用程式沒有流量時,原因可能是應用程式忽略系統代理、使用獨立網路堆疊,或直接傳送 UDP。此時可以評估是否啟用 TUN 模式。啟用後應依作業系統提示授予權限,並檢查虛擬網卡、路由表及 DNS 接管狀態。TUN 並不是修復訂閱格式的工具:如果設定本身無法解析或節點參數錯誤,切換流量接管方式也無法解決問題。

最後,建議為設定建立清晰的維護習慣:遠端訂閱保留容易辨識的名稱,定期更新,重要變更透過覆寫機制管理;更換訂閱位址後刪除失效項目,避免誤選舊設定;發生故障時,依照「下載回應、格式解析、核心載入、流量接管、節點連線」的順序檢查。這個順序能將相似的表面現象拆分到具體環節,減少重複匯入與盲目切換設定。

繼續安裝 Clash Verge

前往下載頁選擇作業系統與架構,或依照教學完成用戶端安裝、訂閱匯入與代理設定。

下載Clash