AnGe-ClashBoard 是一个基于 Vue 3 + TypeScript + Vite 的 Clash 面板，面向 Clash API、Mihomo、OpenClash、Nikki 和 sing-box 的运行态管理、观测与排错。
当前版本为 1.91，基于开源 zashboard 二次开发。
- 支持 Clash API、Mihomo、OpenClash、Nikki、sing-box
- 支持 SQLite 持久化配置，切换浏览器后仍可保留配置
- 支持背景图服务端持久化
- 支持图标上传、拖拽、复制和预览
- 支持规则缓存、域名/IP/关键字规则查询、链路展示和兜底规则判断
- 支持后端中转控制器数据，公网访问面板时无需直接暴露控制器端口
- 支持 Docker 一键部署，适合个人和局域网环境
策略穿透可以直接展开策略组内部的节点和子策略链路，便于快速查看当前命中策略、候选节点状态和最终出口。
规则穿透支持按域名、IP 和关键字查询规则命中结果，并展示规则来源、匹配类型、策略链路和最终节点，方便排查分流问题。
图标管理支持自定义图标映射、上传、复制和删除，可分别为策略组、节点组和其他项目配置专属图标。
安装前提：
- 服务器已安装 Docker
- 可以访问
ghcr.io - 需要对外开放你准备使用的面板端口
默认安装目录：/opt/ange-clashboard
默认数据目录：/opt/ange-clashboard/data
默认端口：2048
curl -fsSL https://raw.githubusercontent.com/liandu2024/AnGe-ClashBoard/main/scripts/install.sh | bash安装完成后访问：
http://<你的服务器IP>:2048例如部署到 8080：
curl -fsSL https://raw.githubusercontent.com/liandu2024/AnGe-ClashBoard/main/scripts/install.sh | bash -s -- 8080升级会保留现有数据目录，不会删除你的配置、背景图和规则缓存。
默认保留目录：
/opt/ange-clashboard/data仍然建议你先在面板里执行一次“导出设置”，额外留一份配置备份，以防意外情况。
curl -fsSL https://raw.githubusercontent.com/liandu2024/AnGe-ClashBoard/main/scripts/update.sh | bash如果你之前是通过一键脚本安装，并且没有手动改过 /opt/ange-clashboard/compose.yaml 和 .env 的结构，这个升级方式就是原位无损升级。
卸载会删除：
- 容器
- 镜像
/opt/ange-clashboard- 本地数据目录
curl -fsSL https://raw.githubusercontent.com/liandu2024/AnGe-ClashBoard/main/scripts/uninstall.sh | bash推荐直接使用已发布到 GHCR 的镜像：
ghcr.io/liandu2024/ange-clashboard:latest已发布镜像支持 linux/amd64、linux/arm64 和 linux/arm/v7。
手动运行：
docker run -d \
--name ange-clashboard \
-p 2048:2048 \
-v ./data:/app/data \
--restart unless-stopped \
ghcr.io/liandu2024/ange-clashboard:latest上面的 --restart unless-stopped 表示容器会在 Docker 服务重启后自动拉起，除非你手动停止它。
如果你是通过 -v ./data:/app/data 这类挂载方式运行，升级镜像时会保留原有数据目录，属于无损升级。
仍然建议先在面板里导出一次设置，额外备份配置数据后再升级。
docker pull ghcr.io/liandu2024/ange-clashboard:latest
docker stop ange-clashboard
docker rm ange-clashboard
docker run -d \
--name ange-clashboard \
-p 2048:2048 \
-v ./data:/app/data \
--restart unless-stopped \
ghcr.io/liandu2024/ange-clashboard:latest如果你之前使用了自定义端口、不同的容器名，或不同的数据目录挂载，请把上面的参数改成你当前正在使用的那一套。
如果你只是通过一键脚本安装，优先使用上面的 update.sh，会更省事。
健康检查：
http://127.0.0.1:2048/api/health项目内置轻量 Node 服务，用于保存：
- 设置
- 背景图
- 规则缓存
默认数据库路径：
./data/zashboard.sqlite可通过环境变量覆盖：
ZASHBOARD_DB_PATH规则页支持按域名查询命中的规则来源，并展示实际策略链路。
当前支持：
- 文本规则源缓存
.mrs域名规则集解析- 规则顺序排序
- 兜底规则检测
- 根据 YAML 中的
interval自动更新缓存 - 刷新规则时显示累计规则数量与手动停止
规则源需要配置代理端 OpenWrt 的 SSH 连接。服务会通过 SSH 实时读取代理端当前配置，不读取本机 OpenClash 文件，也不内置规则源模板。
可在页面的“修改后端配置”弹窗里，为对应后端填写规则源类型、SSH 端口、账号和密码；规则源 SSH 主机直接使用该后端的“主机”。也可以通过环境变量预设：
ZASHBOARD_OPENWRT_SSH_HOST
ZASHBOARD_OPENWRT_SSH_PORT
ZASHBOARD_OPENWRT_SSH_USER
ZASHBOARD_OPENWRT_SSH_PASSWORD
ZASHBOARD_RULE_SOURCE_PLUGIN服务会自动识别代理端的 OpenClash 或 Nikki：
- OpenClash：读取远程
/etc/config/openclash，解析其中真实的option config_path，再读取对应 YAML 的rule-providers。 - Nikki：优先从远程进程命令行和
/etc/config/nikki提取实际 YAML 路径，再校验其中的rule-providers。
OpenClash 远程 UCI 路径不在默认位置时可覆盖：
ZASHBOARD_OPENCLASH_UCI_PATH
ZASHBOARD_OPENCLASH_CONFIG_DIRsrc/：前端代码server/：本地持久化与规则缓存后端data/：运行时数据目录public/：静态资源scripts/：安装、升级、卸载脚本readme/：README 展示图片
本项目基于上游 zashboard 二次开发。上游使用 MIT License，因此你可以在保留原许可证声明的前提下继续修改、发布和分发。
请保留仓库中的 LICENSE 文件。
- 上游项目：zashboard
- Clash / Mihomo / sing-box 生态项目与规则集作者