入門指南 預計閱讀 12 分鐘

Clash Profile 是什麼？訂閱設定、本機 YAML 與多組設定檔管理入門

認識 Clash Profile，了解遠端訂閱與本機設定檔的差異，以及更新週期、設定覆寫、多組設定檔切換與備份方式。

Profile 是設定檔記錄，不是單一節點

Clash 用戶端中的 Profile 通常指一筆可選取、可載入的設定檔記錄。來源可能是訂閱連結，也可能是磁碟上的 YAML 檔案。用戶端通常還會為這筆記錄儲存名稱、來源網址、更新時間與更新方式；這些管理資訊不一定會寫入核心讀取的 YAML。

完整設定檔可能包含監聽連接埠、DNS、代理節點、代理群組與分流規則，節點只是其中一部分。匯入設定檔後，還必須在用戶端啟用，核心才會依照最終設定處理新連線。已新增訂閱、已啟用設定檔、已開啟系統代理，是三種不同狀態。

三種容易混淆的操作

  • 更新訂閱：從原本的網址重新取得內容，不代表一定會切換到這份設定檔。
  • 切換 Profile：更換目前使用的設定來源，代理群組、規則與 DNS 都可能隨之改變。
  • 切換節點：在目前設定檔的某個代理群組中更改選取項目，通常不會更換整份設定檔。

各用戶端的介面名稱不盡相同，常見入口包括「訂閱」、「設定檔」和「Profiles」。本文以 Profile 泛指設定檔記錄，不會將特定用戶端的按鈕名稱當成所有產品通用的選單。

遠端訂閱、本機 YAML 與代理提供者的差異

類型包含內容更新方式適用情境
遠端 Profile伺服器回傳的設定檔；內容是否完整取決於訂閱格式用戶端依 URL 重新取得節點與規則由訂閱來源管理
本機 Profile本機 YAML 檔案中的設定手動編輯或重新匯入固定設定、離線備份、測試規則
代理提供者可供代理群組引用的節點集合依提供者的更新設定重新整理維持主設定檔穩定，只更新節點

遠端訂閱是一種取得方式，YAML 是一種資料格式，兩者並不互斥：遠端訂閱也可以回傳 YAML。本機匯入通常會在用戶端內儲存副本；編輯原始下載檔後，用戶端中的副本不一定會同步更新，請確認匯入時是複製檔案，還是直接參照原檔。

訂閱連結也不保證能直接由 Clash 核心讀取。只有節點 URI 清單、網頁 HTML、登入頁面或錯誤訊息，都不能當成完整的 Clash 設定檔載入。匯入前應選擇訂閱來源明確提供的 Clash 或 mihomo 相容格式，並確認用戶端使用的核心。

proxy-providers 不是另一份完整的 Profile

在支援此功能的核心中，主設定檔的 proxy-providers 用來定義節點來源；proxy-groups 可透過 use 引用提供者。提供者重新整理節點，不代表主設定檔的 DNS、規則或連接埠也會被替換。規則提供者 rule-providers 載入的是規則集合，不可與節點提供者混為一談。

首次匯入：先確認格式，再確認是否啟用

  1. 前往安裝檔下載頁面，選擇適合作業系統的用戶端。請記下用戶端版本與核心版本，之後排查設定相容性時會用到。
  2. 開啟設定檔管理頁面，新增遠端訂閱網址，或匯入本機 .yaml、.yml 檔案。貼上遠端網址時請使用完整網址，避免混入空格、換行或通訊軟體附加的標點符號。
  3. 為記錄設定容易辨識的名稱，例如「日常-遠端」、「辦公-本機」、「測試-DNS」。名稱僅供管理，不會自動建立同名代理群組。
  4. 執行更新並查看結果。如果出現解析失敗，請先檢查回傳內容與格式，不要試圖反覆開啟系統代理來排除語法錯誤。
  5. 選取並啟用這份設定檔，確認代理群組與規則清單已載入，再決定是否啟用系統代理或 TUN。

系統代理會讓遵循系統代理設定的應用程式連線至本機代理連接埠；TUN 則透過虛擬網路介面接管符合路由條件的流量。兩者都不是匯入設定檔的必要步驟，也不會自動修正節點驗證錯誤。TUN 是否可用，還取決於核心、作業系統權限與路由設定。

