Clash Meta 全面升級指南：從舊版 Core 遷移到 Mihomo 核心完整教學

為什麼必須從舊版 Clash Core 升級到 Mihomo？

若您仍在使用 2022 年以前釋出的原版 Clash Core（即 Dreamacro 維護的版本），本篇教學對您格外重要。原版 Clash 專案已於 2023 年 11 月宣告停止維護，官方 GitHub 儲庫亦改為唯讀封存。這代表您的用戶端將不再取得任何安全性修補或新功能支援。

與此同時，代理協議生態系正快速演進。愈來愈多代理服務商開始部署 VLESS + REALITY、Hysteria2、TUIC v5 等新一代協議——這些協議在舊版 Clash Core 中完全無法使用。若您的節點清單出現大量「連線失敗」或「協議不支援」錯誤，十之八九是核心版本過舊所致。

Mihomo（原 Clash Meta）是目前社群最活躍的 Clash 核心分支，由 MetaCubeX 團隊持續維護。它在完整保留舊版 Clash 設定語法的基礎上，新增對 REALITY、Hysteria2、TUIC v5、Shadowsocks 2022 等協議的原生支援，並修復多項記憶體洩漏與連線穩定性問題。升級至 Mihomo 核心，是延續 Clash 使用體驗最實際的選擇。

升級前的準備工作

動手升級前，建議先花約五分鐘完成下列準備，可降低資料遺失或設定失效的風險。

1. 備份現有設定檔

Clash 的設定檔通常命名為 config.yaml，預設位於下列路徑：

• Windows：%USERPROFILE%\.config\clash\，或用戶端資料目錄下的 profiles\ 資料夾
• macOS：~/.config/clash/
• Linux：~/.config/clash/

請將整個 clash 設定資料夾複製到桌面或其他安全位置備份。這是最關鍵的一步；即便升級不如預期，也能隨時還原為舊版設定繼續使用。

2. 確認您的用戶端類型

Mihomo 核心本身為命令列程式，一般使用者多半不會直接操作，而是透過下列具圖形介面的用戶端間接啟動：

若您使用 Clash Verge Rev 或 FlClash，恭喜——這些用戶端已預設採用 Mihomo 核心，只需將用戶端更新至最新版本即可，通常不必手動替換核心檔。

若仍使用舊版 Clash for Windows 或 ClashX，則請依下文步驟手動處理。

Windows 平台：更換 Mihomo 核心

在 Windows 上更換核心相對單純，大致分為：下載新核心、覆寫檔案、重新啟動用戶端。

第一步：下載 Mihomo 核心

前往 Mihomo GitHub Releases 頁面，在最新版本的 Assets 中選擇適用 Windows 的檔案：

• 64 位元 Intel／AMD 處理器（多數使用者）：選擇 mihomo-windows-amd64.zip
• ARM 架構（如 Surface Pro X）：選擇 mihomo-windows-arm64.zip

下載後解壓縮，可取得 mihomo-windows-amd64.exe（檔名依版本可能略有差異）。

第二步：覆寫核心檔

不同用戶端的核心檔位置不同，常見例如：

• Clash for Windows：於安裝目錄找到 resources\static\files\win\x64\，將其中 clash-win64.exe 換成剛下載的 mihomo-windows-amd64.exe，並重新命名為 clash-win64.exe

第三步：重新啟動並驗證

完成後重新開啟用戶端，於「設定」或「關於」頁面查看核心版本字串。若出現 Mihomo 或 Meta 字樣，即表示更換成功；也可在用戶端的日誌面板查看啟動紀錄確認。

macOS 平台：遷移至新用戶端

在 macOS 上，我們建議直接改用已內建 Mihomo 的新用戶端（例如 Clash Verge Rev），而非在舊版 ClashX 內硬換核心——ClashX 專案本身亦已停止更新，即使更換核心，圖形介面層仍可能出現各種相容性問題。

第一步：記錄或匯出訂閱連結

在 ClashX 的設定／設定檔管理介面中，找到您的訂閱連結（通常為以 https:// 開頭的網址）並複製保存。若您使用本機 YAML 設定檔，請一併備份該檔案。

第二步：安裝新用戶端

請造訪本站 下載頁面，選擇適合您 Mac 的版本：

• Apple Silicon（M1／M2／M3／M4 等）：下載 ARM64（Apple Silicon）版本
• Intel 晶片 Mac：下載 x64 版本

安裝後首次啟動時，macOS 可能顯示安全性提示；請至「系統設定 → 隱私權與安全性」中依指示允許開啟（例如點選「仍要開啟」）。

第三步：匯入訂閱連結

於新用戶端的「訂閱」或「設定檔」畫面貼上先前保存的訂閱連結，點選「匯入」或「更新」，待節點清單載入完成後即可切換節點使用。

設定檔遷移注意事項

Mihomo 在語法上與舊版 Clash Core 高度相容，多數現有設定檔可不修改直接載入。少數欄位行為不同，升級後可能導致載入失敗，宜特別留意：

主要設定差異對照

Mihomo 核心基礎設定範例

以下為相容 Mihomo 的最小化 config.yaml 範例，可作為遷移時的參考：

YAMLmixed-port: 7890
allow-lan: false
mode: rule
log-level: info
ipv6: true

external-controller: '127.0.0.1:9090'
secret: ''

