Clash 訂閱匯入

先確認訂閱內容，再選擇匯入方式

已取得訂閱網址時，建議優先使用用戶端的遠端 URL 匯入。QR Code 適合在不同裝置間傳遞網址；本機 YAML 則適合離線搬移或檢查設定。這三種方式解決的是「如何將設定交給用戶端」，不會改變用戶端核心支援的協定，也不會自動修正訂閱格式。

匯入前，先在訂閱服務商頁面選擇 Clash 或 Clash Meta / mihomo 格式，再複製完整網址。帳戶登入頁、方案管理頁和訂閱網址是不同項目。網址問號後的查詢參數可能包含身分驗證權杖，複製時請勿刪除，也不要連同結尾標點一起複製。

透過 URL 匯入：下載設定後還要啟用

桌面用戶端通常會在「訂閱」或「設定檔」頁面管理遠端設定，而非在系統代理設定中操作。以下依常見介面名稱說明；不同版本或介面語言的按鈕名稱可能不同，請以用戶端目前顯示為準。

Windows、macOS 與 Linux 桌面版

1. 以 Clash Verge Rev 為例，開啟側邊欄的「訂閱」，在訂閱連結欄位貼上完整 URL，再按「匯入」。若介面採用「新增」對話框，請選擇遠端類型並輸入 URL。
2. 等待下載與解析完成。確認清單中出現新設定，且更新時間有所變動；只看到空白設定卡片，不代表內容已成功取得。
3. 點選該設定，將它設為目前使用的設定，再前往「代理」頁面檢查策略組。切換設定可能會改變策略組名稱和規則，請勿只查看先前選取的節點。
4. 在「設定」中啟用系統代理，或依需求啟用 TUN。驗證時先只採用一種明確的流量接管方式，避免同時調整多項網路選項。

FlClash 等用戶端也需要在設定管理中新增遠端設定，再將其設為目前使用的項目。在 macOS 上執行 ClashX Meta 時，可在選單列 App 的「設定」→「託管設定」中尋找管理入口。請勿直接套用不同用戶端的選單路徑，也不要把「核心已啟動」視為「新訂閱已啟用」。

Android 與 iOS 行動裝置

1. Clash for Android 常見的操作路徑是「設定」→「＋」→「從 URL 匯入」。輸入名稱和訂閱網址後儲存，等待遠端內容下載完成。
2. 返回設定清單，點選新增項目，再回到首頁啟動。Android 首次建立 VPN 連線時需要系統授權；若其他 VPN 正在使用連線，請先將它停止。
3. 使用其他 Android 或 iOS 用戶端時，請在「設定」或「訂閱」中選擇 URL 匯入，並先確認用戶端支援該訂閱格式與節點協定。iOS 用戶端不一定使用 Clash YAML，不能只憑有「訂閱」按鈕就判定相容。

遠端匯入失敗時，先查看具體錯誤。連線逾時通常與網路路徑有關；HTTP 401 或 403 常見原因包括憑證失效、存取受限或伺服器攔截；若下載成功後出現解析錯誤，則應檢查回傳內容和核心相容性。不同原因需要不同處理方式，不宜反覆點選匯入碰運氣。

QR Code 匯入：分辨訂閱網址與單一節點

QR Code 只是文字的載體。內容可能是 HTTPS 訂閱網址，也可能是以 ss://、vmess:// 或 trojan:// 開頭的單一節點 URI。掃描成功只代表讀取到文字，不表示用戶端能將它當成完整設定使用。

1. 在用戶端的新增設定頁面尋找掃描 QR Code 的入口。若需要相機權限，請依系統提示授權；若 QR Code 已存於相簿，且用戶端支援此功能，可選擇從圖片辨識。
2. 辨識後請確認內容類型。若是 HTTPS 網址，確認來源可信後再儲存為遠端設定；若是單一節點 URI，則應使用用戶端支援的節點匯入流程。
3. 匯入完成後，檢查設定清單和策略組。匯入單一節點可能只會新增一個節點，不包含規則、DNS 或策略組，因此需要搭配用戶端的設定範本。

若同一部裝置沒有從圖片辨識的功能，直接複製原始訂閱 URL 會更穩妥。請勿為了掃描而將訂閱 QR Code 上傳至公開辨識網站。若用戶端顯示「不支援的 QR Code 內容」，請返回訂閱頁面選擇 Clash 格式，而非反覆將節點 QR Code 匯入遠端設定入口。

匯入本機 YAML 與搬移設定

先將檔案儲存為 UTF-8 編碼的 .yaml 或 .yml，再透過用戶端的「本機檔案」、「從檔案匯入」等入口選取檔案。Clash for Android 通常可在「設定」→「＋」中找到檔案匯入；桌面版則可從設定管理頁新增本機設定或匯入檔案。

副檔名無法判斷檔案實際內容。瀏覽器下載的登入頁，即使重新命名為 config.yaml，仍然不能當作設定使用。請用文字編輯器檢查檔案開頭：若出現 <!DOCTYPE html>、登入表單或網站錯誤訊息，請回到訂閱來源重新取得檔案，不要繼續調整 YAML 縮排。