連接埠請以用戶端實際顯示的值為準。以下範例使用 7890 作為混合代理連接埠，這只是範例設定值，不表示所有用戶端都會監聽 127.0.0.1:7890。

本機 YAML 範例：了解設定檔的範圍

以下本機設定檔範例用於說明欄位之間的關係，適合在 mihomo 環境中檢查基本結構。範例只有直連出口，不具備遠端代理功能。將檔案儲存為 local-direct.yaml 並匯入後，即可觀察連接埠、代理群組與規則之間的關係。

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

proxies: []

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

rules:
  - DOMAIN-SUFFIX,example.com,手動選擇
  - MATCH,DIRECT
  • mixed-port 是 HTTP 與 SOCKS 代理共用的監聽連接埠；若連接埠已被其他程序占用，請改用未使用的連接埠。
  • allow-lan: false 不會向區域網路裝置開放代理存取；這項設定與是否啟用 TUN 無關。
  • mode: rule 表示依規則分流。範例最後的 MATCH,DIRECT 會接收前面未符合的請求。
  • 手動選擇 群組中只有 DIRECT，因此流量即使符合該群組，仍會直接連線。規則引用的群組名稱必須一致。

YAML 縮排請使用空格，不要混用 Tab。false 這類布林值應與字串區分；清單項目則必須保留 -。若發生解析錯誤，請先查看記錄檔指出的行及其上一行，常見原因包括縮排層級錯誤、漏寫冒號或引號未成對。

能成功解析不代表可以連線。通過語法檢查後，還要分別確認節點是否存在、代理群組引用是否有效，以及規則是否導向預期出口。原版 Clash、Clash Premium 與 Clash Meta（現稱 mihomo）的功能範圍不同，不能只看副檔名就判定設定檔相容。

更新週期：區分訂閱更新與節點健康檢查

遠端 Profile 的自動更新通常由用戶端管理。主設定檔中的 HTTP 代理提供者則可透過 interval 設定更新週期；在 mihomo 的相關欄位中，數值單位是秒。兩者作用於不同層級，不要以為設定其中一項就會自動管理另一項。

週期換算範例

  • 3600 秒等於 1 小時。
  • 21600 秒等於 6 小時。
  • 86400 秒等於 24 小時。

上述換算適用於以秒為單位的欄位。用戶端介面也可能要求輸入分鐘，或直接提供小時選項，請以輸入欄位的標示為準。日常使用可先依訂閱來源建議的週期更新；若沒有特別要求，可從每天更新一次開始，再依節點變動頻率調整。

節點健康檢查只會測試指定網址的連線狀態與延遲，不會下載新的節點清單。清單中出現無法使用的節點時，請區分「健康檢查失敗」與「訂閱取得失敗」：前者應檢查出口、測試網址與逾時設定；後者則應檢查訂閱網址、網路路徑、存取權限與回應格式。

設定覆寫：將個人設定與遠端內容分開

直接編輯遠端訂閱下載的 YAML，內容可能在下次更新時被取代。需要長期保留的個人規則、DNS 或連接埠設定，應優先使用用戶端提供的覆寫、合併或指令碼功能。實際支援項目依用戶端而異；Clash 核心本身無法辨識所有用戶端專用的覆寫檔案格式。

先確認最終生效的設定

可以將載入流程理解為「訂閱來源設定 → 用戶端合併與覆寫 → 核心執行設定」。這是排查問題的思路，並非所有用戶端都固定採用相同順序。有些用戶端會以介面設定覆蓋設定檔中的連接埠，有些則會區分全域覆寫與個別 Profile 覆寫。排查時應查看最終執行設定，不要只看訂閱原始內容。

  1. 一次只改一項：例如只新增一條網域直連規則，避免同時調整 DNS、TUN 與所有代理群組。
  2. 確認合併方式：清單可能會被取代、置於前方或附加在後。規則依序比對；若將新增規則附加在兜底 MATCH 之後，通常不會達到預期效果。
  3. 確認引用名稱：自訂規則指向的代理群組，必須存在於合併後的設定檔中。
  4. 更新後再次檢查：手動更新一次訂閱，再確認新增規則是否仍存在，以及排序是否正確。

跨多個 Profile 共用覆寫時尤其要小心：設定檔 A 有「手動選擇」群組，不代表設定檔 B 也有。如果共用規則依賴這個名稱，切換後可能會出現無效引用。可以統一自行管理的群組名稱，也可以為每份 Profile 設定獨立覆寫，避免將來源不同的設定檔硬套進同一份修改指令碼。

