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 之间的版本
3. 提交后，宝塔会弹出数据库名 / 用户名 / 密码——先复制保存，安装向导要填

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

第二步：上传并解压程序

**结论：把 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 个必需扩展，宝塔默认一般已带，缺哪个装哪个。

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

| 扩展 | 用途 |
|---|---|
| PDO MySQL | 数据库连接（漏了装不了） |
| cURL | 云存储上传、AI 接口调用 |
| OpenSSL | 邮件发送、云存储签名 |
| mbstring | 中文处理（缺了中文会乱码） |
| JSON | 系统必需 |
| GD | 生成图形验证码（可选，没有会自动降级为算术题） |

安装方法：宝塔 → 软件商店 → 已安装 → 找到你的 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;
}

3. 保存后宝塔会自动重载 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 分钟内就能从零到一个能发帖的社区。最容易踩的两个坑是"解压多套一层目录"和"忘配伪静态"**，避开这两点基本一次成功。