• Flarum｜从零开始的同人女赛博营地盖房指南・一日千秋

Flarum 是一个基于 PHP 的论坛软件。因为是基于 PHP ，所以它对搭建环境的要求比较低。而与其它的基于 PHP 的论坛相比，它的一个优点是比较好看。

另外一个优点是它的插件系统极其丰富，站长可以通过现有的插件很方便地定制自己论坛的功能。

但是，Flarum 现在还是 beta 版本（本文写作时是 beta.15 版本），会有不稳定的情况。而不时的版本升级也使得非官方插件不一定能够兼容。

本文假定您已经配置好了 sudo 权限，并安装好了 PHP-fpm、MySQL、Nginx。若没有，请点进相应的条目查看安装方式。

Flarum 需要使用数据库。使用如下命令进入 MySQL 数据库的控制命令行：

sudo mysql

例如，我想要为我们的论坛准备一个叫做 flarumdb 的数据库，让论坛作为名叫 flarum 的用户访问数据库，则可以在控制命令行输入以下命令：（密码还需要您自行决定）

CREATE DATABASE flarumdb;
CREATE USER 'flarum'@'localhost' IDENTIFIED BY '一个新的密码';
GRANT ALL PRIVILEGES ON flarumdb.* TO 'flarum'@'localhost';
FLUSH PRIVILEGES;
quit

分别创建一个新的 MySQL 数据库、创建一个新的 MySQL 用户、授权新的用户可以自由使用新的数据库。最后的 quit 退出数据库的命令行。 如果您想要其它的名称，也可以相应地：

CREATE DATABASE 您想要的数据库名称;
CREATE USER '您想要的数据库用户名'@'localhost' IDENTIFIED BY '一个新的密码';
GRANT ALL PRIVILEGES ON 您想要的数据库名称.* TO '您想要的数据库用户名'@'localhost';
FLUSH PRIVILEGES;
quit

开启 php-fpm：

sudo systemctl start php7.4-fpm.service

查看 php-fpm 使用的 Linux 用户：

ps aux | grep php

您应该会在看见类似的输出：

root      558  0.0  1.1 274 24 ?        Ss   Jan04   1:20 php-fpm: master process (/etc/php/7.4/fpm/php-fpm.conf)
www-data  611  0.0  4.9 357 998 ?        S    Jan07   2:29 php-fpm: pool www
www-data  611  0.0  4.9 358 101 ?       S    Jan07   2:28 php-fpm: pool www
www-data  611  0.0  4.2 356 86 ?        S    Jan07   2:29 php-fpm: pool www
user     700  0.0  0.0   629   608 pts/0    S+   12:54   0:00 grep --color=auto php

您会找到 www-data （见上述输出），但也可能不是 www-data 而是其它的用户名。如果是其它的用户名，请把这个用户名记下，并用于替换下面所有的 www-data。

先安装 composer ：（参见 Composer 官网）

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '756890a4488ce9024fc62c56153228907f1545c228516cbf63f885e036d37e9a59d27d63f46af1d4d07ee0f76181c7d3') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
sudo php composer-setup.php --install-dir=/usr/bin --filename=composer
php -r "unlink('composer-setup.php');"

创建目录，并把授权给 www-data：

sudo mkdir -p /var/www/flarum
sudo chown -R www-data /var/www/flarum

安装：

cd /var/www/flarum
sudo -u www-data composer create-project flarum/flarum . --stability=beta

其实不使用域名也是很容易实现的。但为简单起见，请配置一个 域名 ：让域名的 A 记录指向您的服务器的 IP。

我们这里假设您的 Nginx 配置 是 /etc/nginx/sites-available/ 整理的，您可以用以下命令验证：

if [ -e /etc/nginx/sites-available/ ]; then echo 'YES'; else echo 'NO'; fi

若输出是 YES 则您可以按下述方法进行，如果输出为 NO 您可以直接联系本站负责人责令其更新教程。

输入以下命令使用 nano 编辑器编辑 Nginx 配置文件：

sudo nano /etc/nginx/sites-available/flarum.conf

输入以下内容：（请将 example.com 替换为您先前配置的域名）

server {
    listen 80;
    server_name example.com;

    # Hide nginx version
    server_tokens off;

    # Various content security headers
    add_header Referrer-Policy "same-origin";
    add_header X-Content-Type-Options "nosniff";
    add_header X-Frame-Options "DENY";
    add_header X-XSS-Protection "1; mode=block";

    root /var/www/flarum/public/;
    index index.htm index.html index.php;
    # frontend
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php7.4-fpm.sock;
    }
    
    include /var/www/flarum/.nginx.conf;
}

Ctrl+S 保存，Ctrl+X 退出 nano。以下命令配置并重启 Nginx： sudo ln -s /etc/nginx/sites-available/flarum.conf /etc/nginx/sites-enabled/flarum.conf sudo systemctl restart nginx

这时您应该已经能够在您的域名看到 Flarum 的安装界面了。

如果您使用 Cloudflare ，此时可能会有报错，请继续下面的配置 HTTPS，配置了 HTTPS 后应该会消除错误。

如果是使用 Cloudflare 的，请跟随 Certbot-cloudflare 进行 HTTPS 配置。

如果不是，您应可以使用普通的 Certbot 完成配置。

在 Flarum 的网页安装界面上：

点击 Install Flarum 稍加等待后即可看到 Flarum 的界面。