PbootCMS 是一款国产开源的企业建站系统,以标签简单、上手快、永久免费著称,被大量用于企业官网、产品展示站和小型门户。很多新手第一次接触时,容易卡在环境配置和伪静态上。这篇教程从零开始,把环境准备、安装步骤、目录结构、后台操作和模板标签串成一条完整链路,跟着做完,你就能独立搭起一个可以对外发布的网站。

PbootCMS 定位是轻量级内容管理系统,核心能力集中在内容发布、栏目管理和模板调用上。它不依赖复杂的框架约束,模板里直接写 HTML,需要数据的地方插入标签即可,学习成本比同类系统低不少。
它适合中小企业的官网、产品展示站、服务型站点,以及需要快速交付的营销落地页。如果你要做的是高并发的电商平台或者复杂业务系统,它并不是最优选择。另外它同时支持 MySQL 和 SQLite,小站点用 SQLite 连数据库都不用单独装,部署成本很低。
动手之前先确认服务器环境,这一步省下来,后面会加倍还回去。推荐配置如下:
如果是宝塔面板,安装 PHP 时把上面几个扩展勾上,再给站点目录设置 755、属主设为 www,基本就不会有权限问题。
到官网下载最新版压缩包,解压后把里面的文件(不是外层文件夹)通过 FTP 或面板文件管理上传到网站根目录。如果打算装在子目录,比如 /cms,就把文件传到对应子目录里。
浏览器打开你的域名,程序检测到尚未安装时会自动跳转到安装向导。如果没有自动跳转,手动访问 你的域名/index.php?install 也可以进入。向导第一屏是环境检测,各项都是绿色对勾才能继续,出现红色提示就按提示去开扩展或改权限。
这一步需要填数据库地址(一般本机就是 127.0.0.1)、端口 3306、数据库名、账号、密码,以及表前缀。表前缀默认是 ay_,如果你要在同一个库里装多个站,把前缀改成不同的值就能共存。区域码填 cn 即可,多语言站点再按需增加。管理员账号和密码请设置得复杂一些,这个账号拥有全部权限。
提交后程序会自动建表并写入初始数据,看到安装成功页面就说明完成了。此时务必做两件事:一是删除根目录下的 install 安装目录,二是登录后台 你的域名/admin.php 后立刻改掉默认管理员密码。安装目录留在线上,等于把重装入口敞开给所有人。
知道每个目录干什么,出问题时才找得到地方。核心目录大致如下(不同大版本略有差异):
后台左侧菜单按功能划分,日常用得最多的是四块。全局配置里改站点名称、LOGO、SEO 标题关键词、联系方式,这些值在模板里用标签就能取到。栏目管理是内容组织的骨架,每个栏目有唯一的 scode 编码,模板调用和文章归属都靠它,栏目还分文章、产品、单页等模型,选错模型前台会调不出数据。
内容管理里发布文章,标题、栏目、正文、缩略图、标签、推荐属性都在这一屏填完。正文编辑器支持直接粘贴图文,图片会自动入库到上传目录。单页管理用来做公司简介、联系我们这类独立页面。留言管理负责收集和回复访客留言,回复后前台会显示。
很多站长忽略的一点是:改完配置或模板,如果前台没变化,先去清一下 runtime 下的缓存和编译文件,这是最高频的“故障”。
PbootCMS 的模板就是普通 HTML 文件,标签用花括号包裹,最常用的是列表标签和内容标签。一个典型的内容列表写法如下:
{pboot:list scode=1 num=10 order='date desc'}
{/pboot:list}
其中 scode 指定栏目,num 是条数,order 控制排序。列表循环体里可以取 [list:title]、[list:link]、[list:date]、[list:ico] 等字段。分页用 {pboot:page/},导航用 {pboot:nav}...{/pboot:nav},单页内容用 {pboot:content scode=1}。内容详情页里则用 [content:title]、[content:content]、[content:date] 这些字段。
写标签时记住一个原则:先确认 scode 和模型,再动手写循环。九成的“前台没数据”都是 scode 写错或者栏目模型选错造成的。
访问提示 404,进不去安装页:多半是伪静态没配,直接用 index.php?install 访问即可。
后台登录报 500:检查 runtime 目录权限,通常是没写权限导致缓存无法生成。
上传图片失败:确认 static/upload 可写,并检查 PHP 是否装了 gd 和 fileinfo 扩展。
改了模板前台没反应:清空 runtime 下的 cache、compile 目录后刷新。
把这些基础环节打通之后,PbootCMS 的日常使用其实很轻:建栏目、发内容、调模板,三步循环。真正需要花心思的地方在内容规划和模板细节上,而不是程序本身。建议你先用一个测试站点把流程走一遍,熟练之后再动正式站,出问题的成本会低很多。