从 Zabbix 6.0 开始，确定性触发器需要在安装期间创建。如果 MySQL/MariaDB 启用了二进制日志记录，则这需要 superuser 权限，或设置变量/配置参数 log_bin_trust_function_creators = 1。有关如何设置该变量的说明，请参见数据库创建脚本。

请注意，如果从控制台执行，该变量只会被临时设置，并会在 Docker 重启时失效。在这种情况下，请保持 SQL 服务运行，仅通过执行 docker compose down zabbix-server 然后执行 docker compose up -d zabbix-server 来停止 zabbix-server 服务。

或者，您也可以在配置文件中设置该变量。

先决条件

在开始之前，请确保您的系统上已安装 Docker。如果尚未安装，请按照 Docker 安装指南进行操作。

某些 Zabbix 组件要求在运行 Docker 的主机上开放特定端口（例如，Zabbix 服务器使用 10051/TCP，SNMP traps 使用 162/UDP）。有关 Zabbix 组件所使用端口的完整列表，请参见要求。对于 Zabbix 服务器和 agent，可以通过在相应容器上设置 ZBX_LISTENPORT 环境变量来更改默认端口。

可用的 Docker 镜像

Zabbix 为每个 Zabbix 组件都提供了一个 Docker 镜像，全部发布在 Docker Hub 上。
每个镜像都用于创建一个运行相应组件的容器。

Zabbix 组件	Docker 镜像
agent	zabbix/zabbix-agent
Agent 2	zabbix/zabbix-agent2
服务器（MySQL）	zabbix/zabbix-server-mysql
服务器（PostgreSQL）	zabbix/zabbix-server-pgsql
Web 界面（Apache + MySQL）	zabbix/zabbix-web-apache-mysql
Web 界面（Apache + PostgreSQL）	zabbix/zabbix-web-apache-pgsql
Web 界面（Nginx + MySQL）	zabbix/zabbix-web-nginx-mysql
Web 界面（Nginx + PostgreSQL）	zabbix/zabbix-web-nginx-pgsql
proxy（SQLite3）	zabbix/zabbix-proxy-sqlite3
proxy（MySQL）	zabbix/zabbix-proxy-mysql
Java 网关	zabbix/zabbix-java-gateway
Web 服务	zabbix/zabbix-web-service
SNMP traps	zabbix/zabbix-snmptraps

要使用 SNMP traps，SNMP traps 容器必须与 Zabbix 服务器或 proxy 容器共享一个卷（请参见 Docker Hub 上的如何使用此镜像以及下面的示例）。

Docker Hub 上的所有 Zabbix 组件镜像都会在其基础镜像更新时自动重新构建。

镜像标签

每个镜像都支持使用标签来选择基础操作系统和 Zabbix 版本：

zabbix/<image>:<os>-<version>

支持的 <os> 值：

alpine - Alpine Linux
ubuntu - Ubuntu
ol - Oracle Linux
ltsc2019 - Windows 10 LTSC 2019（仅 Zabbix agent）
ltsc2022 - Windows 11 LTSC 2022（仅 Zabbix agent）

支持的 <version> 值：

latest - Alpine Linux 上最新的稳定版本
<os>-latest - 所选操作系统上的最新稳定版本
<os>-trunk - 所选操作系统上的最新开发版（nightly）构建
<os>-X.X-latest - 所选操作系统上特定主版本的最新次要版本
<os>-X.X.* - 所选操作系统上的特定次要版本

示例：

# Alpine Linux 上最新稳定版的 Zabbix proxy（SQLite3）：
docker pull zabbix/zabbix-proxy-sqlite3:latest

# Ubuntu 上最新稳定版的 Zabbix proxy（SQLite3）：
docker pull zabbix/zabbix-proxy-sqlite3:ubuntu-latest

# Ubuntu 上 Zabbix 服务器（MySQL）的最新开发版（nightly）构建：
docker pull zabbix/zabbix-server-mysql:ubuntu-trunk

# Alpine Linux 上 Zabbix 服务器（MySQL）的最新 8.0 次要版本：
docker pull zabbix/zabbix-server-mysql:alpine-8.0-latest

