本教程适用于以下操作系统版本
- Debian 12 (Bookworm)
- Debian 11 (Bullseye)
本页内容
- 前提条件
- 安装 Apache2
- 安装 MariaDB Server
- 安装 PHP 软件包
- 安装 Composer
- 为 Flarum 创建新数据库和用户
- 设置 Flarum 项目目录
- 设置 Apache 虚拟主机
- 开始安装 Flarum
- 结论
Flarum 是一款使用 PHP、JavaScript 和 TypeScript 编写的免费开源论坛软件。最初,Flarum 是两个不同项目 FluxBB 和 esoTalk 的合并产物。Flarum 是下一代论坛软件,设计上追求精简,并通过扩展实现高度可扩展性。
Flarum 是现代论坛软件的解决方案,它快速、简洁,易于使用和安装。
本教程将教您如何在 Debian 11 Bullseye 上安装 Flarum。本教程还涵盖 LAMP Stack 的一些基本配置,以及为 Flarum Web 应用程序安装 PHP Composer。
前提条件
- 一台 Debian 11 Bullseye 的 Linux 服务器。
- 一个 root 用户或具有 root 权限的非 root 用户。
- 一个指向该服务器的域名。
安装 Apache2
第一步是在您的 Debian 系统上安装 Apache2 Web 服务器。
使用以下命令检查并更新您的软件仓库包索引。
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 Server
下一步,您将在 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 安装中删除默认的 test 数据库。

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

安装 PHP 软件包
Flarum 是一款使用 PHP 编写的 Web 应用程序。因此,您现在将在 Debian 服务器上安装 PHP 软件包。
使用以下命令为 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
安装 Composer
要安装 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 flarum@localhost IDENTIFIED BY 'flarumdbpassword';
GRANT ALL PRIVILEGES ON flarumdb.* to flarum@localhost;
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
[email protected]
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 已安装在 Debian 11 服务器上,使用 PHP 7.4 和 MariaDB 10.5 。

结论
恭喜!您现在已经成功在最新的 Debian 11 Bullseye 上通过 LAMP Stack 安装了 Flarum Web 应用程序。您现在可以开始添加一些扩展来扩展您的 Flarum Web 应用程序。