5 从容器安装

概述

本节介绍如何使用 Docker 或 Docker Compose 部署 Zabbix。

Zabbix 官方提供：

• 每个 Zabbix 组件的独立 Docker 镜像，以便 run 为便携且自包含的容器。
• Compose 文件用于在 Docker 中定义和运行多容器 Zabbix 组件。

源文件

Docker file 源代码存储在 GitHub 上的 Zabbix official repository 中， 您可以在那里查看最新的 file 变更，或者派生项目以创建自己的镜像。

Docker

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

安装

要getZabbix组件镜像，run：

docker pull zabbix/zabbix-server-mysql

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

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

Docker Hub中提供以下仓库：

标签

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

Docker Compose

或者，可以使用Docker Compose插件安装Zabbix。 用于定义和运行多容器Zabbix组件的Compose文件 可在GitHub上的官方Zabbix Docker repository中找到。

这些compose文件作为示例提供；它们是功能冗余的。 例如，它们包含同时支持MySQL和SQLite3的proxies。

要获取Zabbix提供的Docker compose文件，请克隆仓库：

git clone https://github.com/zabbix/zabbix-docker.git

切换到所需的version：

git checkout 7.0

Compose配置文件和create并启动容器：

docker compose -f ./docker-compose_v3_alpine_mysql_latest.yaml up

将上述命令中的docker-compose_v3_alpine_mysql_latest.yaml替换为所需的配置file。

以下是可用的选项：

环境变量

变量文件具有以下命名结构：.env_<type of component>，并位于 env_vars directory 中。 有关变量命名和可用选项的详细信息，请参阅环境变量。

卷

镜像允许使用以下挂载点来挂载卷：

有关更多信息，请参阅 Docker Hub 上的 Zabbix 官方仓库。

Makefile

The Zabbix Dockerfiles repository also provides a Makefile as a shortcut for common Docker Compose tasks. Instead of using the full docker compose command, you can use shorter make commands (run make help to see the available options):

# Default deployment (Zabbix server, web interface, MySQL, all on Alpine Linux)
make up

# Custom deployment (Zabbix server, web interface with custom Nginx ports, PostgreSQL, all on Ubuntu)
make up \
  OS=ubuntu \
  DB=pgsql \
  ZABBIX_WEB_NGINX_HTTP_PORT=8282 \
  ZABBIX_WEB_NGINX_HTTPS_PORT=8443

By default, make up starts only a minimal set of services (Zabbix server, web interface, and database). This keeps the setup lightweight and avoids starting components that may not be needed. To include additional components, you can use the following Compose profiles:

# Default deployment + Zabbix agent, Java gateway, web service, and SNMP traps:
make up COMPOSE_PROFILES=full

# COMPOSE_PROFILES=full + Zabbix proxy (MySQL and SQLite3):
make up COMPOSE_PROFILES=all

初始配置

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

示例

示例1

该示例演示如何run支持MySQL数据库的Zabbix server， 基于nginx网页服务器的Zabbix网页界面及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 \
      --restart unless-stopped \
      -d mysql:8.0-oracle \
      --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-7.0-latest

4. 启动Zabbix server实例并链接至已创建的MySQL服务器实例：

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-7.0-latest

5. 启动Zabbix网页界面并链接至已创建的MySQL服务器和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-7.0-latest

示例2

该示例演示如何run支持PostgreSQL数据库的Zabbix server， 基于nginx网页服务器的Zabbix网页界面及SNMP trap功能。

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

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

2. 启动空PostgreSQL服务器实例：

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-7.0-latest

4. 启动Zabbix server实例并链接至已创建的PostgreSQL服务器实例：

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-7.0-latest

5. 启动Zabbix网页界面并链接至已创建的PostgreSQL服务器和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-7.0-latest

示例3

该示例演示如何在Red Hat 8上使用podman， run支持MySQL数据库的Zabbix server， 基于nginx网页服务器的Zabbix网页界面及Zabbix Java网关。

1. 创建名为zabbix的新pod并暴露端口（网页界面、Zabbix server trapper）：

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

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

podman run --name zabbix-agent \
    -e ZBX_SERVER_HOST="127.0.0.1,localhost" \
    --restart=always \
    --pod=zabbix \
    -d registry.connect.redhat.com/zabbix/zabbix-agent-70: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

4. 启动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-70

5. 启动Zabbix Java网关容器：

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

6. 启动Zabbix网页界面容器：

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-70