先分清訂閱網址與設定內容

匯入前,先確認手上的內容是什麼。URL 是資源網址,YAML 是設定檔的文字格式,Base64 則是一種編碼方式。三者並非互斥的訂閱類型:同一個 HTTPS 網址可能回傳 YAML、經 Base64 編碼的節點清單,甚至是登入頁面。

Clash 用戶端負責管理設定、提供操作介面並啟動代理核心。mihomo 是相容於 Clash 設定體系並擴充功能的核心,也常稱為 Clash Meta。設定能否使用,取決於回傳內容,以及目前的核心是否支援其中的通訊協定與欄位。

取得的內容辨識線索下一步
URL 訂閱網址通常以 https:// 開頭,可能附有權杖參數複製到用戶端的遠端設定匯入欄位
本機 YAML 檔案副檔名通常是 .yaml 或 .yml,內容包含縮排與鍵值使用本機檔案匯入功能
Base64 節點字串編碼後的長字串,解碼後可能是多行通訊協定連結確認用戶端支援,或取得 Clash 專用訂閱
單一節點連結例如以 ss://、vmess:// 開頭使用明確支援節點匯入的功能

匯入 URL 訂閱:從複製網址到選取設定

1. 複製適用於 Clash 或 mihomo 的訂閱

前往訂閱服務商的帳戶頁面,優先選擇標示為「Clash」、「Clash Meta」或「mihomo」的匯出選項。不同選項可能回傳不同的通訊協定與設定結構;「通用訂閱」不一定能直接作為完整的 Clash 設定使用。

複製真正的訂閱網址,不要複製帳戶後台的瀏覽器網址,也不要複製按鈕旁的說明文字。確認開頭沒有空格,結尾沒有中文句號。網址中的 &、= 和百分比編碼都可能有實際用途,請勿自行刪改。

2. 在用戶端的設定頁匯入

  1. 開啟用戶端,前往「設定」或「Profiles」頁面。以 Clash Verge Rev 為例,先點選側邊欄的「設定」,再使用頁面上的訂閱連結輸入欄。
  2. 貼上完整網址,點選「匯入」。如果目前版本使用「新增」視窗,請選擇遠端設定類型,再填入 URL。
  3. 等待設定卡片出現。查看更新時間或錯誤訊息,請勿連續重複點選匯入。
  4. 選取剛匯入的設定,讓它成為目前使用的設定。僅出現在清單中,不代表已啟用。
  5. 前往「代理」頁面,展開實際使用的策略群組,確認群組內看得到節點,再選取可用節點。

其他用戶端可能將相同操作放在選單列圖示的「設定」選單中。功能名稱可能不同,但操作順序相同:取得遠端內容、解析設定、選取設定、檢查策略群組。

3. 分清下載成功與設定生效

「訂閱更新成功」通常只代表這次內容已成功取得並處理完畢,不代表所選節點可連線,也不代表瀏覽器流量已經透過代理。請先確認目前使用的設定,再檢查代理模式;通常可先使用「規則」模式,由設定中的規則決定直連或代理。

匯入本機 YAML:先檢查結構,再確認來源

YAML 以縮排表示層級。Clash 設定常見的欄位包括 proxies(節點)、proxy-groups(策略群組)、rules(分流規則),也可能透過 proxy-providers 從外部載入節點。沒有內嵌 proxies,不一定代表設定是空的。

  1. 將檔案儲存在容易找到的位置,例如「下載項目」資料夾。確認它不是從網頁另存下來的 HTML 檔案。
  2. 前往用戶端的設定頁,使用「匯入檔案」或本機設定匯入功能。部分用戶端支援直接拖曳檔案,請依介面提示操作。
  3. 選取設定,查看是否出現解析錯誤。如果訊息指出特定行號,請優先檢查該行與上一行的縮排、冒號和引號。
  4. 確認外部節點來源與規則來源是否載入成功。本機檔案仍可能需要透過網路取得資源。

用於測試匯入流程的最小設定

以下是可儲存為本機設定的 YAML 範例。它會在本機 7890 埠監聽,並將請求導向直連出口。此設定沒有代理節點,只適合驗證檔案格式與設定載入流程,無法用來測試代理線路。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
rules:
  - MATCH,DIRECT

mixed-port 是可同時接收 HTTP 與 SOCKS 代理請求的混合埠。此處的 7890 僅為範例,並非所有用戶端的固定值;若介面中的埠設定或設定覆寫變更了埠號,請以實際監聽的埠為準。

編輯 YAML 時請使用空格縮排,勿混用定位字元。節點密碼、URL 或名稱含有特殊字元時,請依 YAML 語法正確加上引號。直接修改遠端設定的內容,可能在下次更新時被覆蓋;若要長期調整,建議使用用戶端提供的覆寫或合併功能。

辨識 Base64:解碼後仍須判斷內容

Base64 並非加密。常見的編碼文字包含英文字母、數字、加號和斜線,結尾可能有等號;URL 安全變體也可能使用連字號和底線。但僅憑「看起來像一長串字元」,無法確認它是有效訂閱。

解碼後的三種常見結果

  • 多行節點 URI:例如數條 ss:// 或 vmess:// 連結。這是節點集合,不含完整的策略群組與分流規則。
  • YAML 文字:仍須檢查設定結構與核心相容性,不能只因解碼成功就認定可用。
  • 錯誤訊息或其他文字:返回服務商頁面,確認訂閱權限、連結類型與有效期限。

若確實需要離線檢查,可以在 Mac 的「終端機」執行以下命令。先將要檢查的編碼文字複製到剪貼簿,再執行命令;它只會在本機解碼,結果會顯示於終端機。

