写在前面

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。

二、安装 Composer

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

image.png

使用 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

三、安装 Flarum

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

image.png执行成功后会下载 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;

image.png

五、网站目录写入权限

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

image.png

六、Flarum 安装引导

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

image.png

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

七、安装中文插件并开启

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

image.png至此,你可以尽情使用 Flarum 论坛了!


可能会遇到的问题

1、下载失败

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

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

2.png

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。