切換多組設定檔：啟用一份，保留多份備份

一般的單一執行個體用戶端通常會選擇一份主要 Profile，再套用自身支援的覆寫。新增三份訂閱，不代表三份規則會自動合併，也不代表所有節點都會出現在同一個代理群組中。若要彙整節點，應明確規劃主設定檔與代理提供者，不要依賴設定檔清單的排列順序。

建議保留三種用途明確的設定檔

  • 日常設定：使用穩定來源並自動更新，作為預設設定檔。
  • 備用設定：另外確認來源與存取方式，並定期手動更新，避免臨時要用時才發現已失效。
  • 實驗設定：用於測試 DNS、規則或 TUN 參數，關閉不必要的自動更新，方便比較修改前後的差異。

切換前請記下目前的設定檔名稱、模式、代理群組選項與連接埠。切換後確認新設定檔是否仍使用規則模式，以及 DNS、區域網路存取與 TUN 設定是否有所變動。用戶端可能會保留部分全域開關，因此更換 Profile 不一定會重設所有設定。

既有連線不一定會在切換後立即改用新的出口，實際情況取決於用戶端的重新載入方式，以及連線是否已關閉。驗證時請建立新的請求；必要時可在用戶端關閉舊連線，或重新啟動目標應用程式。不要只根據仍在傳輸的下載工作判斷切換是否成功。

備份與還原：保存來源、覆寫與執行環境

只備份 YAML 通常不足以完整還原用戶端。遠端網址、更新週期、覆寫檔案與介面上的全域設定，可能分別儲存在用戶端資料庫或設定目錄中。移轉前應優先使用用戶端支援的匯出功能，並確認匯出內容是否包含敏感資訊。

  1. 保存來源資訊：記下訂閱的管理位置、設定檔名稱與更新週期；含權杖的連結請存放在受保護的位置。
  2. 保存本機檔案：備份本機 YAML、覆寫指令碼與自行維護的規則檔案。若設定依賴相對路徑，也要保留原有目錄結構。
  3. 記錄執行環境：記下用戶端與核心版本、實際監聽連接埠、系統代理狀態及 TUN 設定。
  4. 實際測試還原：先匯入設定檔，再載入覆寫，確認記錄檔沒有解析或引用錯誤，最後測試新連線。

檔名可採用 daily-2026-08-27.yaml 與 override-2026-08-27.yaml，方便一眼辨識來源與日期。備份不能讓快取永久保持為有效訂閱：節點憑證可能過期，還原後仍須重新取得遠端來源並確認連線正常。

常見問題：更新、切換與還原異常

訂閱更新成功，為什麼自訂規則不見了？

通常是因為修改套用在遠端設定檔的副本上，更新後便被來源內容取代。請先從備份找回規則，再移至用戶端支援的覆寫位置，並確認清單合併方式與規則順序。不要在每次更新後繼續手動修補整份訂閱。

切換設定檔後節點清單沒有變化，該檢查哪些地方？

先確認執行的是「啟用」而不只是「更新」，再查看目前啟用的設定檔標記與重新載入記錄。如果最終設定使用代理提供者，兩份 Profile 也可能引用相同的節點來源。還要檢查介面顯示的是否仍是上一次快取的清單。

本機設定檔可以自動取得新節點嗎？

純靜態節點清單不會自行變動。如果本地主設定檔使用受支援的 HTTP 代理提供者，並設定更新參數，就能讓主設定檔留在本機、節點則依遠端來源更新。此時主設定檔與提供者來源設定應分開備份。

匯入另一款用戶端後提示欄位不支援，可以直接刪除嗎？

請先確認新用戶端實際使用的核心及版本。該欄位可能屬於 mihomo 擴充功能、舊版核心功能，或用戶端專用中繼資料。刪除前應確認欄位用途，否則即使解析成功，也可能失去 DNS、規則或路由功能。可參考本站的協定參考與核心文件逐項確認。

管理多份 Profile 的關鍵，在於釐清四個位置：設定檔來源、個人修改的儲存位置、目前啟用的設定檔，以及核心最終載入的內容。依這四項逐一檢查，通常就能找出更新覆蓋、切換異常與移轉後設定遺失的問題所在。

下載用戶端