zabbix/zabbix-web-apache-pgsql

!logo

Zabbix Web界面（Apache+PostgreSQL）Docker镜像文档

1. 镜像概述和主要用途

Zabbix是企业级开源分布式监控解决方案，可监控网络参数、服务器健康状态及完整性。Zabbix Web界面是Zabbix软件的核心组件，用于管理监控资源、配置告警规则及查看监控统计数据，支持通过灵活的通知机制实现事件告警，助力快速响应服务器问题，并提供基于历史数据的报表和可视化功能，适用于容量规划等场景。

本镜像为Zabbix官方Web界面镜像，基于Apache2 Web服务器和PostgreSQL数据库支持，提供稳定、高效的监控管理界面。

2. 核心功能和特性

2.1 核心功能

• 监控资源管理：配置和管理被监控设备、主机组、模板等
• 监控数据可视化：通过图表、仪表盘展示实时和历史监控数据
• 告警配置与查看：定义告警触发条件、接收方式，并集中展示告警事件
• 报表生成：支持自定义报表，用于容量规划和性能分析
• 多用户权限管理：基于角色的访问控制，支持精细化权限配置

2.2 技术特性

• 基于Apache2 Web服务器，稳定可靠，支持高并发访问
• 原生支持PostgreSQL数据库，优化数据库交互性能
• 多基础系统支持：基于Alpine Linux、Ubuntu、CentOS Stream、Oracle Linux构建
• 环境变量动态配置：无需修改配置文件即可自定义参数
• 安全特性：支持数据库TLS加密连接、SAML认证集成、Web服务器版本隐藏
• 灵活的卷挂载：支持SSL证书、SAML认证证书、TLS相关文件的外部挂载

3. 使用场景和适用范围

3.1 适用场景

• 企业级监控系统的Web管理界面部署
• 与Zabbix Server/Proxy、PostgreSQL数据库组成完整监控架构
• 容器化监控平台的Web前端组件
• 需要快速部署和动态配置的监控环境

3.2 适用范围

• 中小企业IT基础设施监控
• 大型企业分布式系统监控
• 云环境或混合云环境监控
• 需自定义告警和报表的监控场景

4. 镜像版本与标签

4.1 基础系统

镜像基于以下操作系统构建：

• Alpine Linux v3.22
• Ubuntu 24.04 (noble)
• CentOS Stream 10
• Oracle Linux 10

4.2 版本与标签

支持的Zabbix Web界面版本及对应标签格式如下：

注意：latest标签默认基于Alpine Linux构建，镜像会随Zabbix新版本发布自动更新。

5. 使用方法

5.1 基本启动命令

使用以下命令启动Zabbix Web界面容器，需指定PostgreSQL数据库和Zabbix Server地址：

console
docker run --name zabbix-web -d \
  -e DB_SERVER_HOST="postgres-server-ip" \
  -e POSTGRES_USER="zabbix" \
  -e POSTGRES_PASSWORD="zabbix" \
  -e ZBX_SERVER_HOST="zabbix-server-ip" \
  -e PHP_TZ="Asia/Shanghai" \
  -p 8080:80 \
  docker.xuanyuan.run/zabbix/zabbix-web-apache-pgsql:alpine-latest

参数说明：

• --name zabbix-web：容器名称
• -e：环境变量（详细说明见5.4节）
• -p 8080:80：映射容器80端口到主机8080端口
• zabbix/zabbix-web-apache-pgsql:alpine-latest：镜像名称及标签

5.2 链接Zabbix Server容器

通过--link参数链接Zabbix Server容器（需确保Zabbix Server已启动）：

console
docker run --name zabbix-web -d \
  --link zabbix-server:zabbix-server \  # 链接Zabbix Server容器
  -e DB_SERVER_HOST="postgres-server-ip" \
  -e POSTGRES_USER="zabbix" \
  -e POSTGRES_PASSWORD="zabbix" \
  -e ZBX_SERVER_HOST="zabbix-server" \  # 使用链接的容器名称作为Server地址
  -e PHP_TZ="Asia/Shanghai" \
  -p 8080:80 \
  zabbix/zabbix-web-apache-pgsql:alpine-latest

5.3 链接PostgreSQL数据库容器

通过--link参数链接PostgreSQL容器（需确保PostgreSQL已启动并初始化Zabbix数据库）：

console
docker run --name zabbix-web -d \
  --link postgres:postgres \  # 链接PostgreSQL容器
  -e DB_SERVER_HOST="postgres" \  # 使用链接的容器名称作为数据库地址
  -e POSTGRES_USER="zabbix" \
  -e POSTGRES_PASSWORD="zabbix" \
  -e ZBX_SERVER_HOST="zabbix-server-ip" \
  -e PHP_TZ="Asia/Shanghai" \
  -p 8080:80 \
  zabbix/zabbix-web-apache-pgsql:alpine-latest

5.4 容器日志与shell访问

5.4.1 查看日志

通过Docker日志命令查看Web界面运行日志：

console
docker logs zabbix-web

5.4.2 进入容器shell

通过docker exec进入容器内部：

