6 从容器中安装

概述

本节描述如何使用 Docker or Docker Compose部署 Zabbix。

Zabbix 官方提供：

• 每个 Zabbix 组件的独立 Docker 镜像，可以作为便携且自给自足的容器运行。
• 用于定义和运行多容器 Zabbix 组件的 Compose 文件。

自 Zabbix 6.0 起，安装过程中需要创建确定性触发器。如果为 MySQL/MariaDB 启用了二进制日志记录，则需要超级用户权限或设置变量/配置参数 log_bin_trust_function_creators = 1。有关如何设置变量的说明，请参见 数据库创建脚本 。
注意，如果从控制台执行，变量将仅临时设置，并在 Docker 重新启动时被删除。在这种情况下，请保持 SQL 服务运行，只需通过运行 ‘docker compose down zabbix-server’ 然后 ‘docker compose up -d zabbix-server’ 停止 zabbix-server 服务。
或者，您可以在配置文件中设置此变量。

Docker

Zabbix 提供基于各种操作系统基础镜像的镜像。要获取特定 Zabbix 组件支持的基础操作系统镜像列表，请参见 Docker Hub 中该组件的描述。所有 Zabbix 镜像都配置为在基础镜像更新时重新构建最新镜像。

安装

要获取 Zabbix 组件镜像，运行：

docker pull zabbix/zabbix-server-mysql

将 zabbix/zabbix-server-mysql 替换为所需的 Docker 仓库名称。

此命令将基于 Alpine Linux 操作系统拉取最新的稳定 Zabbix 组件版本。您可以在仓库名称后附加 标签 以获取基于其他操作系统或特定 Zabbix 主版本或次版本的镜像。

以下仓库在 Docker Hub 中可用：

SNMP 陷阱支持在单独的仓库 zabbix/zabbix-snmptraps 中提供。它可以与 Zabbix server 和 Zabbix proxy 链接。

标签

官方 Zabbix 组件镜像可能包含以下标签：

Docker file 源

任何人都可以使用位于 github.com 上的 官方仓库 来追踪 Docker file 的变化。 您可以 fork 项目，或根据官方 Docker file 制作自己的 image。

初始配置

下载镜像后，通过执行 docker run 命令并附加额外参数来指定所需的 环境变量 和/或 挂载点 来启动容器。下面提供了一些 配置示例。

Zabbix不能作为PID1/init进程在容器中运行。

为了启用 Zabbix 组件之间的通信，一些端口，例如 Zabbix server (trapper) 的 10051/TCP、Zabbix agent 的 10050/TCP、SNMP 陷阱的 162/UDP 和 Zabbix Web 界面的 80/TCP，将会暴露给主机。Zabbix 组件使用的默认端口的完整列表可在 要求 页面查看。对于 Zabbix server 和agent，可以通过设置 ZBX_LISTENPORT 环境变量 来更改默认端口。

环境变量

所有 Zabbix 组件 image 都提供环境变量来控制配置。 这些环境变量在每个组件 image 仓库中列出。这些环境变量是 Zabbix 配置文件中的选项，但具有不同的命名方法。 例如，ZBX_LOGSLOWQUERIES 等于来自 Zabbix server 和 Zabbix proxy 配置文件的 LogSlowQueries。

一些配置选项是不允许更改的。例如，PIDFile和 LogType。

其中，一些组件有特定的环境变量，而这些环境变量在官方 Zabbix 配置文件并不存在：

Volumes

Image 中允许使用一些挂载点。根据 Zabbix 组件类型，这些挂载点各不相同：

关于更多的信息请在 Docker Hub 的 Zabbix 官方仓库查看。

使用示例

示例 1

该示例示范了如何运行 MySQL 数据库支持的 Zabbix Server 、基于 Nginx Web 服务器的 Zabbix Web 界面和 Zabbix Java 网关。

1. 创建专用于 Zabbix 组件容器的网络：

# docker network create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 zabbix-net

2. 启动空的 MySQL 服务器实例：

# docker run --name mysql-server -t \
             -e MYSQL_DATABASE="zabbix" \
             -e MYSQL_USER="zabbix" \
             -e MYSQL_PASSWORD="zabbix_pwd" \
             -e MYSQL_ROOT_PASSWORD="root_pwd" \
             --network=zabbix-net \
             -d mysql:8.0 \
             --restart unless-stopped \
             --character-set-server=utf8 --collation-server=utf8_bin \
             --default-authentication-plugin=mysql_native_password

3. 启动 Zabbix Java 网关实例：

# docker run --name zabbix-java-gateway -t \
             --network=zabbix-net \
             --restart unless-stopped \
             -d zabbix/zabbix-java-gateway:alpine-5.4-latest

