westerus/zabbix-agent
自动构建
westerus
Zabbix Agent官方Docker镜像，部署在监控目标上用于主动监控本地资源和应用程序（如硬盘、内存、处理器统计等），支持主动和被动检查，基于Alpine和Ubuntu系统，可灵活配置环境变量和卷以扩展功能。
下载次数: 0状态：自动构建维护者：westerus仓库类型：镜像最近更新：8 年前
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
基本启动命令
consoledocker run --name some-zabbix-agent \ -e ZBX_HOSTNAME="监控目标主机名" \ -e ZBX_SERVER_HOST="Zabbix服务器IP或域名" \ -d 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：
consoledocker run --name some-zabbix-server \ --link some-zabbix-agent:zabbix-agent \ -d zabbix/zabbix-server:latest
主动检查（Agent主动发送数据）
通过容器链接使Agent可访问Zabbix服务器/代理：
consoledocker run --name some-zabbix-agent \ --link some-zabbix-server:zabbix-server \ -d zabbix/zabbix-agent:latest
容器Shell访问和日志查看
进入容器Shell
consoledocker exec -ti some-zabbix-agent /bin/bash
查看Agent日志
consoledocker logs some-zabbix-agent
特权模式
由于Docker容器默认无主机资源访问权限，监控系统资源时需使用特权模式或挂载系统卷：
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
环境变量配置
启动容器时可通过环境变量自定义Agent配置，常用变量如下：
| 变量名 | 描述 | 默认值 |
|---|---|---|
ZBX_HOSTNAME | 唯一主机名（区分大小写） | 容器主机名 |
ZBX_SERVER_HOST | Zabbix服务器/代理的IP/DNS | zabbix-server |
ZBX_PASSIVE_ALLOW | 是否启用被动检查（true/false） | true |
ZBX_PASSIVESERVERS | 允许连接的Zabbix服务器/代理列表（逗号分隔） | - |
ZBX_ACTIVE_ALLOW | 是否启用主动检查（true/false） | true |
ZBX_ACTIVESERVERS | 主动检查的Zabbix服务器/代理列表（格式：服务器:端口,代理:端口） | - |
ZBX_LOADMODULE | 加载的模块列表（逗号分隔，需配合/var/lib/zabbix/modules卷） | - |
ZBX_DEBUGLEVEL | 调试级别（0-5，0=基本信息，5=详细调试） | 3 |
ZBX_TIMEOUT | 检查超时时间（秒） | 3 |
其他支持的环境变量（对应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=
支持的卷
| 卷路径 | 用途 |
|---|---|
/etc/zabbix/zabbix_agentd.d | 挂载自定义配置文件（*.conf），扩展UserParameter功能 |
/var/lib/zabbix/modules | 挂载额外模块文件，配合ZBX_LOADMODULE加载模块 |
/var/lib/zabbix/enc | 存储TLS相关文件（如CA证书、密钥等），需通过TLS相关环境变量指定文件名 |
镜像变体
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讨论功能设计或问题修复方案。
zabbix/zabbix-agent
zabbix
Zabbix代理（Zabbix agent）是部署在被监控主机上的客户端组件，在Zabbix监控架构中负责采集系统资源、应用程序性能及运行状态等关键数据，并通过支持TLS加密协议与Zabbix服务器或代理服务器进行安全通信，有效保障数据传输过程中的机密性与完整性，防止信息泄露或篡改，适用于对数据安全有严格要求的企业级监控场景，提升整体监控系统的安全性和可靠性。
238 次收藏5000万+ 次下载
17 天前更新
zabbixmultiarch/zabbix-agent
zabbixmultiarch
暂无描述
1 次收藏10万+ 次下载
5 年前更新
million12/zabbix-agent
million12
基于CentOS-7的Zabbix Agent Docker镜像，运行在前台，通过映射宿主机的/proc、/dev、/sys目录读取系统信息，用于监控主机系统状态。
7 次收藏10万+ 次下载
9 年前更新
xddxdd/zabbix-agent
xddxdd
暂无描述
5万+ 次下载
6 年前更新
jetbrainsinfra/zabbix-agent
jetbrainsinfra
zabbix-agent
5万+ 次下载
7 年前更新
sctnoc/zabbix-agent
sctnoc
暂无描述
5万+ 次下载
6 年前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"