声明：

由于 flarum.org.cn 中文论坛那篇「宝塔 Linux 面板安装 Flarum 」教程已经太旧了，不太适合2022年的 Flarum 正式版，因此我就按照原文来自https://discuss.flarum.org.cn/d/2195 进行复刻，并对一些重要的地方进行标记。

本教程使用 Nginx 运行
本教程使用www.domain.com 这种方式访问论坛，flarum默认是www.domain.com/public 这种
本教程于2023-06-20更新

注意：必须为没装过其它环境如Apache/Nginx/php/MySQL的新系统,推荐使用centos 7.X的系统安装宝塔面板。

推荐使用Chrome、火狐、edge浏览器，国产浏览器请使用极速模式访问面板登录地址

如果不确定使用哪个Linux系统版本的，可以使用万能安装脚本。

以下教程以 Debian 系统为例:

2.1、打开 SSH 并且连上你的服务器

2.2、输入安装宝塔面板命令

wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && bash install.sh ed8484bec

询问是否安装，输入 y 然后按下回车键（键盘上那个Enter键）

这个过程大概几分钟时间（除非你服务器和网络非常拉跨）

2.3、安装成功你会看到这类信息：

外网面板地址: http://ip地址:20552/6caa8b22  //这个宝塔面板登入链接
内网面板地址: http://10.0.169.2:20552/6caa8b22  //这个不用看
username: 12cptxki    //这个是宝塔面板登入账号
password: 345a2307    //这个是宝塔面板登入密码
If you cannot access the panel,
release the following panel port [20552] in the security group
若无法访问面板，请检查防火墙/安全组是否有放行面板[20552]端口

请把这个成功信息复制并保存在电脑或者记下来，不然很麻烦。

三、安装 LNMP 环境

在浏览器，输入刚才的外网面板地址，并使用账号和密码登入宝塔面板管理后台

首次进入面板，在弹出的“推荐安装套件”窗口中选择左侧的「LNMP 极速安装」

这里要说明一些，PHP版本，如果你的服务器配置很高，而且没啥其他特别要求，建议选择 PHP 8 （因为很多插件都最低要求PHP 8的版本了），而且截至到目前2022年12月 Flarum v 1.6.2版本最低要求还是 PHP 7.4

3.1、Nginx 版本，默认即可

3.2、Mysql数据库：mysql 5.7+ 或者 mariadb 5+

安装 MySQL 5.6 或 5.7 及 MariaDB 10 必须1G以上运行内存，更高版本至少要2G运行内存。
MySQL 5.7，MariaDB 10至少 9GB 剩余磁盘空间，MySQL8.0 最新版至少 25GB 以上

3.3、FTP服务（如果你的服务器只是自己在用，SSH支持SFTP，可以不安装这个，我没这个需要）

3.4、PHP版本

截至到目前2022年12月 Flarum v 1.6.2版本最低要求还是 PHP 7.4 （如果可以，建议选择PHP 8以上的版本）
安装 PHP 7 及以上版本必须 1G 以上运行内存。

3.5、phpmyadmin数据库管理面板，默认即可

这个安装过程大概需要几十分钟，你可以进入消息列表看看是否完成。

3.6、安装PHP扩展

进入宝塔面板 – [软件商店] – [已安装]，点击 PHP 右边的 [设置]

fileinfo [必须] 要安装的，（如果你的RAM运行内存是 1G ，可能无法安装 fileinfo 这个必须的 PHP 扩展）
exif [必须] 要安装的，因为Flarum 很多扩展（插件）都用到这个功能

3.7、删除一些被禁用函数

打开 [禁用函数] ，并找到 putenv()、 pcntl_signal()、proc_open() 这三个然后删除。

如果你不删掉这三个函数，你的 Flarum会无法正常使用

3.8、配置修改

如果你的运行内存是2G以上，把 memory_limit脚本内存限制加大，例如加到256 M 或者512M更大

upload_max_filesize 这个决定你论坛可以上传多大的文件
max_file_uploads 这个决定你论坛可以同时上传多少个文件
max_execution_time 脚本运行时间，如果你服务器配置高，这个可以加大到600

四、添加网站和域名

4.1、创建网站

在宝塔面板，[网站] > [添加站点] > [创建站点]

域名：这里填写你的域名，例如 domain.com 和 www.domain.com 都想用在这个论坛，那么两个都要加上
根目录：默认
FTP：如果你刚才有安装Pure-Ftpd 就可以创建 FTP 账号和密码
PHP版本：就是你刚才安装的版本
数据库：这里需要选择创建，并且要选 utf8mb4 这个数据库字符集

创建成功就会有类似以下的信息，并且要记下来，等下安装Flarum需要用到

数据库账号资料

数据库名：bb_domain_com

用户：bb_domain_com

密码：KtXaycds2pxNdW2f

4.2、域名解析

进入你的域名服务商，把 domain.com 和 www.domain.com 这两个都要 A解析到你服务器IP

此处省略域名解析的教程，不懂请上网搜或者联系你的客服

4.3、配置 SSL 证书

打开站点设置，进入 SSL 选项卡页面，挑选您想要配置的安全证书方式：

宝塔一键 SSL（一年证书免费申请，需要登录宝塔账号并实名认证）
Let’s Encrypt 三个月免费证书
自己的证书文件，上传至宝塔

