Ubuntu 24.04 部署 Zabbix 7.0 LTS Agent/Agent 2

在自动化运维体系中，Zabbix 作为主流的开源监控系统，能够实现对服务器、网络设备、数据库等目标的全方位指标采集与监控告警。Zabbix 提供传统 Agent 和新一代 Agent 2 两种被监控端组件，其中 Agent 2 采用 Go 语言开发，支持插件化架构，资源占用更低、采集效率更高，还能通过插件扩展对各类中间件的监控能力。本文将详细介绍 Ubuntu 24.04 系统下 Zabbix 7.0 LTS Agent 与 Agent 2 的完整部署、配置及验证流程，并优化下载源提升部署效率，适合运维人员快速上手。

一、 环境准备与配置选型

本次实验基于 Zabbix 官方部署指南，明确以下环境与配置选型，确保操作的针对性、可复现性，同时匹配官方推荐路径：

配置项	具体选型
Zabbix 版本	7.0 LTS（长期支持版，稳定性强，适合生产环境）
操作系统发行版	Ubuntu
操作系统版本	24.04 (Noble)
Zabbix 组件	Agent（传统组件）、Agent 2（新一代组件，含插件）
依赖环境	无额外数据库/ Web 服务需求（仅部署被监控端组件）

注：Agent 与 Agent 2 可根据需求选择部署，无需同时安装；Agent 2 更适合需要监控中间件（如 MongoDB、PostgreSQL）的场景。

二、 部署 Zabbix Agent（传统组件）

2.1 切换至 root 权限

为避免操作过程中出现权限不足问题，切换至 root 用户开启新的 shell 会话：

sudo -s

2.2 配置 Zabbix 软件源（阿里云镜像，提升下载速度）

官方源国内访问速度较慢，推荐替换为阿里云镜像源，同时保留原配置备份：

# 下载 Zabbix 7.0 对应 Ubuntu 24.04 的源安装包
wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest_7.0+ubuntu24.04_all.deb

# 安装源包，配置官方源地址
dpkg -i zabbix-release_latest_7.0+ubuntu24.04_all.deb

# 替换为阿里云镜像源（.bak 后缀保留原配置备份）
sed -i.bak 's#http://repo.zabbix.com#https://mirrors.aliyun.com/zabbix#' /etc/apt/sources.list.d/zabbix.list

# 更新系统软件包索引，使镜像源生效
apt update

2.3 安装 Zabbix Agent

源配置完成后，通过 apt 命令一键安装 Zabbix Agent：

apt install zabbix-agent -y

2.4 启动服务并设置开机自启

安装完成后，启动 Zabbix Agent 服务，并配置为开机自启，确保服务器重启后组件自动运行：

# 重启服务使配置生效
systemctl restart zabbix-agent

# 设置开机自启
systemctl enable zabbix-agent

三、 部署 Zabbix Agent 2（新一代组件）

Zabbix Agent 2 兼容 Agent 的核心功能，同时支持插件化扩展，以下是完整部署流程，步骤与 Agent 类似，重点补充插件安装环节。

3.1 切换 root 权限与配置软件源（阿里云镜像）

同 2.1 步骤，已配置过 Zabbix 源可跳过源配置环节：

sudo -s
# 若未配置源，执行以下命令（已配置则忽略）
wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest_7.0+ubuntu24.04_all.deb
dpkg -i zabbix-release_latest_7.0+ubuntu24.04_all.deb

# 替换为阿里云镜像源（关键优化：提升下载速度）
sed -i.bak 's#http://repo.zabbix.com#https://mirrors.aliyun.com/zabbix#' /etc/apt/sources.list.d/zabbix.list

# 更新软件包索引
apt update

3.2 安装 Zabbix Agent 2

执行 apt 命令安装 Zabbix Agent 2 主程序：

apt install zabbix-agent2 -y

3.3 安装 Agent 2 插件（可选，按需安装）

Agent 2 支持通过插件扩展监控能力，官方提供了 MongoDB、PostgreSQL、MSSQL 等常用中间件的插件，可根据监控需求安装：

