Clash 訂閱連結匯入教學：URL、本機檔案與常見格式

匯入前：分清訂閱網址、設定檔與節點清單

匯入 Clash 訂閱時，關鍵不在連結名稱，而在連結回傳的內容。網址以 https:// 開頭，只能表示它是網頁資源網址，無法證明回傳內容是 Clash 設定；網址以 .yaml 結尾，也不代表檔案結構正確。請先在服務提供者的訂閱頁面，選擇符合目前用戶端核心的輸出格式，再複製完整網址。

用戶端負責管理設定與操作介面，核心則負責解析設定、處理規則及建立連線。採用 mihomo 核心的用戶端可辨識相應的新通訊協定與欄位，但舊版原始 Clash 未必支援同一份設定。因此，格式正確與核心相容是兩項獨立條件。

電腦版透過 URL 匯入：建立並啟用遠端設定

以下以 Clash Verge Rev 等電腦版用戶端為例，操作順序為「設定」→「新增」→選擇遠端類型→填入訂閱 URL→儲存，接著選取該設定。介面文字可能因版本而異：有些版本會直接在設定頁頂端顯示 URL 欄位，按鈕則標示為「匯入」，但實際上仍是在新增遠端設定項目。

1. 複製訂閱網址。在服務提供者頁面選擇 Clash 或相容 mihomo 的訂閱格式。請使用頁面上的複製按鈕，以免手動選取時漏掉網址末端的參數；不要複製登入頁或帳單頁的網址。
2. 填入遠端設定。開啟設定頁，將完整網址貼到 URL 欄位，並填入容易辨識的名稱。除非服務提供者另有明確要求，請先保留要求標頭、使用者代理程式與更新間隔的預設值。
3. 首次下載。按下儲存或匯入，等待設定項目出現。若顯示解析錯誤，請檢查回傳格式，不要反覆開啟系統代理。
4. 選取並載入設定。確認該項目已顯示為目前使用的設定。只將項目加入清單，不代表核心已切換至該設定。
5. 檢查策略群組。前往代理頁面，確認策略群組與可選節點均已載入，再視需要啟用系統代理。請先以規則模式測試，不必同時啟用 TUN。

貼上連結時容易忽略的細節

• 移除網址前後的空格、引號與換行，但不要任意刪除 ? 後的查詢參數。
• 從 HTML 原始碼複製到的 & 是轉義形式；建議回到原頁面使用複製按鈕，取得實際 URL。
• 不要自行將 HTTPS 改成 HTTP。若出現憑證錯誤，請先檢查裝置時間、網路環境與伺服器憑證。
• 部分服務會依據 User-Agent 回傳不同內容。請先確認服務提供者有此要求，再調整用戶端的訂閱請求 User-Agent。

手機版匯入：URL、剪貼簿與 QR Code

Android 用戶端通常會在「設定」頁提供新增按鈕，接著可選擇 URL、檔案或 QR Code。以支援 mihomo 的行動用戶端為例，請先新增設定並設為目前使用的設定，再啟動連線。首次啟動時出現的系統 VPN 授權，是用來建立本機流量接管通道；這與下載訂閱是兩個步驟，不能以授權成功判斷訂閱是否可用。

1. 在訂閱頁面複製符合目前用戶端的 URL，再切回用戶端的設定清單。
2. 開啟新增設定入口，選擇透過 URL 匯入並貼上網址；若使用掃描 QR Code，請先確認其中內容是訂閱 URL，而非單一節點連結。
3. 儲存後等待下載完成，並檢查設定名稱、代理群組與錯誤訊息。
4. 將設定設為目前使用的設定，再啟動連線並確認系統授權；接著開啟已知可連線的網站進行測試。

iOS 用戶端支援的格式與匯入方式依各應用程式而異，不能直接照搬 Android 的選單路徑。若應用程式只接受自有訂閱格式，請在服務提供者頁面選擇相應格式；只有明確支援 Clash YAML 的入口，才適合匯入本文所述的完整設定檔。

匯入本機 YAML：檢查檔案結構與縮排

本機檔案適合離線保存設定、移轉既有設定，或排查訂閱下載問題。在用戶端選擇「設定」→檔案匯入，找到實際儲存的 .yaml 或 .yml 檔案，匯入後選取並啟用。將網頁另存為檔案，可能取得的是 HTML；即使更改副檔名，也不會因此變成 YAML。

以下範例僅用來確認設定能否載入，採用明確的本機監聽連接埠與預設規則，不含代理節點。此範例有助於分辨「用戶端能否載入 YAML」與「遠端訂閱能否正常提供代理」這兩類問題。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info

proxies: []
proxy-groups: []

rules:
  - MATCH,DIRECT

• mixed-port: 7890 表示此範例會在本機同一個連接埠提供 HTTP 與 SOCKS 代理入口；若連接埠已被占用，請更改連接埠或停止占用該連接埠的程式。
• allow-lan: false 表示不開放區域網路存取。初次測試不必改為 true。
• MATCH,DIRECT 會讓所有符合預設規則的連線直接連線，因此此範例不具備遠端代理功能。
• YAML 縮排請使用空格，不要使用 Tab。節點名稱若含有冒號加空格等特殊內容，請正確加上引號。

