已知问题 - WP Panel

1

应用 Nginx 配置失败

2026-06-02

错误表现

在创建网站时提示「应用 Nginx 配置失败」。

原因分析

经测试，此报错大概率是服务器操作系统的 Bug 导致 Nginx 配置文件在写入或重载时出现异常，与 WP Panel 面板本身无关。常见于非纯净系统环境或经过第三方面板（如宝塔、1Panel）残留文件干扰的情况。

解决方案

建议根据帮助页面「重装纯净 Debian 13」部分内容，重装纯净系统后再次安装 WP Panel。

点击图片可放大查看

2

Nginx 已停止，启动提示"操作失败"

2026-06-03

错误表现

Nginx 服务已停止运行，在面板中点击启动时提示「操作失败」。

原因分析

此问题由系统兼容性导致。部分 VPS 厂商提供的操作系统模板存在兼容性问题，导致 Nginx 无法正常启动或运行中异常停止。常见于非 Debian 13 系统或经过第三方修改的系统镜像。

解决方案

建议使用帮助页面「重装纯净 Debian 13」中的重装脚本，安装 Debian 13 操作系统后再次安装 WP Panel。

3

迁移站点同步数据库信息失败：未找到 DB_NAME 定义

2026-06-12

错误表现

从 1Panel 迁移 WordPress 站点时，提示：将使用当前数据库名和用户名覆盖 wp-config.php 中的 DB_NAME 和 DB_USER，确认继续？随后操作失败，提示「未找到 DB_NAME 定义，wp-config.php 可能格式异常或使用了非常规引号」。

原因分析

1Panel 基于 Docker 容器运行站点，wp-config.php 中数据库名称、账号并未硬编码为固定字符串，而是通过 getenv() 读取 Docker 容器环境变量。WP Panel 解析器仅识别标准固定字符串写法，无法解析环境变量格式，因此判定配置异常。

解决方案

手动编辑站点目录下的 wp-config.php，将环境变量写法替换为标准固定字符串写法。例如把 define( 'DB_NAME', getenv('MYSQL_DATABASE') ); 修改为 define( 'DB_NAME', '实际数据库名' );，数据库用户名、密码同理修改，保存后重新执行迁移同步即可。