titpetric/netdata

netdata Docker镜像

镜像概述

本镜像用于构建和运行Netdata守护进程，实现主机实例的实时性能监控。Netdata专注于性能和内存使用情况，提供近期服务器指标的详细洞察，现已支持Docker化部署。更多项目信息请访问：https://github.com/firehol/netdata

注意：Netdata项目包含遥测功能，使用Google Analytics聚合遥测数据（已开启IP***化）。目前暂无运行时 opt-out 机制（需跟踪上游https://github.com/netdata/netdata/issues/7404%EF%BC%89%E3%80%82GDPR%E7%AC%AC6%E6%9D%A1%E5%92%8C%E7%AC%AC89(1)%E6%9D%A1%E6%98%8E%E7%A1%AE%E5%85%81%E8%AE%B8%E7%BB%9F%E8%AE%A1%E7%9B%AE%E7%9A%84%E7%9A%84%E5%A4%84%E7%90%86%E6%97%A0%E9%9C%80opt-in%EF%BC%8C%E4%B9%9F%E5%8F%AF%E9%80%9A%E8%BF%87%E7%BC%96%E8%AF%91%E6%97%B6%E7%A6%81%E7%94%A8%E9%81%A5%E6%B5%8B%E5%AE%9E%E7%8E%B0opt-out%E3%80%82%E6%9B%B4%E5%A4%9A%E9%81%A5%E6%B5%8B%E4%BF%A1%E6%81%AF%E8%AF%B7%E5%8F%82%E8%80%83%EF%BC%9A***%E7%BB%9F%E8%AE%A1%E6%96%87%E6%A1%A3

核心功能

• 实时数据收集：每秒采集服务器性能数据（CPU、网络、磁盘、应用等）
• 多维度指标：覆盖系统资源、容器状态、应用性能等多维度监控
• 灵活告警：支持邮件、Slack、、、Pushbullet等告警方式
• 可配置性：支持自定义监听IP、参数、告警规则及配置覆盖
• 容器集成：可监控Docker容器指标（需挂载docker.sock）

使用场景

• 个人/企业服务器性能实时监控
• Docker容器集群状态跟踪
• 多节点服务器的集中流媒体监控
• 关键服务的异常告警与故障排查

配置说明

启动容器

Docker CLI

bash
docker run -d --cap-add SYS_PTRACE \
           -v /proc:/host/proc:ro \
           -v /sys:/host/sys:ro \
           -p 19999:19999 \
           --restart unless-stopped \
           titpetric/netdata

注意：若无需容器开机自启，可移除--restart unless-stopped参数。

Docker Compose

bash
mkdir netdata && cd netdata && wget https://raw.githubusercontent.com/titpetric/netdata/master/docker-compose.yml
docker-compose up -d

注意：若无需自启，可移除restart: unless-stopped选项。

访问监控数据

打开浏览器访问：http://服务器IP:19999 查看服务器状态。

关键配置选项

限制监听IP

通过NETDATA_IP环境变量指定监听IP（默认0.0.0.0）：

bash
-e NETDATA_IP=127.0.0.1

自定义参数

通过NETDATA_ARGS传递自定义参数：

bash
-e NETDATA_ARGS="-i 127.0.0.1"

邮件告警配置

设置SMTP参数实现邮件告警：

bash
-e SMTP_TO=user@example.com -e SMTP_USER=user -e SMTP_PASS=password -e SMTP_SERVER=smtp.example.com

容器监控

挂载docker.sock以监控容器指标：

bash
-v /var/run/docker.sock:/var/run/docker.sock:ro

安全提示：挂载docker.sock会暴露Docker管理API，若容器被入侵可能导致主机安全风险，建议使用https://github.com/titpetric/docker-proxy-acl%E5%AE%9E%E7%8E%B0%E5%AE%89%E5%85%A8%E8%BD%AC%E5%8F%91%E3%80%82

流媒体监控

客户端节点配置：

bash
-e NETDATA_STREAM_DESTINATION=central-netdata:19999 -e NETDATA_STREAM_API_KEY=your-secret-key

中心节点配置：

bash
-e NETDATA_API_KEY_ENABLE_your-secret-key=1

其他注意事项

• 网络接口监控：容器内无法直接监控主机所有网络接口，可使用--net=host模式或fakenet.sh脚本（详见原文档）解决。
• 自定义配置覆盖：挂载卷到/etc/netdata/override以添加自定义告警、图表或配置。
• 版本选择：Docker Hub提供从1.4到最新版本的标签，latest标签与上游同步，旧标签更稳定。

更多详细配置请参考原项目文档或镜像GitHub仓库。