4. 启动 Zabbix server 实例，并将其关联到已创建的 MySQL server 实例：

# docker run --name zabbix-server-mysql -t \
             -e DB_SERVER_HOST="mysql-server" \
             -e MYSQL_DATABASE="zabbix" \
             -e MYSQL_USER="zabbix" \
             -e MYSQL_PASSWORD="zabbix_pwd" \
             -e MYSQL_ROOT_PASSWORD="root_pwd" \
             -e ZBX_JAVAGATEWAY="zabbix-java-gateway" \
             --network=zabbix-net \
             -p 10051:10051 \
             --restart unless-stopped \
             -d zabbix/zabbix-server-mysql:alpine-5.4-latest

Zabbix server 实例将 10051/TCP 端口（Zabbix trapper）暴露给主机。

5. 启动 Zabbix Web 界面，并将其关联到已创建的 MySQL server 和 Zabbix server 实例：

# docker run --name zabbix-web-nginx-mysql -t \
             -e ZBX_SERVER_HOST="zabbix-server-mysql" \
             -e DB_SERVER_HOST="mysql-server" \
             -e MYSQL_DATABASE="zabbix" \
             -e MYSQL_USER="zabbix" \
             -e MYSQL_PASSWORD="zabbix_pwd" \
             -e MYSQL_ROOT_PASSWORD="root_pwd" \
             --network=zabbix-net \
             -p 80:8080 \
             --restart unless-stopped \
             -d zabbix/zabbix-web-nginx-mysql:alpine-5.4-latest

Zabbix web 界面实例将 80/TCP 端口（HTTP）暴露给主机。

示例 2

该示例示范了如何运行 PostgreSQL 数据库支持的 Zabbix server、基于 Nginx Web 服务器的 Zabbix Web 界面和 SNMP trap功能。

1. 创建专用于 Zabbix 组件容器的网络：

# docker network create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 zabbix-net

2. 启动空的 PostgreSQL server 实例：

# docker run --name postgres-server -t \
             -e POSTGRES_USER="zabbix" \
             -e POSTGRES_PASSWORD="zabbix_pwd" \
             -e POSTGRES_DB="zabbix" \
             --network=zabbix-net \
             --restart unless-stopped \
             -d postgres:latest

3. 启动 Zabbix snmptraps 实例：

# docker run --name zabbix-snmptraps -t \
             -v /zbx_instance/snmptraps:/var/lib/zabbix/snmptraps:rw \
             -v /var/lib/zabbix/mibs:/usr/share/snmp/mibs:ro \
             --network=zabbix-net \
             -p 162:1162/udp \
             --restart unless-stopped \
             -d zabbix/zabbix-snmptraps:alpine-5.4-latest

Zabbix snmptrap 实例将 162/UDP 端口（SNMP traps）暴露给主机。

4. 启动 Zabbix server 实例，并将其关联到已创建的 PostgreSQL server 实例：

# docker run --name zabbix-server-pgsql -t \
             -e DB_SERVER_HOST="postgres-server" \
             -e POSTGRES_USER="zabbix" \
             -e POSTGRES_PASSWORD="zabbix_pwd" \
             -e POSTGRES_DB="zabbix" \
             -e ZBX_ENABLE_SNMP_TRAPS="true" \
             --network=zabbix-net \
             -p 10051:10051 \
             --volumes-from zabbix-snmptraps \
             --restart unless-stopped \
             -d zabbix/zabbix-server-pgsql:alpine-5.4-latest

Zabbix server 实例将 10051/TCP 端口（Zabbix trapper）暴露给主机。

5. 启动 Zabbix Web 界面，并将其关联到已创建的 PostgreSQL server 和 Zabbix server 实例：

# docker run --name zabbix-web-nginx-pgsql -t \
             -e ZBX_SERVER_HOST="zabbix-server-pgsql" \
             -e DB_SERVER_HOST="postgres-server" \
             -e POSTGRES_USER="zabbix" \
             -e POSTGRES_PASSWORD="zabbix_pwd" \
             -e POSTGRES_DB="zabbix" \
             --network=zabbix-net \
             -p 443:8443 \
             -p 80:8080 \
             -v /etc/ssl/nginx:/etc/ssl/nginx:ro \
             --restart unless-stopped \
             -d zabbix/zabbix-web-nginx-pgsql:alpine-5.4-latest

Zabbix web 界面实例将 443/TCP 端口（HTTPS）暴露给主机。
/etc/ssl/nginx 目录必须包含具有所需名称的证书。

示例 3