配置完成后，请注意开启 “ 强制 HTTPS ”！ 否则无法用域名打开网站

五、安装 Composer

5.1、更新服务器软件包

使用 SSH 执行更新命令

Centos

yum update -y

Debian / Ubuntu

apt-get update -y

5.2、安装 Composer

本节于2023-06-20更新，更新内容由 phpcomposer.com 改为官方 getcomposer.org
官方安装地址：https://getcomposer.org/download/

1）将安装脚本下载到当前目录

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

2）运行安装脚本

php composer-setup.php

3）删除安装脚本

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

4）全局安装 composer（配置系统环境变量）

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

如果你的服务器在国内，可能需要把composer安装源改为国内的，例如改为~_{使用腾讯云镜像，因为阿里云的源不维护了}]

改为腾讯云镜像

composer config -g repos.packagist composer https://mirrors.tencent.com/composer/

如果你的服务器在国外，可能需要把composer安装源改为全球，CloudFlare

composer config -g repos.packagist composer https://packagist.pages.dev

把composer安装源重置（改为默认）

composer config -g --unset repos.packagist

有关更详尽的镜像列表，可以参考以下链接：https://forum.gitzaai.com/d/102

六、安装 Flarum

进入网站目录。注意网站目录每个人都不一样！记得替换！，刚才4.1步骤里的域名 [www.domain.com] 这个域名仅作演示

6.1、进入网站目录

cd /www/wwwroot/www.domain.com

6.2、清空网站目录下的文件

1）因为宝塔创建网站，会加了一个 .user.ini防跨站文件，需要使用以下命令才能删除

chattr -i .user.ini

2）然后在宝塔面板中（或者在 FTP 中）删除网站目录(www.domain.com)下的所有文件

3）删除了 .user.ini 这个文件后，在SSH里面在输入这句命令看看是否删除了

ls -ahl

就会显示如下

声明：因为安装 flarum 需要在空白的目录才能安装，所以要确保步骤没错。

6.3、准备安装 Flarum 所需配置

确保 SSH 还在www.domain.com 目录（请把www.domain.com改为你的域名），执行以下命令开始安装 Flarum

composer create-project flarum/flarum .

执行成功后会下载 Flarum 并更新依赖包。更新依赖包会根据服务器地理位置花费十几秒至三十分钟不等的时间，请耐心等待。

Flarum 以及对应的依赖安装完成应该是这个样子的：

6.4、修改 Nginx 配置

注意，如果直接使用 include flarum自带 .nginx.conf 配置静态资源优化会冲突，因为跟宝塔自带的重复了。

解决方案1：不用 include ，而是直接在宝塔面板，选择伪静态，规则选 laravel 保存即可

解决方案2：用 include …….nginx.conf ，然后把 [配置文件] 里面宝塔自带的静态资源内容用 # 注释掉。

进入 [宝塔面板] ，打开[站点设置] ，修改网站 [配置文件] ：解决方案1 可对照下图修改)

1）、伪静态 ，选择 laravel 然后保存。

2）、网站目录 ，运行目录选择 /public 保存。（防跨站攻击要取消勾选）

3）、文件 ，选中你的域名，权限 选择 755 权限，应用到子目录 保存。

6.5、打开你的域名，安装和设置 flarum 。

1）、打开你的域名，就能看到安装界面

数据库的名称，账号密码请看步骤 4.1、创建网站

Forum Title 填写论坛名称
MySQL Host 数据库服务器（默认即可）
MySQL Database 填写数据库名
MySQL Username 填写数据库账号
MySQL Password 填写数据库密码
Table Prefix 数据表前缀，（可以不填写）
Admin Username 论坛管理员用户名
Admin Email 论坛管理员邮箱
Admin Password 论坛管理员密码
Confirm Password 论坛管理员密码确认（同上）

填写完毕就点击 Install Flarum

2）、确认论坛是否成功

看到论坛首页，点击一下 Tags ，General 这些页面，看看有没有报错，如果没报错就证明成功了。

论坛管理页面，需要从右上角的用户进入 Administration

3）、安装中文语言包

Flarum 安装完只有英文的语言包，需要显示中文，需要安装一个 中文语言包 的扩展

打开SSH ，进入网站目录(如果你的SSH在当前目录，可以不用这一步，请把www.domain.com 换成你的域名)

cd /www/wwwroot/www.domain.com

然后安装 中文语言包 如果想最新的选择安装 dev-master 那个，不想最新的选择下面第一个

composer require flarum-lang/chinese-simplified

如果想最新的，安装这个

composer require flarum-lang/chinese-simplified:dev-master

安装完成就会看到如下信息

4）、启用中文语言

打开论坛管理后台，找到 Languages 下面的 简体中文 扩展，并点击启用（Enabled）

然后在左侧的工具栏找到 Basics 基本设置，Default Language 默认语言选择 简体中文 然后保存。

Show language selector 这个开启，就能在论坛首页显示中文或者英文。

至此，宝塔安装 Flarum 的过程就完成了。

其他使用指南

找插件或者看看是否兼容你的论坛版本，需要访问 https://extiverse.com/

常用的插件可以看看 https://discuss.flarum.org.cn/d/3560

添加中文搜索可以看看 https://discuss.flarum.org.cn/d/3994/4

本教程如有错误或不足，欢迎留言告知。

声明：

目录

一、服务器环境说明

推荐服务器配置

二、安装宝塔 Linux 面板