epicmorg/zabbix-agent

!logo

Zabbix Agent 镜像文档

镜像概述和主要用途

Zabbix是企业级开源分布式监控解决方案，可监控网络参数、服务器健康状态和完整性。Zabbix Agent是部署在监控目标上的组件，用于主动监控本地资源和应用（如硬盘、内存、处理器统计等）。

本镜像是官方Zabbix Agent Docker镜像，基于Alpine Linux v3.11、Ubuntu 18.04（bionic）和CentOS 7构建，提供多种版本标签选择，镜像会随新版本发布更新。

核心功能和特性

• 多平台支持：基于Alpine、Ubuntu和CentOS多种基础镜像
• 监控能力：主动监控本地资源（硬盘、内存、处理器等）和应用状态
• 检查模式：支持被动检查和主动检查两种模式
• 灵活配置：通过环境变量自定义Zabbix Agent配置
• 可扩展性：支持加载自定义模块和用户参数
• 安全特性：支持TLS加密通信

镜像版本标签

可用的Zabbix Agent版本及对应标签：

• Zabbix Agent 3.0（标签：alpine-3.0-latest、ubuntu-3.0-latest、centos-3.0-latest）
• Zabbix Agent 3.0.（标签：alpine-3.0.、ubuntu-3.0.、centos-3.0.）
• Zabbix Agent 3.2（标签：alpine-3.2-latest、ubuntu-3.2-latest、centos-3.2.*）（不支持）
• Zabbix Agent 3.2.（标签：alpine-3.2.、ubuntu-3.2.、centos-3.2.）（不支持）
• Zabbix Agent 3.4（标签：alpine-3.4-latest、ubuntu-3.4-latest、centos-3.4.*）（不支持）
• Zabbix Agent 3.4.（标签：alpine-3.4.、ubuntu-3.4.、centos-3.4.）（不支持）
• Zabbix Agent 4.0（标签：alpine-4.0-latest、ubuntu-4.0-latest、centos-4.0-latest）
• Zabbix Agent 4.0.（标签：alpine-4.0.、ubuntu-4.0.、centos-4.0.）
• Zabbix Agent 4.2（标签：alpine-4.2-latest、ubuntu-4.2-latest、centos-4.2.*）（不支持）
• Zabbix Agent 4.2.（标签：alpine-4.2.、ubuntu-4.2.、centos-4.2.）（不支持）
• Zabbix Agent 4.4（标签：alpine-4.4-latest、ubuntu-4.4-latest、centos-4.4-latest）（不支持）
• Zabbix Agent 4.4.（标签：alpine-4.4.、ubuntu-4.4.、centos-4.4.）（不支持）
• Zabbix Agent 5.0（标签：alpine-5.0-latest、ubuntu-5.0-latest、centos-5.0-latest、alpine-latest、ubuntu-latest、centos-latest、latest）
• Zabbix Agent 5.0.（标签：alpine-5.0.、ubuntu-5.0.、centos-5.0.）
• Zabbix Agent 5.2（标签：alpine-trunk、ubuntu-trunk、centos-trunk）

注：latest标签基于Alpine Linux。

使用场景和适用范围

适用于企业级分布式监控环境，可部署在各类服务器、虚拟机或容器中，用于监控：

• 系统资源（CPU、内存、磁盘、网络）
• 应用程序状态
• 服务可用性
• 自定义业务指标

使用方法和配置说明

启动Zabbix Agent容器

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

参数说明：

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

与其他容器中的Zabbix Server/Proxy连接（被动检查）

Zabbix Agent暴露标准端口***用于被动检查，可通过容器链接使Zabbix Server/Proxy访问Agent：

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

连接到Zabbix Server/Proxy容器（主动检查）

支持主动检查，通过容器链接使Agent访问Zabbix Server/Proxy：

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

容器shell访问和查看日志

进入容器shell

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

查看Zabbix Agent日志

console
docker logs some-zabbix-agent

特权模式

默认容器为"非特权"模式，若需监控系统资源，可使用特权模式或挂载系统卷：

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

# 挂载系统卷
docker run --name some-zabbix-agent --link some-zabbix-server:zabbix-server -v /dev/sdc:/dev/sdc -d zabbix/zabbix-agent:latest

环境变量配置

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

核心环境变量

其他环境变量

ZBX_SOURCEIP=
ZBX_ENABLEREMOTECOMMANDS=0 # 5.0.0起已弃用
ZBX_LOGREMOTECOMMANDS=0
ZBX_HOSTINTERFACE= # 4.4.0起可用
ZBX_HOSTINTERFACEITEM= # 4.4.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=
ZBX_TLSCIPHERALL= # 4.4.7起可用
ZBX_TLSCIPHERALL13= # 4.4.7起可用
ZBX_TLSCIPHERCERT= # 4.4.7起可用
ZBX_TLSCIPHERCERT13= # 4.4.7起可用
ZBX_TLSCIPHERPSK= # 4.4.7起可用
ZBX_TLSCIPHERPSK13= # 4.4.7起可用
ZBX_DENYKEY=system.run[*] # 5.0.0起可用
ZBX_ALLOWKEY= # 5.0.0起可用

注：上述变量对应zabbix_agentd.conf配置文件中的参数，详细说明参见官方文档。

支持的卷挂载

/etc/zabbix/zabbix_agentd.d

用于包含自定义*.conf文件，通过UserParameter扩展Zabbix Agent功能。

/var/lib/zabbix/modules

用于加载额外模块，配合ZBX_LOADMODULE环境变量使用。

/var/lib/zabbix/enc

用于存储TLS相关文件，与ZBX_TLSCAFILE、ZBX_TLSCRLFILE等TLS相关环境变量配合使用。

镜像变体

zabbix-agent:ubuntu-<version>

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

zabbix-agent:alpine-<version>

基于Alpine Linux，镜像体积更小（约5MB基础镜像），使用musl libc，适合对镜像大小有严格要求的场景。由于Alpine的精简特性，可能需要自行安装额外工具。

支持的Docker版本

官方支持Docker 1.12.0及以上版本，对1.6及以上版本提供尽力支持。

用户反馈

文档

镜像文档存储在https://github.com/zabbix/zabbix-docker/%E7%9A%84https://github.com/zabbix/zabbix-docker/tree/3.0/agent%E3%80%82

问题

如有问题或疑问，请通过https://github.com/zabbix/zabbix-docker/issues%E5%8F%8D%E9%A6%88%E3%80%82

已知问题

目前不支持通过ZBX_ALIAS环境变量配置Alias，需使用/etc/zabbix/zabbix_agent.d卷挂载包含Alias配置的文件。

贡献

欢迎通过Pull Request贡献新功能、修复或更新，建议先通过GitHub Issue讨论计划。