zabbix/zabbix-snmptraps

!logo

什么是Zabbix？

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

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

有关Zabbix组件的更多信息和相关下载，请访问https://hub.docker.com/u/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是指定所需版本的标签。有关相关标签，请参见上面的列表，或查看https://hub.docker.com/r/zabbix/zabbix-snmptraps/tags/%E3%80%82

将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项目构建，可在https://hub.docker.com/_/alpine%E4%B8%AD%E8%8E%B7%E5%8F%96%E3%80%82Alpine Linux比大多数发行版基础镜像小得多（约5MB），因此通常能生成更精简的镜像。

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

为最小化镜像大小，Alpine-based镜像中通常不包含额外的相关工具（如git或bash）。如需使用此镜像作为基础，可在自己的Dockerfile中添加所需工具（如不熟悉如何安装软件包，请参见https://hub.docker.com/_/alpine/%E4%B8%AD%E7%9A%84%E7%A4%BA%E4%BE%8B%EF%BC%89%E3%80%82

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安装文档。

用户反馈

文档

本镜像的文档存储在https://github.com/zabbix/zabbix-docker/%E7%9A%84https://github.com/zabbix/zabbix-docker/tree/trunk/Dockerfiles/snmptraps%E4%B8%AD%E3%80%82%E5%9C%A8%E5%B0%9D%E8%AF%95%E6%8F%90%E4%BA%A4%E6%8B%89%E5%8F%96%E8%AF%B7%E6%B1%82%E5%89%8D%EF%BC%8C%E8%AF%B7%E5%8A%A1%E5%BF%85%E7%86%9F%E6%82%89%E4%BB%93%E5%BA%93%E7%9A%84https://github.com/zabbix/zabbix-docker/blob/trunk/README.md%E3%80%82

问题

如对本镜像有任何问题或疑问，请通过https://github.com/zabbix/zabbix-docker/issues%E4%B8%8E%E6%88%91%E4%BB%AC%E8%81%94%E7%B3%BB%E3%80%82

已知问题

贡献

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

在开始编码前，建议通过https://github.com/zabbix/zabbix-docker/issues%E8%AE%A8%E8%AE%BA%E4%BD%A0%E7%9A%84%E8%AE%A1%E5%88%92%EF%BC%8C%E5%B0%A4%E5%85%B6%E6%98%AF%E5%AF%B9%E4%BA%8E%E8%BE%83%E5%A4%8D%E6%9D%82%E7%9A%84%E8%B4%A1%E7%8C%AE%E3%80%82%E8%BF%99%E8%83%BD%E8%AE%A9%E5%85%B6%E4%BB%96%E8%B4%A1%E7%8C%AE%E8%80%85%E6%9C%89%E6%9C%BA%E4%BC%9A%E4%B8%BA%E4%BD%A0%E6%8C%87%E6%98%8E%E6%96%B9%E5%90%91%E3%80%81%E6%8F%90%E4%BE%9B%E8%AE%BE%E8%AE%A1%E5%8F%8D%E9%A6%88%EF%BC%8C%E6%88%96%E5%91%8A%E7%9F%A5%E6%98%AF%E5%90%A6%E6%9C%89%E5%85%B6%E4%BB%96%E4%BA%BA%E6%AD%A3%E5%9C%A8%E5%BC%80%E5%8F%91%E7%9B%B8%E5%90%8C%E5%8A%9F%E8%83%BD%E3%80%82

许可证

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

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