!logo

Zabbix build base (SQLite3) Docker镜像文档

1. 镜像概述

1.1 Zabbix简介

Zabbix是企业级开源分布式监控解决方案，可监控网络参数、服务器健康状态与完整性，提供灵活的通知机制（如邮件告警）以快速响应服务器问题，并基于存储数据提供报告与数据可视化功能，适用于容量规划。

1.2 Zabbix build base (SQLite3)概述

Zabbix build base (SQLite3)镜像是用于构建Zabbix组件的基础镜像，包含已编译的Zabbix组件。该镜像基于Alpine Linux v3.22、Ubuntu 24.04（noble）、CentOS Stream 10及Oracle Linux 10，旨在为其他Zabbix相关镜像提供预编译组件。

2. 核心功能与特性

• 多基础系统支持：基于Alpine Linux、Ubuntu、CentOS Stream、Oracle Linux等主流发行版，满足不同环境需求。
• 预编译组件：包含有限但核心的Zabbix组件，具体为：zabbix-agent、zabbix-agent2、zabbix-proxy-sqlite3、zabbix-java-gateway（相比MySQL/PostgreSQL构建基础镜像，组件范围更聚焦）。
• 版本同步：镜像标签随Zabbix***版本更新，确保组件与Zabbix新版本兼容。
• 构建专注：基于Zabbix build base镜像（已配置构建环境），仅专注于Zabbix组件的编译，组件可直接用于其他镜像。

3. 适用场景

• Zabbix组件编译环境：用于构建/编译Zabbix核心组件，为自定义Zabbix镜像提供预编译二进制文件。
• Zabbix镜像开发：适用于开发基于SQLite3的Zabbix代理、客户端等组件的自定义镜像场景。

4. 镜像版本与标签

镜像版本与Zabbix版本对应，标签格式为<基础系统>-<Zabbix版本>-<修订号>，具体如下：

注：<Zabbix版本>.*表示具体修订号，如alpine-7.4.2；latest标签默认指向Alpine Linux基础的最新稳定版（当前为7.4系列）。

5. 镜像变体

5.1 zabbix-build-sqlite3:alpine-<version>

• 基础：Alpine Linux（~5MB镜像大小，轻量级）。
• 特点：使用musl libc，镜像体积极小，适合对镜像大小敏感的场景；可能存在部分依赖musl libc的软件兼容性问题（多数软件无影响）。
• 适用：优先选择，尤其需控制最终镜像体积时。

5.2 zabbix-build-sqlite3:ubuntu-<version>

• 基础：Ubuntu 24.04（noble）。
• 特点：使用glibc，兼容性广泛，默认推荐选择；镜像体积较Alpine大，但包含更多系统工具。
• 适用：对libc兼容性要求高或需要系统工具支持的场景。

5.3 zabbix-build-sqlite3:ol-<version>

• 基础：Oracle Linux 10。
• 特点：包含Ksplice（零停机内核补丁）、DTrace（实时诊断）、Btrfs文件系统等Oracle Linux特有功能，适合Oracle工作负载或需企业级Linux特性的场景。

6. 使用方法

6.1 基本用法

该镜像用于编译Zabbix组件，组件可直接用于其他镜像。使用时需基于已配置构建环境的Zabbix build base镜像，示例Dockerfile片段：

dockerfile
# 基于Zabbix build base (SQLite3)镜像编译组件
FROM zabbix/zabbix-build-sqlite3:alpine-latest AS builder

# 提取编译后的组件至目标镜像
FROM alpine:3.22
COPY --from=builder /usr/local/bin/zabbix-agent /usr/local/bin/
# 后续配置...

6.2 组件说明

镜像包含的预编译组件路径通常为/usr/local/bin/，可直接复制到目标镜像使用，支持的组件：

• zabbix-agent：Zabbix客户端
• zabbix-agent2：新一代Zabbix客户端（支持更多协议）
• zabbix-proxy-sqlite3：基于SQLite3的Zabbix代理
• zabbix-java-gateway：Zabbix Java网关

7. 支持的Docker版本

• ***支持：Docker 1.12.0及以上版本。
• 兼容支持：Docker 1.6及以上版本（尽力支持，不保证所有功能）。

Docker升级参考：Docker安装文档

8. 用户反馈与支持

8.1 文档

镜像文档存储于GitHub仓库：zabbix/zabbix-docker，使用前建议参考仓库README.md。

8.2 问题反馈

如遇镜像问题，可通过GitHub Issues提交反馈。

8.3 贡献

欢迎贡献新功能、修复或更新，建议先通过GitHub Issues讨论计划，再提交Pull Request。

8.4 许可证

• Zabbix 7.0及以上版本：采用GNU Affero General Public License v3（AGPLv3）。
• Zabbix 6.4及以下版本：采用GNU General Public License v2（GPLv2）。

商业使用建议：如在商业环境中使用Zabbix，建议购买技术支持以支持Zabbix开发。许可证详情见FSF官网。