[Aquote] 原文： https://www.itnt.xyz/it/11/ [/Aquote] Flarum 是一款非常棒的开源论坛程序，在这里记录下非常详细的适用于宝塔+linux 的搭建步骤，供环境相同的同志们参考参考。目录一、服务器环境二、安装宝塔 Linux 面板三、安装 LNMP 环境四、安装 Composer 五、安装 Flarum 六、配置运行七、Flarum 安装引导八、常用插件安装一、服务器环境说明宝塔 7.0.3 或更新版本 Linux Server（本文用的是 CentOs 7.4.6 64位） Apache 或者 Nginx（本文用的是 Nginx 1.16.0） MySQL 5.6+（本文使用 MySQL 5.7，原因请看下方引用） PHP 7.1+（本文 PHP-7.3） phpMyAdmin 4.7 MySQL 自 5.7 开始支持 FULLTEXT 中文搜索，后续方便我们优化 Flarum 论坛的中文关键词搜索。二、安装宝塔 Linux 面板使用 SSH 工具（查看使用方法），执行命令开始安装（大约2分钟完成面板安装）。 Centos安装宝塔面板命令： yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 执行安装命令，询问是否安装，回答 “ y ” 安装完成会打印这些东西（面板 ip 地址、用户名、密码）：图源：宝塔面板三、安装 LNMP 环境浏览器输入宝塔面板的 ip 地址。登陆账号，进入面板。首次进入面板，在弹出的“推荐安装套件”窗口中选择左侧的「LNMP 极速安装」选择好 PHP 等环境的版本号，点击一键安装后，会弹出消息盒子，等待任务执行完毕即可。需要注意的是，在 LNMP 安装完成之后，我们还需要安装一些 PHP 的扩展（exif / fileinfo），其中 fileinfo 是必须的，否则下面 Flarum 会安装失败。exif 是图片上传所需的扩展。进入宝塔面板 – 【软件商店】 – 【已安装】，点击 PHP 设置。选择【安装扩展】，安装 fileinfo（opcache、exif 非必选）。等待安装完毕。四、安装 Composer 4.1 更新服务器软件包使用 SSH 执行下方命令： yum update -y if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 更新完左下角会提示 “ Complete! ” 4.2 解除 PHP 函数禁用此步骤仅适用于宝塔面板用户，如您直接使用 OneinStack 一键安装服务器环境，请跳过此步。宝塔面板默认禁用一些安装 Composer 要用到的 3 个函数 putenv() 、 pcntl_signal() 、 proc_open() ，我们需要解除禁用，否则导致步骤 4.3 Composer 变更源地址时报错、步骤 5.3 Composer 安装 Flarum 时报错。如下图所示，进入宝塔面板，打开 PHP 设置，在【禁用函数】中，删除 putenv 、 pcntl_signal 以及 proc_open 若您不取消这三个函数的禁用，则会出现以下问题：禁用了 putenv() 函数，会导致变更 Composer 源地址失败。禁用了 pcntl_signal() 函数，会导致无法执行下载 Flarum 命令。禁用了 proc_open() 函数，会导致安装 Flarum 报错。 4.3 安装 Composer 使用 SSH 依次执行以下命令： # （此步骤可省略）进入当前用户家目录 cd if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } # 将安装脚本下载到当前目录 php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } # 运行安装脚本 php composer-setup.php --install-dir=bin --filename=composer if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } # 删除安装脚本 php -r "unlink('composer-setup.php');" if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 由于 Composer 的服务器在国外，可能导致下载 Flarum 已经依赖包会很慢，所以我们需要更换一下源地址。至于 Composer 是啥，其实就是 PHP 的一个包管理，类似 Java 的 Maven 和 Gradle 工具。 ——引用自 ryanc.cc # 变更全局范围内的 Composer 服务器地址：（如果您禁用了 putenv() 函数，会导致此命令执行失败）。将 composer 源改成阿里云的镜像 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 五、安装 Flarum 5.0 设置设置PHP配置文件：最大脚本运行时间（max_execution_time）：600 脚本内存限制（memory_limit）：512M 或 1024M 5.1 新建存放 Flarum 的网站前往宝塔面板 – 【网站】 – 【添加站点】，同时创建用于 Flarum 的数据库。最后提交。务必注意！数据库字符集一定要是 utf8mb4，至于为什么是 utf8mb4，参考： https://www.jianshu.com/p/6967ce16a202 5.2 配置 SSL 证书打开站点设置，进入 SSL 选项卡页面，挑选您想要配置的安全证书方式：宝塔一键 SSL （一年证书免费申请，需要登录宝塔账号并实名认证） Let’s Encrypt 三个月免费证书已有证书文件，上传至宝塔配置完成后，请注意开启 “ 强制 HTTPS ”！否则在 6.2 步骤中无法正常访问网站 5.3 下载 Flarum 因为 Flarum 要求安装目录必须是空目录，因此我们还需要删除刚刚新建的网站目录里的所有文件。在 SSH 中执行： # 进入网站目录。注意网站目录每个人都不一样！记得替换！ cd /www/wwwroot/example.com if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } # 解除 .user.ini 的文件锁定，否则该文件无法被删除 chattr -i .user.ini if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 然后在宝塔面板中（或者在 FTP 中）删除网站目录下的所有文件。 # 确保进入网站目录执行（前面也提到了，若您禁用了 pcntl_signal() 函数和 proc_open() 函数，此步执行会出错） composer create-project flarum/flarum . if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 执行成功后会下载 Flarum 并更新依赖包。更新依赖包会根据服务器地理位置花费十几秒至三十分钟不等的时间，请耐心等待。 Flarum 以及对应的依赖安装完成应该是这个样子的：六、配置运行上面其实就已经安装好了 Flarum，但是还需要进一步配置才能正确运行。 6.1 修改 Nginx 配置进入宝塔面板，打开站点设置，修改网站配置文件：(可对照下图修改) root ：需要在路径后面加上 public ，比如原本是 root /www/wwwroot/example.com; ，需要修改为 root /www/wwwroot/example.com/public; 。引入 Flarum 提供的伪静态配置，在 server name 下方加上 include /www/wwwroot/example.com/.nginx.conf; ，网站目录不要忘记更换成自己的。修改站点配置，别忘记保存 6.2 检查 Nginx 配置修改完上一步的配置，在点击保存时，宝塔会自动检查，如有错误，会保存失败并弹窗提示。七、Flarum 安装引导在浏览器中访问安装 Flarum 的站点网址。可以看到出现下面的情况：这是因为没有给予网站目录写入的权限，我们加一下权限即可：前往宝塔面板，点击左侧【文件】，（或者使用 SSH 工具）进入 /www/wwwroot 目录。右击您的站点目录，选择【权限】，权限修改为 755 权限并保存。不要忘记勾选 “ 应用到子目录 ”。接着刷新一下论坛网页就好了，根据图片提示填写好论坛信息。数据库名、数据库用户名、数据库密码都可以在宝塔面板查看。填写完数据库信息、管理员信息，点击安装即可。安装部署部分到此结束。八、常用插件安装安装完成后会发现不支持中文，所以我们需要安装中文语言包。还有一些常用的插件。更多插件，请前往插件标签查看。 # xxx 为网站目录名称，因为安装插件需在 Flarum 根目录执行。 cd /data/wwwroot/xxx if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } # 简体中文语言包 # 编辑器 Emoji 表情选择框 # 导航栏菜单插件 # 显示帖子阅读次数 # 论坛用户名录 # 上传文件 # Sitemap （网站地图）生成器 # Fancybox 图片灯箱（放大）插件安装完成后去后台启用即可（后台地址：网址/admin）。