搬移前先確認三件事

• 內容完整：設定必須包含可用的出站節點和相應策略。只有 proxies: 的節點片段，不等於包含策略組和規則的完整訂閱設定。
• 相依檔案：檢查 proxy-providers、rule-providers 中的本機路徑。複製主檔案不會一併複製它所引用的規則檔和節點檔。
• 相容性：Clash Meta / mihomo 的擴充欄位和協定不一定受舊版 Clash 核心支援。若出現「不支援的代理類型」，應確認核心支援範圍，不要只刪除欄位名稱。

匯入本機設定後，仍須手動選取該設定。若檔案在外部編輯器中有變更，也要執行用戶端提供的重新載入操作；部分用戶端匯入時會複製檔案，而非持續讀取原始路徑。

Clash YAML 與 Base64 訂閱有何不同

「訂閱連結」指的是取得內容的入口，並非統一的檔案格式。同一個 HTTPS 網址可能依伺服器參數回傳 Clash YAML、Base64 編碼的節點清單，或其他用戶端使用的 JSON 設定。能在瀏覽器中開啟，不代表目前的用戶端能解析。

Base64 是一種編碼方式，不是節點協定，也不具加密保護。若服務商提供多種匯出格式，請優先選擇原生 Clash 或 mihomo 設定。必須轉換時，優先使用可信的本機工具或自行架設的轉換服務；轉換服務取得完整訂閱網址後，通常也能讀取其中的節點憑證。

另一種容易混淆的內容是 proxy-provider 檔案。它可能是合法的 YAML，但通常只包含 proxies 集合，應由主設定中的 proxy-providers 引用。直接將它當成完整設定啟用，可能會缺少預期的策略組和規則。完整設定也可能主要依賴 provider，而不直接列出節點，因此不能只靠尋找某個鍵來判斷檔案是否完整。

匯入後未生效？依四個環節逐一排查

1. 設定是否確實載入

先檢查目前選取的設定名稱和最近一次載入記錄。若記錄顯示 YAML 解析失敗，請依錯誤行號檢查縮排、冒號和引號。YAML 縮排請使用空格，不要使用定位字元；規則引用的策略組名稱必須與設定中的名稱一致。下載成功但載入失敗時，用戶端可能仍在執行舊設定。

2. 應用程式是否連到正確的代理連接埠

若未啟用系統代理，一般瀏覽器流量通常不會因為「已匯入設定」就自動進入核心。以下只是用來說明連接埠關係的設定片段，不能單獨作為訂閱使用：

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

mixed-port: 7890 表示同一個監聽連接埠可接收 HTTP 與 SOCKS 代理連線。若目前設定確實使用此連接埠，手動設定應用程式代理時可填入 127.0.0.1:7890。實際值請以用戶端執行時的設定為準；部分用戶端會覆寫訂閱中的連接埠。控制介面的連接埠不等於流量代理連接埠，請勿填入瀏覽器代理設定。

3. 策略組是否有可用出口

進入策略組並選取一個實際節點，再執行延遲測試。若結果為 timeout，請先確認測試網址和節點連線狀態；顯示 120 ms 之類的數值，只代表該次測試要求已完成，不保證所有網站都能存取。開啟目標網站時，同時查看連線記錄中的規則、策略組和最終出口，才能確認該次要求的流量走向。

4. 流量接管與 DNS 設定是否一致

規則模式會依規則順序決定流量出口。若目標符合 DIRECT，即使已選取代理節點，也可能仍以直連方式連線。TUN 模式負責接管符合路由條件的流量，但需要相應權限和路由設定；它無法讓不相容的訂閱變成可用設定。若 DNS 解析失敗，請查看解析記錄，再檢查設定中的 DNS 上游、Fake-IP 設定及過濾項目，不要一開始就隨意更換多個參數。

• 清單中沒有設定：檢查下載結果、訂閱網址和格式。
• 有設定但沒有預期的策略組：確認匯入的是否為節點片段，或目前是否仍在使用舊設定。
• 策略組有節點但連線逾時：檢查節點狀態、協定相容性和基本網路連線。
• 測試正常但瀏覽器沒有變化：檢查系統代理、TUN 流量接管、瀏覽器個別代理設定及連線記錄。

保留更新能力，並準備回復設定

首次匯入並確認正常後，再設定自動更新。設定層級的訂閱更新與 provider 的 interval 是兩套機制：前者由用戶端取得整份遠端設定，後者由核心更新設定引用的遠端資源。請勿將 provider 的秒數直接當作用戶端訂閱更新間隔；用戶端介面可能以分鐘或小時為單位。

可先將整份訂閱的更新間隔設為 24 小時，再依服務商要求調整。行動裝置的背景更新也會受到系統省電策略限制；即使設定週期，App 停止執行後也不代表仍會準時更新。更新前請保留一份可用設定；更新後核對策略組、規則和目前的出口。若需重新匯入或更換用戶端，請參閱使用指南中的訂閱設定步驟，再繼續確認連線。