dns:
  enable: true
  ipv6: false
  enhanced-mode: fake-ip
  fake-ip-range: '198.18.0.1/16'
  nameserver:
    - 'https://doh.pub/dns-query'
    - 'https://dns.alidns.com/dns-query'
  fallback:
    - 'https://cloudflare-dns.com/dns-query'
    - 'tls://dns.google'
  fallback-filter:
    geoip: true
    geoip-code: CN

tun:
  enable: false
  stack: system
  dns-hijack:
    - 'any:53'
  auto-route: true
  auto-detect-interface: true

proxies: []

proxy-groups:
  - name: "節點選擇"
    type: select
    proxies:
      - "自動選擇"
      - DIRECT

  - name: "自動選擇"
    type: url-test
    proxies: []
    url: 'http://www.gstatic.com/generate_204'
    interval: 300

rules:
  - GEOIP,CN,DIRECT
  - MATCH,節點選擇

升級後常見問題與解法

即使依上述步驟操作，升級後仍可能遇到下列狀況。以下整理使用者最常回報的類型與對應處理方式：

問題 1：Dashboard 面板無法連線（ERR_CONNECTION_REFUSED）

此為升級後極常見情況。常見原因包括：external-controller 監聽位址從 0.0.0.0:9090 改為 127.0.0.1:9090，或連接埠遭防火牆阻擋。

解法：開啟設定檔，確認 external-controller 的值，於瀏覽器開啟對應網址（例如 http://127.0.0.1:9090/ui）。若使用具圖形介面的用戶端，通常可在設定中點選「開啟 Dashboard」捷徑。

問題 2：節點全部逾時或連線失敗

可能原因多元，請依序檢查：

• 訂閱未更新：部分服務商在伺服器端升級節點協議後，舊訂閱內容可能已過期。請在用戶端手動執行一次「更新訂閱」，重新取得最新節點清單。
• DNS 解析失敗：Mihomo 預設常搭配 fake-ip 模式；若 DNS 設定不當，可能導致節點網域名稱無法解析。請檢查 dns.nameserver，建議至少設定一組國內與一組國外上游 DNS。
• 系統代理未啟用：Mihomo 核心本身不會自動寫入系統代理，需透過用戶端開啟系統代理，或手動將系統代理指向 127.0.0.1:7890（連接埠依您的設定為準）。

問題 3：TUN 模式無法啟動

Mihomo 的 TUN 模式通常需要管理員權限以建立虛擬介面。在 Windows 上，可能需以系統管理員身分啟動用戶端，或啟用用戶端的「服務模式」；在 macOS 上，則可能需在系統設定中允許安裝系統延伸功能。

問題 4：規則設定載入報錯

Mihomo 對規則語法較為嚴格，舊版核心「勉強能接受」的非標準寫法可能在新核心中失敗。常見情況包括：

• RULE-SET 規則須搭配 rule-providers 定義；若單寫 RULE-SET,xxx,DIRECT 卻未定義對應的 provider，將導致錯誤
• 規則集檔案須為有效 YAML 或 MRS 等支援格式；Mihomo 不接受部分非標準規則集格式
• 代理組名稱不宜含特殊字元，建議僅使用中文、英文字母與數字

升級後驗證與效能最佳化

完成升級後，建議依下列步驟確認運作正常，並視需要調整幾項基礎最佳化設定：

驗證步驟

1. 在 Dashboard 的「代理」頁面確認節點清單正常顯示，並對常用節點執行延遲測試，應能取得延遲數值
2. 以瀏覽器開啟海外網站（例如 Google），確認頁面可正常載入
3. 於 Dashboard「日誌」檢視即時紀錄，確認未持續出現 ERROR 或 FATAL 等級訊息
4. 若您使用 REALITY 或 Hysteria2 節點，請確認延遲測試能回傳合理數值（舊版核心無法辨識時，往往直接顯示逾時）

效能最佳化建議

升級至 Mihomo 後，可透過下列設定進一步改善體驗：

• 啟用 TCP 並行連線：於設定檔加入 tcp-concurrent: true，可同時嘗試多條連線並採用較快路徑
• 啟用 geodata 自動更新：Mihomo 可自動更新 GeoIP、GeoSite 等資料檔，讓規則分流更精準
• 使用 profile 節點快取：啟用 profile.store-selected: true，用戶端重啟後可記住上次選取的節點，減少重複手動切換

總結：升級 Mihomo 是合理的長期選擇

舊版 Clash Core 停止維護，清楚傳達了生態已進入以 Mihomo 為核心的新階段。無論是協議支援完整度、長期安全性更新，或對現代設定語法的相容性，Mihomo 整體都優於舊版核心。

若現有用戶端仍堪用，可優先考慮僅更換核心檔；若用戶端本身也已停更（例如舊版 Clash for Windows），則一次遷移到新世代用戶端通常更省事，後續維護成本也較低。

挑選新用戶端時，建議優先選擇深度整合 Mihomo 核心、圖形介面完善者——它們往往在訂閱管理、節點切換、TUN 模式開關等日常操作上投入較多心力，整體體驗會比單純操作命令列輕鬆許多。

若遷移過程遇到本文未涵蓋的狀況，歡迎另參考本站 教學頁面；亦可直接試用我們推薦的用戶端——已預先搭載多數合理預設值，即使是首次接觸 Clash 也能較快上手。