先分清網址、設定檔與節點編碼
「匯入訂閱」包含兩個步驟:取得內容,再由用戶端解析內容。URL 是取得內容的網址,YAML 是設定檔的表示格式,Base64 則是一種編碼方式。三者所處的層次不同:同一個 HTTPS 訂閱網址,可能回傳完整的 Clash YAML,也可能回傳經 Base64 編碼的節點連結。光看網址,無法判斷能否直接匯入。
| 取得的內容 | 辨識線索 | 適用的匯入方式 | 後續更新 |
|---|---|---|---|
| 遠端訂閱 URL | 通常以 https:// 開頭,可能包含權杖參數 |
遠端設定或訂閱網址匯入入口 | 用戶端重新向同一網址發出請求 |
| 本機 YAML 檔案 | 包含 proxies:、proxy-groups: 等鍵 |
匯入本機檔案,或開啟設定資料夾 | 通常需要重新匯入或自行維護 |
| Base64 節點字串 | 解碼後常見多行 ss://、vmess:// 等 URI |
使用支援相應格式的節點匯入功能或可信任的轉換工具 | 取決於來源與轉換流程 |
URL 訂閱:從複製網址到啟用設定檔
複製用戶端專用訂閱網址,而非帳戶網頁
在訂閱服務商的帳戶頁面選擇 Clash 或 Mihomo 對應的輸出選項,再複製完整網址。帳戶登入頁、購買紀錄頁與訂閱介面並不是同一個網址。若服務商分別提供 Clash、Clash Meta、通用訂閱,請依實際用戶端核心選擇;使用 Mihomo 的用戶端通常可使用 Clash Meta 專用設定,但仍須確認支援的協定。
- 確認來源。網址應來自你實際使用的服務帳戶。保留查詢參數,勿漏掉
?後方的權杖,也不要把複製時附帶的引號、空格或換行一併貼入輸入欄位。 - 找到遠端匯入入口。例如在 Clash Verge Rev 的「訂閱」頁面,將網址貼入 URL 欄位,再點選「匯入」。不同版本的介面可能有所調整,請找出「透過 URL 取得設定」的入口,而不是本機檔案按鈕。
- 等待下載與解析。匯入後檢查設定名稱、更新時間與節點清單。若出現解析錯誤,請先保留原本可用的設定檔,不要連續覆寫。
- 選取新設定檔。確認剛匯入的設定檔已啟用,再前往「代理」頁面,為實際使用的策略群組選擇節點。下載完成但尚未切換設定檔時,連線仍可能沿用舊設定。
- 確認代理連線。先使用用戶端的連線測試,再啟用系統代理並開啟測試頁面;只有需要接管非系統代理流量時,才進一步設定 TUN。
在 ClashX 系列用戶端中,遠端訂閱入口通常位於選單列圖示的「設定」→「託管設定」→「管理」。新增網址後,再選取對應設定檔。不同分支的選單名稱不盡相同;若找不到「託管設定」,請先確認用戶端名稱與版本,不要直接照搬其他用戶端的截圖步驟。
若在瀏覽器開啟網址後看到登入頁面、驗證碼或 HTML 內容,即使伺服器回傳 HTTP 200,也不是可直接解析的 Clash 設定。請返回服務商頁面重新取得訂閱入口,不要將該網頁另存為 .yaml。
本機 YAML:匯入檔案與檢查結構
本機檔案適合保存手動維護的規則、離線移轉設定,以及匯入服務商直接提供的設定檔。常見副檔名為 .yaml 或 .yml,但副檔名只能協助辨識檔案,無法改變內容格式。將 Base64 文字改名為 YAML,不會自動產生策略群組或分流規則。
匯入前檢查三項
- 編碼與縮排:使用 UTF-8 文字;YAML 階層以空格縮排,不要使用 Tab。清單項目與上層鍵的縮排必須一致。
- 設定範圍:完整的主設定通常包含節點或節點提供者、策略群組與規則。只有
proxies:的檔案可能是節點提供者內容,並非可獨立執行的完整設定。 - 核心相容性:Mihomo 可辨識的欄位,不一定能由舊版 Clash 核心辨識。遇到「不支援的代理類型」時,請確認協定與核心,不能只靠調整縮排解決。
以下僅展示 YAML 階層關係與一個直連策略,不包含代理伺服器,無法用來驗證遠端節點是否可用。7890 是範例監聽連接埠,不代表所有用戶端的預設值。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
proxy-groups:
- name: 手動選擇
type: select
proxies:
- DIRECT
rules:
- MATCH,手動選擇
在用戶端的「訂閱」或「設定」頁面選擇本機檔案匯入入口;支援拖放的用戶端也可將檔案拖曳至對應區域。匯入後請檢查實際生效的連接埠與模式,因為圖形介面用戶端可能透過合併設定或設定面板覆寫檔案中的欄位。若匯入前後的連接埠不一致,請以執行中的設定與記錄為準。
Base64:解碼節點不等於產生 Clash 設定
Base64 並非加密。它可以將文字編碼成方便傳輸的字串,卻無法隱藏節點密碼或訂閱權杖。常見的通用訂閱在解碼後會是一行一個節點 URI;這些 URI 描述單一節點,通常不包含 Clash 主設定中的策略群組、規則與 DNS 設定。
依解碼後的內容選擇處理方式
- 取得節點 URI 清單:先確認用戶端是否提供相應協定的節點匯入功能。主設定匯入器不一定接受 URI 清單,支援匯入單一節點也不代表支援整份通用訂閱。
- 取得完整 YAML:將其視為設定內容檢查,確認縮排、協定類型與欄位相容性,再透過本機檔案入口匯入。
- 取得網頁或錯誤訊息:表示下載來源或存取狀態有問題。繼續進行 Base64 解碼或修改檔案副檔名都無濟於事。
需要轉換時,優先使用服務商提供的 Clash/Mihomo 專用輸出,或可信任的本機轉換工具。轉換不只是解碼,還必須將節點參數對應至目標核心格式、產生策略群組與規則,並保留 TLS、SNI、傳輸方式等必要欄位。原始資訊不完整時,轉換工具無法推算缺少的驗證參數。
第三方線上轉換服務可能會接觸完整訂閱網址與節點憑證。請勿將真實網址貼到來源不明的網站,也不要在公開支援案件中提交原始檔案。排查問題時應隱藏權杖、密碼、UUID 與伺服器資訊;若權杖已外洩,請在服務商帳戶中重設訂閱網址。
自動更新:主設定與節點提供者分別計時
圖形介面用戶端管理的「訂閱更新間隔」與核心設定中的節點提供者更新並非同一項。前者會重新下載主設定,後者只會更新 proxy-providers 引用的節點內容。調整其中一項,不代表另一項也會同步變更。
| 更新對象 | 設定位置 | 檢查重點 |
|---|---|---|
| 遠端主設定 | 用戶端訂閱卡片的編輯或更新設定 | 介面以分鐘或小時為單位,以及是否已啟用自動更新 |
| HTTP 節點提供者 | 主設定中的 proxy-providers |
interval 的單位為秒 |
| 一般本機檔案 | 檔案維護流程 | 是否需要重新載入,以及是否引用遠端資源 |
以下是 Mihomo 的 HTTP 節點提供者片段,86400 秒即為 24 小時。網址使用保留作為範例的網域,不提供實際節點;此片段須合併至完整主設定中,目標回應內容必須是核心支援的節點提供者格式,例如最上層包含 proxies: 的 YAML。
proxy-providers:
remote-nodes:
type: http
url: "https://example.com/nodes.yaml"
path: ./providers/remote-nodes.yaml
interval: 86400
策略群組還需要透過 use: 引用 remote-nodes,節點才會加入相應群組。提供者的健康檢查間隔只控制探測頻率,並非訂閱下載間隔。不要為了「讓節點更快」就將更新間隔設為幾秒;這會增加請求量,也可能觸發伺服器的流量限制。
用戶端未執行、裝置進入睡眠或網路無法使用時,不要假設排程工作一定會執行。變更設定後先手動更新一次,確認沒有錯誤,再觀察更新時間與下次啟動後的狀況。能否顯示剩餘流量與到期日,取決於回應資訊及用戶端支援與否,不影響內容格式的判斷。
匯入失敗:依下載、解析、執行順序排查
第一步:確認是否取得正確回應
- HTTP 401 或 403:優先檢查網址是否完整、權杖是否有效,以及帳戶狀態;403 也可能來自存取政策或防護系統,不能直接判定為節點故障。
- HTTP 429:停止連續點選更新,依伺服器提示稍候,再降低更新頻率。
- 逾時或憑證錯誤:檢查網路、系統時間與訂閱網域解析。不要將停用憑證驗證當作一般解決方式。
第二步:確認格式與核心
出現 YAML 行號錯誤時,檢查提示行及其上一層的縮排,尤其是冒號、引號與清單橫線。出現未知代理類型時,記下用戶端版本與核心名稱,返回服務商頁面選擇相容的輸出格式。設定中有 proxy-providers 卻未直接列出節點,不一定是錯誤;請繼續確認提供者是否下載成功,以及策略群組是否正確引用。
第三步:區分訂閱更新路徑與實際代理路徑
訂閱請求可能由用戶端本身發出,不一定會經過核心代理。若舊設定可以連線,但新訂閱下載失敗,請確認用戶端是否允許為訂閱更新單獨設定代理,以及該選項是否需要先有可用設定。TUN 的作用是接管網路流量,不會自動將 Base64 轉成 YAML,也無法修復失效的權杖。
最後確認目前啟用的設定檔、策略群組選擇與系統代理。系統代理連接埠必須與用戶端實際監聽的連接埠一致;例如用戶端監聽 7890,系統代理卻指向 7897,就會發生設定已匯入但應用程式無法連線的情況。依照這個順序檢查,可分別處理「下載失敗」、「格式不相容」與「連線未接管」,避免反覆重新安裝用戶端。