飞牛docker容器管理增强版(docker-center)
面向多应用用户的 Docker 管理与监控面板。核心不是「一堆容器」,而是把容器按 应用(Compose 项目 / 单容器) 聚合:一眼看哪个应用坏了、占用多少、怎么一键恢复。
- 地址:http://192.168.68.19:7030
- 目录:
/vol1/1000/HD1/docker/docker-center - 端口:7030,
restart: always,内存上限 384MB(实测 ~40MB)
安装(新用户)
前置:Linux/飞牛 NAS 上已装 Docker 与 compose 插件(docker compose version 能跑)、有 git。
curl -fsSL http://192.168.68.19:3200/jinghui/docker-center/raw/branch/main/install.sh | bash
脚本做的事:检查环境 → 自动探测 docker 目录 → 拉源码到安装目录 → 写 .env → docker compose up -d --build → 等健康检查通过 → 打印访问地址。
可覆盖参数(写在 curl 前面):
PORT=8080 \
COMPOSE_ROOT=/你的/docker目录 \
INSTALL_DIR=/opt/docker-center \
bash install.sh
| 变量 | 默认值 | 说明 |
|---|---|---|
PORT |
7030 |
面板访问端口 |
COMPOSE_ROOT |
自动探测(飞牛 /vol1/1000/HD1/docker,其次 ~/docker) |
扫描 compose 文件、判断「未启动应用」的根目录 |
INSTALL_DIR |
/vol1/1000/HD1/docker/docker-center |
源码与数据目录 |
CONTAINER_NAME |
docker-center |
容器名 |
REPO_URL |
本机 Gitea 仓库地址 | 换源时用 |
升级:再跑一次同一条命令即可(检测到已有仓库会 fetch + reset --hard 后重建)。
卸载:cd <安装目录> && docker compose down -v && cd .. && rm -rf <安装目录>。
安全提示:面板挂载了
/var/run/docker.sock(等同宿主 root),不要直接暴露公网,放在内网或前面套一层带鉴权的反代。
为什么按「应用」而不是「容器」管
61 个容器里其实只有 50 个应用(app + db + redis 属于同一个项目)。按容器管要逐个点,按应用管只需看:
- 这个应用整体是否健康(部分容器挂了会标红,而不是淹没在列表里)
- 它总共吃多少 CPU/内存、占了哪些端口
- 一键启动/停止/重启整个应用
- 出问题时有一条事件、一份合并日志
页面
| 页面 | 内容 |
|---|---|
| 应用(默认) | 健康看板:应用总数/异常/注意/资源/运行容器;筛选(全部·有问题·已停止·高占用);应用卡片(状态胶囊、CPU 占整机、内存、网络、端口、已运行时长、可用率、重启次数、问题摘要);卡片内直接启停重启;底部最近事件时间线。排序默认「异常优先」,其次按资源占用 |
| 应用详情 | 应用级指标 + 全部容器表格(状态/健康/CPU/内存/网络/重启/运行时长/单容器操作)+ 三个标签页:容器、聚合日志(多容器合并、按容器名加前缀)、事件;顶部可整应用启停重启 |
| 容器 | 只列运行中容器,可排序(CPU/内存/网络/磁盘IO/进程数/名称)、搜索;行内启停/重启/删除/详情/打开端口 |
| 停止的容器 | 两个部分:有镜像但未启动的应用(compose 项目存在、本地有镜像、但一个容器都没有,可一键 docker compose up -d)+ 已停止/退出的容器(只保留启动/删除/详情) |
| 本地镜像 | 按大小排序、删除、清理悬空镜像 |
| 镜像仓库 | 拉取镜像(流式进度) |
| 网络 | 名称/驱动/子网/网关/容器数 |
| 告警设置 | CPU/内存阈值、推送间隔、Webhook、开关、测试推送、查看事件 |
顶栏工具条:搜索、排序字段、升/降序切换、刷新间隔(1/2/3/5/10/30 秒,默认 3 秒,存浏览器本地)、手动刷新、添加容器。后端采样固定 3 秒,所以设成 1~2 秒只是更勤地读缓存,不会更快拿到新数据。
首页优化建议
首页统计条下面是一块优化建议:服务端根据当前真实状态(容器配置 + 实时占用 + Docker 磁盘)生成,按 高 / 中 / 低 排序,超过 4 条自动折叠。
| 级别 | 规则 |
|---|---|
| 高 | 特权容器(privileged);容器重启 ≥3 次;磁盘可用 <10% |
| 中 | 挂载 docker.sock;内存占用接近上限(>85%);单容器 CPU >60%;容器未设内存上限且合计 >1GB;悬空镜像 >1GB;构建缓存 >5GB;应用整体已停止 |
| 低 | 对外容器没有 HEALTHCHECK;使用 latest 镜像;单容器应用未纳入 Compose |
- 同类问题会合并成一条(例如「31 个应用使用 latest 镜像,涉及 …」),不会一个应用刷一条。
- 可一键处理的直接给按钮:清理悬空镜像、清理构建缓存(都不影响运行中的容器)、启动已停止应用;其余给「查看」跳到应用详情自己改 compose。
- 建议每次刷新(3 秒)重新计算,但 Docker 磁盘统计缓存 60 秒,避免频繁扫描镜像层。
健康判定规则
| 级别 | 触发条件 |
|---|---|
| 异常(红) | 应用里部分容器未运行(其余在跑);任一容器健康检查 unhealthy |
| 注意(黄) | 应用整体已停止;健康检查 starting;CPU 占整机超阈值;容器内存占上限超阈值;容器重启次数增加(单独一条事件) |
| 正常(绿) | 以上都不满足 |
- 状态从正常→异常/注意、异常→恢复都会写一条事件;「一上线就异常」的应用首次发现也会补记一条。
- 可用率:每分钟记录一次应用是否正常,保留 24 小时,卡片显示窗口内可用率。
- 事件保留最近 400 条(内存),重启服务后清空。
告警推送(Webhook)
在「告警设置」填 Webhook 地址,收到的是 POST JSON:
{
"title": "[异常] my-app",
"level": "critical",
"app": "my-app",
"detail": "1 个容器未运行(my-app-db)",
"time": "2026/10/26 16:43:46",
"host": "gzFNos2"
}
注意两点:
- 容器内的
127.0.0.1是容器自己,要推给宿主机上的服务请用宿主 LAN IP(如http://192.168.68.19:端口/hook)或http://host.docker.internal:端口/hook(compose 已加host-gateway)。 - 同一应用在
debounceMinutes(默认 10 分钟)内只推一条,避免刷屏。
运维
cd /vol1/1000/HD1/docker/docker-center
docker compose up -d --build # 改动后重建
docker compose logs -f # 看日志
docker compose restart # 重启
- 配置持久化:
data/settings.json(阈值、webhook、开关) - 环境变量:
PORT、SAMPLE_MS(3000)、INSPECT_MS(15000)、DISK_PATH、SETTINGS_PATH
实现要点 / 坑
- 采样:每 3 秒并行拉一次所有运行中容器的
stats;CPU% 用cpu_stats/precpu_stats差值 × 核数;内存扣inactive_file;网络与块设备速率靠相邻采样差分。 - 重启次数/健康状态来自
inspect,每 15 秒才刷一遍(每 3 秒 inspect 61 个容器太重)。 - 日志是 Docker 的 8 字节头多路复用流,用
demuxLogs手动解帧;modem.demuxStream在 follow=false 时会挂住请求。 - 排序比较器统一按「降序」写,
order=asc时取反,否则会出现 desc 变升序。 - 详情页是独立视图状态(
app-detail),轮询刷新时必须保住它,否则每 4 秒会被看板覆盖。
已知限制
- 曲线与可用率都在内存里,重启服务后重新累积(可用率保留 24 小时窗口)。
- 不提供在线改容器配置,改配置请用 Compose 或重建容器。
- 应用归属依赖
com.docker.compose.project标签;手工docker run的容器各自算一个「单容器应用」。