如何在 Debian 11 上安装 Flarum 论坛

在此页

1. 先决条件
2. 安装 Apache2
3. 安装 MariaDB 服务器
4. 安装 PHP 包
5. 安装作曲家
6. 为 Flarum 创建新的数据库和用户
7. 设置项目目录 Flarum
8. 设置 Apache 虚拟主机
9. 开始安装 Flarum
10. 结论

Flarum 是用 PHP、JavaScript 和 TypeScript 编写的免费开源论坛软件。最初，Flarum 是两个不同项目的合并，即 FluxBB 和 esoTalk。 Flarum 是下一代论坛软件，旨在通过扩展实现最小化和高扩展性。

Flarum 是论坛软件的现代解决方案，它快速、简单且易于使用和安装。

本教程将教您如何在 Debian 11 Bullseye 上安装 Flarum。本教程还介绍了 LAMP Stack 的一些基本配置以及为 Flarum Web 应用程序安装 PHP Composer。

先决条件

• Linux 服务器 Debian 11 Bullseye。
• 具有根权限的根用户或非根用户。
• 指向服务器的域名。

安装 Apache2

第一步是在您的 Debian 系统上安装 Apache2 网络服务器。

使用以下命令检查以更新您的存储库包索引。

sudo apt update

使用以下命令安装 Apache2 包。

sudo apt install apache2 -y

你会得到输出：

安装 Apache2 软件包后，您可以启动 apache2 服务器并启用它。

sudo systemcttl start apache2
sudo systemctl enable apache2

apache2 服务现在正在运行。

现在运行以下命令打开防火墙上的 HTTP 和 HTTPS 端口。在此示例中，Debian 服务器运行 UFW 防火墙。

sudo ufw allow "WWW Full"
sudo ufw reload

检查并验证 UFW 防火墙规则。

sudo ufw status

您将获得以下输出。

安装 MariaDB 服务器

在下一步中，您将在 Debian 服务器上安装和配置 MariaDB 数据库。

使用下面的 apt 命令安装 MariaDB 包。

sudo apt install mariadb-server -y

您将获得以下输出：

MariaDB 安装完成后，使用以下命令启动并启用 MariaDB 服务。

sudo systemctl start mariadb
sudo systemctl enable mariadb

您将获得以下输出：

MariaDB 服务正在运行，现在您将设置 MariaDB root 密码。

运行下面的 mysql_secure_installation 命令开始配置 MariaDB 服务器安装。

sudo mysql_secure_installation

按 ENTER 继续设置 MariaDB 服务器。

当要求将身份验证方法更改为 unix_socket 时，键入 Y 进行确认。

现在输入 Y 确认并设置 MariaDB 的 root 密码。然后为您的 MariaDB root 用户输入新密码并重复密码。

输入 Y 从 MariaDB 服务器中删除默认的匿名用户。

再次输入 Y 以禁用 MariaDB root 用户的远程登录。

输入 Y 以从您的 MariaDB 安装中删除默认数据库测试。

最后，再次输入 Y 以重新加载 MariaDB 服务器上的所有表权限以应用新配置。

安装 PHP 包

Flarum 是一个用 PHP 编写的 Web 应用程序。因此，您现在要将 PHP 软件包安装到您的 Debian 服务器。

使用以下命令为 Flarum 安装带有附加扩展的 PHP 包。

sudo apt install php php-common php-mysql libapache2-mod-php php-gd php-curl php-json php-xmlrpc php-intl php-bcmath php-zip php-apcu php-mbstring php-fileinfo php-xml php-soap php-tokenizer -y

你会得到输出：

PHP 安装完成后，使用 nano 编辑器编辑 php.ini 配置文件。

sudo nano /etc/php/7.4/apache2/php.ini

根据以下配置更改默认的 php.ini 配置。

memory_limit = 512M
upload_max_file_size = 150M
max_execution_time = 600
date.timezone = Europe/Paris

按 CTRL+X 保存文件，然后键入 Y 确认保存。

现在，要对 php.ini 配置文件应用新更改，请使用以下命令重新启动 Apache2 服务。

sudo systemctl restart apache2

安装作曲家

要安装 Flarum，您需要在 Debian 服务器上安装 Composer。 Composer 是 PHP 的依赖项管理器，允许您管理 PHP 应用程序上的库。

现在，Composer 被用于几乎现代的 PHP 框架，例如 Symfony 和 Laravel。

下载并验证 Composer 安装程序。

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '906a84df04cea2aa72f40b5f787e49f22d4c2f19492ac310e8cba5b96ac8b64115ac402c8cd292b8a03482574915d1a8') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

如果您看到输出消息 \Installer verified\，那么 Composer 安装程序是有效的。

现在运行安装程序脚本来安装 Composer。安装完成后，删除安装程序脚本。

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

