以下是在 Serv00 免费空间中通过代码安装 Flarum 论坛的详细步骤:
前置条件
- 确保 Serv00 账户已激活且能访问控制面板
- 确认 Serv00 环境支持:
- PHP ≥ 7.3(推荐 8.0+)
- MySQL ≥ 5.6 或 MariaDB ≥ 10.0.5
- 启用扩展:
mbstring
, pdo_mysql
, openssl
, json
, gd
, dom
步骤 1:准备环境
创建网站目录
登录 Serv00 控制面板,进入 File Manager
:
- 在
public_html
下新建目录(如 forum
)
- 或直接使用根目录(不推荐)
创建数据库
- 进入
MySQL Databases
创建新数据库,记录以下信息:
- 数据库名
- 用户名
- 密码
- 数据库主机(通常为
mysql.serv00.net
)
步骤 2:上传 Flarum 代码
方法一:通过 Composer 本地安装后上传(推荐)
- 本地安装 Composer(需 PHP 环境)
- 执行命令生成 Flarum 项目:
composer create-project flarum/flarum ./flarum --stability=beta
- 将生成的
flarum
目录内所有文件压缩为 ZIP
- 通过 Serv00 的
File Manager
上传到目标目录(如 public_html/forum
)
- 解压文件并删除 ZIP 压缩包
方法二:直接下载源码(无 Composer 时)
- 下载 Flarum 最新版源码 GitHub Release
- 解压后上传至 Serv00 目标目录
步骤 3:配置目录权限
- 通过
File Manager
修改以下目录权限为 755:
/public_html/forum/storage
/public_html/forum/public/assets
- 检查
.htaccess
文件是否存在,若缺失可手动创建(内容参考 Flarum 官方配置)
步骤 4:配置伪静态规则
- Apache 配置(Serv00 默认使用 Apache)
在网站根目录创建/修改 .htaccess
文件,添加以下内容:
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule ^.*$ - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^ index.php [L]
</IfModule>
步骤 5:运行安装向导
- 访问你的网站地址(如
https://yourusername.serv00.net/forum
)
- 填写数据库信息:
- Database Host:
mysql.serv00.net
- Database Name: 之前创建的数据库名
- Username: 数据库用户名
- Password: 数据库密码
- Table Prefix: 留空或按需填写
- 设置管理员账户和论坛名称
- 完成安装
常见问题解决
500 内部错误
- 检查 PHP 版本是否为 7.3+
- 确认所有扩展已启用(如
mbstring
)
- 查看
storage/logs
中的错误日志
无法写入目录
- 通过
File Manager
确认 storage
和 assets
目录权限为 755/777
数据库连接失败
- 确认使用 Serv00 提供的数据库主机地址(非
localhost
)
- 检查数据库用户权限是否已绑定到数据库
优化建议
启用 HTTPS
Serv00 默认提供免费 SSL 证书,在控制面板中开启即可。
清理缓存
安装后删除 /public_html/forum/composer.json
和 /public_html/forum/composer.lock
以节省空间。
备份设置
定期通过 Serv00 的 Backups
功能备份数据库和文件。
通过以上步骤,你应能在 Serv00 免费空间上成功部署 Flarum 论坛。如果遇到特定错误,建议查阅 Serv00 文档或联系其支持团队获取环境配置细节。