console
docker exec -ti zabbix-web /bin/bash  # Alpine版本使用/bin/sh

5.5 Docker Compose部署示例

以下是包含Zabbix Web、Zabbix Server和PostgreSQL的完整docker-compose配置：

yaml
version: '3.8'

services:
  db:
    image: docker.xuanyuan.run/postgres:16-alpine
    container_name: zabbix-db
    environment:
      POSTGRES_USER: zabbix
      POSTGRES_PASSWORD: zabbix
      POSTGRES_DB: zabbix
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: always
    networks:
      - zabbix-net

  server:
    image: docker.xuanyuan.run/zabbix/zabbix-server-pgsql:alpine-latest
    container_name: zabbix-server
    environment:
      DB_SERVER_HOST: db
      POSTGRES_USER: zabbix
      POSTGRES_PASSWORD: zabbix
      POSTGRES_DB: zabbix
      ZBX_LISTENPORT: 10051
    depends_on:
      - db
    restart: always
    networks:
      - zabbix-net

  web:
    image: docker.xuanyuan.run/zabbix/zabbix-web-apache-pgsql:alpine-latest
    container_name: zabbix-web
    environment:
      DB_SERVER_HOST: db
      POSTGRES_USER: zabbix
      POSTGRES_PASSWORD: zabbix
      POSTGRES_DB: zabbix
      ZBX_SERVER_HOST: server
      PHP_TZ: Asia/Shanghai
      ZBX_SERVER_NAME: "企业监控系统"
    ports:
      - "8080:80"
    depends_on:
      - server
      - db
    restart: always
    networks:
      - zabbix-net

networks:
  zabbix-net:
    driver: bridge

volumes:
  postgres-data:

6. 环境变量配置

容器支持通过环境变量自定义配置，以下为常用环境变量说明：

6.1 数据库连接配置

6.2 Zabbix Server连接配置

6.3 PHP配置

6.4 安全与认证配置

6.5 高级配置

7. 卷挂载说明

容器支持以下卷挂载，用于外部配置和数据持久化：

7.1 Apache SSL证书卷

• 挂载路径：/etc/ssl/apache2
• 用途：启用HTTPS访问，需包含以下文件：
  • ssl.crt：Apache服务器证书
  • ssl.key：Apache服务器私钥
• 示例：

  console
  docker run --name zabbix-web -d \
    -v /host/path/to/ssl:/etc/ssl/apache2 \
    ... zabbix/zabbix-web-apache-pgsql:alpine-latest
  

7.2 SAML认证证书卷

• 挂载路径：/etc/zabbix/web/certs
• 用途：SAML认证集成，需包含以下文件：
  • sp.key：服务提供者（SP）私钥
  • sp.crt：服务提供者（SP）证书
  • idp.crt：身份提供者（IDP）证书
• 示例：

  console
  docker run --name zabbix-web -d \
    -v /host/path/to/saml-certs:/etc/zabbix/web/certs \
    ... zabbix/zabbix-web-apache-pgsql:alpine-latest
  

7.3 TLS相关文件卷

• 挂载路径：/var/lib/zabbix/enc
• 用途：存储Zabbix Server TLS相关文件，与以下变量配合使用：
  • ZBX_SERVER_TLS_CAFILE：CA证书文件名
  • ZBX_SERVER_TLS_KEYFILE：私钥文件名
  • ZBX_SERVER_TLS_CERTFILE：证书文件名
• 示例：

  console
  docker run --name zabbix-web -d \
    -v /host/path/to/tls-files:/var/lib/zabbix/enc \
    -e ZBX_SERVER_TLS_CAFILE="ca.pem" \
    -e ZBX_SERVER_TLS_KEYFILE="server.key" \
    -e ZBX_SERVER_TLS_CERTFILE="server.crt" \
    ... zabbix/zabbix-web-apache-pgsql:alpine-latest
  

8. 镜像变体

8.1 alpine-<version> 变体

• 基础系统：Alpine Linux
• 特点：体积极小（~5MB基础镜像），适合对镜像大小敏感的场景
• 注意事项：使用musl libc而非glibc，部分依赖glibc的软件可能不兼容
• 推荐场景：资源受限环境、轻量级部署、CI/CD流水线

8.2 ubuntu-<version> 变体

• 基础系统：Ubuntu 24.04 (noble)
• 特点：兼容性好，包含更多系统工具，社区支持广泛
• 注意事项：镜像体积较大（相比Alpine）
• 推荐场景：生产环境、需要丰富系统工具的场景、对兼容性要求高的环境

8.3 ol-<version> 变体

• 基础系统：Oracle Linux 10
• 特点：针对Oracle工作负载优化，包含Ksplice（零停机内核补丁）、DTrace等特性
• 推荐场景：Oracle数据库环境、需要企业级Linux特性的场景

9. 支持的Docker版本

• 官方支持版本：Docker 1.12.0及以上
• 向下兼容：Docker 1.6及以上版本（尽力支持）

建议使用最新版Docker引擎以获得最佳兼容性和性能，升级方法参考https://docs.docker.com/engine/install/%E3%80%82

10. 用户反馈与贡献