epicmorg/zabbix-web-apache-mysql

Zabbix Web界面Docker镜像

!logo

镜像概述和主要用途

Zabbix是企业级开源分布式监控解决方案，可监控网络参数、服务器健康状态和完整性，并提供灵活的通知机制和数据可视化功能。Zabbix Web界面是Zabbix软件的一部分，用于管理被监控资源和查看监控统计数据。

本镜像为官方Zabbix Web界面Docker镜像，基于Alpine Linux v3.11、Ubuntu 18.04（bionic）和CentOS 7构建，提供Apache2 Web服务器与MySQL数据库支持的版本。

核心功能和特性

• 多版本支持：涵盖Zabbix 3.0、4.0、5.0等多个版本（部分旧版本已不再支持）
• 多系统基础：基于Alpine、Ubuntu和CentOS三种基础镜像
• 灵活配置：通过环境变量自定义Zabbix服务器连接、数据库连接、PHP参数等
• 安全特性：支持数据库连接加密（TLS）、 secrets文件方式传递敏感信息
• Web服务器：基于Apache2 Web服务器，支持HTTPS配置
• 日志管理：可通过Docker容器日志查看Zabbix Web界面日志

镜像版本标签

可用的Zabbix Web界面版本及对应标签：

• Zabbix 3.0：alpine-3.0-latest、ubuntu-3.0-latest、centos-3.0-latest及具体补丁版本（如alpine-3.0.*）
• Zabbix 4.0：alpine-4.0-latest、ubuntu-4.0-latest、centos-4.0-latest及具体补丁版本
• Zabbix 5.0：alpine-5.0-latest、ubuntu-5.0-latest、centos-5.0-latest、alpine-latest、ubuntu-latest、centos-latest、latest（latest标签基于Alpine Linux）
• 开发版（5.2）：alpine-trunk、ubuntu-trunk、centos-trunk

注：3.2、3.4、4.2、4.4版本已标记为不支持（unsupported）

使用场景和适用范围

• 企业级监控系统的Web管理界面部署
• 快速搭建Zabbix监控平台的Web前端
• 多环境（开发、测试、生产）的Zabbix Web界面隔离部署
• 需要灵活配置和快速扩展的监控系统

使用方法和配置说明

基本启动命令

console
docker run --name some-zabbix-web-apache-mysql \
  -e DB_SERVER_HOST="some-mysql-server" \
  -e MYSQL_USER="some-user" \
  -e MYSQL_PASSWORD="some-password" \
  -e ZBX_SERVER_HOST="some-zabbix-server" \
  -e PHP_TZ="some-timezone" \
  -d zabbix/zabbix-web-apache-mysql:tag

参数说明：

• some-zabbix-web-apache-mysql：容器名称
• some-mysql-server：MySQL服务器IP或DNS名称
• some-user：MySQL数据库用户名
• some-password：MySQL数据库密码
• some-zabbix-server：Zabbix服务器或代理的IP或DNS名称
• some-timezone：PHP时区（如Asia/Shanghai）
• tag：指定镜像版本标签（如alpine-5.0-latest）

链接到Zabbix服务器

console
docker run --name some-zabbix-web-apache-mysql \
  --link some-zabbix-server:zabbix-server \
  -e DB_SERVER_HOST="some-mysql-server" \
  -e MYSQL_USER="some-user" \
  -e MYSQL_PASSWORD="some-password" \
  -e ZBX_SERVER_HOST="some-zabbix-server" \
  -e PHP_TZ="some-timezone" \
  -d zabbix/zabbix-web-apache-mysql:tag

链接到MySQL数据库

console
docker run --name some-zabbix-web-apache-mysql \
  --link some-mysql-server:mysql \
  -e DB_SERVER_HOST="some-mysql-server" \
  -e MYSQL_USER="some-user" \
  -e MYSQL_PASSWORD="some-password" \
  -e ZBX_SERVER_HOST="some-zabbix-server" \
  -e PHP_TZ="some-timezone" \
  -d zabbix/zabbix-web-apache-mysql:tag

容器shell访问和日志查看

进入容器shell：

console
docker exec -ti some-zabbix-web-apache-mysql /bin/bash

查看Zabbix Web界面日志：

console
docker logs some-zabbix-web-apache-mysql

环境变量配置

使用secrets文件传递敏感信息

非Docker Swarm/Kubernetes环境：

console
docker run --name some-zabbix-web-apache-mysql \
  -e DB_SERVER_HOST="some-mysql-server" \
  -v ./.MYSQL_USER:/run/secrets/MYSQL_USER \
  -e MYSQL_USER_FILE=/run/secrets/MYSQL_USER \
  -v ./.MYSQL_PASSWORD:/run/secrets/MYSQL_PASSWORD \
  -e MYSQL_PASSWORD_FILE=/run/secrets/MYSQL_PASSWORD \
  -e PHP_TZ="Asia/Shanghai" \
  -d zabbix/zabbix-web-apache-mysql:tag

Docker Swarm环境：

console
printf "zabbix" | docker secret create MYSQL_USER -
printf "zabbix" | docker secret create MYSQL_PASSWORD -
docker run --name some-zabbix-web-apache-mysql \
  -e DB_SERVER_HOST="some-mysql-server" \
  -e MYSQL_USER_FILE=/run/secrets/MYSQL_USER \
  -e MYSQL_PASSWORD_FILE=/run/secrets/MYSQL_PASSWORD \
  -e ZBX_SERVER_HOST="some-zabbix-server" \
  -e PHP_TZ="Asia/Shanghai" \
  -d zabbix/zabbix-web-apache-mysql:tag

支持的卷

/etc/ssl/apache2

用于启用HTTPS，需包含ssl.crt（证书文件）和ssl.key（密钥文件）两个文件。详细配置请参考Apache2 SSL文档。

镜像变体

zabbix-web-apache-mysql:ubuntu-<version>

默认镜像，基于Ubuntu系统，包含较多系统工具，适合大多数场景。

zabbix-web-apache-mysql:alpine-<version>

基于Alpine Linux，镜像体积更小（约5MB基础镜像），使用musl libc替代glibc，适合对镜像大小有严格要求的场景。

支持的Docker版本

官方支持Docker 1.12.0及以上版本，对1.6及以上版本提供有限支持。

用户反馈

文档

镜像文档存储在https://github.com/zabbix/zabbix-docker/%E7%9A%84%60web-apache-mysql/%60%E7%9B%AE%E5%BD%95%E4%B8%8B%E3%80%82

问题反馈

如遇问题，请通过https://github.com/zabbix/zabbix-docker/issues%E6%8F%90%E4%BA%A4%E3%80%82

贡献

欢迎通过Pull Request贡献代码，建议先通过GitHub Issues讨论功能或修复计划。