Clash 訂閱連結匯入教學：YAML 設定與 Base64 訂閱格式比較

匯入前先分清楚：訂閱網址、設定檔與節點連結

Clash 訂閱匯入失敗，常見原因不是網路中斷，而是把不同類型的內容放進同一個匯入入口。訂閱網址是用來取得內容的 URL；YAML 是設定內容的組織格式；Base64 則是一種編碼方式。三者屬於不同層次，不能只憑「連結看起來差不多」來判斷是否相容。

• 遠端訂閱網址：通常以 https:// 開頭，用戶端連線後會取得設定或節點清單。網址可能包含帳戶權杖，請妥善保管，視同登入憑證。
• 本機設定檔：常見副檔名為 .yaml 或 .yml，可透過「匯入檔案」或本機設定入口載入。匯入本機副本後，通常不會自動取得服務商後續更新。
• 單一節點分享連結：例如以 ss://、vmess:// 或 trojan:// 開頭的內容。部分用戶端提供獨立的解析功能，但不代表 Clash 核心能直接將它當成完整 YAML 設定讀取。

開始操作前，先記下用戶端名稱，以及「關於」頁面顯示的核心名稱。Clash、Clash Meta（現稱 mihomo）與其他代理核心支援的通訊協定和欄位不盡相同。若服務商提供「Clash」、「Clash Meta」、「通用訂閱」等選項，請先選擇符合目前核心的格式，再複製網址。

YAML 設定與 Base64 訂閱格式有何不同？

完整的 Clash YAML 設定通常會描述節點、代理群組和規則，分別使用 proxies、proxy-groups、rules 等欄位；也可能透過 proxy-providers 引用外部節點資源。Base64 節點訂閱則常將多行分享連結一併編碼，通常不包含完整的 Clash 分流規則與代理群組結構。

完整設定與 provider 檔案不可混用

只有 proxies: 的檔案可能是有效的節點資源，但不一定是可直接使用的完整設定。若將它當成完整設定載入，即使解析成功，也可能缺少預期的代理群組和規則。反過來，把完整設定交給只接受節點資源的入口，也可能造成格式錯誤。請依照匯入入口的要求操作，不要只看副檔名判斷。

以下是用來辨識結構的最小本機設定範例，不包含代理節點，所有連線都會直連。這個範例只展示 YAML 的階層結構，不能取代服務商訂閱作為連線方案。

mixed-port: 7890
mode: rule
log-level: info

proxy-groups:
  - name: 手動選擇
    type: select
    proxies:
      - DIRECT

rules:
  - MATCH,手動選擇

Base64 解碼不等於轉換成 Clash 設定

Base64 解碼只能還原原始文字，不會自動產生代理群組、DNS 設定或路由規則。真正的格式轉換還需要解析節點欄位，並產生目標核心支援的設定。即使轉換成功，若目標核心不支援某種通訊協定或參數，節點仍然無法使用。建議向服務商索取原生 Clash 或 mihomo 格式，減少轉換過程造成的欄位遺失。

匯入 Clash 訂閱連結：從複製網址到啟用設定

各用戶端的按鈕名稱會隨版本不同。以下以「訂閱」或「設定」頁面中的遠端匯入流程為例；如果入口只接受檔案，請返回上一層尋找 URL 輸入欄位，不要把網址存成文字檔後當作 YAML 匯入。

1. 複製正確格式的網址。在服務商後台選擇 Clash 或 Clash Meta/mihomo 入口。請複製訂閱網址，不是後台首頁、付款頁面或說明文件網址；並確認網址前後沒有多餘的空格、換行或中文標點。
2. 前往遠端設定入口。開啟用戶端的「訂閱」或「設定」頁面。若有直接的 URL 輸入欄位，貼上網址後選擇「匯入」；若需透過「新增」建立，請選擇遠端類型，填入 URL 後儲存。不要選擇本機檔案類型。
3. 等待下載與解析完成。確認是否新增設定卡片、是否顯示更新時間，以及通知區域有沒有 YAML 解析錯誤。只看到卡片不代表下載已完成，還需要確認其狀態。
4. 選取並啟用新設定。清單中可以同時保留多份設定，但實際生效的是目前選取的設定。匯入後確認選取標示，再前往代理頁面檢查是否出現預期的節點與代理群組。
5. 使用規則模式並選擇出口。先將運作模式設為「規則」，再從訂閱設定的選擇群組中挑選節點。部分訂閱預設選取 DIRECT，此時流量會直連，不代表節點失效。
6. 確認應用程式流量。使用系統代理時，請開啟用戶端的「系統代理」，再測試會遵循系統代理設定的瀏覽器。若使用 TUN 接管流量，請另外確認 TUN 權限與路由狀態；匯入訂閱本身不會自動啟用 TUN。