Composer 的二进制文件现在在您的工作目录中可用，名称为 composer.phar。将文件移动到 /usr/local/bin/composer 以便服务器上的所有用户都能够执行 composer 命令。

sudo mv composer.phar /usr/local/bin/composer

接下来，使用以下命令验证您刚刚在系统上安装的 Composer 的版本。

sudo -u www-data composer --version
sudo -u www-data composer -v

您将获得以下输出。

为 Flarum 创建新的数据库和用户

在开始安装 Flarum 之前，现在您需要为 Flarum 创建一个新的 MariaDB 数据库和用户。

使用以下命令以 root 用户身份登录到 MariaDB shell。

sudo mysql -u root -p

现在为 Flarum 安装创建一个新的数据库 flarumdb 和用户 flarum，密码为 flarumdbpassword。

CREATE DATABASE flarumdb;
CREATE USER ;
FLUSH PRIVILEGES;

之后，键入 exit 从 MariaDB shell 注销，或者您可以按 CTRL+D。

设置项目目录 Flarum

在此步骤中，您将使用 PHP Composer 下载并安装 Flarum 源代码。

首先，使用以下命令创建一个新的项目目录 /var/www/flarum 和/var/www/.cache。

mkdir -p /var/www/{.cache,flarum}

主要的 Flarum 项目目录将是 /var/www/flarum。目录 /var/www/.cache 将用于存储 PHP Composer 的缓存。

接下来，将 flarum 和 .cache 目录的所有权更改为 www-data 用户。此外，您还需要授予 www-data 用户读写权限。

sudo chown -R www-data:www-data /var/www/{.cache,flarum}
sudo chmod u+rw /var/www/{.cache,flarum}

现在将您的工作目录更改为 /var/www/flarum 并使用下面的 Composer 命令安装 Flarum。

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

您将获得以下输出：

Composer 将安装 Flarum 以及 Flarum 所需的所有其他 PHP 依赖项。

安装所有 Flarum 后，您将在 /var/www/flarum 目录中看到可用的 Flarum 源代码。 Flarum 的 DocumentRoot 目录位于 /var/www/flarum/public 目录。

设置 Apache 虚拟主机

在开始访问 Flarum 安装之前，您需要为 Flarum 创建一个新的 Apache2 虚拟主机配置。

让我们首先使用以下命令启用一些 Apache 模块。

sudo a2enmod ssl rewrite headers

您将获得以下输出。

接下来，使用 nano 编辑器创建一个新的虚拟主机配置文件 /etc/apache2/sites-available/flarum.conf。

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

粘贴以下虚拟主机配置。您将需要更改下面的一些选项，例如域名和 SSL 证书的路径。

<VirtualHost *:80>
    ServerName example.io
    Redirect permanent / https://example.io/
</VirtualHost>

<VirtualHost *:443>
    ServerAdmin 
    DocumentRoot /var/www/flarum/public
    ServerName example.io

    Protocols h2 http/1.1

    SSLEngine On
    SSLCertificateFile /etc/letsencrypt/live/example.io/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/example.io/privkey.pem

     <Directory /var/www/flarum/public/>
          Options FollowSymlinks
          AllowOverride All
          Require all granted
     </Directory>

     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined
    
     <Directory /var/www/flarum/public/>
            RewriteEngine on
            RewriteBase /
            RewriteCond %{REQUEST_FILENAME} !-f
            RewriteRule ^(.*) index.php [PT,L]
    </Directory>
</VirtualHost>

通过按 CTRL+X 按钮并输入 Y 进行确认来保存文件。

现在，让我们使用以下命令激活虚拟主机配置 flarum.conf。然后验证所有 Apache2 配置。

sudo a2ensite flarum.conf
sudo apachectl configtest

如果您看到输出消息 Syntax OK，那么您所有的 Apache2 配置都是有效的。

最后，使用以下命令重新启动 Apache2 服务以在 Apache2 Web 服务器上应用新更改。

sudo systemctl restart apache2

开始 Flarum 安装

要开始 Flarum 安装和配置，您需要通过 URL https://yourdomain.com/ 访问您的 Flarum，您应该会看到以下页面。

输入 Flarum 安装的详细信息，例如站点标题和数据库详细信息。然后输入 Flarum 的管理员用户和密码。

单击 Install Flarum 开始并确认 Flarum 安装。

安装完成后，您会收到来自 Flarum 的欢迎消息，如下所示。

如果您进入 Flarum 管理设置，您将看到以下信息。

Flarum v1.2.1 安装在带有 PHP 7.4 和 MariaDB 10.5 的 Debian 11 服务器上。

结论

恭喜！您现在已经使用 LAMP 堆栈在最新的 Debian 11 Bullseye 上成功安装了 Flarum Web 应用程序。您现在可以开始添加一些扩展来扩展您的 Flarum Web 应用程序。