PbootBiz是独立维护的PbootCMS第三方资源与工具站,与官方无隶属关系;软件版本、授权政策及公告请以官方信息为准。
环境部署

宝塔面板安装部署PbootCMS教程(超详细步骤)

一步步教你使用宝塔面板部署PbootCMS:环境要求、创建站点、上传源码、配置伪静态、安装授权与常见坑,小白也能轻松完成。

适用场景:在宝塔面板(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)。

本文由PbootBiz整理发布,转载请保留来源信息。