# 安装主流数据库插件（可按需增减）
apt install zabbix-agent2-plugin-mongodb zabbix-agent2-plugin-mssql zabbix-agent2-plugin-postgresql -y

说明：插件安装后无需额外配置，重启 Agent 2 即可加载，后续可在 Zabbix Server 端配置对应中间件的监控模板。

3.4 启动 Agent 2 服务并设置开机自启

启动服务并配置开机自启，确保插件与主程序正常运行：

# 重启 Agent 2 服务，加载插件与配置
systemctl restart zabbix-agent2

# 设置开机自启
systemctl enable zabbix-agent2

四、 配置 Agent/Agent 2 连接 Zabbix Server

默认配置下，Agent/Agent 2 仅允许本地回环地址（127.0.0.1）连接，需修改配置文件指定 Zabbix Server 地址，实现数据上报。两者配置文件路径一致，操作流程相同。

4.1 编辑核心配置文件

使用 vim 编辑器打开 Zabbix Agent/Agent 2 配置文件：

vim /etc/zabbix/zabbix_agentd.conf

4.2 修改关键配置项

找到对应配置行，按以下要求修改（删除注释符 # 使其生效）：

# 核心配置：允许连接的 Zabbix Server 地址（填写实际监控端 IP/域名）
Server=监控端主机地址

# 可选配置（主动模式）：Agent 主动向 Server 上报数据的地址，与 Server 一致即可
# ServerActive=监控端主机地址

# 可选配置：被监控端主机名（需与 Zabbix Server 端添加主机时的名称一致）
# Hostname=Ubuntu-2404-Agent

说明：若采用被动模式（默认），仅需配置 Server 项；主动模式需同时配置 ServerActive 和 Hostname 项。

4.3 重启服务加载配置

保存配置文件后，根据安装的组件重启对应服务：

# 若安装的是 Agent
systemctl restart zabbix-agent

# 若安装的是 Agent 2
systemctl restart zabbix-agent2

五、 验证服务运行状态

配置完成后，检查服务运行状态，确保组件正常启动，无报错信息。

5.1 验证 Zabbix Agent 状态

systemctl status zabbix-agent

正常运行的输出如下（关键状态标注）：

● zabbix-agent.service - Zabbix Agent
     Loaded: loaded (/usr/lib/systemd/system/zabbix-agent.service; enabled; preset: enabled) # 已开机自启
     Active: active (running) since Mon 2026-01-19 14:42:00 UTC; 7s ago # 运行中
    Process: 2263 ExecStart=/usr/sbin/zabbix_agentd -c $CONFFILE (code=exited, status=0/SUCCESS)
   Main PID: 2265 (zabbix_agentd)
      Tasks: 13 (limit: 4548)
     Memory: 9.3M (peak: 10.0M)
        CPU: 25ms
     CGroup: /system.slice/zabbix-agent.service
             ├─2265 /usr/sbin/zabbix_agentd -c /etc/zabbix/zabbix_agentd.conf
             ├─2266 "/usr/sbin/zabbix_agentd: collector [idle 1 sec]"
             └─......（其余进程省略）

5.2 验证 Zabbix Agent 2 状态

systemctl status zabbix-agent2

正常运行的输出如下（Agent 2 进程结构与 Agent 略有差异，含插件加载模块）：

● zabbix-agent2.service - Zabbix Agent 2
     Loaded: loaded (/usr/lib/systemd/system/zabbix-agent2.service; enabled; preset: enabled)
     Active: active (running) since Mon 2026-01-19 15:30:00 UTC; 10s ago
   Main PID: 3456 (zabbix_agent2)
      Tasks: 8 (limit: 4548)
     Memory: 12.5M (peak: 13.2M)
        CPU: 30ms
     CGroup: /system.slice/zabbix-agent2.service
             └─3456 /usr/sbin/zabbix-agent2 -c /etc/zabbix/zabbix_agentd.conf