# Alpine Linux 上 Zabbix 服务器（MySQL）的 8.0.1 版本：
docker pull zabbix/zabbix-server-mysql:alpine-8.0.1

Docker Compose

Docker Compose 是部署 Zabbix 的最快方式。
它会读取一个配置文件（Compose 文件），并处理整个设置过程——拉取 Docker 镜像、在容器之间创建内部网络、设置存储、初始化数据库，并按正确顺序启动所有组件。

official Zabbix Dockerfiles 仓库提供了开箱即用的 Docker Compose 文件，以及一个基于 .env 的配置系统，支持不同的操作系统、数据库后端和 Zabbix 组件配置。

1. 克隆仓库，进入仓库目录，并切换到 8.0 版本：

git clone https://github.com/zabbix/zabbix-docker.git
cd zabbix-docker
git checkout 8.0

如果尚未安装 git，请参阅 Git installation guide。

2. （可选）使用环境变量自定义部署。
对于默认设置，可以跳过此步骤。

3. 部署默认的 Zabbix 设置：

# 使用 MySQL 作为数据库：
docker compose -f ./compose.yaml up -d

# 使用 PostgreSQL 作为数据库：
docker compose -f ./compose_pgsql.yaml up -d

这将启动 Zabbix 服务器、Web 界面（运行在 Nginx 上）以及数据库后端（MySQL 或 PostgreSQL），它们各自在基于 Alpine Linux 的独立容器中运行（默认）。
容器启动并运行后（通常在 1–3 分钟内），Zabbix 服务器将启动，Web 界面可通过 http://localhost 访问。

您可以使用以下命令检查一切是否正常工作：

docker compose ps

所有容器都应显示为 running 状态。
如果有任何容器显示为 exited，请检查其日志（docker logs <container-name>）。

环境变量

Docker Compose 的行为和 Zabbix 组件配置都可以使用环境变量进行自定义。

Compose 级变量（在 .env 文件中定义）用于控制所使用的 Docker 镜像、端口和网络 IP 范围。您可以在 docker compose 命令前以内联方式使用这些变量，或编辑 .env 文件。

例如，以下命令使用基于 Ubuntu 的镜像（而不是默认的 Alpine Linux）部署一个完整的多容器 Zabbix 环境，并通过 Nginx 在自定义的 HTTP（8282）和 HTTPS（8443）端口上暴露 Web 界面：

OS=ubuntu \
ZABBIX_WEB_NGINX_HTTP_PORT=8282 \
ZABBIX_WEB_NGINX_HTTPS_PORT=8443 \
docker compose -f ./compose.yaml up -d

组件级变量（在 env_vars/.env_<component> 文件中定义）用于控制 Zabbix 组件配置。请在运行 docker compose 命令之前编辑相应的 .env_<component> 文件。

例如，您可以通过编辑以下变量来调整 Zabbix 服务器被动轮询器数量和缓存设置，以及配置 Web 界面的时区：

# env_vars/.env_srv
ZBX_STARTPOLLERS=20
ZBX_CACHESIZE=64M
ZBX_HISTORYCACHESIZE=32M

# env_vars/.env_web
PHP_TZ=Europe/Paris

组件级环境变量对应于 Zabbix 组件配置参数，只是采用了不同的命名风格（例如，ZBX_STARTPOLLERS 对应 StartPollers）。有些变量是 Docker 特有的，而某些配置参数则无法更改（例如，PIDFile 和 LogType）。使用环境变量时，请参阅 Docker Hub 上各组件 Docker 镜像说明中的 Environment variables 部分。

卷

Docker Compose 将持久化数据存储在与 Compose 文件一同创建的 zbx_env/ 目录中。
该目录可在容器重启和更新后保留组件数据。

zbx_env/ 的内容已针对每个组件的镜像预先定义。例如：

zbx_env/etc/ - 由 Zabbix Web 界面容器使用
zbx_env/usr/ 和 zbx_env/var/ - 由 Zabbix 服务器容器使用

有关每个卷的更多信息，请参见 Docker Hub 上各组件 Docker 镜像说明中的 Allowed volumes 部分。

Makefile

Zabbix Dockerfiles 仓库还提供了一个 Makefile，作为常见 Docker Compose 任务的快捷方式。
您可以使用更短的 make 命令来代替完整的 docker compose 命令（运行 make help 可查看可用选项）：

