Debian 11 宝塔安装 Flarum

服务器要求

Apache (with mod_rewrite enabled) or Nginx
PHP 8.0+ with the following extensions: curl, dom, fileinfo, gd, json, mbstring, openssl, pdo_mysql, tokenizer, zip
MySQL 8.0.23+ or MariaDB 10.0.5+
SSH (command-line) access to run Composer

宝塔 7.0.7 及以上使用默认的一键安装配置即可。

安装宝塔面板

安装完成后，选择一键安装 LNMP 环境。

配置 PHP 环境

在软件商店，配置 PHP。

在【安装扩展】中，安装 fileinfo、opcache、exif、bz2、pdo_pgsql
在【禁用函数】中，删除 putenv、 pcntl_signal 以及 proc_open
设置 PHP 配置如下

2024 年 8 月 11 日更新：根据官方文档应该只需要 fileinfo 、mbstring 、exif

最大脚本运行时间（max_execution_time）：600

脚本内存限制（memory_limit）：512M 或 1024M

安装 Composer

2024 年 8 月 12 日更新：宝塔版本 7.0.7 默认的 PHP 8.3 插件似乎已经自带了 Composer，不用另外安装了。

更新软件包并安装依赖

sudo apt update
sudo apt install curl php-cli php-mbstring git unzip

下载安装 Composer

cd ~
curl -sS https://getcomposer.org/installer -o composer-setup.php
HASH=`curl -sS https://composer.github.io/installer.sig`
echo $HASH

php -r "if (hash_file('SHA384', 'composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer

composer

删除安装脚本

php -r "unlink('composer-setup.php');"

安装 Flarum

前往宝塔面板 – 【网站】 – 【添加站点】，同时创建用于 Flarum 的数据库。最后提交。

务必注意！数据库字符集一定要是 utf8mb4，至于为什么是 utf8mb4，参考：https://www.jianshu.com/p/6967ce16a202

配置 SSL 证书，请注意开启“强制 HTTPS”！

删除文章目录下的所有文件。

下载 Flarum

定位到网站目录，执行

composer create-project flarum/flarum .

配置运行

修改 Nginx 配置

进入宝塔面板，打开站点设置，修改网站配置文件：

root：需要在路径后面加上 public，比如原本是 root /www/wwwroot/example.com;，需要修改为 root /www/wwwroot/example.com/public;。

引入 Flarum 提供的伪静态配置，在 server name 下方加上 include /www/wwwroot/example.com/.nginx.conf;，网站目录不要忘记更换成自己的。

权限修改

若搭建完成后，页面出现权限报错，无法启动，则需要修改根目录权限为 775，同时所有权为 www。

chmod 775 -R /path/to/directory
chown -R www-data:www-data /path/to/directory

参考文献

更新记录

2024 年 8 月 12 日：更新宝塔 7.0.7 安装

服务器要求#

安装宝塔面板#

配置 PHP 环境#

安装 Composer#

安装 Flarum#

下载 Flarum#

配置运行#

修改 Nginx 配置#

权限修改#

参考文献#

更新记录#