Jan 19 15:29:59 ubuntu-101 systemd[1]: Starting zabbix-agent2.service - Zabbix Agent 2...
Jan 19 15:30:00 ubuntu-101 systemd[1]: Started zabbix-agent2.service - Zabbix Agent 2.

5.3 故障排查技巧

若服务启动失败，可通过以下命令查看日志，定位配置错误、插件异常或权限问题：

# 查看 Agent 日志
journalctl -u zabbix-agent -f

# 查看 Agent 2 日志
journalctl -u zabbix-agent2 -f

六、 验证 Server 与 Agent/Agent 2 连通性

在 Zabbix Server 端执行 zabbix_get 命令，测试与被监控端的通信及数据采集功能（本次测试被监控端 IP 为 10.0.0.101，端口默认 10050）。

6.1 基础连通性测试（通用）

使用 agent.ping 键值检测连通性，返回 1 表示通信正常：

zabbix_get -s 10.0.0.101 -p 10050 -k "agent.ping"

输出结果：1（正常）/ 无输出（异常）

6.2 系统指标采集测试（通用）

采集被监控端 1 分钟 CPU 平均负载，验证数据采集功能：

zabbix_get -s 10.0.0.101 -p 10050 -k "system.cpu.load[all,avg1]"

输出结果：0.000000（示例值，随系统负载变化）

6.3 Agent 2 插件功能测试（可选）

若安装了数据库插件，可测试插件是否正常工作（以 PostgreSQL 为例）：

# 需先在被监控端配置 PostgreSQL 连接权限，再执行以下命令
zabbix_get -s 10.0.0.101 -p 10050 -k "postgresql.ping"

输出结果：1（插件加载正常且数据库可连接）

6.4 测试结果总结

基础测试成功返回结果，说明：

1. Zabbix Server 与被监控端网络通信正常，10050 端口无防火墙拦截；
2. Agent/Agent 2 配置正确，能正常响应 Server 端的数据请求；
3. Agent 2 插件加载成功（若安装），可扩展监控中间件指标。

七、 总结与注意事项

7.1 核心注意事项

1. 版本匹配：务必选择与操作系统版本、Zabbix 版本对应的官方源，避免因版本不兼容导致安装失败或功能异常；
2. 镜像源优化：sed -i.bak 命令会自动备份原源配置文件（后缀 .bak），若镜像源异常，可通过 mv /etc/apt/sources.list.d/zabbix.list.bak /etc/apt/sources.list.d/zabbix.list 恢复官方源；
3. 端口与防火墙：确保被监控端开放 10050 端口（TCP），或 Zabbix Server 端能穿透防火墙访问该端口，这是通信的前提；
4. Agent 与 Agent 2 选型：简单系统监控选 Agent 即可；需监控中间件、追求高效采集选 Agent 2，插件按需安装避免资源浪费；
5. 配置一致性：被监控端 Hostname（若配置）需与 Zabbix Server 端添加主机时的名称完全一致，否则无法关联监控模板。

7.2 后续扩展建议

1. 在 Zabbix Server 端添加被监控主机，关联官方模板（如 Template OS Linux），实现指标自动采集；
2. 配置告警规则，针对 CPU、内存、磁盘等关键指标设置阈值，异常时触发告警；
3. Agent 2 插件需配合对应中间件的权限配置（如数据库账号密码），才能正常采集指标，可参考 Zabbix 官方文档配置。

通过本文流程，可快速完成 Ubuntu 24.04 系统下 Zabbix Agent/Agent 2 的部署与验证，且通过阿里云镜像源优化大幅提升了组件下载速度，为后续构建完整的 Zabbix 监控体系奠定基础。

关键点回顾

1. 核心优化：在 apt update 前通过 sed -i.bak 替换 Zabbix 源为阿里云镜像，既提升下载速度，又保留原配置备份；
2. Agent 2 相比传统 Agent 新增插件化能力，可按需安装 MongoDB/PostgreSQL/MSSQL 等插件扩展监控范围；
3. 连通性验证核心命令为 zabbix_get，agent.ping 返回 1 是通信正常的核心标志。