使用 Netdata 监控服务器
在 Debian 或 Ubuntu 上安装 Netdata,通过 Nginx、HTTPS 和密码保护仪表板,并接收电子邮件告警。
本页内容
您的参数
只需填写一次,指南中的命令会自动更新。
本指南介绍如何在运行 Debian 12/13 或 Ubuntu 22.04/24.04 的 VPS 或专用服务器上安装 Netdata。Netdata 每秒采集一次系统指标(CPU、内存、磁盘、网络、服务),并在网页仪表板中展示。
完成本指南后,您将拥有:
- 从官方软件源安装、使用稳定通道的 Netdata 代理;
- 仅能通过 HTTPS 访问、并由 Nginx 和密码保护的仪表板;
- 电子邮件告警,包括一条自定义告警;
- 更新与备份的操作流程。
订购服务器
为了监控您的服务,HostMyServers 提供多种方案:
前提条件
- 一台运行 Debian 12/13 或 Ubuntu 22.04/24.04 的服务器
- 拥有
sudo权限的用户的 SSH 访问 - 一个域名及其 A 记录:
netdata.您的域名.com必须指向服务器的 IP 地址 - 约 4 GiB 的可用磁盘空间:按默认设置,Netdata 将指标限制在 3 GiB 以内,另有元数据占用的空间
- 如果要接收电子邮件告警,需要一个 SMTP 账户
使用的端口
| 端口 | 协议 | 用途 | 访问 |
|---|---|---|---|
| 22 | TCP | SSH(或您的自定义端口) | 开放,建议尽可能限制来源 |
| 80 | TCP | Let’s Encrypt 验证及重定向到 HTTPS | 开放 |
| 443 | TCP | 通过 Nginx 访问仪表板 | 开放 |
| 19999 | TCP | Netdata 代理 | 仅限本地(127.0.0.1) |
准备服务器
更新系统并安装所需工具:
sudo apt update
sudo apt upgrade -y
sudo apt install -y curl ufw nginx apache2-utils certbot python3-certbot-nginx配置防火墙
请在启用 UFW 之前先放行 SSH,否则可能无法再访问服务器。如果您使用其他 SSH 端口,请将 22 替换为该端口。
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw allow 80,443/tcp
sudo ufw enable
sudo ufw status verbose这些规则中没有 19999 端口,因此它对外保持关闭。如需了解更多,请参阅指南 保护您的服务器。
安装 Netdata
下载官方脚本,然后使用稳定通道运行。如果不指定该选项,脚本会提供 nightly 通道,该通道会收到开发版本。
curl -fsSL https://get.netdata.cloud/kickstart.sh -o /tmp/netdata-kickstart.sh
sh /tmp/netdata-kickstart.sh --release-channel=stable --disable-telemetry脚本会检测您的发行版,添加 Netdata 软件源并安装原生软件包。它会请求确认,并在需要时使用 sudo。--disable-telemetry 选项会关闭匿名统计数据的发送。
然后检查服务和安装类型:
sudo systemctl status netdata --no-pager
sudo netdata -W buildinfo | grep -E 'Installation Type|Install type:'
curl -s http://127.0.0.1:19999/api/v1/info | head -n 5服务应处于 active (running) 状态,安装类型应为 binpkg-deb,最后一条命令应返回 JSON。
将 Netdata 限制在本地接口
使用 Netdata 提供的工具打开配置:
cd /etc/netdata
sudo ./edit-config netdata.conf在 [web] 段中添加或修改 bind to 一行:
[web]
bind to = 127.0.0.1重启代理并检查监听地址:
sudo systemctl restart netdata
sudo ss -tlnp | grep 19999输出应显示 127.0.0.1:19999,而不是 0.0.0.0:19999 或 *:19999。
通过 Nginx 发布仪表板
创建密码
创建凭据文件。该命令会要求您为用户 admin 设置密码:
sudo htpasswd -c /etc/nginx/.htpasswd-netdata admin
sudo chown root:www-data /etc/nginx/.htpasswd-netdata
sudo chmod 640 /etc/nginx/.htpasswd-netdata创建 Nginx 站点
sudo nano /etc/nginx/sites-available/netdata.conf粘贴以下配置,并根据实际情况修改域名:
upstream netdata_backend {
server 127.0.0.1:19999;
keepalive 64;
}
server {
listen 80;
listen [::]:80;
server_name netdata.您的域名.com;
location / {
auth_basic "Netdata";
auth_basic_user_file /etc/nginx/.htpasswd-netdata;
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-Server $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://netdata_backend;
proxy_http_version 1.1;
proxy_pass_request_headers on;
proxy_set_header Connection "keep-alive";
proxy_store off;
}
}启用站点并重新加载 Nginx:
sudo ln -s /etc/nginx/sites-available/netdata.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx启用 HTTPS
申请 Let’s Encrypt 证书并启用到 HTTPS 的重定向:
sudo certbot --nginx -d netdata.您的域名.com -m admin@您的域名.com --agree-tos --no-eff-email --redirect
sudo certbot renew --dry-run更多详情请参阅指南 使用 Let's Encrypt 安装 SSL 证书。
验证访问
在您自己的电脑上执行以下三项测试:
curl -s -o /dev/null -w '%{http_code}\n' https://netdata.您的域名.com/
curl -s -o /dev/null -w '%{http_code}\n' -u admin https://netdata.您的域名.com/
curl -m 5 http://您的服务器IP:19999/| 测试 | 预期结果 |
|---|---|
| 不带凭据 | 401 |
| 带凭据 | 200 |
| 直接访问 19999 端口 | 连接失败或超时 |
然后在浏览器中打开 https://netdata.您的域名.com 并登录。如果界面提示您将代理连接到 Netdata Cloud,这一步是可选的:本地仪表板无需账户即可使用。
配置告警
Netdata 自带大量开箱即用的告警(磁盘、内存、CPU、网络等)。要列出所有已加载的告警:
curl -s 'http://127.0.0.1:19999/api/v1/alarms?all' | head -n 30启用邮件发送
Netdata 通过 sendmail 命令发送电子邮件。msmtp-mta 软件包提供该命令,并将邮件转发到您的 SMTP 服务器:
sudo apt install -y msmtp msmtp-mta
sudo nano /etc/msmtprc如果安装过程中询问 AppArmor,请保留默认选项。然后填写您的 SMTP 账户:
defaults
auth on
tls on
tls_trust_file /etc/ssl/certs/ca-certificates.crt
syslog on
account alertes
host smtp.您的域名.com
port 587
from netdata@您的域名.com
user netdata@您的域名.com
password 您的SMTP密码
account default : alertes该文件包含密码:只有 root 能修改它,只有 netdata 组能读取它。
sudo chown root:netdata /etc/msmtprc
sudo chmod 640 /etc/msmtprc
printf 'Subject: msmtp 测试\n\n这是一封测试邮件。\n' | sudo -u netdata msmtp alertes@您的域名.com选择收件人
cd /etc/netdata
sudo ./edit-config health_alarm_notify.conf修改以下三个变量:
EMAIL_SENDER="netdata@您的域名.com"
SEND_EMAIL="YES"
DEFAULT_RECIPIENT_EMAIL="alertes@您的域名.com"修改会在下一次告警时生效。发送一条测试通知:
sudo su -s /bin/bash netdata
export NETDATA_ALARM_NOTIFY_DEBUG=1
/usr/libexec/netdata/plugins.d/alarm-notify.sh test
exit您应当收到三封测试邮件,分别对应 WARNING、CRITICAL 和 CLEAR 状态。
添加自定义告警
在告警目录中创建一个文件:
sudo nano /etc/netdata/health.d/cpu-15min.conf此示例监控 15 分钟内的 CPU 平均使用率:
alarm: cpu_usage_15min
on: system.cpu
lookup: average -15m unaligned of user,system,softirq,irq,guest
units: %
every: 1m
warn: $this > 80
crit: $this > 95
delay: down 15m multiplier 1.5 max 1h
summary: 15 分钟内 CPU 使用率过高
info: 最近 15 分钟的 CPU 平均使用率
to: sysadmin无需重启代理即可重新加载告警,然后确认您的告警已加载:
sudo netdatacli reload-health
curl -s 'http://127.0.0.1:19999/api/v1/alarms?all' | grep cpu_usage_15min更新 Netdata
安装脚本默认启用每日自动更新。查看其计划:
systemctl list-timers netdata-updater.timer --no-pager根据系统不同,如果未使用 systemd 定时器,计划任务也可能通过 cron 执行。要手动更新,请重新运行官方脚本:
curl -fsSL https://get.netdata.cloud/kickstart.sh -o /tmp/netdata-kickstart.sh
sh /tmp/netdata-kickstart.sh要关闭自动更新:
sudo /usr/libexec/netdata/netdata-updater.sh --disable-auto-updates备份与恢复
| 数据 | 位置 |
|---|---|
| 配置 | /etc/netdata |
| 指标 | /var/cache/netdata |
| 代理标识及可能存在的令牌 | /var/lib/netdata |
复制指标期间请先停止代理,以获得一致的备份:
sudo systemctl stop netdata
sudo tar -czpf "/root/netdata-$(date +%F).tar.gz" /etc/netdata /var/cache/netdata /var/lib/netdata
sudo systemctl start netdata
sudo chmod 600 /root/netdata-*.tar.gz然后将归档文件复制到服务器之外。如果您希望原样重建整套环境,还应备份 /etc/msmtprc 和 Nginx 文件。
恢复时,如有需要请先重新安装 Netdata,然后执行:
sudo systemctl stop netdata
sudo rm -rf /var/cache/netdata
sudo tar -xzpf /root/netdata-YYYY-MM-DD.tar.gz -C /
sudo systemctl start netdata故障排查
502 Bad Gateway 错误
Nginx 无法连接到代理。
sudo systemctl status netdata --no-pager
sudo ss -tlnp | grep 19999
sudo tail -n 30 /var/log/nginx/error.log请确认代理正在运行,并且 bind to 与 upstream 的地址(此处为 127.0.0.1)一致。
浏览器反复要求输入密码
检查文件权限和用户名:
sudo ls -l /etc/nginx/.htpasswd-netdata
sudo htpasswd -v /etc/nginx/.htpasswd-netdata admin该文件必须可被 www-data 组读取。如果 /var/log/nginx/error.log 中出现 Permission denied 错误,则说明是权限问题。
19999 端口可从互联网访问
请确认 [web] 段位于 /etc/netdata/netdata.conf 中,重启代理,然后检查 sudo ss -tlnp | grep 19999 和 sudo ufw status verbose。
Certbot 失败
请使用 getent hosts netdata.您的域名.com 确认域名已指向服务器,80 端口已开放,并且 sudo nginx -t 没有报告任何错误。
收不到电子邮件
- 重新运行
alarm-notify.sh test测试,并查看其详细输出。 - 使用
sudo journalctl -t msmtp -n 30 --no-pager查看 msmtp 日志。 - 如果
command -v sendmail没有返回任何内容,说明尚未安装msmtp-mta软件包。 /etc/msmtprc上出现Permission denied错误,说明该文件存在权限问题。- 如果 SMTP 连接超时,请尝试邮件服务商提供的其他端口。如需确认您的服务是否存在过滤,请通过客户中心联系支持团队。
Netdata 占用磁盘空间过多
检查实际占用情况,然后在 netdata.conf 的 [db] 段中缩短保留期:
sudo du -sh /var/cache/netdata
cd /etc/netdata
sudo ./edit-config netdata.conf[db]
dbengine tier 0 retention size = 500MiB
dbengine tier 1 retention size = 500MiB
dbengine tier 2 retention size = 500MiB然后使用 sudo systemctl restart netdata 重启代理。
延伸阅读
如需保存多台服务器的指标并创建自己的仪表板,请参阅指南 安装 Prometheus 和 Grafana。