Clash Meta(Mihomo) Docker 部署指南

核心目录结构确认

关键点：新版 Mihomo 镜像默认配置目录为 /root/.config/mihomo

📁 宿主机目录建议

假设你的 Docker Compose 文件位于 /vol1/1000/Docker/Clash/，建议结构如下：

/vol1/1000/Docker/Clash/
├── docker-compose.yml       # 编排文件
└── config/                  # 宿主机配置目录 (对应容器内的 /root/.config/mihomo)
    └──  config.yaml          # 主配置文件 (含订阅链接)

Docker Compose 配置 (docker-compose.yml)

version: '3'
services:
  clash-core:
    image: metacubex/mihomo:latest
    container_name: clash-core
    network_mode: host           # 使用 Host 模式，性能最好，无需映射端口
    restart: always
    user: "0"                    # 以 root 用户运行，避免权限问题
    
    volumes:
      - ./config:/root/.config/mihomo

启动命令：

docker-compose up -d --force-recreate
docker-compose logs -f

配置文件模板 (config/config.yaml)

这是直接使用订阅链接的核心配置。请替换 YOUR_SUBSCRIPTION_URL 为你的真实链接。

# --- 基础设置 ---
port: 7890
socks-port: 7891
allow-lan: true          # 允许局域网访问
mode: rule               # 规则模式
log-level: info
external-controller: 0.0.0.0:9090  # API 监听地址
# secret: "your_password"          # 如果设置了密码，面板连接时需填写

# --- 代理提供者 (Proxy Providers) ---
# 这里直接填入订阅链接，实现自动更新
proxy-providers:
  MySubscription:
    type: http
    url: "https://YOUR_SUBSCRIPTION_URL"  # 👈 替换为你的订阅链接
    interval: 3600                        # 每 3600 秒 (1小时) 自动更新
    path: ./providers/my_sub.yaml         # 下载后保存在容器内的路径
    health-check:                         # 健康检查
      enable: true
      interval: 600
      url: http://www.gstatic.com/generate_204
      tolerance: 50

# --- 代理组 (Proxy Groups) ---
proxy-groups:
  # 1. 节点选择组 (手动切换节点)
  - name: PROXY
    type: select
    proxies:
      - MySubscription   # 引用下面的自动组
      - DIRECT
    use:
      - MySubscription   # 👈 关联上面定义的 provider 名称

  # 2. 自动节点列表组 (包含所有从订阅拉取的节点)
  - name: MySubscription
    type: select
    use:
      - MySubscription

# --- 规则 (Rules) ---
rules:
  - GEOIP,LAN,DIRECT             # 局域网直连
  - GEOIP,CN,DIRECT              # 国内 IP 直连
  - GEOSITE,google,PROXY         # Google 系列走代理
  - GEOSITE,github,PROXY         # Github 走代理
  - MATCH,PROXY                  # 其他所有流量走代理

验证与调试流程

✅ 成功标志日志

重启容器后，观察日志 (docker-compose logs -f)，出现以下内容即为成功：

1. 无报错：没有 Can't find config。

2. Provider 加载：Start initial provider MySubscription。

3. GeoIP 加载：Load MMDB file: .../geoip.metadb (如果没有会自动下载)。

4. 规则命中：出现类似 [TCP] ... match GeoIP(cn) using DIRECT 的日志，说明分流生效。

面板连接

• API 地址: http://<服务器IP>:9090

• 推荐客户端: http://board.zash.run.place/#/setup

常见问题速查 (FAQ)

💡 维护提示：

以后如果需要更换订阅链接，只需修改 config.yaml 中的 url 字段，然后执行 docker-compose restart clash-core 即可，无需重新构建镜像或调整目录。