CentOS 7部署zabbix 6出现zabbix server is not running怎么处理

Sheffield
13 阅读6分钟

Zabbix服务器无法正常运行 问题复盘（多问题联动排查+彻底解决）

在Zabbix服务器部署完成后，出现服务无法稳定运行、前端无法正常访问的问题。经过系统性诊断排查，定位到5个相互关联的核心问题，逐一修复后，服务器恢复正常运行。本文详细复盘问题根源、排查过程及解决方案。

一、问题现象

部署完成后，Zabbix服务器出现以下异常：

顶部显示未知/不可用。

底部黄色感叹号zabbix server is not running image.png

二、根本原因深度分析（附报错+影响）

通过查看Zabbix服务日志（/var/log/zabbix/zabbix_server.log）、系统日志、数据库日志及前端错误信息，逐步定位到5个相互关联的问题，其中内存配置不足为主要诱因，其他配置错误加剧了故障。

1. 内存配置不足（主要原因）

  • 核心问题：Zabbix服务器配置文件中，CacheSize（缓存大小）仅设置为8M，远低于最小运行需求，导致服务启动时内存分配失败。
  • 关键错误信息：日志中明确出现 out of memory (requested 256 bytes)。
  • 直接影响：zabbix-server服务启动后瞬间崩溃，无法完成初始化，后续所有依赖服务均无法正常联动。

2. 数据库连接错误

  • 核心问题：Zabbix配置文件中，指定的MySQL socket文件路径错误，导致服务无法连接到MariaDB数据库。
  • 关键错误信息：日志中出现 Can't connect to local MySQL server through socket '/var/run/mariadb/mysql.sock'。
  • 实际路径：系统中MariaDB实际使用的socket路径为 /var/lib/mysql/mysql.sock（CentOS 7默认路径）。
  • 直接影响：即使内存配置正常，服务也无法读取监控数据，启动后会因数据库连接失败而异常退出。

3. 服务配置路径错误

  • 核心问题：zabbix-server服务启动时，默认会去 /etc/zabbix_server.conf 路径寻找配置文件，但实际配置文件存放于 /etc/zabbix/zabbix_server.conf（多一层zabbix目录）。
  • 直接影响：服务启动时读取不到正确的配置（内存、数据库等参数），要么启动失败，要么启动后使用默认低配置导致异常。

4. 服务运行用户权限不匹配

  • 核心问题：Zabbix配置文件中指定的运行用户为 User=zabbixsrv，但系统中实际创建的Zabbix运行用户为 zabbix（默认安装用户）。
  • 直接影响：服务启动时因用户不存在或权限不足，无法读取配置文件、日志文件，导致启动失败或异常崩溃。

5. 前端配置文件语法错误

  • 核心问题：Zabbix前端核心配置文件 zabbix.conf.php 中存在PHP语法错误，具体为关键字使用不当。
  • 关键错误信息：前端访问时，浏览器控制台或PHP日志中出现 PHP Parse error: syntax error, unexpected 'all' (T_STRING)。
  • 直接影响：Zabbix前端页面无法解析，访问时出现空白页或报错页面，无法进行监控配置和查看。

三、分步解决方案（可直接落地执行）

排查出所有问题后，按“先解决主要问题（内存），再解决关联问题（数据库、路径、权限、前端），最后验证”的顺序，逐步修复，确保每一步都生效。

1. 增加内存配置（优先解决）

  • 编辑Zabbix服务器核心配置文件：
  • vim /etc/zabbix/zabbix_server.conf
  • 找到 CacheSize 配置项，将其从8M修改为64M（根据服务器内存调整，建议最小不低于32M，内存充足可设为128M）：
  • CacheSize=64M
  • 保存退出，此步骤可彻底解决内存分配失败问题。

2. 修复数据库连接（解决socket路径错误）

  • 继续编辑上述配置文件，找到 DBSocket 配置项（若未找到则新增），修改为正确的socket路径：
  • DBSocket=/var/lib/mysql/mysql.sock
  • 验证数据库服务状态，确保MariaDB正常运行：
  • systemctl status mariadb（若未启动，执行 systemctl start mariadb）

