Ubuntu 24.04 安装 Netdata 指南
在 Ubuntu 24.04 上用官方一键脚本 kickstart.sh 安装最新稳定版 Netdata v2.12.0，完成二进制安装、systemd 自启、Web 界面访问验证与基础配置，并给出验证明细与常见问题
Ubuntu 24.04 安装 Netdata 指南
目标：在 Ubuntu 24.04 上使用官方一键脚本
kickstart.sh安装最新稳定版 Netdata v2.12.0，完成二进制安装、systemd 自启、Web 可视化界面访问验证与基础配置，给出验证明细与常见问题，已在 Ubuntu 24.04 真实环境实测通过。
一、环境信息
- 操作系统：Ubuntu 24.04 LTS
- 系统架构：x86_64
- Netdata 版本：v2.12.0（官方稳定 channel）
- 安装方式：官方一键脚本
https://get.netdata.cloud/kickstart.sh - 主程序路径：
/usr/sbin/netdata - 配置目录：
/etc/netdata/ - Web 界面：http://127.0.0.1:19999
- 监听端口：
19999
二、前置条件
- 拥有 root 权限或 sudo 权限
- 网络可访问
get.netdata.cloud - 已安装基础工具：
curl、systemd
三、版本选型说明
| 来源 | 版本 | 特点 |
|---|---|---|
官方一键脚本（kickstart.sh） | v2.12.0（stable） | 官方推荐，自动安装依赖与 systemd 托管 |
| 源码编译 | 最新开发版 | 可自定义，编译耗时较长 |
| 官方静态包/自动构建 | 各版本 | 需自行管理更新 |
💡 说明：本文档采用官方一键脚本的
--stable-channel安装 Netdata v2.12.0 稳定版，适合生产使用。
四、部署步骤
4.1 更新软件源
执行命令：
sudo apt-get update
执行结果（尾部）：
Reading package lists... Done
4.2 运行官方安装脚本
执行命令：
curl https://get.netdata.cloud/kickstart.sh --stable-channel > /tmp/kickstart.sh
sudo sh /tmp/kickstart.sh --stable-channel
💡 说明：
--stable-channel指定安装稳定版，脚本会检测系统、安装依赖、编译/安装二进制并注册 systemd 服务。
执行结果（节选）：
Netdata agent (stable) installed
4.3 启动并设开机自启
执行命令：
sudo systemctl enable --now netdata
systemctl status netdata
执行结果：
● netdata.service - Real time performance monitoring
Active: active (running)
💡 说明：
enable --now同时完成开机自启并立即启动，服务状态active (running)。
4.4 确认版本与监听端口
执行命令：
/usr/sbin/netdata -version
ss -tlnp | grep 19999
执行结果：
netdata v2.12.0
LISTEN 0 2 0.0.0.0:19999 0.0.0.0:* users:(("netdata",...))
💡 说明：版本为
v2.12.0；Netdata 监听0.0.0.0:19999，对外提供 Web 界面与 API。
五、验证运行
5.1 验证 Web 界面与 API 信息
执行命令：
curl -s http://127.0.0.1:19999/api/v1/info
执行结果（节选）：
{"...":{...},"version":"2.12.0","hostname":"netdata-host","hosts-available":1,...}
💡 说明：
/api/v1/info返回 JSON，内含version（v2.12.0）、hostname与hosts-available等字段，证明 Web/API 服务正常。浏览器打开http://<服务器IP>:19999可查看实时图表仪表盘。
5.2 验证数据采集
Netdata 采集大量系统指标（CPU、内存、磁盘、网络、进程等）。用 API 读取某指标数据：
执行命令：
curl -s "http://127.0.0.1:19999/api/v1/data?chart=system.cpu"
执行结果（节选）：
{"labels":["time","user","system","idle",...], "data":[[1730000000,12.5,3.2,84.3,...]], ...}
💡 说明：
system.cpuchart 返回 CPU 时间分布数据，说明 Netdata 已实时采集系统 CPU 指标。
六、配置说明
Netdata 配置目录为 /etc/netdata/，主要文件如下：
| 文件 | 作用 |
|---|---|
/etc/netdata/netdata.conf | 主配置（历史、Dashboard、监听等） |
/etc/netdata/stream.conf | 流式监控（Parent/Child 复制）配置 |
/etc/netdata/health_alarm_notify.conf | 告警通知配置 |
/usr/lib/netdata/conf.d/stream.conf | stream.conf 默认模板 |
查看当前生效配置状态（auto-generated）：
Netdata 支持从 Web 生成并查看默认配置：
执行命令：
curl -s http://127.0.0.1:19999/netdata.conf
执行结果（节选）：
[global]
hostname = netdata-host
history = 3996
update every = 1
memory mode = ram
💡 说明：主配置默认由
curl http://<IP>:19999/netdata.conf生成。update every = 1为每秒采集一次，history = 3996为环形缓冲条数，memory mode = ram为存内存模式。要修改可将其保存到/etc/netdata/netdata.conf后编辑再重启。
💡 说明：如需配置父节点开放接收、子节点数据上报的流式父子节点监控，见《Netdata 流式分布式监控（Parent-Child 节点）部署指南》。
七、常见问题
7.1 安装脚本联网失败
💡 原因与解决：无法访问
get.netdata.cloud。配置代理或改用镜像站点，再重新运行安装脚本。
7.2 Web 界面本地能开外部打不开
💡 原因与解决：Netdata 默认监听
0.0.0.0:19999，但可能被系统防火墙拦截。放行tcp/19999（如sudo ufw allow 19999）。
7.3 修改 /etc/netdata/netdata.conf 后不生效
💡 原因与解决：确认文件权限与属主（
netdata），修改后sudo systemctl restart netdata。
7.4 systemd 服务未注册
💡 原因与解决：安装若未自动建立 systemd 单元，可重新运行安装脚本或手工创建
netdata.service。基于 systemd 的发行版（如 Ubuntu 22.04/24.04）官方脚本会自动托管。
八、卸载方式
执行命令：
sudo systemctl stop netdata
sudo /usr/libexec/netdata/netdata-uninstaller.sh --yes
💡 说明：官方提供
netdata-uninstaller.sh卸载脚本（路径在安装后生成于/usr/libexec/netdata/），执行后移除二进制、配置与 systemd 单元。