Clara BBS 宝塔部署教程：从上传解压到能发帖

Clara BBS 宝塔部署教程：从上传解压到能发帖

结论先说： 用宝塔面板部署 Clara BBS 一共 6 步、约 15 分钟——建站 → 上传解压 → 装 PHP 扩展 → 配目录权限 → 设伪静态 → 跑安装向导。全程零命令行（不需要 SSH、不需要 Composer），面板点几下就能完成，装完就能发第一帖。

下面按顺序走，每一步都给到宝塔里的具体点击路径。

部署前准备

• 一台装了宝塔面板的 Linux 服务器（CentOS / Ubuntu / Debian 均可，宝塔官方一键安装脚本装好面板）
• PHP 7.4 – 8.5（推荐 8.0 或 8.1，兼容性与性能最平衡）
• MySQL 5.7+
• 一个域名（可选；没有域名用服务器 IP 也能跑通，只是部分功能受限）

第一步：宝塔建站

结论：先在宝塔里建好站点和数据库，拿到数据库账号密码备用。

1. 宝塔面板 → 网站 → 添加站点
2. 填写：

• 域名：填你的域名（如 bbs.example.com）
• 根目录：默认 /www/wwwroot/bbs.example.com，记下这个路径
• FTP：不需要，选"不创建"
• 数据库：选 MySQL，勾选"创建数据库"（这样宝塔会自动建好库并生成账号密码）
• PHP 版本：选 7.4 – 8.5 之间的版本

1. 提交后，宝塔会弹出数据库名 / 用户名 / 密码——先复制保存，安装向导要填

如果建站时没创建数据库也没关系：安装向导会在有建库权限的账号下自动尝试创建。

第二步：上传并解压程序

**结论：把 Clara BBS 程序包上传到站点根目录并解压，解压后根目录应直接看到 index.php。**

1. 宝塔 → 文件 → 进入站点根目录（如 /www/wwwroot/bbs.example.com）
2. 点 上传，把 Clara BBS 程序压缩包传上去（zip 格式）
3. 右键压缩包 → 解压 → 解压到当前目录
4. 确认解压后的目录结构（根目录下应能看到）：

• index.php、admin.php —— 入口文件
• app/ —— 核心程序
• content/ —— 插件目录
• install/ —— 安装向导
• config/、storage/、uploads/ —— 需可写的目录

常见坑：如果解压后根目录里多套了一层文件夹（比如 bbs/index.php 而不是 index.php），需要把内层文件全部剪切到根目录，否则访问会 404。

第三步：检查 PHP 扩展

结论：Clara BBS 依赖 5 个必需扩展，宝塔默认一般已带，缺哪个装哪个。

安装向导会逐项检测，必需扩展如下：

安装方法：宝塔 → 软件商店 → 已安装 → 找到你的 PHP-8.x → 设置 → 安装扩展 → 勾选缺失的扩展安装。

第四步：设置目录权限

**结论：config、storage、uploads 三个目录必须可写，否则安装会卡在"目录不可写"。**

1. 宝塔 → 文件 → 站点根目录
2. 分别右键 config、storage、uploads → 权限
3. 设为 755（若仍提示不可写，改成 777）
4. 勾选 "应用到子目录"

安全提示：安装完成后，可把 config 目录权限调回 755 降低风险。

第五步：配置伪静态

**结论：Clara 的 URL（如 /thread-123.html）都是虚拟地址，必须配伪静态转发到 index.php，否则除了首页全是 404。**

1. 宝塔 → 网站 → 点你的站点 → 设置 → 伪静态
2. 粘贴下面的 Nginx 规则，保存：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

1. 保存后宝塔会自动重载 Nginx

这条规则在做什么：访问静态文件（图片、CSS）时直接返回；访问 /thread-123.html 这类虚拟地址时，转发给 index.php 处理。不配这条，帖子页全部打不开。

第六步：运行安装向导

结论：访问 /install/ 跟着 4 步向导走完，系统就装好了。

浏览器打开：http://你的域名/install/

① 环境检测

逐项检查 PHP 版本、扩展、目录权限。带 * 的是必需项，全部"通过"才能点下一步。有"未通过"就回到第三、四步处理。

② 填写配置信息

数据库（填第一步宝塔给你的信息）：

• 服务器：127.0.0.1（数据库和站点同机时）
• 端口：3306
• 表前缀：默认 clara_（一般不用改）
• 数据库名 / 用户名 / 密码：填宝塔建站时生成的

站点信息：

• 站点名称：你的社区名
• 站点 URL：一般会自动识别，务必确认带 https:// 或 http:// 且是主域名（后面说明原因）
• 时区：默认 Asia/Shanghai

管理员账号：

• 用户名：必须以字母开头，2–30 位字母/数字/下划线（如 admin）
• 邮箱：必填（找回密码用）
• 密码：至少 6 位

③ 安装

点"开始安装"，向导会自动建表、写入初始数据（管理员、版块、货币、会员套餐、欢迎帖等）。几秒钟完成。

④ 完成

出现"安装完成"，点「进入首页」或「进入后台」。

验证：发出第一帖

结论：能登录后台 + 能发帖，就说明部署成功了。

1. 打开 http://你的域名/，用刚才的管理员账号登录
2. 进入任意版块（如"新人报到"），点发帖
3. 输入标题和内容 → 发布
4. 看到帖子出现在列表里 = 部署成功 ✅

安装后必做 3 件事

1. 删除 install 目录（安全第一）——或保留 storage/install.lock 锁文件防止被重复安装
2. 进后台「系统设置」配基础项：站点地址（带 https）、邮件 SMTP、上传限制
3. （推荐）开启 GEO 优化：后台「系统设置 → GEO 优化」各开关默认已开，robots.txt 自动放行 AI 爬虫——让你的内容能被豆包、DeepSeek、元宝等 AI 引擎收录

常见问题

Q：环境检测里"PHP 版本"或某个扩展未通过怎么办？
A：在宝塔「软件商店 → PHP 设置」里切换 PHP 版本或安装扩展，改完后重新访问 /install/ 刷新检测。宝塔切换 PHP 版本可能需要重启 PHP。

Q：数据库连接失败？
A：三个原因——① 服务器填错了（同机用 127.0.0.1，别填 localhost）；② 数据库名/用户名/密码和宝塔建站时不一致；③ MySQL 没启动。到宝塔「数据库」页可以核对账号密码。

Q：首页能开，但点帖子/版块全是 404？
A：伪静态没生效。回到第五步检查 Nginx 规则是否配置并保存成功。

Q：发帖提示"页面已过期，请刷新后重试"？
A：CSRF 校验未通过，通常是站点 URL 填得不对（比如装的是 www. 域名却填了裸域名，或没带 http(s)://）。到后台「基本设置」改成正确的带协议地址即可。

Q：图片上传失败？
A：三步排查——① 后台「系统设置 → 上传」确认扩展名白名单含该格式；② PHP 的 upload_max_filesize / post_max_size 调大（宝塔默认 2M，手机照片常超，建议 30M+）；③ 确认 uploads 目录可写。

Q：忘记管理员密码了？
A：宝塔 → 数据库 → 找到 clara_users 表 → 编辑管理员那行，把 password 字段替换成新密码的 bcrypt 哈希；或直接重新安装。

一句话总结

宝塔部署 Clara BBS 不需要任何命令行操作——**建站拿数据库信息 → 上传解压 → 补扩展 → 给三个目录写权限 → 配伪静态 → 跑 /install/ 向导，15 分钟内就能从零到一个能发帖的社区。最容易踩的两个坑是"解压多套一层目录"和"忘配伪静态"**，避开这两点基本一次成功。