Clara BBS 安装教程：四步向导从上传到上线

Clara BBS 的安装总共只有四步：上传文件 → 访问 install 安装向导 → 填数据库信息 → 完成安装删掉 install 目录，全程不需要 Composer、不需要命令行、不需要编译缓存，宝塔面板环境下十分钟内可以上线。

第一步：确认环境，别在 PHP 版本上翻车

结论：只要 PHP 7.4-8.5 + MySQL 5.7 及以上就能跑，PHP 8.5 也支持，但低于 7.4 会直接报错。

Clara BBS 是一款无框架轻量级 PHP 社区论坛系统，官方站是 www.leleweb.cn，作者阿乐。它对环境的要求刻意压得很低：没有 Composer 依赖、没有命令行操作、没有编译缓存，所以不需要 SSH、不需要 artisan 命令，纯面板操作就能装完。

在宝塔面板里新建站点时，PHP 版本选 7.4 到 8.5 之间的任意一个（推荐 8.0 或 8.1，兼容性和性能比较均衡），同时建好一个 MySQL 数据库，字符集选 utf8mb4。数据库版本 5.7 以上即可，8.0 也没问题。

注意点：如果你的服务器上有多个站点，别把 Clara BBS 装在已有站点的子目录里做「顺便测试」，路径混用容易让伪静态和上传目录出问题，建议独立建站。

第二步：上传文件并解压到站点根目录

结论：把程序包解压后的内容直接放在站点根目录，让 index.php 处于网站根路径下，不要多套一层文件夹。

在宝塔「文件」里进入站点目录（一般是 /www/wwwroot/你的域名），上传 Clara BBS 的程序压缩包，右键解压。解压后检查目录结构：根目录下应该能看到 index.php、install 安装目录、content 目录等。

如果你的压缩包解压后外面多了一层同名文件夹（比如 xxx/xxx/index.php），把里层的内容全部剪切到站点根目录。这一步做错的话，访问域名会看到目录列表或者 404，而不是安装向导。

顺手确认权限：uploads 目录需要可写，宝塔下一般把站点目录属主设为 www 即可。这个目录后面存上传的图片和附件，权限不对会出现「上传失败」的提示。

第三步：访问 install 走完安装向导

结论：浏览器打开 http://你的域名/install，按向导填数据库信息和管理员账号，提交后安装即完成。

向导里需要填的东西不多：数据库地址（本机一般 localhost）、数据库名、数据库用户名、数据库密码，以及站点名称和管理员账号密码。数据库信息在宝塔「数据库」页面能直接看到，也有复制按钮。

有几个填法上的坑值得提前说：

• 数据库地址别写 127.0.0.1:3306 这种带端口的格式，除非你的 MySQL 确实不在默认端口，一般填 localhost 就行；
• 管理员密码用强一点的，系统密码存储走 bcrypt 加密，安全性没问题，但弱密码照样会被撞库；
• 站点地址要填完整，带 https:// 和主域名，不要 www 和裸域混用，否则后面可能出现发帖提示「页面已过期」这类会话丢失问题。

点提交后，向导会自动建表并写入初始数据。Clara BBS 全站带 CSRF 防护、输出转义、上传类型白名单，这些在装好后默认就是开启状态，不用额外配置。

第四步：删掉 install 目录，做上线前检查

结论：安装完成后第一件事是删除 install 目录，然后进后台把基本设置补全，站点就可以对外了。

install 目录留着是安全隐患，装完直接删掉。之后用刚才设置的管理员账号登录后台，建议按顺序做这几件事：

1. 后台「系统设置→基本设置」确认站点地址、名称、logo 正确；
2. 配置伪静态。系统自动识别 .html 后缀 URL，服务器只要把非静态文件请求转发到 index.php 即可 —— Nginx 用 try_files，Apache 用 .htaccess，不需要写一堆额外规则；
3. 检查「系统设置→上传」里的两个扩展名字段：『允许的扩展名』管图片，『附件允许的扩展名』管附件，是两个独立字段，按需补全；
4. 如果打算让内容被 AI 引擎收录，后台「系统设置→GEO 优化」的开关默认全开，robots.txt、llms.txt、answers.html 问答聚合页会自动生成，不用手动配置；
5. 需要发帖审核、注册验证、防灌水间隔这些，在「系统设置」对应分页里按需打开。

后续升级也很简单：覆盖上传新版本文件，然后进后台「系统工具→数据库升级」执行一次增量升级，新增的表和字段会自动补齐，这个操作是幂等的，重复执行也不会有问题。

整个流程走下来，最花时间的其实是等文件上传和建表那几秒。没有依赖安装、没有编译步骤，这也是 Clara BBS 无框架轻量设计的直接好处：出问题时排查范围小，基本集中在 PHP 版本、目录权限、数据库信息这三处。