做运维这些年上监控系统是每个公司都绕不开的活儿。早期折腾过从源码编译、rpm 依赖逐个装的 Zabbix也踩过 LNMP 环境各种版本不兼容的坑。后来换到 Docker Compose 方式部署 Zabbix一次编排、整套环境拉起扩容、升级、备份都规整了很多给人的感觉确实不一样。这篇我来完整梳理一套我在多个生产环境里跑过的方案从镜像选型、Compose 编排、Web 初始化、加主机、接告警到常见故障排查每一步都讲清楚“为什么这么做”。如果你正在给公司搭监控或者想把已有的 Zabbix 环境重构成容器化可以直接参考这套流程。Zabbix 本身是成熟的企业级开源监控平台可以统一采集服务器、虚拟机、网络设备、数据库、中间件的指标再配合触发器做告警通知。Docker 的作用是把 Server、Web、数据库、Agent 这些组件拆成独立容器用一份 Compose 文件管理起来。这套组合解决的核心问题就是传统安装方式里组件多、依赖乱、迁移难、升级怕出事的痛点尤其适合中小团队用最少的成本搭建一套规范化的监控告警平台。下面我从方案选型开始讲。1. 为什么选 Docker Zabbix 这套组合1.1 传统部署方式有哪些让人头疼的地方Zabbix Server 的依赖链很长。底层要 PHP、Nginx 或 Apache、数据库MySQL 或 PostgreSQL加上一堆 PHP 扩展不同发行版的包名还不一样。CentOS 上装 Zabbix 常用的做法是配官方 rpm 源然后装 server、web、agent 几个包接着还要手动初始化数据库、导入 schema、配 PHP 时区、改 PHP 配置参数。这一套下来如果刚好碰上内网环境没法直接用在线源处理依赖能把人折腾到怀疑人生。更麻烦的是升级。Zabbix 大版本升级经常涉及数据库结构变更如果你手头是那种半手工装出来的环境目录散落、配置混乱升级前不敢动升级后出各种怪问题。而且一旦要迁移到新机器基本上等于重装一遍。还有组件之间的兼容性PHP 版本高了低了都可能让 Web 界面白屏或者图表不显示这类问题排查起来非常费时间。Docker 方案最大的变化是把这些脏活都封装进了镜像里。官方镜像已经处理好了 PHP 扩展、运行时环境、时区配置你要做的就是拉镜像、传环境变量、映射端口、挂载数据目录。组件之间的隔离和连接关系用网络配置和 Compose 依赖关系描述清楚一套标准化的部署模板可以重复使用。1.2 Docker 化之后的优势具体体现在哪首先是部署速度。一条 docker compose up -d 把数据库、Server、Web 全部拉起来正常情况下十几分钟就能有一台能用的 Zabbix Server比传统方式快很多。这在临时演示、POC 验证、测试环境搭建这些场景里非常实用。其次是升级和回滚。镜像有明确的 tag比如 alpine-6.0-latest、alpine-7.0-latest。升级时拉新 tag、改 Compose、重新创建容器数据库备份好就行如果新版有问题把 tag 改回去重新拉起就完成了回滚。对运维来说这个掌控感很重要。再就是迁移。数据都放在 Docker volume 里用 docker compose 导出的配置 数据卷备份迁移到新机器只要把相同文件放上去重新 up 就行。不需要在目标机器上重新装一遍底层依赖这对后续的容灾演练、环境复制帮助很大。1.3 什么场景适合这套方案我个人觉得Docker 部署 Zabbix 特别适合这几类场景一是新项目快速搭建监控不用在安装环节花太多时间二是已有的传统部署想低成本容器化改造三是想多环境并行测试、预发、生产保持配置一致四是团队对 Docker 有一定基础后续想接容器编排。如果你的网络环境里存在大量的存量监控项、自定义脚本、第三方模板迁移前还是需要做个全面评估脚本路径、外部命令依赖这些跟容器环境是有关联的这一点后面会展开讲。2. 部署前的基础准备工作2.1 主机资源与 Docker 环境要求Zabbix Server 对资源的要求取决于你监控的节点数。小规模几十台主机、几千个监控项2 核 4G 内存基本够用如果订阅数上百、历史数据保留时间长建议 4 核 8G 起步。数据库和 Server 都跑在同一台机器上时内存分配要留足。我见过很多兄弟图省事给虚拟机只分 2G 内存就跑生产 Zabbix过一阵子就触发内存告警最后还得迁移不如一开始就按预留 30% 余量来规划。Docker Engine 建议 20.10 以上Docker Compose 建议用 V2 版本的 docker compose 子命令。不要再用老掉牙的 docker-compose 也可以但新版命令更爽利配置文件格式建议用 3.8 版本或者干脆用 Compose V2 的默认格式。Linux 发行版没有强制要求Ubuntu 22.04、Debian 12、CentOS Stream、Rocky Linux 都可以。2.2 镜像选型与版本规划Zabbix 官方镜像有好几套组合核心是 Server 和 Web 镜像里的数据库驱动不同zabbix/zabbix-server-pgsqlServer 配套 PostgreSQLzabbix/zabbix-server-mysqlServer 配套 MySQLzabbix/zabbix-web-nginx-pgsqlWeb 前端 Nginx PHP PostgreSQL 驱动zabbix/zabbix-web-nginx-mysqlWeb 前端 Nginx PHP MySQL 驱动数据库也有两个选择PostgreSQL 和 MySQL。Zabbix 官方对 PostgreSQL 的优化支持更好一点尤其是处理复杂报表查询和分区表的时候PG 的扩展性和查询优化器更稳。我之前做过一次对比相同硬件下监控项上万之后 PG 的查询响应明显比 MySQL 平滑一些。如果你公司已经有 MySQL 运维体系选 MySQL 也没问题只是要留意分区表的维护策略。版本规划方面建议直接用 6.0 LTS 或 7.0 LTS。6.0 是上一代长期支持版生态环境成熟网上资料多7.0 是 2024 年发布的 LTS功能有挺多更新——界面改成 Angular、新增了业务服务仪表盘、告警配置也更灵活。如果没有特殊历史包袱直接上新 LTS 就行毕竟 LTS 维护期长不用频繁操心大版本升级。PostgreSQL 镜像我一般用 postgres:16-alpinealpine 版本体积小资源占用低。2.3 端口、数据目录与网络规划Zabbix 常用端口有这些提前规划清楚别跟宿主机已有服务冲突端口用途8080Web 界面我习惯映射成 8080也可以用 8010051Server 的 Trapper 端口Agent/Proxy 主动连它10050Agent 监听端口Server 主动连它采集数据10052Agent2 附加监听端口按需开启数据持久化是第一优先级。数据库容器里存了配置、历史数据、趋势数据容器一删数据就没了。我会单独建一个 Zabbix 用的 volume比如叫 zabbix-db-data挂载到 PostgreSQL 容器的 /var/lib/postgresql/data。Server 的配置、脚本如果后续要扩展外部告警脚本也可以挂载一个配置目录进去方便不改镜像就能加文件。网络方面Compose 会自动创建一个 bridge 网络几个服务通过服务名互相访问。如果你内网有特殊的 DNS 解析环境或者多个 Docker 网络之间需要互通提前想好。默认方案里Server 要能访问到数据库容器Web 要能访问到 Server 和数据库Agent 所在的宿主机要能访问到 Server 的 10051 端口。3. Docker Compose 编排部署 Zabbix3.1 一份可直接用的 Compose 文件直接上完整文件。我用的版本是 Zabbix 7.0 LTS数据库用 PostgreSQL 16容器编排用 Compose V2 风格services: zabbix-db: image: postgres:16-alpine container_name: zabbix-db restart: unless-stopped environment: POSTGRES_USER: zabbix POSTGRES_PASSWORD: zabbix_pwd_2026 POSTGRES_DB: zabbix volumes: - zabbix-db-data:/var/lib/postgresql/data networks: - zabbix-net zabbix-server: image: zabbix/zabbix-server-pgsql:alpine-7.0-latest container_name: zabbix-server restart: unless-stopped environment: DB_SERVER_HOST: zabbix-db POSTGRES_USER: zabbix POSTGRES_PASSWORD: zabbix_pwd_2026 POSTGRES_DB: zabbix ports: - 10051:10051 depends_on: - zabbix-db networks: - zabbix-net zabbix-web: image: zabbix/zabbix-web-nginx-pgsql:alpine-7.0-latest container_name: zabbix-web restart: unless-stopped environment: ZBX_SERVER_HOST: zabbix-server DB_SERVER_HOST: zabbix-db POSTGRES_USER: zabbix POSTGRES_PASSWORD: zabbix_pwd_2026 POSTGRES_DB: zabbix PHP_TZ: Asia/Shanghai ports: - 8080:8080 depends_on: - zabbix-server - zabbix-db networks: - zabbix-net volumes: zabbix-db-data: networks: zabbix-net: driver: bridge我把版本号和镜像 tag 都写成了 7.0 LTS 的 latest 系列实际使用时你可以根据自己的 LTS 选择改成 6.0 对应 tag。注意密码别用我占位符里这种弱密码生产环境至少换成长随机串后面还要提一句数据库账号权限的重要性。3.2 这些环境变量分别控制什么PostgreSQL 容器的 POSTGRES_USER、POSTGRES_PASSWORD、POSTGRES_DB决定了初始数据库、用户和密码。注意这三个值必须和 Zabbix Server、Web 里配置的完全一致很多新手栽在这里三个容器各写各的最后 Web 初始化连不上数据库。Zabbix Server 的 DB_SERVER_HOST 告诉它数据库容器的地址。在同一个 Docker 网络里直接用服务名 zabbix-db 就能解析到。如果你数据库不在 Docker 里而是在宿主机或者远程机器上改成对应的 IP 或域名但要注意网络连通性和防火墙。Zabbix Web 的 ZBX_SERVER_HOST 指向 Server 容器名 zabbix-serverPHP_TZ 用来设置 Web 界面 PHP 时区不设的话可能出现告警时间和北京时间差 8 小时的问题。这个坑比较隐蔽所以我在 Compose 里提前写好了。3.3 启动操作与验证写好 docker-compose.yml 之后在同目录下执行docker compose up -d第一次会拉取镜像时间取决于网络。启动完成后用下面几个命令检查状态docker compose ps docker compose logs -f zabbix-server docker compose logs -f zabbix-web正常的日志里Server 会打出一行类似 “enabled Zabbix server” 和数据库连接正常的提示。Web 日志会显示 Nginx 和 PHP-FPM 启动成功。如果某一步报错往下翻到第 7 节。数据卷创建好之后后续重启、升级容器都不会丢数据库数据。需要备份时直接对 zabbix-db-data 做快照或者用 pg_dump 导出逻辑备份都可以。4. Web 初始化与基础配置4.1 首次打开 Web 界面完成初始化浏览器访问 http://你的服务器IP:8080进入 Zabbix 安装向导。第一步是检查前置条件确认 PHP 环境、数据库连接、目录权限都没问题有问题的话界面会直接标红列出原因。接着让你填数据库连接信息这里填你 Compose 里配置的那套 PostgreSQL 账号密码和数据库名主机写数据库容器名或者映射后的 IP 都行。如果之前把数据卷挂载好了这一步一般一次过。初始化完成后进入登录页默认账号是 Admin默认密码是 zabbix。进入系统后第一件事就是改密码这是安全检查项别拖着。改密码路径右上角头像 → User settings → 密码。4.2 把界面切换成中文Zabbix 7.0 的 Web 界面默认是英文想切成中文点击右上角的人头像进入 User settings找到 Language 选项选 Chinese (zh_CN)保存后刷新页面就是中文界面了。Zabbix 的中文翻译整体完成度挺高除了少数模板描述和文档内容还是英文日常使用没太大障碍。有些老版本还需要在 Administration → General → User settings 里开启默认语言7.0 直接支持用户在个人设置里覆盖方便多了。4.3 初始化后的几个必要全局设置先改时区。Administration → General → Timezone选 Asia/Shanghai和容器里的 PHP_TZ 保持同步避免告警时间差 8 小时。然后是配置历史数据保留策略。Administration → General → Housekeeping这里定义历史数据history和趋势数据trends保留多少天。历史数据保留 30~90 天、趋势数据保留 365 天是比较常见的组合具体看你的磁盘空间。历史数据表是监控系统膨胀的元凶保留策略一定要根据业务重要程度来定别舍不得删。最后看默认的用户组权限。Zabbix 默认的 Guests 组对某些页面是只读可见的如果你的监控平台是公司内部多人访问建议统一通过用户组管理权限不要直接改默认账号权限。5. 添加第一台被监控主机5.1 Agent 方式接入 Linux 主机被监控主机上需要安装 Zabbix Agent然后配置 Server 地址。Linux 上常见的安装方式是通过官方源装 zabbix-agent安装完成后编辑 /etc/zabbix/zabbix_agentd.conf重点改两个参数Server你的Zabbix Server IP这是被动模式下 Server 主动连 Agent 查数据用的要填 Server 实际 IPServerActive你的Zabbix Server IP这是主动模式下 Agent 主动上报用的要填 Server 实际 IPHostname主机的唯一标识名修改完执行 systemctl restart zabbix-agent。然后在 Zabbix Web 端数据采集 → 主机 → 创建主机填主机名要和 Agent 配置里的 Hostname 一致IP 地址填被监控机的 IP端口填 10050。关联模板Linux 主机直接关联 Template OS Linux by Zabbix agent这个模板里涵盖了 CPU、内存、磁盘、网络、系统负载等几十项监控项。5.2 主动模式与被动模式怎么选简单理解被动模式下Server 主动连 Agent 的 10050 端口抓数据主动模式下Agent 定期主动找 Server 的 10051 端口上报数据。被动模式适合小规模、网络简单的环境排查问题时可以直接用 zabbix_get 手动拉取数据主动模式适合大规模或者中间有 NAT、防火墙限制不好做 Server 到 Agent 回连的场景因为连接方向是从 Agent 往 Server 发出方向普遍放行。两种模式可以同时启用。我生产环境的习惯是Agent 同时配置 Server 和 ServerActive以此兼顾主动上报和问题排查。要注意主动模式需要正确设置 Hostname因为 Agent 上报数据时是靠 Hostname 找到对应主机的。5.3 接 Windows 主机、交换机和 Oracle 数据库Windows 主机之前有人问 Zabbix 监控 Windows GPU原生模板确实不覆盖 GPU 指标需要安装厂商的 exporter 或者用 PowerShell 脚本采集 nvidia-smi 的输出再自定义监控项。如果只是终端服务器基本的 CPU/内存/磁盘/网络指标官方有 Template OS Windows by Zabbix agent安装 Zabbix Agent2 for Windows 后关联模板即可。Agent2 安装包是图形界面的安装时填一下 Server 地址和 Hostname 就行很简单。交换机走 SNMP。先给交换机配置 SNMP 只读团体名比如 snmpwalk 能读到数据然后在 Zabbix 主机配置里把 SNMP interfaces 加上关联 Generic by SNMP 模板或者对应厂商的模板华为、H3C、思科都有社区模板。SNMP 版本优先用 v2c如果设备支持 v3 则用 v3 安全性更强。端口默认 161。Oracle 数据库这是很多人在热搜词里问到的。Oracle 监控有两条主流路线一条是装 Zabbix Agent 之后通过脚本调用 sqlplus 采集表空间、会话数、事务量把数据交给 Agent 上报另一条是走 ODBC 方式Zabbix Server 直连 Oracle关联 Oracle by ODBC 模板。ODBC 方式对 Server 有额外依赖需要在 Server 容器里装 Oracle Instant Client 和 ODBC 驱动稍微复杂但自动化程度高。小规模环境我更推荐 Agent 脚本方式可控性强不用改 Server 镜像。5.4 监控项、触发器和模板的关系简单说监控项负责采集数据比如 CPU 使用率触发器负责判断异常比如 CPU 使用率 90% 持续 5 分钟模板是把一批监控项、触发器、图表、告警动作打包成一个可复用的单元。所以接入新主机最省力的方式就是找一个合适的模板关联上去不用手动一个个创建监控项。如果模板里的监控项不全比如你还需要监控某个自定义进程、某个日志文件的大小那就可以在主机上手动添加监控项。日志监控会用 log[] 这个 key注意 Agent 要开启 log 文件的读取权限路径权限不到位也读不到。6. 配置告警通知6.1 邮件告警的完整配置流程告警通知是监控平台的核心价值不然墙上的大屏再好看出了问题没人知道也白搭。邮件告警是最基础的方式Zabbix 配置分三步第一步是配告警媒介。Administration → Media types → Email。SMTP 服务器填你公司邮箱的 SMTP 地址比如企业邮箱常见的 smtp.exmail.qq.com端口 465SSL或 587STARTTLS然后填发送账号和密码/授权码。Zabbix 7.0 的邮件媒介界面上还能直接勾选 SSL 和 STARTTLS比老版本好用。注意很多邮箱需要开启 SMTP 授权码直接用登录密码会提示认证失败。第二步是给用户加告警媒介。Administration → Users → 对应用户 → Media → Add选择 Email 媒介填接收邮箱地址设置发送时间段建议 7x24和告警级别。第三步是配动作。Alerts → Actions → Trigger actions → Create action。在 Actions 的 Conditions 里加触发条件比如触发器严重程度 警告在 Operations 里选发送给哪个用户组介质类型选 Email。这样触发器被触发后就会自动发邮件到指定人。6.2 邮件收不到的排查顺序邮件告警最常碰到“Zabbix 显示发送成功但就是收不到”的情况。我建议按这个顺序排查先看 Zabbix UI 的 Reports → Action log确认动作是否执行、发送是否成功再查邮箱垃圾箱有时候会被反垃圾规则拦掉然后 telnet SMTP 端口试试连通性有时候服务器出方向 25/465/587 被限制了最后检查发件人域名是否有 SPF/DKIM 记录部分严格的反垃圾策略会把没有 SPF 记录的邮件直接拒收。6.3 用 Webhook 接钉钉、企业微信告警团队现在很少用纯邮件通知钉钉群和企业微信机器人是更刚需的通道。Zabbix 7.0 的告警媒介类型里直接内置了 Webhook 模式不需要像老版本那样写一堆外部脚本。我以前在 5.0 时代是拿 Python 脚本 zabbix_sender 实现的容器化之后还要考虑脚本挂载的问题。7.0 内置 Webhook 之后省事很多告警媒介里选 Webhook填入钉钉自定义机器人的 Webhook 地址消息模板里可以引用 {ALERT.MESSAGE}、{ITEM.NAME}、{EVENT.SEVERITY} 这些宏。配置好之后触发器一触发钉钉群就会收到告警卡片。企业微信的机器人原理类似区别是消息类型和密钥校验。我建议不要一次接太多通道先把邮件和钉钉两个渠道跑顺再考虑是否加电话告警这类付费服务。6.4 告警级别的合理规划很多人接到告警通知后发现被轰炸了——阈值设得太低、持续时间太短什么波动都发一遍。我的经验是触发器一定要设持续时间。比如 CPU 使用率 90% 持续 5 分钟网络丢包 5% 持续 3 分钟过滤掉瞬时抖动的噪音。另外给告警分级别信息Information、警告Warning、严重Average、高High、灾难Disaster不同级别对应不同的通知渠道和值班策略。7. 常见问题与排查技巧实录7.1 “Zabbix server is not running: the information displayed may not be current.”这是 Zabbix Web 界面顶部经常出现的红色警告意思是 Web 连不上 Server 进程界面显示的数据可能不是最新的。拿这个标题去搜网上十有八九有人问过。先别急着怀疑数据库按顺序查第一docker compose ps 看 Server 容器是否在运行如果 Exited 了docker compose logs zabbix-server 看崩溃原因。最常见是数据库连不上比如 DB_SERVER_HOST 写错、密码不对日志里会直接打 Postgre 连接的报错。第二如果容器在跑但 Web 还报这个错检查 Server 的 10051 端口是否监听正常。可以进 Web 容器里执行docker exec -it zabbix-web bash nc -zv zabbix-server 10051第三确认 Server 容器的时区和数据库时区是否一致有时候是时间偏移导致内部心跳检查失败。设置好环境变量后重启容器一般能解决。7.2 “Access denied for user replace_userlocalhost (using password: YEs/N0)”这个报错字面意思是数据库访问被拒绝注意报错里那个 replace_user很多集成包里用 sed 占位符替换配置参数如果没替换干净就把字符串 replace_user 原样写进去了。遇到这个先别慌检查两处第一Web 初始化阶段填的数据库用户名、密码、数据库名必须和 PostgreSQL 容器的 POSTGRES_USER、POSTGRES_PASSWORD、POSTGRES_DB 完全一致。PostgreSQL 对大小写敏感别手滑多打空格。第二如果你是在已有的数据库实例上复用要确保那个用户存在且权限足够。建议用初始化的专有账号或者在数据库里执行ALTER USER zabbix WITH PASSWORD 强密码; GRANT ALL PRIVILEGES ON DATABASE zabbix TO zabbix;7.3 Docker 镜像下载慢或超时镜像下载慢是国内 Docker 用户的老问题。Zabbix 官方镜像体积不小第一次拉的时候如果速度很慢可以给 Docker 配置镜像加速器。Linux 下编辑 /etc/docker/daemon.json{ registry-mirrors: [https://docker.m.daocloud.io] }然后重启 Docker 服务再拉取。注意不同镜像加速商的稳定性和速度会有差异多试几个。另外如果你要长时间保存镜像 tar 包建议用 docker save 把镜像归档方便离线环境导入。7.4 Agent 显示不可达或者没数据主机页面显示“Zabbix agent on X.X.X.X is unreachable”最常见的几个原因被监控机器防火墙没放行 10050 端口Agent 配置文件里 Server 地址填的不是 Zabbix Server 的 IPHostname 配置不一致主动模式下尤其明显。排查时先在被监控机上执行zabbix_get -s 127.0.0.1 -p 10050 -k agent.ping能返回 1 说明 Agent 本地正常。然后再测试从 Server 容器去连docker exec -it zabbix-server bash zabbix_get -s 被监控机IP -p 10050 -k agent.ping从哪个方向通不了就查哪段的网络和安全组思路很清晰。7.5 告警通知发不出的快速自查告警动作没触发、或者触发了但通知没发先看 Reports → Action log里面会有每次动作的执行记录和报错。常见的问题有告警媒介里发的账号密码不对、接收人没有关联告警媒介、动作的触发条件设置得过于严格比如只在特定主机组触发而你的主机不在那个组里。如果日志显示发送成功但没收到回到第 6.2 节那个排查顺序。7.6 数据备份与恢复经验容器化部署之后备份极其重要。Zabbix 的数据都在这几个地方数据库PostgreSQL、配置文件Compose 文件和挂载目录、外部脚本如果有。只备份数据库不备份配置恢复时还要重新写 Compose只备份容器不备份数据卷容器删了照样完蛋。我常用两套备份策略一是文件系统级快照对 zabbix-db-data 卷做定时快照适合快速恢复整机数据二是逻辑备份定期执行docker exec zabbix-db pg_dump -U zabbix zabbix zabbix_backup.sql前者恢复快后者更灵活可以只恢复某张表。建议两者结合备份文件放到另一台机器或对象存储上别跟监控系统放同一块盘。8. 后续扩展建议这套 Docker 部署方案稳定运行之后有几个方向可以继续扩展。一是用 Zabbix Proxy 代理采集数据适合跨机房、多分支的场景Proxy 可以缓存采集数据再集中上报减少对主 Server 的网络压力。二是对接 Grafana把 Zabbix 的指标数据用 Grafana 做更炫的自定义大屏Zabbix 自带的大屏功能偏保守Grafana 的灵活度和美观度更好。三是做健康检查脚本比如用 cron 定期检查 Docker 容器状态容器异常重启过就通知到人起码保证监控平台本身先活着。个人实际操作中的一点体会刚开始切到 Docker 部署时我对容器里的文件持久化特别不放心总觉得要把配置目录挂出来才踏实。后来发现只要把数据库卷和数据备份这两件事做扎实容器的不可变是优势不是劣势——配置错了改 Compose 重新拉一个实例就行。还有一点建议所有环境变量、密码、脚本文件都放到 Git 里管起来换机器时 Clone 仓库改几个 IP 就能重建整套环境这个习惯越早养成受益越大。Zabbix 这套东西本身不难难的是让它持续稳定地跑在业务前面。