!logo

什么是Zabbix？

Zabbix是企业级开源分布式监控解决方案。

Zabbix能够监控网络的众多参数以及服务器的健康状态和完整性。它采用灵活的通知机制，允许用户为几乎任何事件配置基于电子邮件的告警，从而能够快速响应服务器问题。Zabbix基于存储的数据提供出色的报告和数据可视化功能，使其成为容量规划的理想工具。

有关Zabbix组件的更多信息和相关下载，请访问[] 和 []

什么是本镜像？

本镜像用于接收SNMP陷阱，将其存储到日志文件，并提供给Zabbix访问收集到的SNMP陷阱消息。

Zabbix snmptraps镜像

这些是唯一的***Zabbix snmptraps Docker镜像。它们基于Alpine Linux v3.22、Ubuntu 24.04（noble）、CentOS Stream 10和Oracle Linux 10镜像构建。支持的Zabbix snmptraps版本如下：

• Zabbix snmptraps 6.0（标签：alpine-6.0-latest、ubuntu-6.0-latest、ol-6.0-latest）
• Zabbix snmptraps 6.0.（标签：alpine-6.0.、ubuntu-6.0.、ol-6.0.）
• Zabbix snmptraps 7.0（标签：alpine-7.0-latest、ubuntu-7.0-latest、ol-7.0-latest）
• Zabbix snmptraps 7.0.（标签：alpine-7.0.、ubuntu-7.0.、ol-7.0.）
• Zabbix snmptraps 7.2（标签：alpine-7.2-latest、ubuntu-7.2-latest、ol-7.2-latest）
• Zabbix snmptraps 7.2.（标签：alpine-7.2.、ubuntu-7.2.、ol-7.2.）
• Zabbix snmptraps 7.4（标签：alpine-7.4-latest、ubuntu-7.4-latest、ol-7.4-latest、alpine-latest、ubuntu-latest、ol-latest、latest）
• Zabbix snmptraps 7.4.（标签：alpine-7.4.、ubuntu-7.4.、ol-7.4.）
• Zabbix snmptraps 8.0（标签：alpine-trunk、ubuntu-trunk、ol-trunk）

镜像会在新版本发布时更新。

如何使用本镜像

启动zabbix-snmptraps

按以下方式启动Zabbix snmptraps容器：

console
docker run --name some-zabbix-snmptraps -p 162:1162/udp -d zabbix/zabbix-snmptraps:tag

其中some-zabbix-snmptraps是你要分配给容器的名称，tag是指定所需版本的标签。有关相关标签，请参见上面的列表，或查看完整标签列表。

将Zabbix服务器或Zabbix代理与容器链接

console
docker run --name some-zabbix-server --link some-zabbix-snmptraps:zabbix-snmptraps --volumes-from some-zabbix-snmptraps -d zabbix/zabbix-server:tag

容器shell访问和查看Zabbix snmptraps日志

docker exec命令允许你在Docker容器内运行命令。以下命令将为你提供zabbix-snmptraps容器内的bash shell：

console
$ docker exec -ti some-zabbix-snmptraps /bin/bash

Zabbix snmptraps日志可通过Docker的容器日志查看：

console
$ docker logs some-zabbix-snmptraps

环境变量

启动zabbix-snmptraps镜像时，可通过在docker run命令行中传递一个或多个环境变量来调整配置。

ZBX_SNMP_TRAP_DATE_FORMAT

该变量表示输出snmptraps.log文件中的日期和时间格式。默认值为+%Y-%m-%dT%T%z。有关日期和时间格式的更多详情，请参考date命令手册。

ZBX_SNMP_TRAP_FORMAT

该变量是输出snmptraps.log文件中的SNMP陷阱格式。默认值为\n，此时每个新变量将换行显示。

ZBX_SNMP_TRAP_USE_DNS

该变量管理源网络地址的表示方式，可设为SNMP陷阱发送者的IP地址或DNS。仅当容器命令修改且参数列表中移除“-n”参数时，该变量才生效。默认值为false。

Zabbix snmptraps容器的允许卷

/var/lib/zabbix/snmptraps

该卷包含存储接收的SNMP陷阱的snmptraps.log日志文件。

/var/lib/zabbix/mibs

该卷允许添加新的MIB文件。不支持子目录，所有MIB文件必须放置在/var/lib/zabbix/mibs中。

/var/lib/zabbix/snmptrapd_config

该卷包含snmptrapd守护进程生成的各种持久配置文件。通常仅在处理SNMPv3陷阱时需要该卷。请勿手动修改卷中存储的任何内容。

镜像变体

zabbix-snmptraps镜像有多种版本，每种版本适用于特定场景。

zabbix-snmptraps:alpine-<version>

该镜像基于流行的Alpine Linux项目构建，可在alpine***镜像中获取。Alpine Linux比大多数发行版基础镜像小得多（约5MB），因此通常能生成更精简的镜像。

当需要最小化最终镜像大小时，强烈推荐使用此变体。需要注意的是，它使用musl libc而非glibc及相关库，因此某些软件可能因libc依赖深度而出现问题。但大多数软件无此问题，因此该变体通常是非常安全的选择。有关可能出现的问题及使用Alpine-based镜像的优缺点比较，请参见此Hacker News评论线程。

为最小化镜像大小，Alpine-based镜像中通常不包含额外的相关工具（如git或bash）。如需使用此镜像作为基础，可在自己的Dockerfile中添加所需工具（如不熟悉如何安装软件包，请参见alpine镜像说明中的示例）。

zabbix-snmptraps:ubuntu-<version>

这是默认镜像。如不确定需求，建议使用此版本。它既可用作临时容器（挂载源代码并启动容器以运行应用），也可用作构建其他镜像的基础。

zabbix-snmptraps:ol-<version>

Oracle Linux是基于GNU通用公共许可证（GPLv2）的开源操作系统。适用于通用用途或Oracle工作负载，每天通过超过128,000小时的真实工作负载严格测试，包含独特创新功能，如Ksplice（零停机内核补丁）、DTrace（实时诊断）、强大的Btrfs文件系统等。

支持的Docker版本

本镜像***支持Docker 1.12.0版本。

对旧版本（低至1.6）的支持基于尽力而为原则。

有关如何升级Docker守护进程的详细信息，请参见Docker安装文档。

用户反馈

文档

本镜像的文档存储在zabbix/zabbix-docker GitHub仓库的snmptraps/目录中。在尝试提交拉取请求前，请务必熟悉仓库的README.md文件。

问题

如对本镜像有任何问题或疑问，请通过GitHub issue与我们联系。

已知问题

贡献

欢迎贡献新功能、修复或更新，无论大小；我们始终乐于接收拉取请求，并会尽力快速处理。

在开始编码前，建议通过GitHub issue讨论你的计划，尤其是对于较复杂的贡献。这能让其他贡献者有机会为你指明方向、提供设计反馈，或告知是否有其他人正在开发相同功能。

许可证

从Zabbix 7.0版本开始，所有后续Zabbix版本均采用GNU Affero通用公共许可证第3版（AGPLv3）发布。你可以修改相关版本，并根据自由软件基金会发布的AGPLv3条款传播修改后的版本。有关AGPLv3的更多详情（包括常见问题解答），请参见自由软件基金会的通用FAQ。

Zabbix是开源软件，但如果你在商业环境中使用Zabbix，我们恳请你通过购买某种级别的技术支持来支持Zabbix的开发。所有之前的Zabbix软件版本（直至6.4）均采用GNU通用公共许可证第2版（GPLv2）发布。GPLv2和AGPLv3的正式条款可在[***]