适用场景:在宝塔面板(BT Panel)环境中从零部署 PbootCMS 站点。本文以 PHP 7.4 + Nginx + MySQL 为例,Apache 环境仅伪静态步骤不同,其余一致。
一、环境要求
PbootCMS 官方要求如下,宝塔面板均可一键满足:
PHP:5.6 及以上,推荐 7.2 - 8.1(新版程序建议 PHP 7.4+)
数据库:MySQL 5.5+ 或 SQLite(PHP 需开启 pdo_sqlite 扩展)
Web 服务器:Apache / Nginx / IIS 均可,需支持伪静态
打开宝塔面板「软件商店」,安装 Nginx、MySQL 5.7、PHP 7.4,并给 PHP 安装 fileinfo、opcache 等常用扩展。若使用 SQLite 数据库,还需在 PHP 扩展中开启 pdo_sqlite。
二、创建站点
在宝塔面板「网站 - 添加站点」中:
域名:填写你的正式域名(如 www.pbootbiz.com),本地测试可填 IP 或本地域名
根目录:默认 /www/wwwroot/你的域名,保持默认
PHP 版本:选择 7.4
数据库:选择「MySQL」,宝塔会自动创建数据库和账号,请记下数据库名、用户名和密码(安装时要用)
创建完成后,站点根目录下会出现 index.html、404.html 等默认文件,稍后全部替换。
三、上传 PbootCMS 源码
从 PbootCMS 官方下载最新版源码包(zip),解压后全选文件上传到站点根目录,覆盖默认文件。上传后检查根目录下应有:
index.php config/ # 配置文件目录 core/ # 核心程序目录 static/ # 静态资源目录 template/ # 模板目录 data/ # 数据目录
然后设置目录权限:data 目录需可写(755 或 775)。在宝塔文件管理器中右键 data 目录,权限设为 755,属主为 www 即可。
四、配置伪静态(关键步骤)
Nginx 环境:在宝塔「网站 - 设置 - 伪静态」中,将官方伪静态规则粘贴进去保存。核心规则如下:
location / {
if (!-e $request_filename) {
rewrite ^(.*)$ /index.php?s=$1 last;
break;
}
}Apache 环境:源码包自带 .htaccess,确认宝塔「网站 - 设置 - 配置文件」中 AllowOverride 为 All 即可,无需额外操作。
配置完成后,到后台「全局参数 - 核心配置」中开启「伪静态」开关。
五、执行安装
浏览器访问你的域名,进入 PbootCMS 安装引导:
阅读并勾选「我已阅读并同意许可协议」
填写环境检测(全部绿色即可继续)
数据库配置:数据库服务器 127.0.0.1,数据库名/用户名/密码使用宝塔创建时记录的
填写管理员账号密码(务必修改默认密码)
需要授权码时,访问官方 freesn 页面申请免费授权码填入
六、常见坑与排查
首页 404:伪静态规则未配置或后台伪静态开关未开启
安装页空白:PHP 版本过低或缺少 fileinfo 扩展,宝塔 PHP 设置中安装
数据库连接失败:检查数据库名/密码是否正确,或数据库服务未启动
data 目录不可写:权限未设置,重新 755
部署完成后,建议到「全局参数」中修改网站名称、备案号等基础信息,并生成站点地图(Sitemap)。