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，九成是配置檔案路徑或語法問題。