在实际企业 IT 环境中服务器、网络设备、应用服务的稳定运行是业务连续性的基石。当系统规模从几台服务器扩展到成百上千台甚至跨越多个数据中心时单纯依靠人工登录检查、查看日志的方式变得不可行。此时一套能够自动采集数据、智能分析、及时告警的监控系统就成为运维工程师的“眼睛”和“耳朵”。Zabbix 正是这样一款成熟、强大且开源的企业级分布式监控解决方案它能够监控网络参数、服务器健康状态、应用性能指标并通过灵活的告警机制让运维团队在问题影响用户之前就做出响应。对于希望从零开始学习运维或计划将 Zabbix 引入生产环境的工程师而言最大的挑战往往不是理解监控概念而是如何将 Zabbix 及其依赖的数据库如 MySQL、Web 服务器如 Nginx等组件以一种可靠、可维护、易于扩展的方式部署起来。传统的手动编译安装步骤繁琐环境依赖复杂且难以保证多套环境的一致性。Docker 容器化技术的出现为这个问题提供了优雅的解决方案。通过 Docker我们可以将 Zabbix Server、Zabbix Web、MySQL 数据库等每个组件封装在独立的、标准化的容器中实现一键部署、快速迁移和版本隔离。本文将带你从零开始完成一个基于 Docker 的 Zabbix 7.0 LTS 监控系统的企业级部署。我们将使用官方提供的 Docker 镜像通过 Docker Compose 编排多个服务并集成 MySQL 作为后端数据库Nginx 作为反向代理。整个过程不仅会详细说明每一步的操作和配置还会深入解释每个参数的作用、组件间的通信原理以及部署完成后如何进行基础监控配置和故障排查。无论你是刚接触 Linux 运维的新手还是希望优化现有部署流程的工程师都能通过本文获得一个可复现、可投入生产使用的参考架构。1. 理解 Zabbix 监控架构与 Docker 部署优势在动手部署之前必须先理解 Zabbix 的核心组件如何协同工作以及为什么 Docker 是部署它的理想选择。盲目执行命令而不知其所以然会在后续的排错和扩展中寸步难行。1.1 Zabbix 核心组件与数据流一个完整的 Zabbix 监控系统通常包含以下核心组件它们共同构成了一个数据采集、处理、存储和展示的闭环Zabbix Server: 这是监控系统的大脑。它负责轮询或接收来自 Zabbix Agent 和各类设备的数据进行数据处理、触发告警规则并将数据存储到数据库中。所有配置管理和核心逻辑都在这里。Zabbix Database: 存储所有配置信息、采集到的历史数据、趋势数据以及事件、告警信息。MySQL、PostgreSQL、Oracle 等都是支持的后端数据库。生产环境通常将其部署在独立的、高可用的数据库服务器上。Zabbix Web Interface (Frontend): 基于 PHP 的 Web 管理界面。运维人员通过它进行监控项配置、查看监控图表、确认告警、管理用户权限等所有操作。它需要与 Zabbix Server 和 Database 进行交互。Zabbix Agent: 部署在被监控主机如 Linux/Windows 服务器上的轻量级守护进程。它负责收集本地主机的系统指标如 CPU、内存、磁盘、网络和应用指标并主动或被动地发送给 Zabbix Server。Zabbix Proxy (可选): 用于分布式监控或减轻 Server 压力。Proxy 可以替 Server 从一片区域的 Agent 收集数据并缓存后统一转发给 Server特别适用于跨网络区域或监控节点极多的场景。数据流向可以简化为被监控主机 (Zabbix Agent) - Zabbix Server - Database。Web 界面则从 Database 和 Server 读取数据呈现给用户。1.2 为什么选择 Docker Compose 部署 Zabbix传统部署方式需要在目标服务器上安装 LAMP (Linux, Apache, MySQL, PHP) 或 LEMP (Linux, Nginx, MySQL, PHP) 环境然后分别编译或安装 Zabbix Server、Frontend 的各个包。这个过程涉及大量系统包的依赖、配置文件散落在多个目录、版本升级困难且容易污染主机环境。使用 Docker 和 Docker Compose 部署可以带来以下显著优势环境隔离与一致性: 每个组件MySQL, Zabbix Server, Zabbix Web, Nginx运行在独立的容器中拥有自己的文件系统、网络命名空间。这意味着你不会因为部署 Zabbix 而影响主机上已有的 MySQL 服务也确保了开发、测试、生产环境的高度一致。快速部署与销毁: 一个docker-compose up -d命令就能启动全套服务docker-compose down则可以彻底清理非常适合快速搭建测试环境。版本管理清晰: 在docker-compose.yml中明确指定每个镜像的版本如zabbix/zabbix-server-mysql:7.0-latest升级或回滚只需修改版本号并重启。配置即代码: 所有服务配置、网络设置、数据卷映射都定义在docker-compose.yml文件中。此文件可以纳入版本控制系统如 Git实现基础设施的版本化管理。资源可控: 可以方便地为每个容器分配 CPU、内存限制避免某个组件异常时拖垮整个主机。基于这些优势我们将采用 Docker Compose 作为本次部署的工具。接下来我们开始准备部署环境。2. 部署环境准备与 Docker 安装一个稳定可靠的部署始于一个干净、规范的环境。我们将在一台全新的 Linux 服务器上完成所有操作。假设你使用的是一台 CentOS 7/8 或 Rocky Linux 8/9 的服务器。2.1 系统基础要求检查首先登录你的 Linux 服务器检查系统是否符合基本要求。# 查看系统版本和内核信息 cat /etc/os-release uname -r # 检查内存和磁盘空间建议内存 2GB磁盘 20GB free -h df -h /对于 Zabbix 7.0 LTS 在 Docker 中运行建议系统内核版本不低于 3.10并且有足够的资源。Docker 本身对资源消耗不大但 Zabbix Server 和 MySQL 在数据处理时可能需要较多内存。2.2 安装 Docker 与 Docker Compose我们将使用官方脚本安装最新稳定版的 Docker Engine 和 Docker Compose Plugin。# 1. 卸载旧版本 Docker如果存在 sudo yum remove docker \ docker-client \ docker-client-latest \ docker-common \ docker-latest \ docker-latest-logrotate \ docker-logrotate \ docker-engine # 2. 安装 yum-utils 工具包并设置稳定的仓库 sudo yum install -y yum-utils sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo # 3. 安装 Docker Engine, containerd 和 Docker Compose Plugin sudo yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin # 4. 启动 Docker 服务并设置开机自启 sudo systemctl start docker sudo systemctl enable docker # 5. 验证 Docker 和 Docker Compose 安装是否成功 sudo docker --version sudo docker compose version如果docker compose version命令成功输出版本号说明 Docker Compose Plugin 已安装。它是docker-compose命令的现代替代品集成在 Docker CLI 中。注意在生产环境中可能需要配置 Docker 的镜像加速器如阿里云、腾讯云镜像加速服务以提升拉取镜像的速度。具体配置方法请参考对应云服务商的文档通常涉及修改/etc/docker/daemon.json文件。2.3 创建项目目录与文件结构良好的目录结构是运维规范化的第一步。我们将所有与本次 Zabbix 部署相关的文件集中管理。# 创建一个项目根目录 mkdir -p /opt/zabbix-docker cd /opt/zabbix-docker # 创建子目录用于存放配置、数据和日志 mkdir -p {env,data/mysql,data/zabbix-server,logs/nginx,logs/zabbix-server}/opt/zabbix-docker: 项目根目录。env/: 存放环境变量文件用于敏感信息如数据库密码管理。data/mysql/: 映射 MySQL 容器的数据目录实现数据持久化。data/zabbix-server/: 映射 Zabbix Server 的 externalscripts、alertscripts 等目录。logs/nginx/和logs/zabbix-server/: 分别存放 Nginx 和 Zabbix Server 的日志文件方便主机上直接查看。3. 编写 Docker Compose 编排文件这是整个部署的核心。我们将在一个docker-compose.yml文件中定义 MySQL、Zabbix Server、Zabbix Web 和 Nginx 四个服务。在/opt/zabbix-docker目录下创建docker-compose.yml文件version: 3.8 services: mysql-server: image: mysql:8.0 container_name: zabbix-mysql restart: unless-stopped # 设置环境变量密码等敏感信息建议通过 env_file 引入 environment: - MYSQL_DATABASEzabbix - MYSQL_USERzabbix - MYSQL_PASSWORDYourStrongPasswordHere - MYSQL_ROOT_PASSWORDYourStrongRootPasswordHere volumes: - ./data/mysql:/var/lib/mysql - ./env/mysql-init:/docker-entrypoint-initdb.d:ro command: - --character-set-serverutf8mb4 - --collation-serverutf8mb4_bin - --default-authentication-pluginmysql_native_password networks: - zabbix-net healthcheck: test: [CMD, mysqladmin, ping, -h, localhost, -u, root, -p$$MYSQL_ROOT_PASSWORD] interval: 30s timeout: 10s retries: 3 start_period: 60s zabbix-server: image: zabbix/zabbix-server-mysql:7.0-latest container_name: zabbix-server restart: unless-stopped depends_on: mysql-server: condition: service_healthy environment: - DB_SERVER_HOSTmysql-server - MYSQL_DATABASEzabbix - MYSQL_USERzabbix - MYSQL_PASSWORDYourStrongPasswordHere - MYSQL_ROOT_PASSWORDYourStrongRootPasswordHere volumes: - ./data/zabbix-server/externalscripts:/usr/lib/zabbix/externalscripts:ro - ./data/zabbix-server/alertscripts:/usr/lib/zabbix/alertscripts:ro - ./logs/zabbix-server:/var/log/zabbix networks: - zabbix-net ports: - 10051:10051 healthcheck: test: [CMD, curl, -f, http://localhost:10051/] interval: 30s timeout: 10s retries: 3 start_period: 120s zabbix-web: image: zabbix/zabbix-web-nginx-mysql:7.0-latest container_name: zabbix-web restart: unless-stopped depends_on: mysql-server: condition: service_healthy zabbix-server: condition: service_healthy environment: - ZBX_SERVER_HOSTzabbix-server - DB_SERVER_HOSTmysql-server - MYSQL_DATABASEzabbix - MYSQL_USERzabbix - MYSQL_PASSWORDYourStrongPasswordHere - MYSQL_ROOT_PASSWORDYourStrongRootPasswordHere - PHP_TZAsia/Shanghai volumes: - ./env/zabbix.conf.php:/etc/zabbix/web/zabbix.conf.php:ro networks: - zabbix-net nginx-proxy: image: nginx:alpine container_name: zabbix-nginx restart: unless-stopped depends_on: - zabbix-web ports: - 80:80 - 443:443 volumes: - ./nginx/conf.d:/etc/nginx/conf.d:ro - ./logs/nginx:/var/log/nginx networks: - zabbix-net networks: zabbix-net: driver: bridge3.1 关键配置详解版本与网络:version: 3.8: 指定 Compose 文件格式版本。networks: zabbix-net: 创建一个名为zabbix-net的桥接网络所有服务加入此网络它们可以通过服务名如mysql-server直接通信无需知道 IP 地址。MySQL 服务 (mysql-server):image: mysql:8.0: 使用 MySQL 8.0 官方镜像。Zabbix 7.0 完全支持 MySQL 8.0。environment: 设置数据库、用户和密码。请务必在生产环境中修改YourStrongPasswordHere为复杂密码。volumes: 将主机./data/mysql目录挂载到容器的/var/lib/mysql实现数据持久化。即使容器删除数据也不会丢失。command: 指定 MySQL 启动参数确保使用utf8mb4字符集和mysql_native_password认证插件某些旧版客户端兼容需要。healthcheck: 定义健康检查确保数据库完全启动后其他服务才启动。Zabbix Server 服务 (zabbix-server):image: zabbix/zabbix-server-mysql:7.0-latest: 使用 Zabbix 官方提供的、与 MySQL 配套的 Server 镜像。depends_on: 依赖于mysql-server服务并且等待其健康状态变为healthy。environment: 配置数据库连接信息DB_SERVER_HOST直接使用服务名mysql-server。ports: - 10051:10051: 将容器的 10051 端口映射到主机。这是 Zabbix Server 的默认端口用于接收 Agent 和 Proxy 的数据。healthcheck: 通过检查 Server 的 10051 端口来判断服务是否就绪。Zabbix Web 服务 (zabbix-web):image: zabbix/zabbix-web-nginx-mysql:7.0-latest: 使用集成了 Nginx 和 PHP 的 Zabbix Web 镜像。environment: 除了数据库信息还指定了 Zabbix Server 的地址 (ZBX_SERVER_HOST) 和 PHP 时区 (PHP_TZ)。volumes: 挂载一个自定义的 PHP 配置文件。我们可以通过这个文件覆盖一些默认的 Web 配置。Nginx 代理服务 (nginx-proxy):我们额外部署一个 Nginx 容器作为反向代理和 SSL 终端。这样做的好处是职责分离: Zabbix Web 容器只处理 PHP 应用Nginx 处理静态文件、负载均衡和 SSL。灵活性: 可以方便地在此 Nginx 上配置域名、SSL 证书、访问控制等而无需修改 Zabbix 官方镜像。ports: - 80:80: 将主机的 80 端口暴露出来用于 HTTP 访问。volumes: 挂载自定义的 Nginx 站点配置文件目录。3.2 配置 Nginx 反向代理在/opt/zabbix-docker目录下创建 Nginx 配置mkdir -p nginx/conf.d创建文件/opt/zabbix-docker/nginx/conf.d/zabbix.confserver { listen 80; server_name _; # 此处可替换为你的域名如 zabbix.yourcompany.com location / { proxy_pass http://zabbix-web:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_buffering off; proxy_request_buffering off; } access_log /var/log/nginx/zabbix.access.log main; error_log /var/log/nginx/zabbix.error.log warn; }这个配置将所有到达主机 80 端口的 HTTP 请求转发到zabbix-web容器的 8080 端口Zabbix Web 镜像内部 Nginx 的默认端口。3.3 创建环境变量文件可选但推荐将敏感信息从docker-compose.yml中分离出来是安全最佳实践。创建环境变量文件# 在 env 目录下创建文件 cat /opt/zabbix-docker/env/.env EOF MYSQL_DATABASEzabbix MYSQL_USERzabbix MYSQL_PASSWORDYourStrongPasswordHere MYSQL_ROOT_PASSWORDYourStrongRootPasswordHere ZBX_SERVER_HOSTzabbix-server DB_SERVER_HOSTmysql-server PHP_TZAsia/Shanghai EOF然后修改docker-compose.yml将environment部分改为引用环境变量文件并移除明文密码# 在每个服务的定义中修改 environment 部分例如 mysql-server: mysql-server: ... env_file: - ./env/.env environment: - MYSQL_DATABASE${MYSQL_DATABASE} - MYSQL_USER${MYSQL_USER} - MYSQL_PASSWORD${MYSQL_PASSWORD} - MYSQL_ROOT_PASSWORD${MYSQL_ROOT_PASSWORD} ...4. 启动服务与初始化验证所有配置文件准备就绪后就可以启动整个 Zabbix 监控栈了。4.1 启动所有容器在/opt/zabbix-docker目录下执行# 使用 Docker Compose 启动所有服务-d 表示后台运行 sudo docker compose up -d命令执行后Docker 会依次执行以下操作拉取所需的镜像如果本地不存在。创建zabbix-net网络。按照依赖顺序启动容器mysql-server-zabbix-server-zabbix-web-nginx-proxy。等待mysql-server健康检查通过后再启动zabbix-server和zabbix-web。4.2 检查服务状态与日志启动完成后使用以下命令检查服务状态# 查看所有容器的运行状态 sudo docker compose ps # 查看所有容器的日志实时滚动CtrlC 退出 sudo docker compose logs -f # 查看特定容器的日志例如查看初始化数据库的日志 sudo docker compose logs mysql-server如果一切正常你应该看到所有容器的状态都是Up (healthy)或Up。重点关注mysql-server和zabbix-server的日志确保没有报错。4.3 访问 Zabbix Web 界面完成安装打开浏览器访问你的服务器 IP 地址或配置的域名例如http://your-server-ip。欢迎页面: 你应该能看到 Zabbix 的欢迎页面检查所有前提条件PHP 扩展、权限等是否都为 “OK”。由于我们使用了官方 Docker 镜像这些条件通常都已满足。配置数据库连接:Database type:MySQLDatabase host:mysql-server(这是 Docker Compose 网络中的服务名容器内可解析)Database port:3306Database name:zabbixUser:zabbixPassword: 你在.env文件中设置的MYSQL_PASSWORD设置 Zabbix Server 信息:Host:zabbix-server(同样是服务名)Port:10051Name: 给你的 Zabbix 实例起个名字如 “Production Monitoring”。预览配置并完成安装: 确认信息无误后点击下一步系统会生成配置文件zabbix.conf.php并执行数据库初始化。最后你会看到安装成功的页面。登录: 默认的管理员用户名是Admin密码是zabbix。首次登录后请立即修改密码5. 基础监控配置与常见问题排查成功登录后你面对的是一个空白的监控系统。接下来我们需要添加第一台被监控主机。5.1 添加被监控主机Linux我们将监控运行 Zabbix Server 的这台主机自身。创建主机:导航到 “配置” - “主机” - “创建主机”。主机名称: 填写一个易于识别的名称如 “Zabbix-Server-Host”。可见名称: 同主机名称。群组: 选择 “Linux servers” 或新建一个群组。Agent 代理程序的接口:IP 地址: 填写 Zabbix Server 容器所在主机的物理 IP 地址不是127.0.0.1或容器 IP。因为 Agent 安装在物理主机上需要连接容器映射出来的端口10051。端口:10051(默认)。点击 “添加”。关联模板:在新建主机的 “模板” 标签页点击 “选择”。在链接的模板输入框中输入Linux选择 “Template OS Linux by Zabbix agent”。点击 “添加” - “更新”。在被监控主机上安装 Zabbix Agent: 回到你的 Linux 服务器终端不是容器内安装 Zabbix Agent。# 对于 RHEL/CentOS/Rocky Linux 8 sudo rpm -Uvh https://repo.zabbix.com/zabbix/7.0/rhel/8/x86_64/zabbix-release-7.0-1.el8.noarch.rpm sudo dnf clean all sudo dnf install zabbix-agent2 # 编辑 Agent2 配置文件 sudo vi /etc/zabbix/zabbix_agent2.conf找到并修改以下关键参数Server127.0.0.1,ZABBIX_SERVER_IP # 允许本地和 Zabbix Server IP 来采集数据 ServerActiveZABBIX_SERVER_IP # Zabbix Server 的 IP用于主动模式 HostnameZabbix-Server-Host # 必须与 Web 界面中创建的“主机名称”完全一致保存并退出然后启动 Agent2sudo systemctl enable --now zabbix-agent2 sudo systemctl status zabbix-agent2检查数据采集:回到 Zabbix Web 界面导航到 “监测” - “最新数据”。过滤器选择主机 “Zabbix-Server-Host”点击 “应用”。等待几分钟Zabbix 默认更新间隔你应该能看到系统 CPU、内存、磁盘、网络等监控项开始有数据涌入。5.2 部署过程常见问题排查即使按照步骤操作也可能遇到问题。以下是几个常见问题及其排查路径。问题现象可能原因检查方式处理建议访问http://server-ip无响应或连接被拒绝1. 容器未成功启动。2. 防火墙阻止了 80 端口。3. Nginx 配置错误。1.sudo docker compose ps查看容器状态。2.sudo firewall-cmd --list-ports或sudo iptables -L -n检查防火墙。3.sudo docker compose logs nginx-proxy查看 Nginx 日志。1. 根据日志修复容器启动错误。2. 开放防火墙端口sudo firewall-cmd --add-port80/tcp --permanent sudo firewall-cmd --reload。3. 检查nginx/conf.d/zabbix.conf语法。Zabbix Web 安装页面数据库连接失败1. MySQL 容器未就绪。2. 数据库连接参数错误主机名、密码。3. 数据库用户权限不足。1.sudo docker compose logs mysql-server查看 MySQL 启动日志。2. 进入 MySQL 容器测试连接sudo docker exec -it zabbix-mysql mysql -uzabbix -p。3. 检查.env文件中的密码是否与docker-compose.yml中一致。1. 等待 MySQL 健康检查通过healthy。2. 确保 Web 安装页面填写的 Database host 是mysql-server。3. 确认密码正确并检查zabbix用户是否有zabbix数据库的所有权限。主机状态显示为 “ZBX” 灰色不支持1. Agent 未安装或未运行。2.Hostname不匹配。3. 网络不通或防火墙阻止了 10050/10051 端口。1. 在被监控主机上执行systemctl status zabbix-agent2。2. 对比 Agent 配置文件的Hostname和 Zabbix Web 中的 “主机名称”。3. 从被监控主机telnet ZABBIX_SERVER_IP 10051测试端口连通性。1. 启动 Agent 服务。2. 确保Hostname严格一致区分大小写。3. 确保 Server 主机的防火墙放行了 10051 端口入站规则。监控项有数据但触发器未告警1. 触发器表达式阈值设置不当。2. 触发器处于“禁用”状态。3. 动作Action未配置或配置错误。1. 检查该监控项关联的触发器表达式。2. 在 “配置” - “主机” - “触发器” 中查看触发器状态。3. 检查 “配置” - “动作” 是否有相关动作以及动作的条件和操作。1. 根据业务需求调整触发器阈值。2. 启用触发器。3. 配置正确的动作包括条件如触发器“问题”、操作发送消息和恢复操作。5.3 生产环境部署最佳实践上述部署适用于学习和测试。若用于生产环境还需考虑以下方面数据持久化与备份:MySQL 数据: 我们已经通过volumes将数据挂载到主机./data/mysql。必须定期备份此目录。可以考虑使用mysqldump在容器内执行逻辑备份或使用文件系统快照。Zabbix 配置: 所有配置存储在数据库中备份数据库即备份配置。但自定义的脚本、媒体文件等也应纳入备份范围。安全性加固:密码: 使用强密码并定期更换。.env文件权限应设置为600。网络: 生产环境不应将 Zabbix Web80端口和 Server10051端口直接暴露在公网。应置于内网通过 VPN 或跳板机访问或至少配置 Nginx 的 SSL 证书和基础认证。Zabbix 用户权限: 在 Web 界面中遵循最小权限原则创建用户角色避免使用默认的Admin账户进行日常操作。性能与高可用:数据库分离: 对于大规模监控应将 MySQL 数据库部署在独立的、配置更高的服务器或集群上。使用 Zabbix Proxy: 如果监控节点超过500台或网络环境复杂强烈建议部署 Zabbix Proxy 进行分布式数据收集。调整历史数据存储策略: Zabbix 默认会保存所有监控项的详细历史数据和小时级的趋势数据。对于高频监控项这会导致数据库快速增长。需要在 “管理” - “一般” - “Housekeeping” 中合理设置历史数据和趋势数据的保留时长。日志与监控:收集容器日志: 将 Docker 容器的日志/opt/zabbix-docker/logs/接入统一的日志平台如 ELK。监控 Zabbix 自身: 创建一个名为 “Zabbix Server” 的主机使用 “Template App Zabbix Server” 和 “Template App Zabbix Proxy” 模板来监控 Zabbix 各组件的健康状态。通过以上步骤你已经完成了一个基于 Docker 的企业级 Zabbix 监控系统的搭建、基础配置和初步优化。这套架构清晰、易于维护为后续监控更多服务器、网络设备和应用服务打下了坚实的基础。真正的运维价值在于利用这套系统发现并解决潜在问题而不仅仅是搭建它。接下来你可以探索 Zabbix 的自动发现、低级自动发现、自定义监控项和可视化仪表盘等功能构建出贴合你业务需求的监控体系。
原理与工业实践)