匯入本機檔案後，用戶端可能會另存一份副本；繼續編輯原始檔不一定會同步至已匯入的項目。一般本機設定不會自動重新下載遠端完整設定，但其中獨立宣告的遠端 provider 仍可能依照其設定更新。若需要持續同步完整訂閱，請使用遠端 URL 項目。

Base64 節點清單與完整設定檔的差異

Base64 是編碼方式，不是代理通訊協定，也不是加密。一段 Base64 文字解碼後，可能只是多行節點連結，通常不含 Clash 所需的策略群組與分流規則。若直接將它當成完整 YAML 匯入，常見結果是解析失敗，或只載入節點資訊，缺少可用的選擇與路由結構。

完整設定與 provider 檔案不可互換

完整設定可以透過 proxies 直接宣告節點，也可以使用 proxy-providers 引入外部節點資源；策略群組則透過 proxies 或 use 引用這些資源，再由規則決定連線路徑。單獨一份頂層為 proxies: 的檔案，即使能作為 provider 解析，也不等於已設定好策略群組與規則的主設定。

建議的格式轉換順序

1. 優先選擇原生輸出。優先使用服務提供者直接產生的 Clash 或 mihomo 設定，減少轉換步驟。
2. 接著確認用戶端支援能力。有些用戶端支援匯入節點連結並自動產生設定，有些則只接受完整 YAML；請以目前使用的用戶端說明為準。
3. 最後再考慮轉換。確實需要轉換時，請使用可信任或自行架設的轉換工具，並確認節點通訊協定、傳輸參數、策略群組範本與規則來源。

轉換工具可能會接觸原始訂閱與所有節點憑證，不建議將私人訂閱交給來源不明的公開轉換網站。轉換也無法讓舊版核心取得原本不支援的通訊協定；若節點需要 mihomo 支援的功能，請先確認用戶端實際執行的核心，而非只更改輸出檔案名稱。

訂閱匯入失敗：依下載、解析與連線階段排查

先查看用戶端記錄中的錯誤階段，再決定要修改哪項設定。下載失敗表示取得內容時出了問題，解析失敗則是讀取內容時發生錯誤；設定已載入但無法開啟網頁，才需要排查代理連線、規則與 DNS。將這三類問題混在一起處理，容易改亂原本正常的設定。

瀏覽器能開啟，為什麼用戶端仍然失敗？

瀏覽器可能帶有登入 Cookie，但用戶端通常會獨立發出訂閱請求；瀏覽器也可能使用系統代理，而用戶端更新訂閱時則可能直接連線，或使用專門的下載設定。因此，瀏覽器顯示帳戶頁面，不代表用戶端已取得 YAML。若更新必須透過代理，請先確認目前載入的設定可用，再檢查用戶端的訂閱更新代理選項，避免首次匯入時依賴尚未建立的連線。

設定已載入，但網頁仍無法開啟

• 確認目前選取的設定是否為新匯入的項目，以及策略群組是否已選取可用節點。
• 確認代理模式：規則模式會依規則比對；直連模式不會透過節點；全域模式也無法修復節點本身無法連線的問題。
• 確認系統代理連接埠與實際監聽連接埠是否一致。例如實際監聽連接埠為 7890，系統代理卻仍指向舊的 7897，應用程式就可能無法連線。
• 不使用系統代理的應用程式，需要另外確認流量接管方式，再考慮啟用 TUN；不要把 TUN 開關當成修復訂閱格式的工具。

自動更新與本機覆寫：建立可重複使用的設定流程

更新遠端訂閱時，通常會以遠端內容取代該項目的原有內容；直接編輯下載的 YAML，修改內容可能在下次更新時消失。若要固定 DNS、新增自訂規則或調整策略群組，建議使用用戶端支援的覆寫、合併設定或指令碼機制，並確認執行順序。不同用戶端的覆寫語法並不通用，不能將某款用戶端的指令碼直接當成核心設定欄位。

1. 先手動更新一次。確認下載與解析正常後，再設定定期更新。可先從 24 小時的更新間隔開始，並依服務提供者的說明調整，避免短時間內重複發出請求。
2. 分清更新項目。完整設定、代理 provider 與規則 provider 可能各自有不同的更新週期；更新其中一項，不代表其他資源也已更新。
3. 確認覆寫結果。檢查最後生效的設定與記錄，不要只看編輯畫面。自訂規則的位置會影響結果；通常在預設 MATCH 之後的規則不會再被比對。
4. 保留復原方式。儲存一份已確認可用的設定副本，並記下原始訂閱來源；更新失敗時，先還原可用設定，再查找原因。

匯入完成後，至少確認遠端下載成功、核心載入成功、策略群組可供選取，且目標應用程式確實依預期規則連線。若要進一步設定系統代理或 TUN，請參閱訂閱匯入與連線教學；欄位與 DNS 設定請見完整手冊，更新失敗的後續處理則請參閱訂閱更新疑難排解。