有没有什么能把评论区的留言置顶的插件呢

最佳回复咯 https://discuss.flarum.org.cn/d/1323

Golden Flarum中文社区的宝塔面板安装教程缺失了安装PHP扩展的步骤，缺失扩展会安装不完全，SSH会提示缺失PHP扩展

Golden 扩展为 fileinfo 、 opcache 以及 exif 这三个扩展，其中 exif 可以根据需求安装

Golden 需要注意的是，在 LNMP 安装完成之后，我们还需要安装一些 PHP 的扩展（exif / fileinfo），其中 fileinfo 是必须的，否则下面 Flarum 会安装失败。exif 是图片上传所需的扩展。仙儿最会爬了没缺

这里缺少一步伪静态设置。

在安装 fof/upload``和 fof/links```插件的时候报错如下： fof/upload 0.10.0 requires flarum/core >=0.1.0-beta.12 <0.1.0-beta.14 -> found flarum/core[v0.1.0-beta.12, v0.1.0-beta.13] but the package is fixed to v0.1.0-beta.14 (lock file version) by a partial update and that version does not match. Make sure you list it as an argument for the update command. if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 请问要怎么解决呀？

LightningStar 暂时不支持14版本

宝塔 Linux 面板安装 Flarum

Golden

seepine /www/wwwroot/taois.top/ 里应该有个 .user.ini 文件，修改允许的路径，或者直接删掉这个文件

open_basedir=/www/wwwroot/taois.top/:/tmp/:/proc/

seepine

Golden 多谢，后来整个目录删掉重装了次就好了

幻想工作室

Golden composer create-project flarum/flarum . –stability=beta

安装这一步时报错报错

幻想工作室

Golden composer create-project flarum/flarum . –stability=beta

安装这一步时报错

Levi_Marvin

建议在帖子“五、安装 Flarum”内容之前加入：
设置设置PHP配置文件：

最大脚本运行时间（max_execution_time）：600
脚本内存限制（memory_limit）：1024M

详见：https://discuss.flarum.org.cn/d/2506

alex1504

教程完整而且清晰，已搭好，赞

kaifang

教程好评, 终于搭建成功了👍🤝

smt

感谢，安装最新版的1.02成功：https://gg.smt.net/ 网址贴出来，若有不对的地方，还请朋友们指点，目前属于学习试运营阶段。一面摸索，一面学习。暂未推广。静待自我提高。😍

ceshi123

smt 大佬，为啥你的站点访问不卡顿，我的站点每次刷新都要卡顿几秒时间，有的时候更长。

Boxster

恭喜恭喜 (^__^)

qiang

成功了，very good

抱天下

终端返回报错，文件未能保存，终端输出如下：

PHP Warning:  putenv() has been disabled for security reasons in phar:///usr/local/bin/composer/vendor/composer/xdebug-handler/src/Process.php on line 93

Warning: putenv() has been disabled for security reasons in phar:///usr/local/bin/composer/vendor/composer/xdebug-handler/src/Process.php on line 93
PHP Warning:  putenv() has been disabled for security reasons in phar:///usr/local/bin/composer/src/Composer/Util/Platform.php on line 37

Warning: putenv() has been disabled for security reasons in phar:///usr/local/bin/composer/src/Composer/Util/Platform.php on line 37
Creating a "flarum/flarum" project at "./"
Installing flarum/flarum (v1.0.0)
  - Downloading flarum/flarum (v1.0.0)
  - Installing flarum/flarum (v1.0.0): Extracting archive
    Install of flarum/flarum failed

                                                                                           
  [Symfony\Component\Process\Exception\RuntimeException]                                   
  The Process class relies on proc_open, which is not available on your PHP installation.  
                                                                                           

create-project [-s|--stability STABILITY] [--prefer-source] [--prefer-dist] [--prefer-install PREFER-INSTALL] [--repository REPOSITORY] [--repository-url REPOSITORY-URL] [--add-repository] [--dev] [--no-dev] [--no-custom-installers] [--no-scripts] [--no-progress] [--no-secure-http] [--keep-vcs] [--remove-vcs] [--no-install] [--ignore-platform-req IGNORE-PLATFORM-REQ] [--ignore-platform-reqs] [--ask] [--] [<package>] [<directory>] [<version>]

SS_PRO

抱天下把php的putenv打开啊，教程里说了

抱天下

SS_PRO 解禁了啊

抱天下

SS_PRO

松鼠爱摸鱼

抱天下 php cli 命令行版本改下

peteru100

大家有遇到这个问题吗？
Creating a “flarum/flarum” project at “./”
Installing flarum/flarum (v1.0.0)
Failed to download flarum/flarum from dist: /www/wwwroot/processing.love/vendor/composer does no
t exist and could not be created.
Now trying to download from source

Installing flarum/flarum (v1.0.0): Cloning d5b2515f54
Install of flarum/flarum failed

yannis

peteru100

安装源试试看切换默认或者国内源，
另外，ssh 指令用户有给到权限吗？

peteru100

嗯嗯，已经解决了，是运行require的命令，必须是在网站的目录运行，小白前端不太懂，嘿嘿

kyyi

执行composer create-project flarum/flarum .

报错如下：
InvalidArgumentException]
Project directory “/home/lighthouse/.” is not empty.

但是我的网站目录并不是这样的。是/wwwroot/home/www/****.com

Golden

kyyi 需要 cd 进网站目录再运行安装命令，你现在的命令行在 /home/lighthouse 目录