mihomo前端面板yacd安装与配置

配图：张掖市七彩丹霞

一、什么是yacd？

yacd（Yet Another Clash Dashboard）是一个基于Web的Clash/mihomo前端管理面板。它本身不做任何代理工作，只是一个轻量级的”遥控器”——通过调用mihomo的RESTful API来实现可视化管理。

说实话，mihomo跑起来之后纯靠命令行改配置文件太麻烦了，有了yacd，切换节点、看连接、测速度更加方便。

核心特点：

• 纯前端，体积小，不吃资源
• 支持代理组切换、连接查看、速度测试
• Docker一键部署

二、Docker部署yacd

直接用Docker跑是最省事的方式。一条命令搞定：

docker run -d \
  --name yacd \
  --restart always \
  -p 12345:80 \
  haishanh/yacd:latest

如果拉镜像慢，可以用国内镜像加速：

docker run -d \
  --name yacd \
  --restart always \
  -p 12345:80 \
  docker.1ms.run/haishanh/yacd:latest

注意：这里用docker.1ms.run作为镜像前缀，解决国内拉取Docker Hub镜像慢的问题。端口映射是 12345:80，即外部通过12345端口访问面板。

部署完成后，浏览器打开：

http://树莓派IP:912345

就能看到yacd的界面了！

三、连接mihomo后端

打开yacd面板后，第一步是连接mihomo的API。在页面上会提示你输入：

API Base URL：http://树莓派IP:12344
Secret（密钥）：你mihomo配置文件里设置的secret

这里的12344是mihomo的默认API端口，secret对应mihomo配置文件中的 external-controller-secret 字段。如果你没设密码，留空即可。

填好后点Save，连接成功就能看到节点信息了。

四、yacd主要功能

1. 代理组管理（Proxies） 左侧Proxies页面展示所有代理组，点击某个组可以展开查看节点列表，直接点击节点就能切换.
2. 连接监控（Connections） Connections页面实时显示当前所有活跃连接，包括目标地址、使用的代理节点、上传下载速度等。排查问题的时候特别有用，一眼就能看出哪个连接走了哪个节点。
3. 速度测试（Latency Test） 在代理组页面点击”Test All”，可以批量测试所有节点的延迟。测完之后按延迟排序，最快的节点一目了然。
4. 配置管理（Configs） 可以切换策略模式（Rule/Global/Direct），开关系统代理等。

五、实用技巧

技巧一：快速切换节点。

技巧二：如果感觉网速慢，去Connections看看是不是有连接走了错误的节点或者卡在某个地方。

技巧三：定期测延迟。节点质量会变化，建议每隔几天跑一次延迟测试，把慢节点从策略组里去掉或者换个顺序。

六、总结

yacd就是一个纯粹的前端面板，不涉及代理核心逻辑，轻量又实用。配合Docker部署，一行命令就跑起来了。对于mihomo用户来说，几乎是必装的管理工具。

参考链接：

• yacd GitHub仓库：https://github.com/haishanh/yacd
• yacd Docker Hub：https://hub.docker.com/r/haishanh/yacd
• mihomo 官方文档：https://wiki.metacubex.one
• mihomo GitHub仓库：https://github.com/MetaCubeX/mihomo

发布于2026/10/07。