宝塔面板安装Flarum bate13轻论坛教程

Flarum作为一个国外开源的轻论坛程序，开发者一直强调目前是bate版，不建议适用于生产环境，虽然开发版并不稳定，功能还需要各种完善，但目前越来越多的网站都开始使用flarum搭建。国内目前也有相应的中文论坛，有搭建教程，但仍有很多朋友在搭建中会出现各种问题，因此本站做一个详细的宝塔面板搭建教程，供大家参考

1. 安装英文原版，然后安装中文语言包和各种插件，需要调试的地方较多。

2. 安装中文优化版FlarumChina，内置了很多插件，较省心，参考：https://flarum.atowerlight.cn/d/1880

但目前中文优化版刚更新到bate12，而英文原版已经推出了bate13，追求最新为原则，本教程选用了bate13，搭建过程稍微复杂一些，同时本教程也是针对英文原版安装的教学和中文汉化的方法。

本教程在搭建过程中主要借鉴了英文官方论坛、Flarum中文社区。

Ucloud  腾讯云  阿里云

• 宝塔 7.4.5

• Linux Server（本文用的是 CentOs 7 64位）

• Apache 或者 Nginx（本文用的是 Nginx 1.18.0）

• MySQL 5.6+（本文使用 MySQL 5.6）

• PHP 7.1+（本文 PHP-7.3）

安装PHP 扩展（exif / fileinfo / opcache），其中 fileinfo 是必须的，否则 Flarum 会安装失败。

宝塔面板默认禁用一些安装 Composer 要用到的 3 个函数putenv() 、 pcntl_signal() 、 proc_open()，我们需要解除禁用，否则导致Composer 变更源地址时报错、Composer 安装 Flarum 时报错。

进入宝塔面板，打开 PHP 设置，在【禁用函数】中，删除 putenv 、 pcntl_signal 以及 proc_open。

复制代码，右键粘贴后回车

使用 SSH 依次执行以下命令：
# 更新服务器软件包
1.yum update -y
#　CD 服务器根目录，全局安装 composer
2.cd
#　将安装程序下载到当前目录
3.php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');"
#　运行安装程序
4.php composer-setup.php
#　删除安装程序
5.php -r "unlink('composer-setup.php');"
#　将 composer.phar 移至默认目录
6.mv composer.phar /usr/local/bin/composer

由于 Composer 的服务器在国外，可能导致下载 Flarum 已经依赖包会很慢，所以我们需要更换一下源地址。至于 Composer 是啥，其实就是 PHP 的一个包管理，类似 Java 的 Maven 和 Gradle 工具。

变更全局范围内的 Composer 服务器地址：（如果您禁用了putenv() 函数，会导致此命令执行失败）。将 composer 源改成阿里云的镜像
7.composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

注意：

# 有些特殊情况下插件安装失败，可以尝试将composer源改回默认
composer config -g --unset repos.packagist

3.1 新建存放 Flarum 的网站

前往宝塔面板 – 【网站】 – 【添加站点】，同时创建用于 Flarum 的数据库。最后提交。

务必注意！数据库字符集一定要是 utf8mb4，至于为什么是 utf8mb4，参考：https://www.jianshu.com/p/6967ce16a202

3.2 清空网站目录

删除网站根目录下的所有文件，网站设置—>网站目录—>去掉勾选防跨站攻击

3.3 下载安装 Flarum

在网站根目录点击终端进入根目录命令行输入代码下载安装flarum
composer create-project flarum/flarum . --stability=beta

执行成功后会下载 Flarum 并更新依赖包。更新依赖包会用花费一小段时间，请耐心等待。

四、配置运行

上面的步骤我们将Flarum文件已经下载到了服务器，但是还需要进一步配置才能正确运行。

4.1 修改 Nginx 配置

进入宝塔面板，打开站点设置，修改网站配置文件：(可对照下图修改)

此处操作请注意网站地址不要输错，每句结尾要有封号（英文状态）
1.root：需要在路径后面加上 public，比如我的原本是 root /www/wwwroot/bbs.404ma.com;，需要修改为
root /www/wwwroot/bbs.404ma.com/public;
2.引入 Flarum 提供的配置，在 server name 下方加上include /www/wwwroot/xxx/.nginx.conf;，xxx为网站目录名。比如我的是 include /www/wwwroot/bbs.404ma.com/.nginx.conf;

对flarum网站整站文件权限进行修改，更改网站文件夹的目录权限为755，所有者www，应用到子文件夹

访问域名，开始安装配置，数据库信息从宝塔面板数据库处获取

按如图提示填写数据库信息及管理员信息，确认安装即可

flarum的插件都是通过composer安装，具体步奏和3.3中的下载flarum基本一致，进入网站根目录，点击终端，进入后黏贴插件代码回车就行了。
# 安装中文汉化插件
composer require littlegolden/flarum-lang-simplified-chinese
安装结束后，去后台插件处开启中文插件即可。

至此，你可以尽情使用Flarum论坛了！

1、下载失败

如果你遇到如图所示错误提示，请参照第二步第7条。

2、第3.3步，下载很久依然没动静，建议使用SSH软件连接服务器并且CD至网站根目录下重新执行3.3的安装代码，安装完成后界面如下图所示