Z-Blog 迁移到 1Panel 面板

发表于 网络经验

将 Z-Blog 迁移到 1Panel 面板时,核心是更新数据库连接配置和确保环境兼容。以下是必须修改的关键数据和操作步骤:

一、修改数据库配置文件

Z-Blog 的数据库连接信息存储在 zb_users/c_option.php 文件中,迁移后必须手动更新以下四项:

数据库服务器地址:在 1Panel 中,若 phpMyAdmin 与 MySQL 同属一个 Docker 网络,应填写 mysql(容器名)或 127.0.0.1,避免使用 localhost

数据库用户名:填写你在 1Panel 中为 Z-Blog 创建的数据库用户(如 zblog_user),或默认的 root。

数据库密码:填写该用户的密码,可在 1Panel “数据库 → 连接信息”中查看或重置。

数据库名称:填写你导入数据时创建的数据库名(如 zblog_db)。

提示:修改前建议备份原文件,修改后保存并刷新网站,若仍报错,请检查 MySQL 容器是否运行、端口是否为 3306。

二、确认环境与路径

PHP 版本:确保 1Panel 中安装的 PHP 版本 ≥ 7.2,可在“应用商店 → PHP”中查看或升级。

Web 服务器:推荐使用 OpenResty(1Panel 默认支持),并确保伪静态规则已配置(Z-Blog 依赖 pathinfo)。

文件权限:上传网站文件后,需设置 zb_users 目录及其子文件夹为 755 权限,避免写入失败。

三、导入数据库与域名解析

导入 SQL 文件:通过 phpMyAdmin 选择目标数据库,点击“导入”上传旧站导出的 .sql 文件。

域名解析:将域名 A 记录指向新服务器 IP,生效时间约 10 分钟,期间可临时用 IP 访问测试。

四、常见问题排查

无法连接数据库:检查 c_option.php 中的服务器地址是否为 mysql 或 127.0.0.1,而非 localhost

页面空白或 500 错误:检查 PHP 日志(1Panel → 网站 → 日志),确认是否缺少扩展(如 pdo_mysql)。

后台登录失败:清除浏览器缓存,或尝试访问 /zb_system/login.php 直接登录。

完成以上步骤后,Z-Blog 即可在 1Panel 上正常运行。建议迁移后第一时间测试文章发布、评论、插件功能,确保数据完整性和功能可用性。

上面提到的 c_option.php 改起来容易出错,需要我直接帮你生成一份改好的代码吗?


<?php
return array (
  'ZC_CLOSE_WHOLE_SITE' => false,
  'ZC_DATABASE_TYPE' => 'pdo_mysql',【可在PHP中安装对应扩展,mysql或者是pdo_mysql】
  'ZC_SQLITE_NAME' => '',
  'ZC_SQLITE_PRE' => 'zbp_',
  'ZC_MYSQL_SERVER' => '【原先localhost修改为MYSQL容器对应的连接信息】',
  'ZC_MYSQL_USERNAME' => '【修改为数据库新用户名】',
  'ZC_MYSQL_PASSWORD' =>'【修改为数据库新密码】',
  'ZC_MYSQL_NAME' => '【修改为数据库新名称】',
  'ZC_MYSQL_CHARSET' => 'utf8',
  'ZC_MYSQL_PRE' => 'zb_',
  'ZC_MYSQL_ENGINE' => 'MyISAM',
  'ZC_MYSQL_PORT' => '3306',
  'ZC_MYSQL_PERSISTENT' => false,
  'ZC_PGSQL_SERVER' => '1Panel-mysql-85Aj',【原先localhost修改为MYSQL容器对应的连接信息】
  'ZC_PGSQL_USERNAME' => 'postgres',
  'ZC_PGSQL_PASSWORD' => '',
  'ZC_PGSQL_NAME' => '',
  'ZC_PGSQL_CHARSET' => 'utf8',
  'ZC_PGSQL_PRE' => 'zbp_',
  'ZC_PGSQL_PORT' => '5432',
  'ZC_PGSQL_PERSISTENT' => false,
  'ZC_YUN_SITE' => '',
);

发表评论:

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。