Clash Guide

Appearance

Mihomo (Clash Meta) 完整使用教程 2026：从零部署与 Web 面板 ​

直接结论：在 2026 年，Mihomo（原 Clash Meta）是全网最强悍、特性最前沿的开源代理内核。无论是在 Linux 软路由（OpenWrt/Docker）、无头 Linux 服务器还是 Windows 桌面后台，运行 Mihomo 的核心流程只需三步：下载对应系统架构的二进制执行文件 -> 配置带有 external-controller: 0.0.0.0:9090 的 config.yaml 规则文件 -> 通过浏览器打开 metacubexd Web 控制面板管理节点与分流。

一、Mihomo 系统架构与外部控制交互模型 ​

Mihomo 采用前后端分离的现代化架构，内核作为一个高性能轻量后台守护进程运行，通过 RESTful API 与 WebSocket 向外部 Web 管理面板提供实时控制通道：

mermaid
graph TD
    UserBrowser["管理员浏览器 (Chrome/Edge/手机)"] -->|HTTP / WebSocket 9090 端口| WebUI["metacubexd / yacd-meta Web 面板"]
    WebUI -->|RESTful 控制指令| MihomoCore["Mihomo (Go 语言原生内核守护进程)"]
    MihomoCore --> Inbound["入站流量监听 (mixed-port: 7890 / TUN 网卡)"]
    MihomoCore --> RuleEngine["路由分流引擎 (GeoSite / GeoIP / Rules)"]
    RuleEngine --> ProxyOut["出站代理节点 (VLESS / Reality / Hysteria2)"]
    RuleEngine --> DirectOut["国内直连网络 (DIRECT)"]

二、三步实操：从零部署与启动 Mihomo ​

步骤 1：获取对应硬件架构的 Mihomo 二进制文件 ​

根据您的运行平台前往官方 Releases 下载编译好的无头可执行文件：

  • 64 位 x86 电脑/软路由：mihomo-windows-amd64.exe 或 mihomo-linux-amd64
  • 树莓派 / ARM 软路由：mihomo-linux-arm64

步骤 2：编写核心配置文件 config.yaml ​

在二进制程序同一目录下创建 config.yaml，填入以下最小化可用配置：

yaml
# 基础监听端口
mixed-port: 7890
allow-lan: true
mode: rule
log-level: info
ipv6: false

# RESTful 外部控制器 (Web 面板连接凭证)
external-controller: 0.0.0.0:9090
secret: "ClashGuide2026"
external-ui: "metacubexd"

# 内置 DNS 引擎 (Fake-IP 防污染)
dns:
  enable: true
  listen: 0.0.0.0:1053
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  nameserver:
    - 223.5.5.5
    - 119.29.29.29
  fallback:
    - https://1.1.1.1/dns-query
    - https://dns.google/dns-query

# 代理集合（挂载您的机场订阅）
proxy-providers:
  my_sub:
    type: http
    url: "https://your-airport-sub-link.com"
    interval: 86400
    path: ./profiles/airport.yaml
    health-check:
      enable: true
      interval: 300
      url: https://www.gstatic.com/generate_204

proxy-groups:
  - name: "PROXIES"
    type: select
    use:
      - my_sub

rules:
  - GEOIP,lan,DIRECT,no-resolve
  - GEOSITE,cn,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,PROXIES

步骤 3：启动内核并通过 Web 面板管理 ​

在终端中启动程序：

bash
# Linux / macOS 运行
./mihomo -d .

# Windows PowerShell 运行
.\mihomo-windows-amd64.exe -d .

启动后，打开浏览器访问在线 Web 管理面板（例如 https://metacubex.github.io/metacubexd/）：

  1. API 地址：填写 http://127.0.0.1:9090（如果是远程软路由，填软路由局域网 IP 如 http://192.168.1.1:9090）；
  2. Secret 密钥：填写刚才在配置文件中设定的 ClashGuide2026；
  3. 点击连接，即可在优雅的暗色仪表盘中实时查看网络上下行速率、切换节点与批量测速！

三、进阶：配置 Linux Systemd 无人值守守护进程 ​

若在软路由、Ubuntu 服务器或 NAS 上长期运行，推荐配置 Systemd 守护进程以实现开机自启与崩溃自愈：

ini
# /etc/systemd/system/mihomo.service
[Unit]
Description=Mihomo Proxy Daemon
After=network.target

[Service]
Type=simple
User=root
ExecStart=/usr/local/bin/mihomo -d /etc/mihomo
Restart=always
RestartSec=5
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target

执行以下命令使其常驻：

bash
sudo systemctl daemon-reload
sudo systemctl enable --now mihomo

四、常见问题速查（FAQ） ​

Q1：Web 面板连接提示“Network Error”连不上外部控制器怎么办？ ​

答：主要排查两点：1. 检查 external-controller 是否填写为 0.0.0.0:9090 而不是 127.0.0.1:9090（若从局域网其他设备访问必须绑定 0.0.0.0）；2. 检查操作系统防火墙是否放行了 9090 TCP 端口。

Q2：Mihomo 内核支持直接导入 Clash Verge 的配置文件吗？ ​

答：完全兼容。Clash Verge Rev 底层正是 Mihomo 内核，其 profiles 目录下的 YAML 文件可直接无缝供 Mihomo 读取运行。

Q3：为什么日志提示“Country.mmdb not found”？ ​

答：这是由于缺少 GeoIP 离线 IP 库文件。新版 Mihomo 会在首次启动时自动尝试从 GitHub 下载；若网络受阻，可手动将 Country.mmdb 或 GeoIP.dat 放置在配置根目录下。

五、优质专线服务商与生态导流 ​

Mihomo 极客内核需搭配吞吐充沛的高 SLA 专线，方能跑满千兆带宽：

商业评测参考jichangblog.blog
2026 高可用晚高峰不卡顿机场深度横评
全专线 BGP 入口与多线机房容灾，完美契合 Mihomo 内核多线程吞吐与软路由高并发需求。
查阅高稳定性专线推荐

最后核验更新：2026-06-01 · 聚焦 Mihomo 原生内核实操与 Web 仪表板集成