流程概览

前言

Mihomo（原名 Mihomo Meta，亦即 Clash Meta）是目前 Clash 核心最活跃、功能最强大的分支。由于原始 Clash 项目删库，Mihomo 已成为各平台客户端的首选核心。

值得注意的是，Mihomo 本身是一个纯命令行程序（Core），没有图形界面。为了方便日常管理和监控，我们需要为其搭配一个 Web UI（如 Metacubexd）。本文将详细介绍如何在 Docker 环境（包括 Linux 服务器、NAS、飞牛OS等）中优雅地部署 Mihomo + WebUI，并开启 TUN 模式实现更接管更底层的流量。

准备工作

在开始之前，请确保您的环境满足以下条件：

• Docker 环境：已安装 Docker 及 Docker Compose。
• 基础知识：熟悉基本的命令行操作（创建文件夹、编辑文件）。
• 网络环境：拥有可用的节点订阅链接。
• 体验订阅地址：https://xboard.88531.cn

第一步：编写配置文件 (config.yaml)

Mihomo 的运行核心在于配置文件。我们需要先在宿主机上准备好这个文件。

1. 新建一个文件夹，命名为 mihomo。
2. 在其中创建一个名为 config.yaml 的文件。
3. 参考以下模板填入内容。

⚠️ 重点修改提示： 请务必修改下方模板中的 第 7 行（API访问密钥）、第 20、21 行（节点订阅信息）与 第 26 行（节点名称前缀）。修改时请去掉尖括号 < >。

[crayon-6ab3983a09198081534748/]

​

第二步：构建 Docker Compose

我们将同时部署 Mihomo 核心 和 Metacubexd (WebUI)。

在 mihomo 文件夹同级或任意位置，创建 docker-compose.yml。

🌟 关键配置说明 (TUN 模式支持)： 为了支持 TUN 模式（虚拟网卡），容器必须拥有网络管理权限。我们在配置中加入了 cap_add: [NET_ADMIN] 和 devices: [/dev/net/tun]，这是实现透明代理的关键。

[crayon-6ab3983a091af724923574/]

​

第三步：启动与初始化

1. 启动容器

在 docker-compose.yml 所在目录执行：

[crayon-6ab3983a091b7051868260/]

如果是飞牛OS等图形化系统，请直接在 Docker 管理器中“使用现有 Compose 文件”创建项目即可。

2. 解决规则文件下载失败 (Fatal Error)

初次启动时，查看日志可能会发现如下报错： level=fatal msg="Parse config error... can't download MMDB: context deadline exceeded"

这是因为网络环境导致容器无法自动下载 GeoIP/GeoSite 数据库。

解决方法：

1. 前往 MetaCubeX/meta-rules-dat 下载以下文件：
   • geoip.dat
   • geosite.dat
   • country-lite.mmdb
   • GeoLite2-ASN.mmdb
2. 将这4个文件手动上传到宿主机的 mihomo 文件夹（与 config.yaml 同级）。
3. 重启容器：sudo docker-compose restart mihomo

第四步：配置 WebUI

1. 打开浏览器访问：http://设备IP:9097。
2. 进入设置页面，添加后端：
   • API Base URL: http://设备IP:9090
   • Secret: 在 config 第 6 行设置的 API 访问密钥
     
3. 点击添加，连接成功后即可看到流量仪表盘和节点选择界面。
   

进阶：关于 TUN 模式与透明代理

TUN 模式允许 Mihomo 创建一个虚拟网卡，接管设备上所有层级的流量（包括不走系统代理的终端命令、游戏等）。

为什么需要特殊权限？

在 Docker 中，默认容器是没有权限创建网络设备的。要启用 TUN 模式，必须在启动参数中显式声明：

• --cap-add=NET_ADMIN：允许容器修改网络堆栈。
• --device=/dev/net/tun：允许容器访问 Linux 的 TUN 字符设备。

在本文提供的 docker-compose.yml 中，我们已经默认添加了这两项配置。

如何启用？

1. 确保 Docker 配置已包含上述权限参数。
2. 在 WebUI 的设置页面中勾选 TUN 模式。
3. 或者在 config.yaml 中将 tun: enable 设置为 true 并重启容器。

此时，配合路由表的设置，Mihomo 即可变身为一个网关，实现透明代理。

Q&A 常见问题

Q1: “Failed to fetch” 无法连接后端？

• A: 检查 WebUI 中填写的后端地址端口是否为 9090（不是 9097），并确保 config.yaml 中 external-controller 监听的是 0.0.0.0:9090。

Q2: 为什么不使用在线版的 WebUI (如 yacd)？

• A: 在线版面板（通常是 HTTPS）因浏览器安全策略（混合内容拦截），往往无法连接到你本地的 HTTP 后端（Mihomo）。使用 Docker 自建本地版 WebUI 最稳定。

Q3: 如何在其他设备上使用这个代理？

• A: 在其他设备（手机/电脑）的 Wi-Fi 代理设置中，填入 IP: 宿主机IP，端口: 7890。

相关链接

体验订阅地址：https://xboard.88531.cn

• Mihomo 项目仓库
• Mihomo 官方文档
• Metacubexd 面板仓库