简介面向CentOS 7.9运维环境这份Zabbix 6.0 LTS部署文档适合需要搭建自建监控平台的系统管理员、运维工程师和入门学习者。全文以源码方式给出Zabbix Server与Agent 6.0.12的完整安装流程并串联Nginx 1.20.2、PHP 7.4.30、MySQL 8.0.28等核心组件的编译与配置涵盖SELinux关闭、依赖安装、Nginx隐藏版本号、systemd开机自启及自启动服务文件示例等关键操作。资源包共1个docx文档大小约257KB内容结构化记录从环境准备、用户创建、数据库初始化到Web访问验证的每一条命令和配置片段步骤间配有代码块与必要说明便于对照执行和排错。文档还写明了Nginx配置文件修改位置与Zabbix Server参数设定适合初次接触源码部署、希望理解组件间配置关系的读者直接作为实战参考手册。已有4194人学习/下载可满足常用监控场景下的快速落地需求。1. CentOS 7.9 上装 Zabbix 6.0 LTS先卡在 PHP 和数据库版本上CentOS 7.9 安装 Zabbix 6.0 LTS很多人拿 5.0 的旧教程直接照搬结果第一步就翻车6.0 要求 PHP 7.2 以上而 7.9 系统自带的 PHP 5.4 根本不够数据库要求也高了一截默认的 MariaDB 5.5 官方明确不支持。这篇笔记把从换 yum 源、解决 PHP 版本、装 MariaDB 10.5、初始化数据库、启动 server到 Web 前端出现的完整流程过一遍顺手把 SELinux、时区、API 验证和告警手动处理这些落地必碰的点都说明白。适合正在给内部服务器搭监控、不想在旧教程里浪费时间的人照这个顺序装基本一遍过。2. 环境准备yum 源、SELinux 和 PHP 7.4少一步后面都白搭2.1 先换 yum 源阿里 base、epel、remi 一次配齐国内服务器直接连官方源经常慢到怀疑人生我一般先把 base 源和 epel 源都切成阿里镜像。CentOS 7.9 的 base 源只需要下载阿里的 CentOS-7.repo 覆盖默认文件epel 源用 rpm 装阿里镜像的 release 包即可。这一步不做后面装 Zabbix 依赖包时等得你想砸键盘。mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.bak curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-7.repo yum install -y epel-release yum clean all yum makecacheCentOS-Base.repo.bak 留着是后悔药万一源配错还能切回去。阿里镜像的 epel-release 和官方 epel 内容一致只是下载路径在国内速度差别明显。这里有个小细节CentOS 7 默认源里epel是没启用的必须单独装 release 包直接yum install epel-release走的就是 base 源里的 epel-release国内网络环境下没问题。接下来是 Zabbix 官方仓库和 remi 仓库。Zabbix 6.0 的 rpm 包在官方仓库里装完 release 包后 repo 文件指向 repo.zabbix.com为了下载快我会把 baseurl 改成阿里的 zabbix 镜像。remi 仓库则是为了拿 PHP 7.4这一步直接决定了后面能不能装上 Zabbix 6.0。rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/7/x86_64/zabbix-release-6.0-4.el7.noarch.rpm rpm --import https://repo.zabbix.com/RPM-GPG-KEY-ZABBIX sed -i s#repo.zabbix.com#mirrors.aliyun.com/zabbix#g /etc/yum.repos.d/zabbix.repo yum install -y https://mirrors.aliyun.com/remi/enterprise/remi-release-7.rpm yum install -y yum-utils yum-config-manager --enable remi-php74 yum clean all yum makecache解释一下这几个动作zabbix-release只负责往 /etc/yum.repos.d/ 里写仓库文件不是 Zabbix 本体sed替换 baseurl 是为了走阿里镜像remi-release-7.rpm装完后默认启用 remi 主仓库还要单独yum-config-manager --enable remi-php74把 PHP 7.4 的仓库打开否则 remi 源里默认 PHP 版本还是偏旧。yum-utils提供 yum-config-manager 命令这个包本身也在 base 源里先装不亏。2.2 SELinux 与防火墙先放开 80 和 10051 等端口Zabbix 的 Web 前端要跑 httpd 的 80 端口zabbix-server 要监听 10051agent 主动上报也要连 server 的 10051。CentOS 7 默认防火墙是 firewalld直接加端口规则别动不动就 systemctl stop firewalld生产环境这样干容易给自己挖坑。firewall-cmd --permanent --add-port80/tcp firewall-cmd --permanent --add-port10051/tcp firewall-cmd --permanent --add-port10050/tcp firewall-cmd --reload firewall-cmd --list-ports10050 是 agent 被动模式的监听端口如果只用主动模式可以不开但我在排查问题时常需要临时开一下索性一并用--add-port加进去。--reload之后用--list-ports确认三条规则都在这一步防止后面端口不通时瞎猜。SELinux 是另一大坑。Zabbix 官方文档明确要求开启 SELinux 时设置httpd_can_connect_zabbix这个布尔值否则 httpd 连不上 zabbix-server前端会一直报 server 不可达。如果只想快速验证可以临时setenforce 0但生产环境建议保持 Enforcing只放开必要布尔值。setsebool -P httpd_can_network_connect 1 setsebool -P httpd_can_connect_zabbix 1 2/dev/null || true getenforce-P参数让策略永久生效重启不丢。httpd_can_network_connect控制 httpd 能否向外发起 TCP 连接连数据库和 zabbix-server 都需要httpd_can_connect_zabbix是 Zabbix 文档里专门提到的布尔值部分内核版本里没有这个项所以加了|| true防止命令报错中断脚本。最后getenforce看一眼当前状态如果是 Enforcing 且上述命令没报错就说明策略放开了。2.3 PHP 版本为什么是 6.0 的分水岭Zabbix 6.0 前端依赖 PHP 7.2官方文档推荐 7.2 到 7.4 之间。CentOS 7.9 自带的是 PHP 5.4直接装 zabbix-web-mysql 会报依赖冲突yum 甚至会尝试把 PHP 5.4 的一堆包拉进来装完前端全是白屏。所以要先把 PHP 7.4 的环境准备好。装 PHP 7.4 的方式有两条路用 remi 仓库或者用 Red Hat 的 Software Collectionsrh-php72。我习惯用 remi因为国内的阿里镜像有完整的 remi 仓库yum install php php-fpm装完后版本就是 7.4不需要额外改 httpd 的解析器配置。SCL 的方式需要额外管理scl enable环境对新手不够友好。yum install -y php php-fpm php-bcmath php-gd php-mbstring php-xml php-ldap php-mysqlnd php -v systemctl enable --now php-fpm ss -lntp | grep 9000php-mysqlnd是前端连数据库的驱动缺了它安装向导会提示 pdo_mysql 未启用php-bcmath、php-gb是 Zabbix 前端画图和计算依赖的扩展漏装会在安装向导的检查页里红一片。ss -lntp | grep 9000确认 php-fpm 在监听 9000 端口Zabbix 6.0 的 httpd 配置默认通过 fastcgi 代理到 127.0.0.1:9000php-fpm 没起来后面访问前端就是 503。这里还容易踩一个坑httpd 装好后/etc/httpd/conf.d/zabbix.conf是 Zabbix 包自带的里面已经写好了 PHP 转发规则不需要手动改。很多人上网搜教程改了一堆 httpd 配置结果越改越乱其实确认 php-fpm 在跑就行。3. 服务端安装从 MariaDB 10.5 建库到 zabbix-server 单机跑起来3.1 换 MariaDB 10.55.5 装不了 Zabbix 6.0Zabbix 6.0 官方对数据库版本有明确要求MySQL 5.7/8.0或者 MariaDB 10.5/10.6。CentOS 7.9 默认是 MariaDB 5.5导入官方 create.sql.gz 时虽然不一定立刻报错但后期跑聚集查询、分区表维护时会出现各种怪问题。我在测试环境试过一次建表能过但 web 前端显示历史数据时卡顿明显后来直接换 10.5 重装。MariaDB 10.5 的 yum 仓库配置如下我用的清华镜像cat /etc/yum.repos.d/mariadb.repo EOF [mariadb] name MariaDB baseurl https://mirrors.tuna.tsinghua.edu.cn/mariadb/yum/10.5/centos7-amd64 gpgkey https://mirrors.tuna.tsinghua.edu.cn/mariadb/yum/RPM-GPG-KEY-MariaDB gpgcheck 1 EOF yum install -y MariaDB-server MariaDB-client systemctl enable --now mariadbbaseurl指向清华的 MariaDB 10.5 编译包目录仓库自带 repodatagpgcheck1会校验签名如果 rpm 报 key 问题就先rpm --import https://mirrors.tuna.tsinghua.edu.cn/mariadb/yum/RPM-GPG-KEY-MariaDB再装。装完是 mariadb 10.5 的版本号mysql --version应该能看到 10.5 字样。需要留意的是系统里如果已经装了老版本 mariadb 5.5先yum remove -y mariadb-server mariadb清掉再装 10.5否则两个版本共存在 rpm 层面会打架。数据目录 /var/lib/mysql 如果被旧版本初始化过直接把目录清空再启动新版本避免 inode 格式不兼容导致起不来。3.2 建库授权与导入 schema三个细节别搞错数据库起来后建库和授权直接决定 Zabbix 能不能连上。字符集用 utf8mb4排序规则用 utf8mb4_bin这是 Zabbix 官方推荐配置乱改排序规则后面做字符串匹配时会出幺蛾子。mysql -uroot -pCREATE DATABASE zabbix CHARACTER SET utf8mb4 COLLATE utf8mb4_bin; CREATE USER zabbix127.0.0.1 IDENTIFIED BY YourPassword; GRANT ALL PRIVILEGES ON zabbix.* TO zabbix127.0.0.1; GRANT ALL PRIVILEGES ON zabbix.* TO zabbixlocalhost; FLUSH PRIVILEGES;创建用户时分了 127.0.0.1 和 localhost 两条记录是因为 Zabbix server 和前端连接数据库时一个走 TCP 到 127.0.0.1一个可能走 socket 解析成 localhostMySQL 对这两个来源按不同的 host 匹配用户。只建其中一条后面大概率会遇到 one of them 连接被拒的尴尬。密码别用太简单的生产环境至少 12 位混合。授权完成后导入官方 schema 文件。这个文件是 gzip 压缩的直接用 zcat 管道给 mysql 命令zcat /usr/share/doc/zabbix-server-mysql*/create.sql.gz | mysql -uzabbix -pYourPassword zabbix/usr/share/doc/zabbix-server-mysql*/这个通配路径在装完 zabbix-server-mysql 包后才会出现里面只有 create.sql.gz 一个文件。导入过程大概十几秒到一分钟取决于机器性能。如果这里报语法错误九成是数据库版本还是 5.5回去执行 3.1 的步骤换 10.5如果报权限错误检查上面两条 GRANT 是否都执行了。3.3 zabbix-server.conf 关键参数DBPassword 不配服务起不来装包和改配置是连在一起的我会一口气把 zabbix-server-mysql、zabbix-web-mysql、zabbix-agent 三个包装掉再统一配置。装包命令如下PHP 依赖会自动从 remi 拉取。yum install -y zabbix-server-mysql zabbix-web-mysql zabbix-agent装完后重点改 /etc/zabbix/zabbix_server.conf。这个文件里大部分参数是注释掉的默认值真正必须改的是数据库连接那几项。用 vim 打开搜索 DB 开头的行vim /etc/zabbix/zabbix_server.confDBHost127.0.0.1 DBNamezabbix DBUserzabbix DBPasswordYourPasswordDBHost写 127.0.0.1 而不是 localhost是为了让 zabbix-server 走 TCP 连 MariaDB与建库时授权的 host 保持一致。DBName、DBUser、DBPassword对应 3.2 里创建的库和账号。这里有个血泪教训zabbix_server.conf 的 DBPassword 默认是注释状态很多人忘了解注释然后 server 启动后日志里反复报cannot connect to database实际上根本不是网络问题就是密码没写进去。改完启动服务并观察日志systemctl enable --now zabbix-server tail -f /var/log/zabbix/zabbix_server.log正常启动的日志最后会停在监听相关输出类似listener started或者直接停在using configuration file然后进程驻留后台。用ss -lntp | grep 10051确认 10051 端口在监听。日志如果出现database is down或者cannot connect先把数据库账号那段配置逐项核对这是最高频的启动失败原因。另外两个可以顺手看一眼的参数StartPollers和CacheSize。单机小规模监控保持默认即可别一上来就调大反而增加数据库压力。等监控项数量超过两千再考虑调这些。3.4 初始化前端配置装完 server 不等于装完前端zabbix-web-mysql 包装完后httpd 的虚拟目录和 PHP 转发规则已经就位但前端配置文件还没有生成。第一次访问 http://服务器IP/zabbix 会进入安装向导向导第一步检查 PHP 环境第二步填数据库连接第三步设置时区。这里的数据库连接信息要和 zabbix_server.conf 里保持一致。systemctl enable --now httpd systemctl status httpdhttpd 启动后确认 80 端口在监听。此时如果 php-fpm 没跑访问 /zabbix 会直接 503如果跑了但 PHP 版本还是 5.4会看到依赖检查页大片红色。这两种情况都回到第 2 章处理。4. Agent 与前端配置装完不等于能用时区和端口都要核对4.1 agent 配置Server、Hostname 和被动模式的三个参数Zabbix agent 的配置文件是 /etc/zabbix/zabbix_agentd.conf。被监控主机上装完 agent 后要改的核心参数就三个Server允许谁来采数据、ServerActive主动上报给谁、Hostnameagent 上报时的名字必须在 Zabbix 前端的主机名一致。分不清这三个参数的大有人在我原来也在这里迷糊过。vim /etc/zabbix/zabbix_agentd.confServer10.0.0.5 ServerActive10.0.0.5 Hostnameweb01Server10.0.0.5表示允许 Zabbix server 从 10.0.0.5 发起被动采集agent 监听 10050 端口等待请求ServerActive10.0.0.5表示 agent 主动向 10.0.0.5 的 10051 端口上报数据主动模式适合 agent 在 NAT 后面、server 无法直接访问的场景。Hostnameweb01必须和前端添加主机时填的名字一字不差否则主动模式的数据到了 server 端匹配不到主机所有监控项都会显示不支持。改完重启 agentsystemctl enable --now zabbix-agent systemctl restart zabbix-agent tail -f /var/log/zabbix/zabbix_agentd.log日志里出现active checks开头的行说明主动模式已建立连接。此时可以在前端添加主机填上 agent 的 IP 和 Hostname然后链接Linux by Zabbix agent模板两分钟后就能看到 CPU、内存等数据。4.2 前端安装向导数据库连接填 127.0.0.1别填 localhost浏览器打开 http://服务器IP/zabbix进入安装向导。这里有两个看似不起眼的决定最影响后续使用数据库 host 填 127.0.0.1时区选 Asia/Shanghai。数据库连接那一步如果填 localhostPHP 会尝试走 Unix socket 连接而 MariaDB 的 socket 默认只允许 root 或特定用户访问zabbix 用户很可能被拒。填 127.0.0.1 强制走 TCP与第 3 章授权保持一致最省心。端口默认 3306填库名 zabbix用户名 zabbix密码用第 3 章设置的。向导最后一步会让选 PHP timezone这里直接选Asia/Shanghai。很多人忽略这一步装完发现图表时间全是 UTC差八个小时这就是根因。4.3 php-fpm 时区与前端显示八十的坑为什么普遍安装向导走完后Zabbix 前端会生成 /etc/zabbix/web/zabbix.conf.php里面保存了数据库连接信息。但这个文件不会写时区前端实际用的时区是 PHP-FPM 进程的 date.timezone。所以除了向导里选还要改 PHP 配置文件双保险。sed -i s/;date.timezone /date.timezone Asia\/Shanghai/ /etc/php.ini systemctl restart php-fpmPHP 7.4 的 php.ini 里 date.timezone 默认是注释状态sed直接替换成 Asia/Shanghai。重启 php-fpm 后再看前端右上角的时钟应该是北京时间。这一步做完再去监控页看历史数据横轴时间就和墙上的钟对得上了。再检查一下 /etc/zabbix/web/zabbix.conf.php 的权限确保 apache 用户可读。这个文件是安装向导自动生成的正常情况下权限是 644如果之前手动改过导致 httpd 读不了前端会报配置错误。5. 常见问题排查Zabbix 6.0 落地必踩的六个坑5.1 前端打不开或报 PHP 版本过低现象访问 /zabbix 页面空白或安装向导的依赖检查页里 PHP 版本一栏红色提示需要 7.2.0 以上。原因系统自带的 php 5.4 还在生效remi 的 php74 仓库没启用或者 php-fpm 服务根本没起来。解决先php -v看版本不是 7.4 就去执行第 2.3 节的yum-config-manager --enable remi-php74然后重装 php 系列包如果版本对但页面空白systemctl status php-fpm看进程再用ss -lntp | grep 9000确认端口。我遇到过 php 包装好了但 php-fpm 没 enable导致 httpd 代理到 9000 端口超时前端一直转圈。5.2 安装向导卡在 “zabbix server is not running”现象前端向导全部填完最后一步提示 Zabbix server 未运行但实际上 server 进程是启动状态。原因这个提示其实是前端连不上 zabbix-server 的 API最常见原因是数据库密码没写进 zabbix_server.confserver 启动后在反复重连数据库对外表现就是服务未就绪。解决tail -n 50 /var/log/zabbix/zabbix_server.log如果看到cannot connect to database回第 3.3 节检查DBPassword是否取消注释如果日志里有cache相关错误那就是内存配置太小调大CacheSize。这个坑我踩过两次每次都是密码没配对日志一翻就明白了。5.3 数据库连接报错 Access denied现象前端向导填完数据库信息提示Access denied for user zabbix...。原因MySQL/MariaDB 对 localhost 和 127.0.0.1 是两种不同的 host 匹配规则只授权了其中一个另一个来源被拒。解决回到 3.2 节的 GRANT 命令把zabbix127.0.0.1和zabbixlocalhost两条授权都执行一遍然后FLUSH PRIVILEGES。同时检查 zabbix_server.conf 的 DBHost统一写成 127.0.0.1避免混乱。5.4 图表时间显示 Universal Time差八个小时现象监控图表横轴时间比本地时间晚 8 小时数据点位置也不对早上看的图横坐标还在半夜。原因php.ini 的 date.timezone 没设置或者安装向导时 PHP timezone 选了默认的 UTC。Zabbix 前端图表时间由 PHP 决定PHP 时区是 UTC所有时间就按 UTC 显示。解决在安装向导里重新检查时区设置同时执行第 4.3 节的sed命令改 php.ini重启 php-fpm 后再看。改完之后记得清一下浏览器缓存旧页面可能还缓存着 UTC 时间戳。5.5 SELinux 拦截导致数据不采集或页面 502现象agent 已经配置好前端主机状态显示绿色但监控项全部“不支持”或者前端页面间歇性 502。原因SELinux 默认限制 httpd 进程对外发起网络连接前端连不上 zabbix-server 的 APIagent 与被监控端的通信也被策略挡住。解决执行第 2.2 节的setsebool -P httpd_can_network_connect 1有条件的再执行httpd_can_connect_zabbix 1。改完systemctl restart httpd和zabbix-server再观察前端。如果只想快速验证是不是 SELinux 问题setenforce 0后如果马上恢复正常基本坐实。5.6 计划报表报错 “Report manager is disabled”现象打开 Reports → Scheduled reports页面提示Report manager is disabled.无法创建定时报表。原因Zabbix 6.0 的定时报表功能默认没有启用需要在管理后台打开开关。解决进 Administration → General → Scheduled reports把 Enabled 选项打开并保存。如果开关已经是开的状态检查前端版本和 server 版本是否一致版本不匹配时前端组件会认为报表管理器不可用。这个报错在 6.0 早期版本也出现过升级到最新 patch 版本能解决大部分情况。6. 装完不是结束用 API 验活、手动处理告警与备份习惯6.1 用 curl 调一次 Zabbix API确认整条链路是通的前端能打开、数据能出图只能证明 Web 链路通。我每次装完都会用 API 走一遍认证和数据查询确认 server 的进程、数据库、前端三层都是好的。用 curl 就行Postman 里填一样的 JSON 也可以。curl -s -X POST http://127.0.0.1/zabbix/api_jsonrpc.php \ -H Content-Type: application/json-rpc \ -d {jsonrpc:2.0,method:user.login,params:{username:Admin,password:zabbix},id:1}返回结果里会带一段 token类似result:64e0d3...。把 token 存到变量里继续查主机列表TOKEN64e0d3... curl -s -X POST http://127.0.0.1/zabbix/api_jsonrpc.php \ -H Content-Type: application/json-rpc \ -d {\jsonrpc\:\2.0\,\method\:\host.get\,\params\:{\output\:[\hostid\,\host\]},\id\:2,\auth\:\$TOKEN\}id字段是请求序号每次请求递增即可Zabbix 不强制连续但会原样返回。如果能看到 JSON 格式的主机列表说明数据库和 server 链路彻底没问题如果返回Session terminated说明 token 过期重新 login 一次。6.2 手动处理告警与自定义端口监控被监控主机链接Linux by Zabbix agent模板后CPU、内存、磁盘这些监控项会自动生效磁盘分区通过 vfs.fs.discovery 自动发现。如果想监控某个 TCP 端口比如 httpd 的 80 端口直接加一个监控项键值用net.tcp.port[127.0.0.1,80]返回 1 表示端口通0 表示不通。告警手动消除的场景也很常见某个告警持续了几个小时人工确认已经处理完业务数据还没恢复此时不用等自动恢复事件。在前端 Monitoring → Problems 页面点开问题详情点击 Acknowledge 按钮勾选 Resolve 并附上一句处理备注问题状态就会手动置为已解决。注意这个操作会写入审计日志团队协作时最好把备注写清楚方便事后追溯。6.3 备份这些配置和数据库最后的后悔药Zabbix 的配置分两部分文件和应用数据。文件是 /etc/zabbix/ 下所有 conf应用数据是整个 zabbix 数据库。我用一条 cron 每天凌晨打包一次。tar czf /backup/zabbix_conf_$(date %F).tar.gz /etc/zabbix/ mysqldump -uzabbix -pYourPassword zabbix | gzip /backup/zabbix_db_$(date %F).sql.gz find /backup -name *.gz -mtime 30 -deletefind -mtime 30删除三十天前的备份防止磁盘被备份撑爆。恢复时先装好相同版本的 Zabbix 包再zcat zabbix_db_*.sql.gz | mysql -uzabbix -p zabbix最后把 /etc/zabbix 下的 conf 文件还原回去。从那以后我每次装完 Zabbix都强制自己走一遍这四步端口检查、时区核对、API 验活、备份落盘。希望帮到你。本文还有配套的精品资源点击获取
简介面向CentOS 7.9运维环境这份Zabbix 6.0 LTS部署文档适合需要搭建自建监控平台的系统管理员、运维工程师和入门学习者。全文以源码方式给出Zabbix Server与Agent 6.0.12的完整安装流程并串联Nginx 1.20.2、PHP 7.4.30、MySQL 8.0.28等核心组件的编译与配置涵盖SELinux关闭、依赖安装、Nginx隐藏版本号、systemd开机自启及自启动服务文件示例等关键操作。资源包共1个docx文档大小约257KB内容结构化记录从环境准备、用户创建、数据库初始化到Web访问验证的每一条命令和配置片段步骤间配有代码块与必要说明便于对照执行和排错。文档还写明了Nginx配置文件修改位置与Zabbix Server参数设定适合初次接触源码部署、希望理解组件间配置关系的读者直接作为实战参考手册。已有4194人学习/下载可满足常用监控场景下的快速落地需求。1. CentOS 7.9 上装 Zabbix 6.0 LTS先卡在 PHP 和数据库版本上CentOS 7.9 安装 Zabbix 6.0 LTS很多人拿 5.0 的旧教程直接照搬结果第一步就翻车6.0 要求 PHP 7.2 以上而 7.9 系统自带的 PHP 5.4 根本不够数据库要求也高了一截默认的 MariaDB 5.5 官方明确不支持。这篇笔记把从换 yum 源、解决 PHP 版本、装 MariaDB 10.5、初始化数据库、启动 server到 Web 前端出现的完整流程过一遍顺手把 SELinux、时区、API 验证和告警手动处理这些落地必碰的点都说明白。适合正在给内部服务器搭监控、不想在旧教程里浪费时间的人照这个顺序装基本一遍过。2. 环境准备yum 源、SELinux 和 PHP 7.4少一步后面都白搭2.1 先换 yum 源阿里 base、epel、remi 一次配齐国内服务器直接连官方源经常慢到怀疑人生我一般先把 base 源和 epel 源都切成阿里镜像。CentOS 7.9 的 base 源只需要下载阿里的 CentOS-7.repo 覆盖默认文件epel 源用 rpm 装阿里镜像的 release 包即可。这一步不做后面装 Zabbix 依赖包时等得你想砸键盘。mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.bak curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-7.repo yum install -y epel-release yum clean all yum makecacheCentOS-Base.repo.bak 留着是后悔药万一源配错还能切回去。阿里镜像的 epel-release 和官方 epel 内容一致只是下载路径在国内速度差别明显。这里有个小细节CentOS 7 默认源里epel是没启用的必须单独装 release 包直接yum install epel-release走的就是 base 源里的 epel-release国内网络环境下没问题。接下来是 Zabbix 官方仓库和 remi 仓库。Zabbix 6.0 的 rpm 包在官方仓库里装完 release 包后 repo 文件指向 repo.zabbix.com为了下载快我会把 baseurl 改成阿里的 zabbix 镜像。remi 仓库则是为了拿 PHP 7.4这一步直接决定了后面能不能装上 Zabbix 6.0。rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/7/x86_64/zabbix-release-6.0-4.el7.noarch.rpm rpm --import https://repo.zabbix.com/RPM-GPG-KEY-ZABBIX sed -i s#repo.zabbix.com#mirrors.aliyun.com/zabbix#g /etc/yum.repos.d/zabbix.repo yum install -y https://mirrors.aliyun.com/remi/enterprise/remi-release-7.rpm yum install -y yum-utils yum-config-manager --enable remi-php74 yum clean all yum makecache解释一下这几个动作zabbix-release只负责往 /etc/yum.repos.d/ 里写仓库文件不是 Zabbix 本体sed替换 baseurl 是为了走阿里镜像remi-release-7.rpm装完后默认启用 remi 主仓库还要单独yum-config-manager --enable remi-php74把 PHP 7.4 的仓库打开否则 remi 源里默认 PHP 版本还是偏旧。yum-utils提供 yum-config-manager 命令这个包本身也在 base 源里先装不亏。2.2 SELinux 与防火墙先放开 80 和 10051 等端口Zabbix 的 Web 前端要跑 httpd 的 80 端口zabbix-server 要监听 10051agent 主动上报也要连 server 的 10051。CentOS 7 默认防火墙是 firewalld直接加端口规则别动不动就 systemctl stop firewalld生产环境这样干容易给自己挖坑。firewall-cmd --permanent --add-port80/tcp firewall-cmd --permanent --add-port10051/tcp firewall-cmd --permanent --add-port10050/tcp firewall-cmd --reload firewall-cmd --list-ports10050 是 agent 被动模式的监听端口如果只用主动模式可以不开但我在排查问题时常需要临时开一下索性一并用--add-port加进去。--reload之后用--list-ports确认三条规则都在这一步防止后面端口不通时瞎猜。SELinux 是另一大坑。Zabbix 官方文档明确要求开启 SELinux 时设置httpd_can_connect_zabbix这个布尔值否则 httpd 连不上 zabbix-server前端会一直报 server 不可达。如果只想快速验证可以临时setenforce 0但生产环境建议保持 Enforcing只放开必要布尔值。setsebool -P httpd_can_network_connect 1 setsebool -P httpd_can_connect_zabbix 1 2/dev/null || true getenforce-P参数让策略永久生效重启不丢。httpd_can_network_connect控制 httpd 能否向外发起 TCP 连接连数据库和 zabbix-server 都需要httpd_can_connect_zabbix是 Zabbix 文档里专门提到的布尔值部分内核版本里没有这个项所以加了|| true防止命令报错中断脚本。最后getenforce看一眼当前状态如果是 Enforcing 且上述命令没报错就说明策略放开了。2.3 PHP 版本为什么是 6.0 的分水岭Zabbix 6.0 前端依赖 PHP 7.2官方文档推荐 7.2 到 7.4 之间。CentOS 7.9 自带的是 PHP 5.4直接装 zabbix-web-mysql 会报依赖冲突yum 甚至会尝试把 PHP 5.4 的一堆包拉进来装完前端全是白屏。所以要先把 PHP 7.4 的环境准备好。装 PHP 7.4 的方式有两条路用 remi 仓库或者用 Red Hat 的 Software Collectionsrh-php72。我习惯用 remi因为国内的阿里镜像有完整的 remi 仓库yum install php php-fpm装完后版本就是 7.4不需要额外改 httpd 的解析器配置。SCL 的方式需要额外管理scl enable环境对新手不够友好。yum install -y php php-fpm php-bcmath php-gd php-mbstring php-xml php-ldap php-mysqlnd php -v systemctl enable --now php-fpm ss -lntp | grep 9000php-mysqlnd是前端连数据库的驱动缺了它安装向导会提示 pdo_mysql 未启用php-bcmath、php-gb是 Zabbix 前端画图和计算依赖的扩展漏装会在安装向导的检查页里红一片。ss -lntp | grep 9000确认 php-fpm 在监听 9000 端口Zabbix 6.0 的 httpd 配置默认通过 fastcgi 代理到 127.0.0.1:9000php-fpm 没起来后面访问前端就是 503。这里还容易踩一个坑httpd 装好后/etc/httpd/conf.d/zabbix.conf是 Zabbix 包自带的里面已经写好了 PHP 转发规则不需要手动改。很多人上网搜教程改了一堆 httpd 配置结果越改越乱其实确认 php-fpm 在跑就行。3. 服务端安装从 MariaDB 10.5 建库到 zabbix-server 单机跑起来3.1 换 MariaDB 10.55.5 装不了 Zabbix 6.0Zabbix 6.0 官方对数据库版本有明确要求MySQL 5.7/8.0或者 MariaDB 10.5/10.6。CentOS 7.9 默认是 MariaDB 5.5导入官方 create.sql.gz 时虽然不一定立刻报错但后期跑聚集查询、分区表维护时会出现各种怪问题。我在测试环境试过一次建表能过但 web 前端显示历史数据时卡顿明显后来直接换 10.5 重装。MariaDB 10.5 的 yum 仓库配置如下我用的清华镜像cat /etc/yum.repos.d/mariadb.repo EOF [mariadb] name MariaDB baseurl https://mirrors.tuna.tsinghua.edu.cn/mariadb/yum/10.5/centos7-amd64 gpgkey https://mirrors.tuna.tsinghua.edu.cn/mariadb/yum/RPM-GPG-KEY-MariaDB gpgcheck 1 EOF yum install -y MariaDB-server MariaDB-client systemctl enable --now mariadbbaseurl指向清华的 MariaDB 10.5 编译包目录仓库自带 repodatagpgcheck1会校验签名如果 rpm 报 key 问题就先rpm --import https://mirrors.tuna.tsinghua.edu.cn/mariadb/yum/RPM-GPG-KEY-MariaDB再装。装完是 mariadb 10.5 的版本号mysql --version应该能看到 10.5 字样。需要留意的是系统里如果已经装了老版本 mariadb 5.5先yum remove -y mariadb-server mariadb清掉再装 10.5否则两个版本共存在 rpm 层面会打架。数据目录 /var/lib/mysql 如果被旧版本初始化过直接把目录清空再启动新版本避免 inode 格式不兼容导致起不来。3.2 建库授权与导入 schema三个细节别搞错数据库起来后建库和授权直接决定 Zabbix 能不能连上。字符集用 utf8mb4排序规则用 utf8mb4_bin这是 Zabbix 官方推荐配置乱改排序规则后面做字符串匹配时会出幺蛾子。mysql -uroot -pCREATE DATABASE zabbix CHARACTER SET utf8mb4 COLLATE utf8mb4_bin; CREATE USER zabbix127.0.0.1 IDENTIFIED BY YourPassword; GRANT ALL PRIVILEGES ON zabbix.* TO zabbix127.0.0.1; GRANT ALL PRIVILEGES ON zabbix.* TO zabbixlocalhost; FLUSH PRIVILEGES;创建用户时分了 127.0.0.1 和 localhost 两条记录是因为 Zabbix server 和前端连接数据库时一个走 TCP 到 127.0.0.1一个可能走 socket 解析成 localhostMySQL 对这两个来源按不同的 host 匹配用户。只建其中一条后面大概率会遇到 one of them 连接被拒的尴尬。密码别用太简单的生产环境至少 12 位混合。授权完成后导入官方 schema 文件。这个文件是 gzip 压缩的直接用 zcat 管道给 mysql 命令zcat /usr/share/doc/zabbix-server-mysql*/create.sql.gz | mysql -uzabbix -pYourPassword zabbix/usr/share/doc/zabbix-server-mysql*/这个通配路径在装完 zabbix-server-mysql 包后才会出现里面只有 create.sql.gz 一个文件。导入过程大概十几秒到一分钟取决于机器性能。如果这里报语法错误九成是数据库版本还是 5.5回去执行 3.1 的步骤换 10.5如果报权限错误检查上面两条 GRANT 是否都执行了。3.3 zabbix-server.conf 关键参数DBPassword 不配服务起不来装包和改配置是连在一起的我会一口气把 zabbix-server-mysql、zabbix-web-mysql、zabbix-agent 三个包装掉再统一配置。装包命令如下PHP 依赖会自动从 remi 拉取。yum install -y zabbix-server-mysql zabbix-web-mysql zabbix-agent装完后重点改 /etc/zabbix/zabbix_server.conf。这个文件里大部分参数是注释掉的默认值真正必须改的是数据库连接那几项。用 vim 打开搜索 DB 开头的行vim /etc/zabbix/zabbix_server.confDBHost127.0.0.1 DBNamezabbix DBUserzabbix DBPasswordYourPasswordDBHost写 127.0.0.1 而不是 localhost是为了让 zabbix-server 走 TCP 连 MariaDB与建库时授权的 host 保持一致。DBName、DBUser、DBPassword对应 3.2 里创建的库和账号。这里有个血泪教训zabbix_server.conf 的 DBPassword 默认是注释状态很多人忘了解注释然后 server 启动后日志里反复报cannot connect to database实际上根本不是网络问题就是密码没写进去。改完启动服务并观察日志systemctl enable --now zabbix-server tail -f /var/log/zabbix/zabbix_server.log正常启动的日志最后会停在监听相关输出类似listener started或者直接停在using configuration file然后进程驻留后台。用ss -lntp | grep 10051确认 10051 端口在监听。日志如果出现database is down或者cannot connect先把数据库账号那段配置逐项核对这是最高频的启动失败原因。另外两个可以顺手看一眼的参数StartPollers和CacheSize。单机小规模监控保持默认即可别一上来就调大反而增加数据库压力。等监控项数量超过两千再考虑调这些。3.4 初始化前端配置装完 server 不等于装完前端zabbix-web-mysql 包装完后httpd 的虚拟目录和 PHP 转发规则已经就位但前端配置文件还没有生成。第一次访问 http://服务器IP/zabbix 会进入安装向导向导第一步检查 PHP 环境第二步填数据库连接第三步设置时区。这里的数据库连接信息要和 zabbix_server.conf 里保持一致。systemctl enable --now httpd systemctl status httpdhttpd 启动后确认 80 端口在监听。此时如果 php-fpm 没跑访问 /zabbix 会直接 503如果跑了但 PHP 版本还是 5.4会看到依赖检查页大片红色。这两种情况都回到第 2 章处理。4. Agent 与前端配置装完不等于能用时区和端口都要核对4.1 agent 配置Server、Hostname 和被动模式的三个参数Zabbix agent 的配置文件是 /etc/zabbix/zabbix_agentd.conf。被监控主机上装完 agent 后要改的核心参数就三个Server允许谁来采数据、ServerActive主动上报给谁、Hostnameagent 上报时的名字必须在 Zabbix 前端的主机名一致。分不清这三个参数的大有人在我原来也在这里迷糊过。vim /etc/zabbix/zabbix_agentd.confServer10.0.0.5 ServerActive10.0.0.5 Hostnameweb01Server10.0.0.5表示允许 Zabbix server 从 10.0.0.5 发起被动采集agent 监听 10050 端口等待请求ServerActive10.0.0.5表示 agent 主动向 10.0.0.5 的 10051 端口上报数据主动模式适合 agent 在 NAT 后面、server 无法直接访问的场景。Hostnameweb01必须和前端添加主机时填的名字一字不差否则主动模式的数据到了 server 端匹配不到主机所有监控项都会显示不支持。改完重启 agentsystemctl enable --now zabbix-agent systemctl restart zabbix-agent tail -f /var/log/zabbix/zabbix_agentd.log日志里出现active checks开头的行说明主动模式已建立连接。此时可以在前端添加主机填上 agent 的 IP 和 Hostname然后链接Linux by Zabbix agent模板两分钟后就能看到 CPU、内存等数据。4.2 前端安装向导数据库连接填 127.0.0.1别填 localhost浏览器打开 http://服务器IP/zabbix进入安装向导。这里有两个看似不起眼的决定最影响后续使用数据库 host 填 127.0.0.1时区选 Asia/Shanghai。数据库连接那一步如果填 localhostPHP 会尝试走 Unix socket 连接而 MariaDB 的 socket 默认只允许 root 或特定用户访问zabbix 用户很可能被拒。填 127.0.0.1 强制走 TCP与第 3 章授权保持一致最省心。端口默认 3306填库名 zabbix用户名 zabbix密码用第 3 章设置的。向导最后一步会让选 PHP timezone这里直接选Asia/Shanghai。很多人忽略这一步装完发现图表时间全是 UTC差八个小时这就是根因。4.3 php-fpm 时区与前端显示八十的坑为什么普遍安装向导走完后Zabbix 前端会生成 /etc/zabbix/web/zabbix.conf.php里面保存了数据库连接信息。但这个文件不会写时区前端实际用的时区是 PHP-FPM 进程的 date.timezone。所以除了向导里选还要改 PHP 配置文件双保险。sed -i s/;date.timezone /date.timezone Asia\/Shanghai/ /etc/php.ini systemctl restart php-fpmPHP 7.4 的 php.ini 里 date.timezone 默认是注释状态sed直接替换成 Asia/Shanghai。重启 php-fpm 后再看前端右上角的时钟应该是北京时间。这一步做完再去监控页看历史数据横轴时间就和墙上的钟对得上了。再检查一下 /etc/zabbix/web/zabbix.conf.php 的权限确保 apache 用户可读。这个文件是安装向导自动生成的正常情况下权限是 644如果之前手动改过导致 httpd 读不了前端会报配置错误。5. 常见问题排查Zabbix 6.0 落地必踩的六个坑5.1 前端打不开或报 PHP 版本过低现象访问 /zabbix 页面空白或安装向导的依赖检查页里 PHP 版本一栏红色提示需要 7.2.0 以上。原因系统自带的 php 5.4 还在生效remi 的 php74 仓库没启用或者 php-fpm 服务根本没起来。解决先php -v看版本不是 7.4 就去执行第 2.3 节的yum-config-manager --enable remi-php74然后重装 php 系列包如果版本对但页面空白systemctl status php-fpm看进程再用ss -lntp | grep 9000确认端口。我遇到过 php 包装好了但 php-fpm 没 enable导致 httpd 代理到 9000 端口超时前端一直转圈。5.2 安装向导卡在 “zabbix server is not running”现象前端向导全部填完最后一步提示 Zabbix server 未运行但实际上 server 进程是启动状态。原因这个提示其实是前端连不上 zabbix-server 的 API最常见原因是数据库密码没写进 zabbix_server.confserver 启动后在反复重连数据库对外表现就是服务未就绪。解决tail -n 50 /var/log/zabbix/zabbix_server.log如果看到cannot connect to database回第 3.3 节检查DBPassword是否取消注释如果日志里有cache相关错误那就是内存配置太小调大CacheSize。这个坑我踩过两次每次都是密码没配对日志一翻就明白了。5.3 数据库连接报错 Access denied现象前端向导填完数据库信息提示Access denied for user zabbix...。原因MySQL/MariaDB 对 localhost 和 127.0.0.1 是两种不同的 host 匹配规则只授权了其中一个另一个来源被拒。解决回到 3.2 节的 GRANT 命令把zabbix127.0.0.1和zabbixlocalhost两条授权都执行一遍然后FLUSH PRIVILEGES。同时检查 zabbix_server.conf 的 DBHost统一写成 127.0.0.1避免混乱。5.4 图表时间显示 Universal Time差八个小时现象监控图表横轴时间比本地时间晚 8 小时数据点位置也不对早上看的图横坐标还在半夜。原因php.ini 的 date.timezone 没设置或者安装向导时 PHP timezone 选了默认的 UTC。Zabbix 前端图表时间由 PHP 决定PHP 时区是 UTC所有时间就按 UTC 显示。解决在安装向导里重新检查时区设置同时执行第 4.3 节的sed命令改 php.ini重启 php-fpm 后再看。改完之后记得清一下浏览器缓存旧页面可能还缓存着 UTC 时间戳。5.5 SELinux 拦截导致数据不采集或页面 502现象agent 已经配置好前端主机状态显示绿色但监控项全部“不支持”或者前端页面间歇性 502。原因SELinux 默认限制 httpd 进程对外发起网络连接前端连不上 zabbix-server 的 APIagent 与被监控端的通信也被策略挡住。解决执行第 2.2 节的setsebool -P httpd_can_network_connect 1有条件的再执行httpd_can_connect_zabbix 1。改完systemctl restart httpd和zabbix-server再观察前端。如果只想快速验证是不是 SELinux 问题setenforce 0后如果马上恢复正常基本坐实。5.6 计划报表报错 “Report manager is disabled”现象打开 Reports → Scheduled reports页面提示Report manager is disabled.无法创建定时报表。原因Zabbix 6.0 的定时报表功能默认没有启用需要在管理后台打开开关。解决进 Administration → General → Scheduled reports把 Enabled 选项打开并保存。如果开关已经是开的状态检查前端版本和 server 版本是否一致版本不匹配时前端组件会认为报表管理器不可用。这个报错在 6.0 早期版本也出现过升级到最新 patch 版本能解决大部分情况。6. 装完不是结束用 API 验活、手动处理告警与备份习惯6.1 用 curl 调一次 Zabbix API确认整条链路是通的前端能打开、数据能出图只能证明 Web 链路通。我每次装完都会用 API 走一遍认证和数据查询确认 server 的进程、数据库、前端三层都是好的。用 curl 就行Postman 里填一样的 JSON 也可以。curl -s -X POST http://127.0.0.1/zabbix/api_jsonrpc.php \ -H Content-Type: application/json-rpc \ -d {jsonrpc:2.0,method:user.login,params:{username:Admin,password:zabbix},id:1}返回结果里会带一段 token类似result:64e0d3...。把 token 存到变量里继续查主机列表TOKEN64e0d3... curl -s -X POST http://127.0.0.1/zabbix/api_jsonrpc.php \ -H Content-Type: application/json-rpc \ -d {\jsonrpc\:\2.0\,\method\:\host.get\,\params\:{\output\:[\hostid\,\host\]},\id\:2,\auth\:\$TOKEN\}id字段是请求序号每次请求递增即可Zabbix 不强制连续但会原样返回。如果能看到 JSON 格式的主机列表说明数据库和 server 链路彻底没问题如果返回Session terminated说明 token 过期重新 login 一次。6.2 手动处理告警与自定义端口监控被监控主机链接Linux by Zabbix agent模板后CPU、内存、磁盘这些监控项会自动生效磁盘分区通过 vfs.fs.discovery 自动发现。如果想监控某个 TCP 端口比如 httpd 的 80 端口直接加一个监控项键值用net.tcp.port[127.0.0.1,80]返回 1 表示端口通0 表示不通。告警手动消除的场景也很常见某个告警持续了几个小时人工确认已经处理完业务数据还没恢复此时不用等自动恢复事件。在前端 Monitoring → Problems 页面点开问题详情点击 Acknowledge 按钮勾选 Resolve 并附上一句处理备注问题状态就会手动置为已解决。注意这个操作会写入审计日志团队协作时最好把备注写清楚方便事后追溯。6.3 备份这些配置和数据库最后的后悔药Zabbix 的配置分两部分文件和应用数据。文件是 /etc/zabbix/ 下所有 conf应用数据是整个 zabbix 数据库。我用一条 cron 每天凌晨打包一次。tar czf /backup/zabbix_conf_$(date %F).tar.gz /etc/zabbix/ mysqldump -uzabbix -pYourPassword zabbix | gzip /backup/zabbix_db_$(date %F).sql.gz find /backup -name *.gz -mtime 30 -deletefind -mtime 30删除三十天前的备份防止磁盘被备份撑爆。恢复时先装好相同版本的 Zabbix 包再zcat zabbix_db_*.sql.gz | mysql -uzabbix -p zabbix最后把 /etc/zabbix 下的 conf 文件还原回去。从那以后我每次装完 Zabbix都强制自己走一遍这四步端口检查、时区核对、API 验活、备份落盘。希望帮到你。本文还有配套的精品资源点击获取
