westerus/zabbix-agent

Zabbix Agent Docker镜像文档

!logo

镜像概述和主要用途

Zabbix是企业级开源分布式监控解决方案，而Zabbix Agent是部署在监控目标上的组件，用于主动监控本地资源和应用程序（如硬盘、内存、处理器统计等）。本镜像为官方Zabbix Agent Docker镜像，基于最新Alpine和Ubuntu系统，提供灵活的配置选项，支持主动和被动检查，适用于企业网络监控、服务器健康状态监测等场景。

核心功能和特性

• 多版本支持：提供Zabbix Agent 3.0、3.2、3.4等版本，基于Alpine和Ubuntu系统
• 主动/被动检查：支持被动检查（Zabbix服务器/代理主动请求数据）和主动检查（Agent主动发送数据）
• 灵活配置：通过环境变量自定义Agent配置，如主机名、服务器地址、超时时间等
• 可扩展性：支持挂载卷添加自定义配置文件和加载模块
• 轻量级选项：提供基于Alpine Linux的镜像，体积更小，资源占用低

使用场景和适用范围

• 企业级服务器集群监控
• 本地资源（CPU、内存、磁盘）实时监测
• 应用程序性能指标收集
• 跨平台监控目标部署（支持Alpine/Ubuntu基础系统）
• 需要快速部署和配置的监控环境

详细使用方法和配置说明

镜像版本标签

官方Zabbix Agent镜像提供以下版本标签：

• Zabbix Agent 3.0：alpine-3.0-latest、ubuntu-3.0-latest、alpine-3.0.*、ubuntu-3.0.*
• Zabbix Agent 3.2：alpine-3.2-latest、ubuntu-3.2-latest、alpine-latest、ubuntu-latest、latest（默认基于Alpine）
• Zabbix Agent 3.2.*：alpine-3.2.*、ubuntu-3.2.*
• Zabbix Agent 3.4：alpine-trunk、ubuntu-trunk

基本启动命令

console
docker run --name some-zabbix-agent \
  -e ZBX_HOSTNAME="监控目标主机名" \
  -e ZBX_SERVER_HOST="Zabbix服务器IP或域名" \
  -d docker.xuanyuan.run/zabbix/zabbix-agent:tag

参数说明：

• some-zabbix-agent：容器名称
• ZBX_HOSTNAME：监控目标主机名（对应zabbix_agentd.conf中的Hostname参数）
• ZBX_SERVER_HOST：Zabbix服务器或代理的IP/DNS（对应zabbix_agentd.conf中的Server参数）
• tag：指定镜像版本标签（如latest、alpine-3.2-latest）

与Zabbix服务器/代理容器连接

被动检查（服务器主动请求数据）

暴露***端口，通过容器链接使Zabbix服务器/代理可访问Agent：

console
docker run --name some-zabbix-server \
  --link some-zabbix-agent:zabbix-agent \
  -d docker.xuanyuan.run/zabbix/zabbix-server:latest

主动检查（Agent主动发送数据）

通过容器链接使Agent可访问Zabbix服务器/代理：

console
docker run --name some-zabbix-agent \
  --link some-zabbix-server:zabbix-server \
  -d docker.xuanyuan.run/zabbix/zabbix-agent:latest

容器Shell访问和日志查看

进入容器Shell

console
docker exec -ti some-zabbix-agent /bin/bash

查看Agent日志

console
docker logs some-zabbix-agent

特权模式

由于Docker容器默认无主机资源访问权限，监控系统资源时需使用特权模式或挂载系统卷：

console
# 特权模式
docker run --name some-zabbix-agent \
  --link some-zabbix-server:zabbix-server \
  --privileged \
  -d docker.xuanyuan.run/zabbix/zabbix-agent:latest

# 挂载系统卷（如监控特定磁盘）
docker run --name some-zabbix-agent \
  --link some-zabbix-server:zabbix-server \
  -v /dev/sdc:/dev/sdc \
  -d docker.xuanyuan.run/zabbix/zabbix-agent:latest

环境变量配置

启动容器时可通过环境变量自定义Agent配置，常用变量如下：

其他支持的环境变量（对应zabbix_agentd.conf参数）：

ZBX_ENABLEREMOTECOMMANDS=0
ZBX_LOGREMOTECOMMANDS=0
ZBX_STARTAGENTS=3
ZBX_HOSTNAMEITEM=system.hostname
ZBX_METADATA=
ZBX_METADATAITEM=
ZBX_REFRESHACTIVECHECKS=120
ZBX_BUFFERSEND=5
ZBX_BUFFERSIZE=100
ZBX_MAXLINESPERSECOND=20
ZBX_UNSAFEUSERPARAMETERS=0
ZBX_TLSCONNECT=unencrypted
ZBX_TLSACCEPT=unencrypted
ZBX_TLSCAFILE=
ZBX_TLSCRLFILE=
ZBX_TLSSERVERCERTISSUER=
ZBX_TLSSERVERCERTSUBJECT=
ZBX_TLSCERTFILE=
ZBX_TLSKEYFILE=
ZBX_TLSPSKIDENTITY=
ZBX_TLSPSKFILE=

支持的卷

镜像变体

zabbix-agent:ubuntu-<version>

默认镜像，基于Ubuntu系统，适合需要glibc环境或依赖较多系统工具的场景。

zabbix-agent:alpine-<version>

基于Alpine Linux，体积更小（约5MB基础镜像），资源占用低，适合对镜像大小有严格要求的场景。需注意Alpine使用musl libc，部分依赖glibc的软件可能存在兼容性问题。

支持的Docker版本

官方支持Docker 1.12.0及以上版本，1.6及以上版本提供有限支持。

用户反馈

文档

镜像文档存储在https://github.com/zabbix/zabbix-docker/%E7%9A%84%60agent/%60%E7%9B%AE%E5%BD%95%E4%B8%8B%E3%80%82

问题反馈

如遇问题，可通过https://github.com/zabbix/zabbix-docker/issues%E6%8F%90%E4%BA%A4%E3%80%82

已知问题

当前不支持通过ZBX_ALIAS环境变量配置Alias，需通过/etc/zabbix/zabbix_agentd.d卷添加包含Alias配置的文件。

贡献

欢迎通过Pull Request贡献代码，建议先通过GitHub Issues讨论功能设计或问题修复方案。