Zabbix Web 界面安装时**无法自动创建配置文件 `zabbix.conf.php`** 的问题

你现在遇到的是 Zabbix Web 界面安装时无法自动创建配置文件 zabbix.conf.php 的问题，这是源码编译安装 Zabbix 时的常见情况，核心原因是 Web 服务器（如 Nginx/Apache）对 Zabbix Web 目录没有写入权限，导致安装程序无法自动生成配置文件。解决思路是手动下载配置文件模板，填写数据库信息后上传到指定路径，以下是分步操作方案：

一、核心原因分析

Zabbix Web 安装向导的最后一步会尝试将数据库连接信息、Server 地址等配置写入 /app/code/zbx/conf/zabbix.conf.php，但由于：

因此安装程序无法自动创建文件，需要手动完成这一步。

二、手动创建配置文件的详细步骤

1. 下载配置文件模板（或直接创建）

你可以通过 Zabbix 安装向导的“下载配置文件”按钮获取模板文件，也可以直接在服务器上创建（更高效），两种方式选其一即可：

方式一：直接在服务器创建模板文件

# 进入 Zabbix Web 的 conf 目录（你的路径是 /app/code/zbx/conf）
cd /app/code/zbx/conf

# 创建配置文件（若 conf 目录不存在，先创建：mkdir -p /app/code/zbx/conf）
vi zabbix.conf.php

方式二：下载模板文件后上传

2. 填写配置文件内容（核心！需匹配你的 Zabbix 环境）

将以下内容复制到 zabbix.conf.php 中，替换为你自己的数据库信息和 Zabbix Server 地址：

<?php
// Zabbix GUI configuration file.
global $DB, $HISTORY;

// 数据库配置（与 zabbix_server.conf 中的参数一致）
$DB['TYPE'] = 'MYSQL'; // 数据库类型：MYSQL/POSTGRESQL/ORACLE，这里选 MYSQL
$DB['SERVER'] = 'localhost'; // 数据库地址：本地填 localhost，远程填数据库 IP
$DB['PORT'] = '3306'; // 数据库端口：MySQL 默认 3306
$DB['DATABASE'] = 'zabbix'; // Zabbix 数据库名（需提前创建）
$DB['USER'] = 'zabbix'; // Zabbix 数据库用户（需提前授权）
$DB['PASSWORD'] = '123456'; // Zabbix 数据库用户密码（替换为你的实际密码）

// 可选：数据库连接参数（默认即可，无需修改）
$DB['SCHEMA'] = '';
$DB['ENCRYPTION'] = false;
$DB['KEY_FILE'] = '';
$DB['CERT_FILE'] = '';
$DB['CA_FILE'] = '';
$DB['VERIFY_HOST'] = false;
$DB['CIPHER_LIST'] = '';

// Zabbix Server 配置
$ZBX_SERVER = 'localhost'; // Zabbix Server 地址：本地填 localhost，远程填 Server IP
$ZBX_SERVER_PORT = '10051'; // Zabbix Server 端口：默认 10051
$ZBX_SERVER_NAME = 'Zabbix Server'; // 服务器名称（自定义，如你的主机名）

// 历史数据存储配置（默认即可）
$HISTORY['DEFAULT'] = 'SERVER';

// 其他配置（默认即可）
$IMAGE_FORMAT_DEFAULT = IMAGE_FORMAT_PNG;
?>

3. 设置配置文件的正确权限（关键！否则 Web 无法读取）

配置文件创建后，需要将所有者改为 Web 服务器运行用户（如 nginx/apache），并设置正确的权限：

# 查看 Web 服务器运行用户（以 Nginx 为例）
ps aux | grep nginx | head -1 # 通常输出为 nginx 用户

# 修改配置文件所有者（若为 Apache，用户是 apache）
chown nginx:nginx /app/code/zbx/conf/zabbix.conf.php

# 设置文件权限（只读即可，避免被篡改）
chmod 644 /app/code/zbx/conf/zabbix.conf.php

# 若 SELinux 开启，需设置安全上下文（可选，解决 SELinux 限制）
chcon -R -t httpd_sys_content_t /app/code/zbx/

4. 回到 Zabbix 安装向导，完成安装

三、常见问题排查

如果完成上述步骤后，仍提示“无法读取配置文件”，请检查以下几点：

总结

• 无法自动创建配置文件的核心是权限不足，手动创建并配置权限是最直接的解决方案；
• 配置文件中的数据库信息和 Zabbix Server 地址必须与实际环境匹配，否则会导致登录失败或监控数据无法采集；
• 权限设置是关键，需确保 Web 服务器用户能读取配置文件，同时避免配置文件被恶意篡改（设置为 644 权限）。

如果登录后出现“Zabbix Server is not running”的提示，可回到之前的步骤，检查 Zabbix Server 服务是否正常运行，以及 Agent 配置是否正确。