3. 修复服务配置（路径+运行用户）

  • 第一步：修改服务启动命令，指定正确的配置文件路径（永久生效）
  • 编辑zabbix-server服务配置文件：vim /usr/lib/systemd/system/zabbix-server.service
  • 找到 ExecStart 行，修改为：
  • ExecStart=/usr/sbin/zabbix_server -c /etc/zabbix/zabbix_server.conf
  • 第二步：修改Zabbix配置文件中的运行用户，回到/etc/zabbix/zabbix_server.conf，找到 User 配置项，修改为：
  • User=zabbix
  • 第三步：重新加载服务配置，使修改生效：
  • systemctl daemon-reload

4. 修复前端配置文件（解决语法错误）

  • 删除原有错误的配置文件，重新创建 zabbix.conf.php（路径：/etc/zabbix/web/zabbix.conf.php）：
  • rm -rf /etc/zabbix/web/zabbix.conf.php
  • vim /etc/zabbix/web/zabbix.conf.php
  • 添加正确的配置内容（根据实际环境修改数据库参数）：
  • <?php
  • $DB['TYPE'] = 'MYSQL';
  • $DB['SERVER'] = 'localhost';
  • $DB['PORT'] = '0';
  • $DB['DATABASE'] = 'zabbix';
  • $DB['USER'] = 'zabbix';
  • $DB['PASSWORD'] = 'zabbix';
  • $DB['SCHEMA'] = '';
  • $DB['ENCRYPTION'] = false;
  • $DB['KEY_FILE'] = '';
  • $DB['CERT_FILE'] = '';
  • $DB['CA_FILE'] = '';
  • $DB['VERIFY_HOST'] = false;
  • $DB['CONNECTION_TIMEOUT'] = 10;
  • $ZBX_SERVER = 'localhost';
  • $ZBX_SERVER_PORT = '10051';
  • $ZBX_SERVER_NAME = '';
  • $IMAGE_FORMAT_DEFAULT = IMAGE_FORMAT_PNG;
  • ?>
  • 保存退出，确保语法无错误（可通过 php -l /etc/zabbix/web/zabbix.conf.php 验证，提示“No syntax errors”即为正常）。

5. 清理环境+重启所有相关服务

  • 第一步：杀死Zabbix相关僵尸进程（若有）：
  • pkill -9 zabbix-server
  • 第二步：清理PID文件锁定（避免服务启动失败）：
  • rm -rf /var/run/zabbix/zabbix_server.pid
  • 第三步：重启所有关联服务，确保配置生效：
  • systemctl restart mariadb zabbix-server httpd php-fpm zabbix-agent
  • 第四步：设置所有服务开机自启（避免重启服务器后故障复发）：
  • systemctl enable mariadb zabbix-server httpd php-fpm zabbix-agent

四、验证结果（全量通过）

所有配置修复完成后，通过4个维度验证Zabbix服务器运行状态，确保无异常：

  • ✅ 服务状态验证：执行 systemctl status zabbix-server，显示“active (running)”，无报错，服务稳定运行。
  • ✅ 端口监听验证：执行 netstat -tulnp | grep 10051（Zabbix Server默认端口），显示端口已被zabbix_server进程监听。
  • ✅ 前端访问验证：浏览器访问 http://服务器IP/zabbix，可正常打开登录页面，无语法报错，页面加载流畅。
  • ✅ 服务器状态验证：使用默认账号（Admin/zabbix）登录前端，查看“管理 → 系统信息”，显示“Zabbix服务器端运行中 是”，监控数据可正常采集。

image.png

五、技术总结与避坑提醒

本次故障是典型的“多配置错误联动导致服务崩溃”案例，看似复杂，实则只要按“日志排查 → 定位根源 → 分步修复 → 全量验证”的思路，就能快速解决。结合本次排查经验，给各位3点避坑提醒：

  1. 资源配置是基础：Zabbix Server的CacheSize、HistoryCacheSize等内存参数，需根据服务器内存和监控规模合理设置，最小不低于32M，避免因内存不足导致服务崩溃。
  2. 路径/权限要核对：CentOS 7中，Zabbix配置文件默认路径为 /etc/zabbix/，运行用户为zabbix，数据库socket路径为 /var/lib/mysql/mysql.sock，部署后先核对这3个关键配置，可避免80%的启动故障。
  3. 日志是排查核心：遇到Zabbix服务启动失败、前端报错时，优先查看3类日志——Zabbix服务日志（/var/log/zabbix/zabbix_server.log）、PHP日志（/var/log/php-fpm/www-error.log）、系统日志（/var/log/messages），日志中会明确提示错误根源，避免盲目排查。
avatar
文章
阅读
粉丝