cmp1234/zabbix-agent

Zabbix agent Docker镜像文档

!logo

镜像概述和主要用途

Zabbix是企业级开源分布式监控解决方案，可监控网络参数、服务器健康状态和完整性。Zabbix agent是部署在监控目标上的组件，用于主动监控本地资源和应用程序（如硬盘、内存、处理器统计等）。本镜像为官方Zabbix agent Docker镜像，基于Alpine和Ubuntu系统，提供多种版本选择。

核心功能和特性

• 主动监控：主动收集本地系统资源和应用程序数据
• 灵活配置：通过环境变量自定义Zabbix agent参数
• 多版本支持：提供Zabbix 3.0、3.2、3.4、4.0等多个版本
• 双系统基础：基于Alpine（轻量级）和Ubuntu（兼容性好）
• 安全通信：支持TLS加密通信配置
• 模块化扩展：支持加载自定义模块和用户参数

使用场景和适用范围

• 监控服务器、虚拟机、容器等IT基础设施
• 集成到Docker环境中实现容器化监控
• 作为Zabbix监控系统的客户端组件
• 需要轻量级监控代理的场景（Alpine版本）
• 需要广泛兼容性的企业环境（Ubuntu版本）

详细使用方法和配置说明

镜像版本标签

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

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

基本启动命令

console
docker run --name some-zabbix-agent -e ZBX_HOSTNAME="some-hostname" -e ZBX_SERVER_HOST="some-zabbix-server" -d docker.xuanyuan.run/zabbix/zabbix-agent:tag

参数说明：

• some-zabbix-agent：容器名称
• some-hostname：Zabbix agent主机名（对应配置文件中的Hostname参数）
• some-zabbix-server：Zabbix服务器或代理的IP或DNS名称
• tag：指定所需版本的标签（如latest、alpine-3.4-latest）

被动检查配置

Zabbix agent暴露标准端口***用于被动检查，可通过容器链接使Zabbix服务器/代理访问：

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

主动检查配置

支持主动检查，可链接到Zabbix服务器/代理容器：

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

容器操作

进入容器shell

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

查看Zabbix 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

环境变量配置

启动容器时可通过环境变量调整Zabbix agent配置：

其他常用环境变量及默认值：

ZBX_SOURCEIP=
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_LISTENIP=
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系统，兼容性好，适合大多数场景。包含较多系统工具，镜像体积较大。

zabbix-agent:alpine-<version>

基于Alpine Linux，体积小（约5MB基础镜像），适合对镜像大小有严格要求的场景。使用musl libc替代glibc，部分依赖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%E5%8F%8D%E9%A6%88%E3%80%82

已知问题

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

贡献

欢迎通过GitHub pull request贡献代码或改进，建议先通过GitHub issue讨论重大变更。