PbootCMS 模板安装与授权方法

重要：网站安装完成后，需进行安全设置。
安全设置指南：https://www.wtlu.cn/pbootcms/

发布的源码默认采用 SQLite 数据库，放入 PHP（7.0+）空间即可直接使用（不支持 PHP 8.0）。
无需导入数据库或配置数据库连接。

环境要求

  • PHP 版本：PHP 7.0+，不支持 PHP 8.0

安装步骤

第一步：上传程序到站点根目录

把 PbootCMS 整套文件上传到网站根目录（例如宝塔的 /www/wwwroot/你的站点/，或 phpstudy 的 D:\phpstudy_pro\WWW\）。

第二步：访问域名，进入授权页面

浏览器打开 你的域名/，首次访问会自动跳转到授权填写页面。

第三步：申请授权码并填入

授权页面会引导你跳转到 PbootCMS 官网申请授权码。也可直接打开：

https://www.pbootcms.com/freesn/

按页面提示填写域名信息，提交后立即获得授权码（免费）。

把授权码复制回第二步的授权填写页面，提交保存。授权通过后即可正常访问网站。

第四步：登录后台

在浏览器输入：

你的域名/admin.php

默认登录信息：

  • 账号：admin
  • 密码：admin 或 123456（取决于版本）

登录后立刻修改默认账号和密码。默认凭据是公开的，不改等于门没锁。

第五步：核对站点信息

后台 → 全局配置 → 站点信息：

  • 站点域名必须与浏览器地址栏一致（包括 http:// 或 https:// 协议头）
  • 协议头不一致会导致前台资源加载错乱、链接跳转异常

第六步：配置伪静态

规则来自 PbootCMS 官方文档：伪静态配置，请勿使用网上来路不明的版本。

如果需要 SEO 友好的 URL（去掉地址栏中的 ?p= 或 ?s=），需在 Web 服务器配置伪静态规则。

通用前置步骤：登录后台 → 全局配置 → 配置参数 → 开启「伪静态」开关。

Apache 环境

PbootCMS 源码已自带 .htaccess 文件，正常情况无需手动配置。如果文件丢失或被误删，在站点根目录新建 .htaccess，内容如下：

<IfModule mod_rewrite.c>
  Options +FollowSymlinks
  RewriteEngine On

  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f

  RewriteRule ^(.*)$ index.php?p=$1 [QSA,PT,L]
</IfModule>

注意需开启 Apache 的 mod_rewrite 重写模块，常见空间默认已开启。

Nginx 环境

在 Nginx 虚拟主机的 location 配置中添加：

location / {
    if (!-e $request_filename) {
        rewrite ^/index.php(.*)$ /index.php?p=$1 last;
        rewrite ^(.*)$ /index.php?s=$1 last;
    }
}

注意：如果站点部署在二级目录（例如 /test），需对应修改重写路径：

rewrite ^/test/(.*)$ /test/index.php?p=$1 last;

IIS 7+ 环境

  1. 安装 URL Rewrite 重写组件（一般空间商默认已安装）
  2. 在站点根目录建立 web.config 文件（可从源码包 rewrite/ 目录拷贝），内容如下：
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="reIndex" stopProcessing="true">
                    <match url="^(.*)$" ignoreCase="true" />
                    <conditions logicalGrouping="MatchAll">
                        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
                        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
                    </conditions>
                    <action type="Rewrite" url="index.php?p={R:1}" appendQueryString="true" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>

常见后续操作

  • 修改前台显示的文字：进入 template/ 目录下的当前主题文件夹，编辑对应的 .html 文件
  • 修改公司信息（公司名、电话、地址）：后台 → 公司信息
  • 修改 SEO 信息（站名、关键词、描述）：后台 → 全局配置 → 站点信息
  • 替换轮播图：后台 → 轮播图管理

补充：授权异常处理

如果首次访问域名时授权填写出现异常（页面卡住、提示授权失败、需要更换授权码、站点更换域名后授权失效等），可以登录后台手动填写：

  1. 进入后台 你的域名/admin.php
  2. 后台 → 全局配置 → 配置参数
  3. 拉到页面最下方，找到授权码输入框
  4. 填入新授权码，保存

安装完成验证

打开 你的域名/，应能正常显示首页；打开 你的域名/admin.php，应能正常登录后台。两者都正常即安装完成。