# 默认部署（Zabbix 服务器、Web 界面、MySQL，全部基于 Alpine Linux）
make up

# 自定义部署（Zabbix 服务器、使用自定义 Nginx 端口的 Web 界面、PostgreSQL，全部基于 Ubuntu）
make up \
  OS=ubuntu \
  DB=pgsql \
  ZABBIX_WEB_NGINX_HTTP_PORT=8282 \
  ZABBIX_WEB_NGINX_HTTPS_PORT=8443

停止或删除容器时，请始终指定与部署时相同的数据库类型（例如：make down DB=pgsql）。

默认情况下，make up 仅启动一组最小服务（Zabbix 服务器、Web 界面和数据库）。
这样可以使部署保持轻量，并避免启动可能不需要的组件。
如需包含其他组件，可以使用以下 Compose profiles：

# 默认部署 + Zabbix agent、Java 网关、Web 服务和 SNMP traps：
make up COMPOSE_PROFILES=full

# COMPOSE_PROFILES=full + Zabbix proxy（MySQL 和 SQLite3）：
make up COMPOSE_PROFILES=all

Docker（手动部署）

当您希望逐步部署 Zabbix、运行单独的组件、将其与现有环境集成，或使用诸如 Podman 之类的替代容器运行时，可使用手动部署。

例如，要部署一个 Zabbix proxy，请运行以下命令：

docker run --name zabbix-proxy-sqlite3 \
  -e ZBX_SERVER_HOST=192.0.2.0 \
  -e ZBX_PROXYMODE=0 \
  -e ZBX_HOSTNAME=zabbix-proxy-sqlite3 \
  -v zabbix-proxy-data:/var/lib/zabbix/db_data \
  --init \
  -d \
  zabbix/zabbix-proxy-sqlite3:alpine-8.0-latest

此命令将：

拉取 zabbix/zabbix-proxy-sqlite3:alpine-8.0-latest Docker 镜像。
基于该 Docker 镜像创建并启动一个 zabbix-proxy-sqlite3 容器（使用 --init 和 -d 标志）。
通过 ZBX_SERVER_HOST 环境变量配置 Zabbix proxy 的 Server 参数。
此参数指定 Zabbix 服务器的 IP 地址，proxy 将从该服务器获取配置数据，并向其发送采集到的数据。
请注意，主动 proxy 运行所需的其他变量使用默认值，因此可以省略。

环境变量对应于 Zabbix 组件配置参数，但采用不同的命名风格（例如，ZBX_SERVER_HOST 对应 Server）。
某些变量是 Docker 特有的，而某些配置参数则无法更改（例如，PIDFile 和 LogType）。
使用环境变量时，请参阅 Docker Hub 上各组件 Docker 镜像描述中的 Environment variables 部分。

将由 Docker 管理的存储位置（例如 /var/lib/docker/volumes/zabbix-proxy-data/）连接到容器的 /var/lib/zabbix 目录，以便即使容器被删除，Zabbix proxy 数据也能被永久保存。

有关各个卷的更多信息，请参阅 Docker Hub 上各组件 Docker 镜像描述中的 Allowed volumes 部分。

部署 Zabbix proxy 容器后，您可以继续在 Zabbix 前端中添加 proxy，并配置主机由该 proxy 进行监控。

以下示例还涵盖另外三种部署场景：

带有 Java 网关的 Zabbix 服务器（MySQL）
带有 SNMP traps 的 Zabbix 服务器（PostgreSQL）
在 RHEL 8 上带有 Java 网关的 Zabbix 服务器（MySQL）

如需更多示例，请参阅 Docker Hub 上各组件的 Docker 镜像描述。

使用 Java 网关部署 Zabbix 服务器（MySQL）

1. 创建一个专用 Docker 网络，以便所有 Zabbix 组件容器都可以通过容器名称互相访问：

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

2. 运行一个空的 MySQL 服务器容器（将 zabbix_pwd 和 root_pwd 替换为高强度密码）：

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.4-oracle \
  --character-set-server=utf8 --collation-server=utf8_bin \
  --default-authentication-plugin=caching_sha2_password \
  --innodb-default-row-format=dynamic \
  --innodb-strict-mode=OFF

