Docker 运行 mihomo 教程：一条命令跑起来

不想污染宿主机环境？MetaCubeX 提供官方 Docker 镜像 metacubex/mihomo，一条命令即可把内核跑起来，NAS 用户尤其友好。

最小可用命令

docker run -d --name mihomo --restart unless-stopped -v /etc/mihomo:/root/.config/mihomo -p 7890:7890 -p 9090:9090 metacubex/mihomo:latest —— 把订阅 yaml 放进 /etc/mihomo 目录命名为 config.yaml 即可。

compose 写法要点

• 镜像固定 latest 或指定版本号，升级时 pull 后重建容器
• 需要 TUN 模式时加 cap_add: NET_ADMIN 与 /dev/net/tun 设备映射
• 9090 端口配合 metacubexd 网页面板可视化管理

升级与排错

升级：docker pull 新镜像后重建容器，配置在挂载目录里不会丢。启动失败先看 docker logs mihomo，九成是配置文件路径或语法问题。