quynhbofit/zabbix-agent

Zabbix Agent Docker镜像文档

镜像概述

quynhbofit/zabbix-agent镜像为Zabbix监控系统的客户端代理组件，用于在目标主机上收集系统资源、应用程序性能等监控数据，并将数据发送至Zabbix Server进行集中处理与分析。该镜像支持容器化部署，简化了Zabbix Agent的安装与配置流程。

核心功能与特性

• 数据采集：支持收集主机CPU、内存、磁盘、网络等系统资源数据及应用程序性能指标
• 服务通信：与Zabbix Server建立稳定连接，实时传输监控数据
• 容器化优势：简化部署流程，支持快速启停与版本管理
• 配置灵活：通过环境变量自定义Zabbix Server地址等核心参数
• 高可用性：支持自动重启策略，确保服务持续运行

使用场景

• 监控物理机或虚拟机的系统资源使用情况
• 收集容器化应用的性能指标
• 构建基于Zabbix的分布式监控系统
• 需要快速部署Zabbix Agent的环境

使用方法

基本部署（docker run）

bash
docker run -d \
  --name zabbix-agent \
  --network zabbix-net \
  --privileged \
  -e ZBX_SERVER_HOST=zabbix-server-mysql \
  --restart unless-stopped \
  quynhbofit/zabbix-agent:latest

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3.9'
networks:
  zabbix-net:
    name: zabbix-net
    driver: bridge
services:
  zabbix-agent:
    image: quynhbofit/zabbix-agent:latest
    container_name: zabbix-agent
    environment:
      - ZBX_SERVER_HOST=zabbix-server-mysql  # Zabbix Server主机名或IP
    networks:
      - zabbix-net  # 连接至Zabbix网络
    privileged: true  # 赋予特权模式，允许访问主机资源
    restart: unless-stopped  # 除非手动停止，否则自动重启

启动服务：

bash
docker-compose up -d

配置参数说明

环境变量

容器配置

• --privileged：启用特权模式，允许容器访问主机设备和系统资源，确保监控数据采集准确性
• --restart unless-stopped：设置容器重启策略，在容器意外停止时自动重启
• --network zabbix-net：将容器加入Zabbix专用网络，确保与Zabbix Server通信

注意事项

• 确保Zabbix Server已部署并运行，且与Zabbix Agent在同一网络中
• ZBX_SERVER_HOST需设置为Zabbix Server的正确主机名或IP，否则无法建立连接
• 特权模式可能带来安全风险，生产环境中需根据实际需求评估是否启用