在第 4 步运行 Zabbix 服务器容器之前，MySQL 必须完成初始化，否则 Zabbix schema 可能无法正确加载。要确认 MySQL 已就绪，请运行 docker logs mysql-server，仅当您看到 /usr/sbin/mysqld: ready for connections 时再继续。

3. 运行一个 Zabbix Java 网关容器：

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

4. 运行一个 Zabbix 服务器容器，并将其连接到 MySQL 服务器容器（将 zabbix_pwd 和 root_pwd 替换为第 2 步中使用的相同密码）：

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

运行 Zabbix 服务器容器后，请等待 Zabbix 服务器完成数据库 schema 初始化。要确认其已就绪，请运行 docker logs zabbix-server-mysql，仅当您不再看到 Creating 'zabbix' schema in MySQL 时再继续。

5. 运行一个 Zabbix Web 界面容器，并将其连接到 Zabbix 服务器和 MySQL 服务器容器（将 zabbix_pwd 和 root_pwd 替换为第 2 步中使用的相同密码）：

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

当容器启动并运行后（通常在 1–3 分钟内），Zabbix 服务器即已启动，Web 界面可通过 http://localhost 访问。

使用 SNMP traps 部署 Zabbix 服务器（PostgreSQL）

1. 创建一个专用 Docker 网络，以便所有 Zabbix 组件容器都可以通过容器名称互相访问：

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

2. 运行一个空的 PostgreSQL 服务器容器（将 zabbix_pwd 替换为高强度密码）：

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 SNMP traps 容器：

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

4. 运行一个 Zabbix 服务器容器，将其连接到 PostgreSQL 服务器容器和 SNMP traps 容器（将 zabbix_pwd 替换为第 2 步中使用的相同密码）：

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

运行 Zabbix 服务器容器后，请等待 Zabbix 服务器完成数据库 schema 初始化。要确认其已就绪，请运行 docker logs zabbix-server-pgsql，仅当您不再看到 Creating 'zabbix' schema in PostgreSQL 时再继续。

5. 运行一个 Zabbix Web 界面容器，并将其连接到 Zabbix 服务器和 PostgreSQL 服务器容器（将 zabbix_pwd 替换为第 2 步中使用的相同密码）：

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

当容器启动并运行后（通常在 1–3 分钟内），Zabbix 服务器即已启动，Web 界面可通过 http://localhost 访问。

在 RHEL 8 上使用 Java 网关部署 Zabbix 服务器（MySQL）

在 Red Hat Enterprise Linux 8 上，推荐使用 Podman 而不是 Docker 作为容器运行时。 Podman 的工作方式与 Docker 类似，但不需要以 root 身份运行后台服务，因此更适合 Red Hat 环境。

1. 创建一个名为 zabbix 的新 pod，并为 Zabbix Web 界面和 Zabbix 服务器 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-80:latest

3. 在 RHEL 主机上创建一个 ./mysql/ 目录：

mkdir -p ./mysql

4. 运行一个空的 MySQL 服务器容器（将 zabbix_pwd 和 root_pwd 替换为高强度密码）：

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.4 \
  --character-set-server=utf8 --collation-server=utf8_bin \
  --default-authentication-plugin=caching_sha2_password \
  --innodb-default-row-format=dynamic \
  --innodb-strict-mode=OFF

在第 6 步运行 Zabbix 服务器容器之前，MySQL 必须完成初始化，否则 Zabbix schema 可能无法正确加载。要确认 MySQL 已就绪，请运行 podman logs mysql-server，仅当您看到 /usr/sbin/mysqld: ready for connections 时再继续。

5. 运行一个 Zabbix Java 网关容器：

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

6. 运行一个 Zabbix 服务器容器（将 zabbix_pwd 和 root_pwd 替换为第 4 步中使用的相同密码）：

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

7. 运行一个 Zabbix Web 界面容器（将 zabbix_pwd 和 root_pwd 替换为第 4 步中使用的相同密码）：

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

Pod zabbix 将 zabbix-web-mysql 容器的 8080/TCP 映射并暴露为主机上的 80/TCP 端口（HTTP）。

What’s next?

从源代码安装

Docs

从容器安装

概述