cmp1234/zabbix-agent
自动构建
cmp1234
Zabbix agent部署在监控目标上，用于主动监控本地资源和应用程序（如硬盘、内存、处理器统计等），是企业级开源分布式监控解决方案Zabbix的重要组件。
下载次数: 0状态：自动构建维护者：cmp1234仓库类型：镜像最近更新：8 年前
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
基本启动命令
consoledocker 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-3.4-latest）
被动检查配置
Zabbix agent暴露标准端口***用于被动检查，可通过容器链接使Zabbix服务器/代理访问：
consoledocker run --name some-zabbix-server --link some-zabbix-agent:zabbix-agent -d zabbix/zabbix-server:latest
主动检查配置
支持主动检查，可链接到Zabbix服务器/代理容器：
consoledocker run --name some-zabbix-agent --link some-zabbix-server:zabbix-server -d zabbix/zabbix-agent:latest
容器操作
进入容器shell
consoledocker exec -ti some-zabbix-agent /bin/bash
查看Zabbix 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
环境变量配置
启动容器时可通过环境变量调整Zabbix agent配置：
| 变量名 | 说明 | 默认值 |
|---|---|---|
ZBX_HOSTNAME | 唯一主机名（区分大小写） | 容器主机名 |
ZBX_SERVER_HOST | Zabbix服务器/代理的IP或DNS | zabbix-server |
ZBX_PASSIVE_ALLOW | 是否允许被动检查 | true |
ZBX_PASSIVESERVERS | 允许连接的Zabbix服务器/代理列表（逗号分隔） | - |
ZBX_ACTIVE_ALLOW | 是否允许主动检查 | true |
ZBX_ACTIVESERVERS | 主动检查的Zabbix服务器/代理列表（可带端口，如zabbix-server:10061） | - |
ZBX_LOADMODULE | 加载的模块列表（逗号分隔，需配合/var/lib/zabbix/modules卷） | - |
ZBX_DEBUGLEVEL | 调试级别（0-5） | 3 |
ZBX_TIMEOUT | 检查超时时间（秒） | 3 |
其他常用环境变量及默认值：
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=
支持的卷
| 卷路径 | 用途 |
|---|---|
/etc/zabbix/zabbix_agentd.d | 挂载自定义配置文件（*.conf），用于扩展UserParameter |
/var/lib/zabbix/modules | 挂载自定义模块，配合ZBX_LOADMODULE使用 |
/var/lib/zabbix/enc | 存储TLS相关文件（CA、证书、密钥等） |
镜像变体
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讨论重大变更。
zabbix/zabbix-agent
zabbix
Zabbix代理（Zabbix agent）是部署在被监控主机上的客户端组件，在Zabbix监控架构中负责采集系统资源、应用程序性能及运行状态等关键数据，并通过支持TLS加密协议与Zabbix服务器或代理服务器进行安全通信，有效保障数据传输过程中的机密性与完整性，防止信息泄露或篡改，适用于对数据安全有严格要求的企业级监控场景，提升整体监控系统的安全性和可靠性。
238 次收藏5000万+ 次下载
14 天前更新
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访问体验非常流畅，大镜像也能快速完成下载。"