该示例示范了如何在Red Hat 8上使用 podman 运行 MySQL 数据库支持的 Zabbix Server 、基于 Nginx Web 服务器的 Zabbix Web 界面和 Zabbix Java 网关。

1. 创建一个名为 zabbix 的 pod 并暴露端口 (web 界面、Zabbix server trapper)：

podman pod create --name zabbix -p 80:8080 -p 10051:10051

2. （可选）在 zabbix pod 中启动 Zabbix agent 容器：

podman run --name zabbix-agent \
           -eZBX_SERVER_HOST="127.0.0.1,localhost" \
           --restart=always \
           --pod=zabbix \
           -d registry.connect.redhat.com/zabbix/zabbix-agent-50:latest

3. 在主机上创建./mysql/ 目录并启动 Oracle MySQL server 8.0:

podman run --name mysql-server -t \
             -e MYSQL_DATABASE="zabbix" \
             -e MYSQL_USER="zabbix" \
             -e MYSQL_PASSWORD="zabbix_pwd" \
             -e MYSQL_ROOT_PASSWORD="root_pwd" \
             -v ./mysql/:/var/lib/mysql/:Z \
             --restart=always \
             --pod=zabbix \
             -d mysql:8.0 \
             --character-set-server=utf8 --collation-server=utf8_bin \
             --default-authentication-plugin=mysql_native_password

3. 启动 Zabbix server 容器：

podman run --name zabbix-server-mysql -t \
                         -e DB_SERVER_HOST="127.0.0.1" \
                         -e MYSQL_DATABASE="zabbix" \
                         -e MYSQL_USER="zabbix" \
                         -e MYSQL_PASSWORD="zabbix_pwd" \
                         -e MYSQL_ROOT_PASSWORD="root_pwd" \
                         -e ZBX_JAVAGATEWAY="127.0.0.1" \
                         --restart=always \
                         --pod=zabbix \
                         -d registry.connect.redhat.com/zabbix/zabbix-server-mysql-50

4. 启动 Zabbix Java 网关容器：

podman run --name zabbix-java-gateway -t \
             --restart=always \
             --pod=zabbix \
             -d registry.connect.redhat.com/zabbix/zabbix-java-gateway-50

5. 启动 Zabbix web 界面 容器：

podman run --name zabbix-web-mysql -t \
                         -e ZBX_SERVER_HOST="127.0.0.1" \
                         -e DB_SERVER_HOST="127.0.0.1" \
                         -e MYSQL_DATABASE="zabbix" \
                         -e MYSQL_USER="zabbix" \
                         -e MYSQL_PASSWORD="zabbix_pwd" \
                         -e MYSQL_ROOT_PASSWORD="root_pwd" \
                         --restart=always \
                         --pod=zabbix \
                         -d registry.connect.redhat.com/zabbix/zabbix-web-mysql-50

zabbix pod 从 zabbix-web-mysql 容器的 8080/TCP 向 主机的 80/TCP port (HTTP) 暴露端口。

Docker Compose

Zabbix 还提供了用于在 Docker 中定义和运行多容器 Zabbix 组件的 compose 文件。 这些 compose 文件可以在 github.com: https://github.com/zabbix/zabbix-docker 上的 Zabbix docker 官方仓库中找到。这些 compose 文件作为示例添加，并支持广泛。例如，Zabbix proxy 支持 MySQL和 SQLite3。

以下为几个不同版本的 compose 文件：

Docker compose 文件支持 Docker Compose 3 版本。

存储

Compose 文件已经配置为支持主机上的存储。当你使用 Compose 文件运行 Zabbix 组件时，Docker Compose 将在其所在文件夹中创建一个 zbx_env 目录，该目录将包含于 Volumes 章节所述相同的结构，以用于数据库存储。

此外，volume 下的文件 /etc/localtime 和 /etc/timezone 为只读模式。

环境变量文件

在 github.com 上与存放 compose 文件的同一目录中，您可以在 compose 文件中找到每个组件的默认环境变量文件，这些环境变量文件的命令与 .env_<type of component> 类似。

示例

示例 1

# git checkout 5.4
       # docker-compose -f ./docker-compose_v3_alpine_mysql_latest.yaml up -d

这个命令将会为每个 Zabbix 组件下载最新的 Zabbix 5.4 image，并以 detach 模式运行。

不要忘记从 github.com 的 Zabbix 官方镜像仓库下载 .env_<type of component> 文件和 compose 文件。

示例 2

# git checkout 5.4
       # docker-compose -f ./docker-compose_v3_ubuntu_mysql_local.yaml up -d

这个命令将会下载基于 Ubuntu 20.04 的 image，并在本地构建 Zabbix 5.4 组件，以 detach 模式运行。