本機監聽連接埠與訂閱網址是兩回事。範例中的 7890 是混合代理監聽連接埠，不是訂閱伺服器的連接埠。如果記錄中出現 address already in use，請檢查本機是否有其他代理程序占用相同連接埠，不要反覆重設訂閱權杖。

訂閱更新間隔：分清用戶端更新與 provider 更新

遠端設定更新通常由用戶端外殼負責：定時重新下載整份設定，再依用戶端的邏輯重新載入。設定中的 proxy-providers 則由支援此功能的核心更新節點資源。這是兩套不同的計時機制，不能把介面中的「更新間隔」直接視為 YAML 裡的 interval。

用戶端遠端設定更新

• 首次匯入後：先手動更新一次，確認網址可用且解析正常，再啟用自動更新。
• 日常使用：可先設定每 24 小時更新一次，並依照服務商建議調整。若節點變動頻繁，可考慮每 6 小時更新一次，但不應無故設定成每分鐘擷取。
• 注意輸入單位：24 小時等於 1440 分鐘，也等於 86400 秒。如果介面要求以分鐘為單位，輸入 86400 就不是一天。
• 留意執行條件：部分用戶端只會在應用程式執行時處理定時工作；裝置休眠、網路中斷或背景執行限制都可能延後更新，請以最近一次成功更新的時間為準。

mihomo 節點 provider 更新

mihomo 的 HTTP 類型節點 provider 使用 interval 設定資源更新週期，單位為秒。例如一天可設定為 interval: 86400。這只會更新該 provider 指向的節點資源，不會替你更新外層設定中的所有規則。health-check 下的間隔則用於檢查節點是否可用，同樣不等於訂閱更新間隔。

如果訂閱中根本沒有 proxy-providers，不要為了「啟用自動更新」而隨意加入這個區塊。直接使用用戶端的遠端設定定時更新功能即可。如果使用多層引用，則需分別確認外層設定和各 provider 的最後更新時間。

訂閱匯入失敗排查：HTTP、YAML 與核心相容性

每次只排查一個層級。先確認請求是否取得正確內容，再檢查目前核心能否解析，最後確認節點是否可以連線。以下錯誤訊息比單說「無法匯入」更能協助縮小問題範圍。

瀏覽器能開啟，不代表用戶端取得相同內容

瀏覽器可能會帶上登入 Cookie，但用戶端請求通常不會；部分伺服器也會依 User-Agent 回傳不同內容。HTTP 200 只表示請求成功取得回應，不代表回應內容就是 Clash 設定。若回應本文開頭是 <!DOCTYPE html>，請先處理登入跳轉、存取驗證或網址錯誤，不能靠調整 YAML 縮排解決。

YAML 出錯先看原始內容，別急著改規則

YAML 使用空格縮排表示階層，不能用定位字元取代。複製到聊天軟體後，英文冒號可能被轉成中文冒號，縮排也可能遺失。若遠端訂閱的原始內容就有語法錯誤，請向提供方回報已遮蔽敏感資訊的錯誤行；不要為了讓程式「能啟動」就刪掉整段設定，否則可能遺失規則或 DNS 設定。

訂閱正常，但網頁無法開啟

先查看用戶端的連線記錄。如果沒有目標請求，請檢查系統代理或 TUN 是否接管流量；如果有請求，則檢查命中的規則、代理群組和實際出口。節點延遲測試成功，只代表特定探測請求可用，不能證明所有網域、UDP 流量或應用程式都能正常連線。訂閱下載成功、節點可用、應用程式透過代理連線，是三項各自獨立的檢查。

格式轉換與更新後的檢查項目

只有在服務商無法提供目標格式，且用戶端不支援原始格式時，才考慮轉換訂閱。轉換工具可能會接觸完整訂閱網址和節點憑證，請優先選擇可在本機執行且來源明確的工具。不要只為了測試一個網址，就把憑證提交給多個不熟悉的轉換網站。

1. 確認目標核心：先確認輸出格式是傳統 Clash 相容設定還是 mihomo 設定，並檢查目標通訊協定是否受支援。轉換只能調整表示方式，無法替舊版核心補上新通訊協定的實作。
2. 確認規則來源：轉換過程可能會取代代理群組和分流規則。請確認預設出口、最終 MATCH 的指向，以及原本需要的直連規則是否保留。
3. 確認後續更新方式：匯入一次轉換後的本機檔案，通常只會取得一份靜態快照。若要持續更新，請確認由誰定時取得來源訂閱、執行轉換並重新載入設定。
4. 檢查更新結果：手動更新後，確認成功時間已更新、節點數量合理，而且目前仍選取正確的設定；接著測試一個應直連的目標和一個應走代理的目標，並在連線記錄中確認出口。

如果要確認運作模式、DNS 或 TUN 的詳細參數，可繼續參閱技術參考；想依照步驟完成首次設定，則可從入門教學開始。先確認訂閱格式與設定選擇，再處理網路流量接管，排查起來會更有效率。