中文

应用程序

使用 Netdata 监控服务器

在 Debian 或 Ubuntu 上安装 Netdata,通过 Nginx、HTTPS 和密码保护仪表板,并接收电子邮件告警。

阅读约 7 分钟, 更新于 2026年11月18日

本页内容

您的参数

只需填写一次,指南中的命令会自动更新。

本指南介绍如何在运行 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

粘贴以下配置,并根据实际情况修改域名:

Nginx
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。

参考资料