基于 Docker Compose 部署在 OpenWrt (x86_x64) 上的 Mihomo 代理服务器。

本项目已在Github开源：https://github.com/Mooloco/mihomo-proxy

请移至 Github Release 页面获取源代码。

• 模式：代理服务器（Mixed / SOCKS5 / HTTP）
• 无 TUN / 无 TProxy / 不修改路由表
• Web 管理：Zashboard
• DNS：Fake-IP，支持 Windows AD 域环境（moolo.net → 192.168.1.3，请在config.yaml.template修改为自己的域名和域控DNS）

目录结构

/opt/mihomo
├── .env                         # ★ 所有配置都在这里编辑
├── compose.yaml
├── backup/
├── cache/
├── config/
│   ├── config.yaml              # 自动生成，不要手动编辑
│   └── config.yaml.template     # 配置模板
├── dashboard/
├── logs/
├── providers/
│   ├── proxy/
│   └── ruleset/
└── scripts/
    ├── apply-config.sh          # ★ 渲染模板 → 生成 config.yaml
    ├── generate-secret.sh
    ├── backup.sh
    ├── restore.sh
    └── update.sh

端口规划

首次部署

1. 上传项目到路由器

scp -r ./mihomo root@192.168.1.1:/opt/mihomo
ssh root@192.168.1.1

scp -r ./mihomo root@192.168.1.1:/opt/mihomo
ssh root@192.168.1.1

2. 编辑 .env 文件

vi /opt/mihomo/.env

需要填写的三项：

# 你的原始订阅链接（V2Ray / SS / Trojan / VMess 等均可）
SUBSCRIPTION_URL=https://你的订阅链接
​
# subconverter 公共后端（默认即可，也可填自建地址）
SUBCONVERTER_URL=https://sub.xeton.dev
​
# Secret 暂时留空，下一步自动生成
SECRET=

3. 生成 Secret

cd /opt/mihomo
sh scripts/generate-secret.sh

4. 生成配置文件

sh scripts/apply-config.sh

此步骤读取 .env 中的订阅链接和 Secret，渲染成 config/config.yaml。

5. 启动服务

docker compose up -d

6. 访问 Dashboard

浏览器打开：http://192.168.1.1:9075

首次连接填入：

• API 地址：http://192.168.1.1:9073
• Secret：.env 文件中 SECRET= 的值

客户端使用

在需要使用代理的设备上，配置以下任一代理地址：

DNS（可选）：192.168.1.1:1053（Fake-IP 模式）

更换订阅链接

1. 编辑 .env，修改 SUBSCRIPTION_URL= 的值
2. 重新生成配置并重启：

cd /opt/mihomo
sh scripts/apply-config.sh
docker compose restart mihomo

cd /opt/mihomo
sh scripts/apply-config.sh
docker compose restart mihomo

或一步完成（同时检查镜像更新）：

sh scripts/update.sh

升级镜像

cd /opt/mihomo
sh scripts/update.sh

脚本会依次：重新渲染配置 → docker compose pull → docker compose up -d

备份

cd /opt/mihomo
sh scripts/backup.sh

备份内容：config/（含模板）、providers/、.env 保留最新 5 个，命名：mihomo_backup_YYYYMMDD_HHMMSS.tar.gz

恢复

cd /opt/mihomo
​
# 恢复最新备份
sh scripts/restore.sh
​
# 恢复指定备份
sh scripts/restore.sh backup/mihomo_backup_20250101_120000.tar.gz

恢复后启动：

sh scripts/apply-config.sh
docker compose up -d

迁移到新服务器

# 旧机器备份
sh /opt/mihomo/scripts/backup.sh
​
# 复制整个目录到新机器
scp -r /opt/mihomo root@新服务器IP:/opt/mihomo
​
# 新机器上启动
ssh root@新服务器IP
cd /opt/mihomo
sh scripts/apply-config.sh
docker compose up -d

# 旧机器备份
sh /opt/mihomo/scripts/backup.sh
​
# 复制整个目录到新机器
scp -r /opt/mihomo root@新服务器IP:/opt/mihomo
​
# 新机器上启动
ssh root@新服务器IP
cd /opt/mihomo
sh scripts/apply-config.sh
docker compose up -d

故障排查

查看日志

docker compose logs -f mihomo
docker compose logs -f zashboard

检查容器状态

docker compose ps

Mihomo 启动失败

• 检查 config/config.yaml 是否存在（需先运行 apply-config.sh）
• YAML 格式错误：cat config/config.yaml 检查内容
• 端口占用：ss -tlnp | grep 9070

订阅拉取失败

• 检查 .env 中 SUBSCRIPTION_URL 是否正确
• 在浏览器中测试转换 URL 是否可访问： 查看 config/config.yaml 中 proxy-providers.subscription.url 的值，在浏览器打开
• 可尝试更换 SUBCONVERTER_URL 为其他公共后端：
  • https://api.v1.mk
  • https://sub.mi200.top

Secret 重置

sh scripts/generate-secret.sh
sh scripts/apply-config.sh
docker compose restart mihomo

.env 配置项说明

策略组说明

默认各应用组均引用「🚀 节点选择」，在 Dashboard 中可单独调整。

项目原则

1. 不启用 TUN
2. 不修改 OpenWrt 路由
3. 所有配置集中在 .env，config.yaml 自动生成
4. 使用官方推荐配置 + MetaCubeX 官方规则集
5. 长期维护优先，迁移友好