Dockprom 监控平台部署教程

本教程将引导您使用 Docker Compose 快速部署 Dockprom，这是一个包含 Grafana、Prometheus、cAdvisor、Node Exporter 和 Alertmanager 的强大监控解决方案。

第一步：获取并进入项目

首先，我们需要从 GitHub 克隆 Dockprom 的官方仓库，并进入项目目录。

1
2

git clone https://github.com/stefanprodan/dockprom.git
cd dockprom

第二步：配置端口

在启动服务之前，我们需要检查并根据需求修改端口配置。使用以下命令编辑 docker-compose.yml 文件：

1

nano docker-compose.yml

找到 caddy 服务部分。默认配置会映射多个端口，您可以根据下表决定需要暴露哪些服务。

一般情况下，我们仅需开放 Grafana 的 3000 端口即可。您可以按需将外部端口 5000 修改为任何未被占用的端口。

请参考以下配置，将其他服务端口注释掉，以增强安全性：

1
2
3
4
5
6
7
8
9
10

caddy:
image: caddy:2.10.0
container_name: caddy
ports:
 - "5000:3000" # 只保留这一行，用于访问 Grafana
 # - "8080:8080" # 注释掉 Caddy 管理端点
 # - "9090:9090" # 注释掉 Prometheus
 # - "9093:9093" # 注释掉 Alertmanager
 # - "9091:9091" # 注释掉 Node Exporter
# ... 其他配置

注意：在修改 YAML 文件时，请确保注释符号 # 与端口定义前的 - 保持相同的缩进，以避免语法错误。

第三步：启动服务

配置完成后，执行以下命令在后台启动所有容器：

1

docker-compose up -d

第四步：故障排查（镜像下载失败）

在部分网络环境下，拉取 cadvisor 等镜像时可能会遇到困难。如果出现此问题，可以尝试替换为国内的镜像源。

例如，可以将 cadvisor 的镜像地址替换为：

1

swr.cn-north-4.myhuaweicloud.com/ddn-k8s/gcr.io/cadvisor/cadvisor-amd64:v0.52.0

提示：其它镜像遇到下载问题可以使用腾讯云镜像、通过阿里云容器加速服务申请的个人镜像、轩辕镜像、华为镜像源等。您也可以在 https://docker.aityp.com/ 此网站查询其它可用的镜像。请注意选择与您设备架构和软件版本相匹配的镜像。

解决镜像问题后，重新执行启动命令即可：

1

docker-compose up -d

第五步：（可选）集成 Nginx Proxy Manager

如果您使用 Nginx Proxy Manager (NPM) 作为反向代理，需要将 caddy 容器连接到 NPM 所在的 Docker 网络中，以便进行域名转发。

1. 再次编辑 docker-compose.yml 文件。
2. 在 caddy 服务的配置下（注意：是 caddy，不是 cadvisor！），添加 networks 定义。

1
2
3
4
5
6

caddy:
# ... 已有配置
restart: unless-stopped
networks:
 - monitor-net
 - npm_proxy_net # 此处替换为您 NPM 所在的 Docker 网络名称

3. 保存文件后，重新执行命令使配置生效：

1

docker-compose up -d

第六步：登录和使用

部署完成后，通过 http://<您的服务器IP>:5000 访问 Grafana 仪表盘。

• 默认用户名: admin
• 默认密码: admin

首次登录后，系统会强制要求您修改初始密码。

结语

至此，您的监控面板已搭建完成。如果部分监控项显示为 N/A，这通常是由于查询语句与您的设备硬件不完全匹配所致，需要您根据实际情况借助 AI 或官方文档自行调整查询语句。

*本教程内容已在 Ubuntu 22.04 系统上经过实际测试。