帮助文档

适用版本：1.1.25　｜　最后更新：2026-11-06

本文档面向站点管理员与使用者，讲清"怎么装、怎么用、出问题怎么办"。二次开发请看《开发手册》。

一、SanbbbCMS 是什么

SanbbbCMS 是叁佰建站自主研发的企业建站管理系统，基于 ThinkPHP 8 + MySQL 8 开发。定位是"一次建站、多站复用、持续升级"：一套后台管内容，一套主题决定长相，官方升级包在线更新。

核心能力一览：

二、运行环境

必须：网站运行目录指向 public/，不是项目根目录。否则 .env、runtime/ 等敏感文件会暴露。

三、安装部署

3.1 上传文件

1. 解压安装包，得到 app/ config/ public/ template/ vendor/ ... 等目录；
2. 把整个目录上传到服务器（如 /www/wwwroot/你的站点/）；
3. 把 Web 服务器根目录指向其中的 public/。

Nginx 伪静态参考（宝塔面板可直接粘贴）：

location / {
    try_files $uri $uri/ /index.php?s=$uri&$args;
}

3.2 运行安装向导

浏览器访问 http://你的域名/install/，按向导填写：

安装完成会生成 public/install/install.lock，请勿删除；再访问 /install/ 会自动跳转前台。

3.3 安装后三件事

1. 登录 /manage/，在「系统设置 → 站点信息」填写站点名称、Logo、备案号；
2. 在「系统设置 → SEO」填写默认标题、关键词、描述；
3. 修改后台默认密码（「系统用户 → 管理员」）。

⚠️ 如果安装后前台 404 或样式错乱，先检查伪静态是否生效、运行目录是否指向 public/。

四、后台快速上手

4.1 登录

• 地址：http://你的域名/manage/
• 需要输入账号、密码、验证码
• 同一 IP 连续失败 5 次会锁定 15 分钟
• 登录后 3 小时内无操作自动退出，有操作会自动续期

4.2 界面结构

左侧为功能菜单，右侧为工作区。菜单分组：

五、栏目管理

「内容管理 → 栏目管理」是整站骨架。

5.1 栏目类型

• 支持无限级（推荐 3 级以内，便于 SEO 与导航）
• 别名 决定前台 URL，如别名 news → /news/、/news/12.html
• 栏目可设置独立 TDK、Banner 图、排序、显示级别
• 别名一经上线不建议修改，会造成旧链接 404

5.2 栏目与模型

栏目绑定的模型决定"新增内容时能选哪些栏目"。在新闻栏目下点新增，所属栏目只会列出文章类栏目；在产品栏目下点新增，只列出产品类栏目——这是按模型自动过滤的，不需要手工设置。

六、内容管理

6.1 通用字段

老站点升级后如果缺少这些字段，系统会在保存时自动补列，不需要手工改数据库。

6.2 各模型差异

6.3 富文本编辑

编辑器支持：标题层级、加粗斜体、列表、引用、表格、代码块、图片/视频插入、源码模式。粘贴 Word 内容会保留基础格式，建议粘贴后检查一次样式。

七、模型与扩展字段

7.1 模型管理

「系统管理 → 模型管理」可查看内置 7 个模型（专题/新闻/产品/案例/人才/问答/下载）。模型的 表类型 决定数据存哪张表，系统模型 不建议删除。

7.2 扩展字段

「系统管理 → 扩展字段」给模型加字段，例如给产品加"功率""材质"：

新增字段后，对应内容编辑页会自动出现该字段，前台用模板标签 {$item.字段名} 输出。

八、模板与主题

8.1 切换模板

「系统管理 → 模板管理」列出可用主题，点"使用"切换。切换模板需要站点授权——未授权站点只能用官方标配 default 模板，避免付费主题被白用。

8.2 主题目录结构

template/主题名/
├── template_info.php     # 主题信息（名称、版本、截图、分类）
├── data.php              # 主题数据声明（可选）
├── index/index.html      # 首页
├── article/index.html    # 文章列表
├── article/show.html     # 文章详情
├── product/ case/ job/ faq/ download/
├── page/index.html       # 单页
└── common/               # 公共片段 header/footer/sidebar

8.3 模板修改注意

• 改模板只改 template/你的主题/ 下的文件，不要动 app/；
• 模板编译缓存在 runtime/index/temp/，改完不生效时可清空该目录；
• 升级不会覆盖你的主题目录，但官方 default 模板会随升级更新，自定义改动请放在自己的主题里。

九、会员中心

后台「会员管理」可查看会员列表、修改资料、禁用账号、调整等级。

