micrograils/clash-client repository overview

⁠clash-client Docker 镜像

本地代理客户端镜像：mihomo（Clash.Meta）内核 + MetaCubeXD 面板，等价于 Clash Verge Rev 的 「内核 + 面板」组合，只是去掉了桌面外壳，跑在容器里。

• 内核：MetaCubeX/mihomo⁠
• 面板：MetaCubeX/metacubexd⁠（由 mihomo 的 external-controller 直接托管，无需额外 Web 服务器）
• 配置合并工具：mikefarah/yq⁠

⁠快速开始

⁠用法一：host 网络（推荐）

容器直接占用宿主网络，起完之后 127.0.0.1:7890 就是本地代理，127.0.0.1:9090/ui 就是面板。

docker run -d --name clash_client \
  --network host \
  -e CLASH_SUB_URL="https://your-subscription-url" \
  -v ./config:/etc/mihomo \
  micrograils/clash-client

想让 TUN 接管全局流量（含 DNS、不放过任何程序）：

docker run -d --name clash_client \
  --network host \
  --cap-add NET_ADMIN --device /dev/net/tun \
  -e CLASH_SUB_URL="https://your-subscription-url" \
  -e CLASH_TUN=true \
  -v ./config:/etc/mihomo \
  micrograils/clash-client

⁠用法二：桥接网络 + 端口映射

容器网络隔离更好，但 TUN 只影响容器内。此时必须 CLASH_ALLOW_LAN=true （否则 mihomo 只绑 127.0.0.1，端口映射收不到流量）。

docker run -d --name clash_client \
  -p 127.0.0.1:7890:7890 \
  -p 127.0.0.1:9090:9090 \
  -e CLASH_ALLOW_LAN=true \
  -e CLASH_SUB_URL="https://your-subscription-url" \
  -v ./config:/etc/mihomo \
  micrograils/clash-client

⁠面板

打开 http://127.0.0.1:9090/ui⁠。若 CLASH_ALLOW_LAN=true 且没设 CLASH_SECRET， entrypoint 会随机生成一个 secret 并打印在容器日志里（docker logs clash_client）。

⁠环境变量

⁠数据卷

⁠配置分层

entrypoint 用 yq 做深度合并，后者覆盖前者（map 逐层合并，数组整体替换）：

所以：节点和规则交给订阅或 config.yaml，运行参数交给环境变量，想改什么就写 merge.yaml。

生成后的最终配置在 CLASH_RUN_DIR/config.yaml，启动前会用 mihomo -t 自检，失败会打印配置并退出。

⁠高级用法

• 规则覆写：挂载 merge.yaml，例如只改规则：

  rules:
    - DOMAIN-SUFFIX,example.com,DIRECT
    - GEOIP,CN,DIRECT
    - MATCH,Proxy
  

  Copy
• 本地代理给局域网：CLASH_ALLOW_LAN=true + 宿主防火墙放行 7890，配合 CLASH_SECRET。
• 当旁路网关：同一台机器上其它设备把网关/DNS 指向本机，配合 TUN 模式使用。
• 只用内核、用桌面版 Verge 接管：不挂面板也行，把 CLASH_CONTROLLER_PORT 暴露出去， 在 Clash Verge Rev 里填 http://<host>:9090 + secret 即可「外部控制」本容器。
• 固定 fake-ip / 规则持久化：挂卷 /etc/mihomo，profile.store-selected 已默认开启。

⁠相关链接

• 上游内核：https://github.com/MetaCubeX/mihomo⁠
• 上游面板：https://github.com/MetaCubeX/metacubexd⁠
• Docker Hub：https://hub.docker.com/r/micrograils/clash-client⁠
• 配套服务端：clash-server⁠

维护者文档（架构 / 构建 / 版本管理 / 维护）见 MAINTENANCE.md⁠。