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' => '', );
发表评论:
◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。