热门搜索:
epicmorg/zabbix-agent
epicmorg
Zabbix Agent是部署在监控目标上的组件，用于主动监控本地资源和应用（如硬盘、内存、处理器统计等），是企业级开源分布式监控解决方案Zabbix的一部分。
1 次收藏下载次数: 0状态：社区镜像维护者：epicmorg仓库类型：镜像最近更新：3 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
!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容器
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-5.0-latest等）
与其他容器中的Zabbix Server/Proxy连接（被动检查）
Zabbix Agent暴露标准端口***用于被动检查，可通过容器链接使Zabbix Server/Proxy访问Agent：
consoledocker run --name some-zabbix-server --link some-zabbix-agent:zabbix-agent -d zabbix/zabbix-server:latest
连接到Zabbix Server/Proxy容器（主动检查）
支持主动检查，通过容器链接使Agent访问Zabbix Server/Proxy：
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
查看Zabbix Agent日志
consoledocker 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_HOSTNAME | 唯一的区分大小写主机名，对应zabbix_agentd.conf中的Hostname参数 | 容器主机名 |
ZBX_SERVER_HOST | Zabbix服务器或代理的IP或DNS名称，对应Server参数 | zabbix-server |
ZBX_PASSIVE_ALLOW | 是否启用被动检查（true/false） | true |
ZBX_PASSIVESERVERS | 允许连接的Zabbix服务器/代理主机列表（逗号分隔） | - |
ZBX_ACTIVE_ALLOW | 是否启用主动检查（true/false） | true |
ZBX_ACTIVESERVERS | 允许主动连接的Zabbix服务器/代理主机列表（可指定端口，如zabbix-server:***） | - |
ZBX_LOADMODULE | 加载的Zabbix模块列表（逗号分隔，需配合/var/lib/zabbix/modules卷） | - |
ZBX_DEBUGLEVEL | 调试级别（0-5） | 3 |
ZBX_TIMEOUT | 检查处理超时时间（秒） | 3 |
其他环境变量
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讨论计划。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 zabbix-agent 镜像标签
docker pull docker.xuanyuan.run/epicmorg/zabbix-agent:<标签>
DockerHub 原生拉取命令
docker pull epicmorg/zabbix-agent:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"