2026最新flarum搭建教程 免费开源Flarum论坛程序搭建图文教程 从零开始搭建flarum论坛

本文详细记录了flarum从零开始搭建的详细图文步骤，希望对初次搭建的朋友有所帮助，教程基于aapanel网站管理面板，默认各位朋友已经安装。

一、环境信息

• Debian 13
• 已安装aapanel并创建了网站和数据库；
• mysql 8.0,因为涉及到中文检索功能，推荐mysql 5.7之后的版本,mariadb不支持ngram参数。
• flarum v1.8.17
• php v8.3

二、安装步骤

1.检查composer当前版本

sudo --user=www composer --version

2.如果版本比较旧了，更新到最新版

依次执行下面命令：

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

php -r "if (hash_file('sha384', 'composer-setup.php') === 'c8b085408188070d5f52bcfe4ecfbee5f727afa458b2573b8eaaf77b3419b0bf2768dc67c86944da1544f06fa544fd47') { echo 'Installer verified'.PHP_EOL; } else { echo 'Installer corrupt'.PHP_EOL; unlink('composer-setup.php'); exit(1); }"


php composer-setup.php

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

查看当前composer位置：

which composer

备份旧版本composer:

mv /usr/bin/composer  ./composer-v2.0.14

替换新版本：

mv composer.phar /usr/bin/composer

3.执行安装flarum命令

⚠️ 执行此步骤时需要注意目录需要是空的，而且指定的用户www拥有目录权限，比如我在路径：/www/wwwroot/www.aichuangshi.com这个空目录下执行。

sudo --user=www composer create-project flarum/flarum:^1.8.0 .

4.在aapanel网站目录设置那里，选择刚才创建的目录，如下图：

5.修改nginx配置，设置URL Rewriting，增加一行内容：

三、访问网站首页进行网站配置

安装环境后，访问网站首页：https://www.your-site.com，会出现如下界面；

依次设置网站名称、管理员账号和密码等。

• mysql username: aapanel创建网站时的数据库用户名；
• mysql password: aapanel创建网站时的数据库密码；
• table prefix: 数据库表前缀，比如我的前缀ai_。

四、网站后台设置

使用上面设置的管理员账号和密码登录，设置网站信息即可。

五、安装扩展

flarum像是一个空架子，很多功能需要以扩展的方式安装，比如中文语言包等。

1.安装中文语言包

sudo --user=www composer require flarum-lang/chinese-simplified

2.内容回复可见组件

组件源码详见。

sudo --user=www composer require rehiy/flarum-reply-to-see:*

3.邮箱白名单组件

过滤一些临时邮箱注册等，组件源码详见。

sudo --user=www composer require nyu8/flarum-email-filter

4.emoji表情选择

组件源码详见：

sudo --user=www composer require clarkwinkelmann/flarum-ext-emojionearea

5.markdown表格

扩展源码详见。

sudo --user=www composer require askvortsov/flarum-markdown-tables:*

6.富文本切换按钮

扩展源码详见：

sudo --user=www composer require askvortsov/flarum-rich-text:*

7.顶部导航链接

扩展源码详见：

sudo --user=www composer require fof/links