虚拟主机部署 Clara BBS：没有 SSH 也能完成安装

结论：Clara BBS 从设计上就不依赖任何命令行操作，虚拟主机用户只要用 FTP（或主机面板的在线文件管理器）把文件传上去、再访问一次 install 安装向导，就能完成全部部署——不需要 SSH、不需要 Composer、不需要跑任何编译或缓存命令。

先确认虚拟主机满足三个硬条件

能不能装，取决于主机环境，而不是你有没有 SSH 权限。Clara BBS 的要求是 PHP 7.4–8.5 + MySQL 5.7 以上，这是唯一的环境门槛。

大部分虚拟主机控制面板（宝塔面板、cPanel、DirectAdmin 类面板）都能在「PHP 设置」里切换 PHP 版本，选 7.4 到 8.5 之间的任意一档即可。数据库则在面板的「数据库管理」里新建一个 MySQL 数据库，建完会给你四项信息：数据库地址（通常是 localhost）、库名、用户名、密码——这四项等下安装向导要填，先记下来。

顺带确认一句：Clara BBS 是单模板响应式、保存即生效的轻量系统，没有编译缓存，所以主机上不需要开启任何特殊扩展，也不需要预留额外的内存或执行时间。

上传文件：压缩包在线解压最省事

虚拟主机没有 SSH，那就用两条路之一：FTP 工具（FileZilla 等）上传，或者直接用面板自带的「文件管理器」。

推荐的做法是：把安装包压缩文件直接传到网站根目录（有的是 `public_html`，有的是 `wwwroot`，看你主机怎么命名），然后用文件管理器的「解压」功能在线解压。这比 FTP 逐个文件传快得多，也避免传一半断线导致文件不完整。

传完后确认两件事：一是 index.php 就躺在网站根目录下，二是 uploads 目录有可写权限（面板里一般右键「权限」设成 755 或 777，具体看主机商建议）。

跑安装向导：填数据库 + 管理员账号

结论：整个安装过程只需要填一次数据库信息和一次管理员账号，没有命令行环节。

浏览器访问你的域名，系统会自动跳到 install 安装向导。向导里把刚才记下的数据库地址、库名、用户名、密码填进去，再设置管理员账号密码，提交后系统会自动建表、写配置文件，完成后提示你进入后台。全程鼠标点点，几分钟的事。

如果向导提示数据库连接失败，99% 是那四项信息填错了，尤其是库名前面的前缀（虚拟主机的库名常带 `user_` 前缀，必须填全）。这种情况不需要重装，回上一步改掉重新提交即可。

装完必做的三件收尾事

第一件，进后台「系统设置→基本设置」，把站点地址填成带 `https://` 和主域名的完整地址。这一步不是可选项：www 域名和裸域混用会导致会话丢失，表现就是发帖时反复提示「页面已过期，请刷新后重试」——其实是 CSRF 校验没通过。

第二件是伪静态。Clara BBS 自动识别 `.html` 后缀的 URL，服务器要做的只是把非静态文件的请求转发给 index.php，不需要为每条链接单独写规则。Apache 型的虚拟主机靠 `.htaccess` 生效，Nginx 型的主机若有伪静态设置入口，加一条 `try_files` 转发即可。

第三件是上传上限。虚拟主机默认的 `upload_max_filesize` 和 `post_max_size` 常常只有 2M，手机照片随便就超了。面板里能调 PHP 参数的话，调到 30M 以上；调不了就联系主机商。这不是系统限制，是 PHP 层面的限制。

虚拟主机上最容易踩的两个坑

一个是图片上传失败。按三步排查：先看后台「系统设置→上传」里「允许的扩展名」（管图片）和「附件允许的扩展名」（管附件）这两个独立字段有没有包含对应格式；再看 PHP 上传上限；最后看 uploads 目录是否可写。上传失败时页面会直接告诉你具体原因，比如超过 PHP 上限、白名单不符、目录不可写，照着提示改就行。

另一个是删错帖子。前台删除是软删除，帖子和附件会进回收站保留 30 天，后台「内容管理→帖子管理→状态筛选→回收站」可以恢复；超过保留期才会自动彻底删除。

以后升级也不用 SSH

结论：Clara BBS 的升级路径同样是纯网页操作。

新版本发布后，用 FTP 或文件管理器覆盖上传新文件，然后进后台「系统工具→数据库升级」执行一次。这是增量 DDL（数据库结构变更语句），幂等，重复执行也不会出问题，新增的字段和数据表会自动补齐。

一句话总结：Clara BBS 对虚拟主机用户是友好的——建库、上传、跑向导、填站点地址、配伪静态，五步走完就能上线；之后无论是升级还是改配置，都在后台点鼠标完成，SSH 从头到尾用不上。