本教程适用于以下操作系统版本

  • 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

您将看到如下输出:

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

安装 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

您将看到以下输出。

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

安装 MariaDB Server

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

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

sudo apt install mariadb-server -y

您将看到以下输出:

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

MariaDB 安装完成后,使用以下命令启动 MariaDB 服务并将其设为开机自启。

sudo systemctl start mariadb
sudo systemctl enable mariadb

您将看到以下输出:

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

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

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

sudo mysql_secure_installation

按 ENTER 继续设置 MariaDB 服务器。

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

当询问是否将认证方式更改为 unix_socket 时,输入 Y 确认。

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

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

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

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

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

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

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

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

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

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

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

安装 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

您将看到如下输出:

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

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

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

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

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

您将看到以下输出。

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

为 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 。

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

设置 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}

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

现在将工作目录切换到 /var/www/flarum,并使用下面的 Composer 命令安装 Flarum。

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

您将看到以下输出:

在 Debian 11 上安装部署 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

您将看到以下输出。

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

接下来,使用 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

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

开始安装 Flarum

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

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

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

点击 Install Flarum 开始并确认 Flarum 的安装。

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

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

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

Flarum v1.2.1 已安装在 Debian 11 服务器上,使用 PHP 7.4 和 MariaDB 10.5 。

在 Debian 11 上安装部署 Flarum 论坛系统完整教程

结论

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