Loading... > 转:[原文链接](https://www.itnt.xyz/it/11/) > Flarum 是一款非常棒的开源论坛程序,跟着网上教程搭建了 Flarum ,不过并没有完全符合我自己环境的步骤,所以在这里记录下非常详细的适用于我自己的搭建步骤。也供跟我环境相同的同志们参考参考。 ### 目录 ##### [一、服务器环境](https://www.itnt.xyz/it/11/#title1) ##### [二、安装宝塔 Linux 面板](https://www.itnt.xyz/it/11/#title2) ##### [三、安装 LNMP 环境](https://www.itnt.xyz/it/11/#title3) ##### [四、安装 Composer](https://www.itnt.xyz/it/11/#title4) ##### [五、安装 Flarum](https://www.itnt.xyz/it/11/#title5) ##### [六、配置运行](https://www.itnt.xyz/it/11/#title6) ##### [七、Flarum 安装引导](https://www.itnt.xyz/it/11/#title7) ##### [八、常用插件安装](https://www.itnt.xyz/it/11/#title8) ### 一、服务器环境说明 1. 1. 宝塔 7.0.3 2. Linux Server(本文用的是 CentOs 7.4.6 64位) 3. Apache 或者 Nginx(本文用的是 Nginx 1.16.0) 4. MySQL 5.6+(本文使用 MySQL 5.7,原因请看下方引用) 5. PHP 7.1+(本文 PHP-7.2) 6. phpMyAdmin 4.7 > MySQL 自 5.7 开始支持 FULLTEXT 中文搜索,后续方便我们优化 Flarum 论坛的中文关键词搜索。 ### 二、安装宝塔 Linux 面板 使用SSH 工具([查看使用方法](https://www.bt.cn/bbs/thread-1971-1-1.html)),执行命令开始安装(大约2分钟完成面板安装)。 **Centos安装宝塔面板命令:** ``` yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh ``` 执行安装命令,询问是否安装,回答 “ y ”  安装完成会打印这些东西(面板 ip 地址、用户名、密码): ### 三、安装 LNMP 环境 浏览器输入宝塔面板的 ip 地址。登陆账号,进入面板。 > 首次进入面板,在弹出的“推荐安装套件”窗口中选择左侧的“ **LNMP 极速安装** ” 选择好 PHP 等环境的版本号,点击一键安装后,会弹出消息盒子,等待任务执行完毕即可。  > 需要注意的是,在 LNMP 安装完成之后,我们还需要安装一些 PHP 的扩展(exif / fileinfo / opcache),其中 **fileinfo** 是必须的,否则 Flarum 会安装失败。 进入宝塔面板 – 【软件商店】 – 【已安装】,点击 PHP 设置。 [](https://imgchr.com/i/wNCUOI) 选择【安装扩展】,安装 fileinfo(opcache、exif 非必选)。 等待安装完毕。 [](https://imgchr.com/i/wNCg6s) ### 四、安装 Composer #### 4.1 更新服务器软件包 使用 SSH 执行下方命令: 1. ``` yum update -y ``` 更新完左下角会提示 “ Complete! ” [](https://imgchr.com/i/wNCf00) #### 4.2 解除 PHP 函数禁用 *此步骤仅适用于宝塔面板用户,如您直接使用完全的 Linux 命令行安装服务器环境,请**跳过此步**。* > 宝塔面板默认禁用一些安装 Composer 要用到的 3 个函数`putenv()` 、 `pcntl_signal()` 、 `proc_open()`,我们需要**解除禁用**,否则导致步骤 4.3 Composer 变更源地址时报错、步骤 5.3 Composer 安装 Flarum 时报错。 如下图所示,进入宝塔面板,打开 PHP 设置,在【禁用函数】中,**删除** `putenv` 、 `pcntl_signal` 以及 `proc_open` [](https://imgchr.com/i/wNCbc9) [](https://imgchr.com/i/wNPC1H) [](https://imgchr.com/i/wNPPcd) [](https://imgchr.com/i/wNC7p4) #### 4.3 安装 Composer 使用 SSH 依次执行以下命令: ``` cd ``` ``` php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');" ``` ``` php composer-setup.php ``` ``` php -r "unlink('composer-setup.php');" ``` ``` mv composer.phar /usr/local/bin/composer ``` > 由于 `Composer` 的服务器在国外,可能导致下载 Flarum 已经依赖包会很慢,所以我们需要更换一下源地址。至于 `Composer` 是啥,其实就是 PHP 的一个包管理,类似 Java 的 `Maven` 和 `Gradle` 工具 变更全局范围内的 Composer 服务器地址:(如果您禁用了 putenv() 函数,会导致此命令执行失败)。 将 composer 源改成 阿里云的镜像 ``` composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ ``` ### 五、安装 Flarum #### 5.1 新建存放 Flarum 的网站 前往宝塔面板 – 【网站】 – 【添加站点】,同时创建用于 Flarum 的数据库。最后提交。 > 务必注意!数据库字符集一定要是 `utf8mb4`,至于为什么是 `utf8mb4`,参考:[https://www.jianshu.com/p/6967ce16a202](https://www.jianshu.com/p/6967ce16a202%20ho) #### 5.2 配置 SSL 证书 选择您要配置的证书: * [宝塔一键 SSL(一年证书免费申请,需要登录宝塔账号并实名认证)](https://www.bt.cn/ssl) * [Let’s Encrypt 三个月免费证书](https://blog.csdn.net/msllws/article/details/82255078) * [已有证书文件,上传至宝塔](https://yq.aliyun.com/articles/705391) 配置完成后,请注意开启 “ 强制 HTTPS ”!否则在 6.2 步骤中无法正常访问 bbs.csur.fun #### 5.3 下载 Flarum > 因为 Flarum 要求安装目录必须是空目录,因此我们还需要删除刚刚新建的网站目录里的所有文件。 在 SSH 中执行: <pre spellcheck="false" class="md-fences mock-cm md-end-block" lang="" cid="n509" mdtype="fences">cd /www/wwwroot/bbs.csur.fun</pre> <pre spellcheck="false" class="md-fences mock-cm md-end-block" lang="" cid="n511" mdtype="fences">chattr -i .user.ini</pre> > 然后在宝塔面板中(或者在 FTP 中)删除网站目录(本文是 /www/wwwroot/bbs.csur.fun)下的所有文件。 <pre spellcheck="false" class="md-fences mock-cm md-end-block" lang="" cid="n515" mdtype="fences">composer create-project flarum/flarum . --stability=beta</pre> [](https://imgchr.com/i/wNi7LR) [](https://imgchr.com/i/wNFpyd) 执行成功后会下载 Flarum 并更新依赖包。更新依赖包会用花费大约十五分钟的时间,请耐心等待。 Flarum 以及对应的依赖安装完成应该是这个样子的:  ### 六、配置运行 > 上面其实就已经安装好了 Flarum,但是还需要进一步配置才能正确运行。 #### 6.1 修改 Nginx 配置 进入宝塔面板,打开站点设置,修改网站配置文件:(可对照下图修改) 1. root:需要在路径后面加上 `public`,比如我的原本是 `root /www/wwwroot/bbs.csur.fun;`,需要修改为 `root /www/wwwroot/bbs.csur.fun/public;`。 2. 引入 Flarum 提供的配置,在 server name 下方加上 `include /www/wwwroot/xxx/.nginx.conf;`,xxx 为网站目录名。比如我的是 `include /www/wwwroot/bbs.csur.fun/.nginx.conf;` [](https://imgchr.com/i/wNFw01) 修改站点配置,别忘记保存 #### 6.2 检查 Nginx 配置 最后我们需要检查 Nginx 配置是否有误并重载 Nginx 配置: <pre spellcheck="false" class="md-fences mock-cm md-end-block" lang="" cid="n536" mdtype="fences">nginx -t</pre> <pre spellcheck="false" class="md-fences mock-cm md-end-block" lang="" cid="n538" mdtype="fences">nginx: the configuration file /www/server/nginx/conf/nginx.conf syntax is ok</pre> <pre spellcheck="false" class="md-fences mock-cm md-end-block" lang="" cid="n539" mdtype="fences">nginx: configuration file /www/server/nginx/conf/nginx.conf test is successful</pre> <pre spellcheck="false" class="md-fences mock-cm md-end-block" lang="" cid="n541" mdtype="fences">nginx -s reload</pre> ### 七、Flarum 安装引导 在浏览器中访问安装 Flarum 的站点网址。 我的是:[bbs.csur.fun](https://bbs.csur.fun/) 如果看到出现下面的情况: > 这是因为没有给予网站目录写入的权限,我们加一下权限即可: 前往宝塔面板,点击左侧【文件】,(或者使用 SSH 工具)进入 /www/wwwroot 目录。 右击 bbs.csur.fun 站点目录,选择【权限】,将 755 权限修改为 775 权限。不要忘记勾选 “ 应用到子目录 ”。 [](https://imgchr.com/i/wNka8S) 接着刷新一下论坛网页就好了,根据图片提示填写好论坛信息。 `数据库名`、`数据库用户名`、`数据库密码`都可以在宝塔面板查看。 [](https://imgchr.com/i/wNkDDs) 填写完数据库信息、管理员信息,点击安装即可。 安装部署部分到此结束。 ### 八、常用插件安装 > 安装完成后会发现不支持中文,所以我们需要安装中文语言包。还有一些常用的插件。更多插件推荐,请[前往此处](https://bbs.csur.fun/d/84)查看。 <hr class="content-copyright" style="margin-top:50px" /><blockquote class="content-copyright" style="font-style:normal"><p class="content-copyright">版权属于:gogobody</p><p class="content-copyright">本文链接:<a class="content-copyright" href="https://blog.gogobody.cn/archives/202/">https://blog.gogobody.cn/archives/202/</a></p><p class="content-copyright">转载时须注明出处及本声明</p></blockquote> Last modification:September 11th, 2020 at 04:55 pm © 允许规范转载 Support 如果觉得我的文章对你有用,请随意赞赏 ×Close Appreciate the author Sweeping payments Pay by AliPay Pay by WeChat