pbpaste | /usr/bin/base64 -D

這是 macOS 內建工具的參數格式。若解碼失敗,可能是文字遭截斷、混入其他字元,或使用不同的編碼變體,不能直接據此判定帳戶失效。解碼結果可能含有密碼,請勿錄影或原樣分享;檢查後請清除剪貼簿內容。

如果解碼結果是節點清單,而用戶端的遠端設定匯入功能只接受完整 YAML,請返回服務商頁面選擇 Clash 專用訂閱。只有在用戶端明確支援通用節點訂閱,或已設定可信任的本機轉換流程時,才使用相應的匯入功能。請勿只為了匯入一次,就將含有憑證的訂閱交給來源不明的線上轉換服務。

首次驗證:分三步檢查設定、節點與流量

先檢查設定與策略群組

確認目前設定已標示為選取,且代理頁面的節點名稱與這次匯入的內容相符。策略群組是「從哪些出口中選一個」的設定集合;如果規則引用的群組不存在,即使檔案下載成功,也可能無法正確載入或路由。

接著檢查節點是否可用

在代理頁面執行一次延遲測試。測試結果反映用戶端對測試網址的探測情況,不等於下載速度,也無法保證所有網站都能連線。若逾時,請換一個節點再測一次,並查看記錄中的連線或驗證錯誤;不要只因出現一個紅色數字就重新安裝用戶端。

最後檢查應用程式是否使用代理

在用戶端開啟「系統代理」,再用瀏覽器開啟要測試的網站。系統代理是 macOS 提供給應用程式的代理設定,只有遵循這項設定的應用程式才會使用代理。終端機命令和部分應用程式不一定會自動套用,因此可以明確指定代理埠進行測試:

curl --proxy http://127.0.0.1:7890 --connect-timeout 10 --max-time 20 -I https://example.com

執行前,請將命令中的埠號改為用戶端實際使用的 HTTP 或混合埠。127.0.0.1 代表這台 Mac;連線等待上限為 10 秒,整個請求的上限為 20 秒。收到 HTTP 回應表示請求鏈路有收到回應,但是否經過遠端節點,仍須參考「連線」頁面或記錄中的規則命中與出口資訊。

TUN 是透過虛擬網卡接管流量的方式,涵蓋範圍通常比系統代理更廣。首次匯入訂閱時不必立即啟用 TUN:先確認設定與一般代理請求運作正常,再依應用程式需求調整流量接管方式,可減少排錯時需要檢查的變因。

設定訂閱更新間隔:先手動更新成功,再啟用自動更新

先從設定卡片的操作選單手動執行一次「更新」。確認更新時間已變更且設定仍能載入後,再開啟該設定的編輯或設定功能,尋找自動更新與更新間隔選項。不同用戶端的單位可能是分鐘、小時或秒,輸入前務必確認單位。

  • 一般個人使用:可先設定為每 24 小時更新一次,也就是 1440 分鐘或 86400 秒。這是建議的起始值,並非通訊協定規定。
  • 節點經常調整:依服務商說明改為每 6 或 12 小時更新一次,請勿將間隔縮短到幾秒。
  • 暫時更換節點或方案:在服務商完成變更後手動更新一次,再確認策略群組中是否出現新節點。
  • Mac 經常闔上上蓋:休眠期間通常不會準時執行用戶端工作。喚醒後查看實際更新時間,必要時手動更新。

訂閱更新、節點來源更新、規則來源更新和延遲測試是四件不同的事。YAML 中某個 provider 的 interval 通常以秒為單位,但它不是用戶端設定卡片共用的更新設定。請勿為了提高訂閱更新頻率,任意修改所有包含 interval 的欄位。

如果目前設定必須透過既有代理才能更新,請先保留一個可用節點。更新失敗時,確認用戶端是否保留舊設定,避免刪除唯一可用的設定後,才發現新網址無法連線。

匯入或更新失敗:依錯誤類型排除問題

遇到的狀況優先檢查項目處理方式
HTTP 401 或 403權杖、帳戶權限、服務商存取政策登入帳戶確認訂閱狀態,必要時重新產生網址
HTTP 404路徑是否完整、訂閱入口是否變更重新複製服務商目前提供的網址
HTTP 429是否頻繁更新或多台裝置同時請求停止連續重試,依伺服器要求等待
YAML 解析錯誤是否回傳網頁、縮排是否有誤檢查回傳內容類型,再依錯誤行號修正本機檔案
不支援的代理類型核心功能是否符合匯出格式需求改用相容格式,或更新至支援該通訊協定的用戶端與核心
請求逾時或憑證錯誤網路路徑、系統時間、伺服器憑證檢查連線與日期時間,向服務商確認服務狀態

已下載內容,但沒有節點

確認是否誤用了只含規則的檔案,或匯入了需要由其他設定引用的節點來源檔案。完整設定、節點 provider 檔案與規則 provider 檔案用途不同,不能只因副檔名都是 YAML 就互相替代。

瀏覽器能開啟網址,但用戶端更新失敗

瀏覽器可能帶有登入 Cookie,但用戶端通常不會沿用瀏覽器的登入狀態;伺服器也可能依據請求標頭回傳不同格式。請返回帳戶頁面取得專用訂閱網址,並查看用戶端記錄中的實際錯誤。請勿透過停用憑證驗證來略過錯誤。

訂閱網址曾公開,該怎麼處理

在服務商後台重設訂閱權杖,再於每台裝置更新網址,並確認舊網址已失效。僅刪除聊天截圖或移除本機設定,無法撤銷已外洩的存取憑證。