先確認訂閱回傳的格式
Clash 訂閱能否匯入,取決於連結回傳的內容,以及用戶端支援的設定格式,而不是連結是否以 .yaml 結尾。請優先使用訂閱服務提供者標示為「Clash」或「Clash Meta / mihomo」的入口,再匯入用戶端。一般 HTTPS 網址可能回傳完整設定、Base64 節點清單、登入頁面或錯誤訊息。
用戶端是用來管理設定、系統代理與核心的圖形介面;mihomo 則是負責執行代理通訊協定與分流規則的核心。介面提供「匯入訂閱」按鈕,不代表核心能直接讀取所有訂閱格式。有些用戶端會先轉換內容,有些則只接受 Clash YAML,請分別確認。
| 取得的內容 | 辨識特徵 | 處理方式 |
|---|---|---|
| 完整 Clash YAML | 常見的頂層欄位包括 proxies、proxy-groups、rules | 使用 URL 設定匯入或本機設定匯入 |
| 節點提供者 YAML | 通常只有 proxies 節點清單 | 交由 proxy-providers 引用,或使用用戶端明確支援的合併功能 |
| Base64 節點清單 | 解碼後可看到多行 ss://、vmess:// 等 URI | 使用提供者提供的 Clash 格式,或可信任的本機轉換工具 |
| 網頁或錯誤資料 | 出現 HTML 標籤、登入表單或 JSON 錯誤訊息 | 檢查連結、授權狀態與訂閱效期,這類內容不能當成 YAML 載入 |
透過 URL 匯入訂閱
從訂閱服務提供者複製完整網址,並保留查詢參數。URL 中的權杖通常就是存取憑證;複製時漏掉問號後面的內容,可能會導致 HTTP 401 或 403。請勿將網頁登入網址、購買頁面或 QR Code 圖片網址當成訂閱網址。
分別確認匯入與啟用狀態
- 開啟設定管理。在用戶端開啟「設定」、「訂閱」或
Profiles頁面,選擇有 URL 輸入欄位的遠端匯入入口。各用戶端的名稱可能不同,請以實際介面為準。 - 貼上完整 URL。輸入欄位只填入連結本身,不要包含通訊軟體附加的引號、說明文字或換行。建議優先使用提供者提供的 HTTPS 網址。
- 下載或匯入。等待設定項目出現,再查看更新時間與錯誤訊息。以舊版 Clash for Windows 的英文介面為例,操作路徑為
Profiles → URL 輸入框 → Download;該用戶端已停止維護,此路徑僅供辨識舊版介面。 - 選取設定。下載完成後,點選該設定項目,將其設為目前使用的設定。如果介面顯示重新載入失敗,請先查看記錄,不能只因清單中出現項目就判定匯入成功。
- 確認執行狀態。在規則模式下確認策略群組已載入,並選取可用策略。桌面用戶端還需要依使用情境啟用系統代理或 TUN;匯入設定不代表流量已開始由用戶端接管。
建議依序確認「下載成功 → 解析成功 → 設定已啟用 → 流量接管生效」四個步驟。若只完成第一步,瀏覽器仍可能沿用原本的連線方式;解析失敗時,用戶端也可能繼續使用上一份有效設定。如需尋找安裝入口,可先前往用戶端下載頁選擇作業系統,再參考安裝與設定教學操作。
匯入本機 YAML 檔案
本機 YAML 適合離線保存、移轉設定與排查格式問題。匯入入口通常位於「設定」頁面的「匯入檔案」或檔案拖放區。匯入後仍須手動選取設定,並確認用戶端記錄沒有語法錯誤。
匯入檔案前的三項檢查
- 編碼與副檔名:使用 UTF-8 文字,並確認檔案不是
config.yaml.txt。在檔案管理員中開啟副檔名顯示,比只看圖示更可靠。 - 縮排與層級:YAML 使用空格縮排,不可使用 Tab。同一層級的欄位要對齊;清單項目的連字號也要放在正確的欄位層級。
- 確認設定完整:只有節點清單的 YAML 不等於完整的分流方案。實際需要的策略群組、規則與 DNS 設定應由主設定檔提供。
以下是用來說明層級的最小直連設定。檔案中沒有遠端代理節點,無法用來確認訂閱節點是否可用。若只用來檢查匯入與解析流程,請先備份目前設定,測試後再切回原設定。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
proxies: []
proxy-groups:
- name: 手動選擇
type: select
proxies:
- DIRECT
rules:
- MATCH,手動選擇
mixed-port: 7890 設定本機 HTTP 與 SOCKS 共用的監聽連接埠,不是遠端節點連接埠。mode: rule 表示依規則比對;最後的 MATCH 會將其餘連線交給「手動選擇」群組,而該群組只包含 DIRECT,因此範例中的連線會直接連線。如果連接埠已被占用,即使設定語法正確,也可能無法正常啟動監聽。
辨識 Base64 節點清單
Base64 是一種編碼方式,不是 Clash 設定語法,也不具加密保護。常見的通用訂閱會將多筆節點 URI 合併後編碼,解碼後可能會看到 ss://、trojan://、vmess:// 或 vless://。這類文字通常不包含完整的策略群組與規則。
辨識格式後選擇相容的處理方式
- 先到提供者頁面尋找明確標示為 Clash 或 mihomo 的訂閱格式。同一個帳戶可能提供多個輸出網址,請複製適用於目前核心的那一個。
- 如果只有通用訂閱,請確認用戶端是否明確支援 URI 清單或 Base64 匯入。支援單一節點 URI,不代表也支援整段 Base64 訂閱。
- 確實需要轉換時,請優先使用提供者提供的轉換功能或可信任的本機工具。轉換過程需要解析節點通訊協定、傳輸層與 TLS 等欄位,不能只靠更改副檔名取代。
- 轉換完成後,請檢查節點數量、策略群組引用與核心錯誤,再決定是否啟用。解析成功不代表每個節點的連線參數都正確。
原版 Clash 與 Clash Meta(現稱 mihomo)支援的通訊協定和欄位並不完全相同。轉換工具產生了某種通訊協定欄位,也不代表舊版核心能夠執行。遇到 unsupported proxy type 之類的錯誤時,請確認目前實際執行的核心與訂閱目標格式,不要反覆匯入同一個檔案。
設定訂閱更新間隔
整份遠端設定更新與節點提供者更新是兩種不同機制。圖形用戶端負責下載遠端設定;mihomo 的 proxy-providers 則可定時取得節點清單。請勿混淆兩處的 interval 或介面數值,也不要將健康檢查週期當成訂閱更新週期。
| 更新位置 | 更新對象 | 單位與範例 |
|---|---|---|
| 用戶端遠端設定 | 完整設定檔 | 依介面顯示的單位設定;若明確標示為分鐘,360 代表 6 小時 |
proxy-providers 下的 interval | 指定提供者的節點清單 | 單位為秒;21600 代表 6 小時 |
health-check.interval | 節點連線狀態檢查 | 單位為秒;300 代表每 5 分鐘檢查一次,不會下載新的訂閱 |
日常使用可先將更新間隔設為 6 小時,再依提供者的限制調整;這只是設定範例,並非通訊協定要求。如果用戶端支援讀取回應中的更新建議,實際行為仍取決於用戶端的實作。帳戶服務端更新後,可先手動更新一次,再確認更新時間與節點清單。
更新後保留本機設定
更新遠端設定可能會覆蓋直接修改的連接埠、規則與 DNS 設定。若要長期保留本機調整,請使用用戶端支援的覆寫、合併或擴充設定功能,並確認合併結果。請勿假設編輯遠端檔案後,這些內容仍會保留在下一次訂閱更新中。
此外,完整設定訂閱可能包含規則與外部資源引用,不只有節點。匯入前請確認來源可信,並檢查 allow-lan、控制介面與監聽位址等設定是否適合目前裝置。一般個人桌面使用情境下,不應為了完成匯入而任意開放區域網路存取。
訂閱匯入失敗的排查順序
先區分下載失敗、內容格式錯誤與執行失敗,再處理對應環節。反覆點選匯入通常無法修復格式問題,還可能觸發提供者的請求頻率限制。
| 現象 | 優先檢查項目 | 下一步 |
|---|---|---|
| HTTP 401 或 403 | 權杖、帳戶狀態、存取限制 | 從提供者管理後台重新複製連結;不要只憑狀態碼就認定原因 |
| HTTP 429 | 請求頻率是否過高 | 停止連續重新整理,依照伺服器的重試提示操作,並延長更新間隔 |
| 回傳 HTML 或解析第一行時出錯 | 是否進入登入頁、驗證頁或重新導向錯誤頁 | 檢查最終回應本文,確認取得的是訂閱資料 |
| YAML 縮排或欄位錯誤 | 檔案內容、縮排、重複鍵、通訊協定支援情況 | 根據記錄定位行號,確認下載的目標格式是否正確 |
| 匯入成功但沒有預期的節點 | 是否為節點提供者檔案,以及帳戶是否回傳空清單 | 檢查設定類型與提供者狀態,再確認策略群組引用 |
| 啟用設定後仍無法連線 | 目前設定、群組選擇、系統代理或 TUN、DNS | 依流量路徑逐項檢查,不要只是不斷重新下載訂閱 |
瀏覽器可以開啟,卻無法從用戶端下載
瀏覽器與用戶端可能使用不同的代理路徑、DNS 或請求標頭。瀏覽器顯示下載結果,不代表用戶端的請求也能連到相同網址。請先查看記錄中的逾時、憑證或網域解析錯誤;若用戶端提供訂閱下載代理選項,再依說明選擇。請勿透過關閉憑證驗證來掩蓋連線問題。
訂閱尚未匯入,但下載又需要代理
首次設定時可能會遇到這種循環依賴。可在已能連上提供者的可信任裝置或網路下載 YAML,再透過本機檔案完成首次匯入;之後回到原裝置確認遠端更新。傳送設定檔時請當成敏感檔案處理,避免放在公開雲端硬碟或共享群組。
完成排查後,請同時確認三件事:目前啟用的是目標設定、記錄中沒有持續出現解析或資源下載錯誤,以及測試連線採用了預期策略。欄位說明與規則寫法可參閱設定檔參考;常見的流量接管問題可參閱常見問題。訂閱更新成功只能證明取得與載入流程正常,節點連線狀態仍須另外確認。