本站支持搜索的镜像仓库:Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com
!logo
Zabbix 是一款企业级开源分布式监控解决方案。它能监控网络的多项参数,以及服务器的健康状态与完整性。Zabbix 具备灵活的通知机制,支持用户为几乎所有事件配置邮件告警,帮助快速响应服务器问题。同时,它基于存储数据提供优秀的报表和数据可视化功能,非常适合容量规划。
更多信息及 Zabbix 组件的相关下载,可访问 [***] 和 *** 什么是 Zabbix agent 2?
Zabbix agent 2 部署在被监控目标上,用于主动监控本地资源与应用(如硬盘、内存、处理器统计等)。
以下是官方发布的 Zabbix agent 2 Docker 镜像,基于 Alpine Linux v3.22、Ubuntu 24.04(noble)、CentOS Stream 10、Oracle Linux 10、Windows 10 LTSC 2019 和 Windows 11 LTSC 2022 构建。支持的 Zabbix agent 2 版本及对应标签如下:
镜像会随新版本发布更新,latest 标签默认基于 Alpine Linux。
zabbix-agent2通过以下命令启动 Zabbix agent 2 容器:
docker run --name some-zabbix-agent -e ZBX_HOSTNAME="some-hostname" -e ZBX_SERVER_HOST="some-zabbix-server" --init -d zabbix/zabbix-agent2:tag
参数说明:
some-zabbix-agent:自定义容器名称some-hostname:主机名(对应 Zabbix agent 2 配置文件中的 Hostname 参数)some-zabbix-server:Zabbix 服务器或代理的 IP 或 DNS 名称tag:指定版本的标签(见上文列表或 完整标签列表)此镜像暴露 Zabbix agent 2 的标准端口(10050)用于被动检查。通过容器链接,可让 Zabbix 服务器/代理容器访问 agent 实例。启动服务器/代理容器时链接 agent:
$ docker run --name some-zabbix-server --link some-zabbix-agent:zabbix-agent2 --init -d zabbix/zabbix-server:latest
镜像支持主动检查,通过容器链接可让 agent 访问服务器/代理容器。启动 agent 时链接服务器/代理:
$ docker run --name some-zabbix-agent --link some-zabbix-server:zabbix-server --init -d zabbix/zabbix-agent2:latest
使用 docker exec 进入容器命令行:
$ docker exec -ti some-zabbix-agent /bin/bash
通过 Docker 日志查看 agent 运行日志:
$ docker logs some-zabbix-agent
默认容器权限有限,无法访问主机资源。若需监控系统资源,可使用特权模式或挂载系统卷:
# 特权模式 $ docker run --name some-zabbix-agent --link some-zabbix-server:zabbix-server --privileged --init -d zabbix/zabbix-agent2:latest # 挂载特定卷(如磁盘) $ docker run --name some-zabbix-agent --link some-zabbix-server:zabbix-server -v /dev/sdc:/dev/sdc --init -d zabbix/zabbix-agent2:latest
启动容器时,可通过环境变量调整 agent 配置,常用变量如下:
ZBX_HOSTNAMEHostname 参数ZBX_SERVER_HOSTServer 参数zabbix-serverZBX_SERVER_PORT 指定非默认端口ZBX_PASSIVE_ALLOWtrue/false)trueZBX_PASSIVESERVERSZBX_ACTIVE_ALLOWtrue/false)trueZBX_ACTIVESERVERSzabbix-server:10061)ZBX_DEBUGLEVEL3(警告)ZBX_TIMEOUT3以下变量对应 zabbix_agent2.conf 配置参数,默认值已标注:
ZBX_ENABLEPERSISTENTBUFFER=false # 启用持久化缓冲区(5.0.0+支持) ZBX_PERSISTENTBUFFERPERIOD=1h # 缓冲区周期(5.0.0+支持) ZBX_ENABLESTATUSPORT= # 状态端口 ZBX_SOURCEIP= # 源 IP ZBX_HEARTBEAT_FREQUENCY=60 # 心跳频率(6.2.0+支持) ZBX_ENABLEREMOTECOMMANDS=0 # 启用远程命令(5.0.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= # 监听 IP ZBX_LISTENPORT=10051 # 监听端口 ZBX_UNSAFEUSERPARAMETERS=0 # 允许不安全的用户参数 ZBX_TLSCONNECT=unencrypted # TLS 连接方式 ZBX_TLSACCEPT=unencrypted # TLS 接受方式 ZBX_TLSCAFILE= # TLS CA 文件路径 ZBX_TLSCA= # TLS CA 内容(明文) ZBX_TLSCRLFILE= # TLS CRL 文件路径 ZBX_TLSCRL= # TLS CRL 内容(明文) ZBX_TLSSERVERCERTISSUER= # 服务器证书颁发者 ZBX_TLSSERVERCERTSUBJECT= # 服务器证书主题 ZBX_TLSCERTFILE= # TLS 证书文件路径 ZBX_TLSCERT= # TLS 证书内容(明文) ZBX_TLSKEYFILE= # TLS 密钥文件路径 ZBX_TLSKEY= # TLS 密钥内容(明文) ZBX_TLSPSKIDENTITY= # TLS PSK 标识 ZBX_TLSPSKFILE= # TLS PSK 文件路径 ZBX_TLSPSK= # TLS PSK 内容(明文) ZBX_DENYKEY=system.run[*] # 禁用的键(5.0.0+支持) ZBX_ALLOWKEY= # 允许的键(5.0.0+支持)
更多配置说明见 官方文档。
/etc/zabbix/zabbix_agentd.d用于挂载自定义配置文件(.conf 格式),扩展 UserParameter 功能。
/var/lib/zabbix/enc存储 TLS 相关文件(如 CA 证书、密钥),需配合 ZBX_TLSCAFILE 等变量指定文件名。也可通过 ZBX_TLSCA 等变量直接传入明文内容。
/var/lib/zabbix/buffer启用持久化缓冲区(ZBX_ENABLEPERSISTENTBUFFER=true)时,用于存储 SQLite 数据库文件(5.0.0+支持)。
zabbix-agent2:alpine-<version>基于 Alpine Linux(~5MB 体积),适合追求最小镜像的场景。使用 musl libc,部分依赖 glibc 的软件可能存在兼容性问题。
zabbix-agent2:ubuntu-<version>默认推荐镜像,基于 Ubuntu,兼容性好,适合通用场景。
zabbix-agent2:ol-<version>基于 Oracle Linux,针对 Oracle 工作负载优化,支持 Ksplice、DTrace 等企业级特性。
官方支持 Docker 1.12.0 及以上版本,1.6 及以下版本仅提供有限兼容。
升级 Docker 可参考 官方安装文档。
镜像文档存储在 zabbix-docker 仓库 的 agent2/ 目录下,使用前建议先阅读 仓库 README。
如有问题,可通过 GitHub Issue 提交。
已知问题:暂不支持 ZBX_ALIAS 环境变量,需通过 /etc/zabbix/zabbix_agent.d 卷挂载包含 Alias 配置的文件。
欢迎提交功能、修复或更新,建议先通过 GitHub Issue 讨论计划,再提交 PR。
Zabbix 7.0 及以上版本基于 GNU Affero General Public License v3 (AGPLv3) 发布,6.4 及以下版本基于 GPLv2。具体条款见 FSF 文档。商业用户可通过购买技术支持支持开发。
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录方式配置轩辕镜像加速服务,包含7个详细步骤
在 Linux 系统上配置轩辕镜像源,支持主流发行版
在 Docker Desktop 中配置轩辕镜像加速,适用于桌面系统
在 Docker Compose 中使用轩辕镜像加速,支持容器编排
在 k8s 中配置 containerd 使用轩辕镜像加速
在宝塔面板中配置轩辕镜像加速,提升服务器管理效率
在 Synology 群晖NAS系统中配置轩辕镜像加速
在飞牛fnOS系统中配置轩辕镜像加速
在极空间NAS中配置轩辕镜像加速
在爱快ikuai系统中配置轩辕镜像加速
在绿联NAS系统中配置轩辕镜像加速
在威联通NAS系统中配置轩辕镜像加速
在 Podman 中配置轩辕镜像加速,支持多系统
配置轩辕镜像加速9大主流镜像仓库,包含详细配置步骤
无需登录即可使用轩辕镜像加速服务,更加便捷高效
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429