十、表单与留言

• 留言板：后台「互动管理 → 留言」，前台模板放 {include file="form/show" /} 或调用表单；
• 自定义表单：先建表单（选择字段），再把表单嵌入页面，提交数据在「表单数据」查看，支持导出。

防刷建议：表单已带基础校验，如需更强防护可在 Nginx 层加频率限制。

十一、系统设置与 SEO

11.1 常改配置

11.2 收录优化

• 前台 URL 全部伪静态：/栏目别名/ 与 /栏目别名/文章id.html；
• 每个栏目、每篇内容都可独立设置 TDK；
• robots.txt 已放行主流搜索引擎与 AI 爬虫，禁止后台、安装、运行目录；
• 内置 /sitemap.xml，可在搜索引擎后台提交；
• 后台所有页面带 X-Robots-Tag: noindex，不会被误收录。

十二、在线升级

12.1 操作步骤

1. 后台「系统管理 → 系统升级」→ 点「检查更新」；
2. 有新版时显示版本号、更新日志、包大小与 MD5；
3. 点「立即升级」，系统自动下载 → 校验 → 备份 → 覆盖文件 → 更新版本号；
4. 升级完成后刷新后台，确认版本号已变。

12.2 安全保障

• 升级包下载需要站点授权 + 域名双重验证，服务端签发 10 分钟有效的短时令牌，复制链接或用下载器都拿不到；
• 包级 MD5 + 每文件 SHA256 双重校验，下载损坏或被篡改会中止；
• 覆盖前自动备份到 runtime/upgrade/backup/版本号/，出问题可手工回滚；
• 升级只覆盖程序文件，不动数据库、不动你的主题、不动上传的图片。

12.3 升级失败怎么办

十三、站点授权

13.1 授权影响什么

不锁站：未授权站点前台照常访问，不会出现"授权过期"遮罩。

13.2 授权规则

• 按域名一对一：www.abc.com 与 abc.com 是两条独立授权，需要分别登记；
• 未登记的子域名（如 cms.abc.com）同样视为未授权；
• 授权可设到期时间，到期前 7 天内有宽限（沿用上次授权回执），到期后按未授权处理；
• 停用授权即时生效，无需等缓存；
• 仅 localhost / 127.0.0.1 / 本机 IP 保留"可切模板、不可在线升级"的本地调试豁免。

13.3 申请与续期

把站点域名、站点名称、联系人发给叁佰建站，登记后即刻生效（客户端每小时自动重新校验一次，也可在后台"系统升级"页触发）。续期在后台「站点授权」点"续期"，顺延一年。

十四、安全建议

上线前逐条确认：

1. 关闭调试：.env 里 APP_DEBUG = false（生产环境必须）；
2. 改掉弱口令：后台管理员、数据库 root 都要改；
3. 保留 install.lock：删除后任何人都能重装覆盖你的站；
4. 全站 HTTPS：后台 Cookie 已带 HttpOnly + SameSite，但传输加密仍需证书；
5. 定期备份：后台「数据库」可导出，建议同时备份 public/uploads/；
6. 限制后台入口：可在 Nginx 层对 /manage/ 加 IP 白名单（可选）；
7. 不要在生产环境保留 public/install/ 里的安装文件（保留 install.lock 即可）。

十五、常见问题

Q：前台 500 错误，怎么定位？
A：APP_DEBUG=true 时会直接显示异常信息与文件行号；生产环境看 runtime/index/log/年月/日.log。最常见是模板表达式写错、PHP 版本过低、目录无写权限。

Q：后台登录提示验证码错误？
A：刷新验证码重试；若一直错误，检查 runtime/session/ 是否可写、服务器时间是否准确。

Q：上传图片失败？
A：检查 public/uploads/ 权限（755/777）与 upload_max_filesize、post_max_size 配置。

Q：改了模板没效果？
A：清空 runtime/index/temp/，再强制刷新浏览器。

Q：栏目改了别名，旧链接 404？
A：伪静态按别名生成，旧别名链接会失效。如需保留，可在 Nginx 加 301 重定向。

Q：授权后还是不能升级？
A：确认登记的域名与访问域名完全一致（含是否带 www）；确认授权未停用、未过期；清一次缓存再试。

Q：能装多套系统在同一个数据库吗？
A：可以，安装时给每套设置不同的表前缀即可。

文档随版本更新，最新版见 https://www.sanbbb.com/docs/ 。遇到本文未覆盖的问题，请把「操作步骤 + 报错截图 + 系统日志」一起发给技术支持。