Flarum论坛网站搭建教程 | 零基础搭建论坛社区网站 | Flarum主题和插件安装教程

Posted on Author admin 0

Linux+Docker+1Panel+Flarum 快速搭建轻量级论坛网站，纯小白教程，手把手教你搭建论坛网站。此教程使用Docker来快速部署Flarum，省去了PHP环境配置的麻烦。还有Flarum的主题和插件安装的教程。

随着开源社区的日益繁荣，人们对社区品质的要求也越来越高。传统的 BBS 论坛模式已经难以满足现代用户对美观、便捷、互动性的需求。搭建一个现代化的高品质社区，成为许多网站管理者的迫切需求和共同挑战。

今天就给大家安利一款现代化的、优雅的开源论坛软件 – Flarum。

视频教程： https://www.bilibili.com/video/BV1WgoFYxEf6/

简介

什么是论坛

论坛（Forum）作为互联网早期的社交形态，是用户围绕特定主题进行深度讨论的虚拟社区。传统BBS论坛（如Discuz!）以树状回帖、版块划分和等级体系为核心，而现代论坛（如Flarum）更注重扁平化交互设计和移动端优先体验。相较于博客的单向输出，论坛具备更强的用户共创性——通过话题发起、多级回复、点赞收藏等机制，形成知识沉淀与社交网络的双重价值。

站长交流群：767557452

Flarum简介

Flarum 是一个诞生于 2014 年的开源论坛软件项目。创始人 Toby Zerner 和 Franz Liedke 希望创建一个现代化的、优雅的论坛系统，以应对传统论坛软件在界面设计、用户体验、可扩展性等方面的不足。

经过两年的开发，Flarum 在 2015 年发布了第一个公开 Beta 版本，迅速吸引了大量开发者和社区运营者的关注。此后，Flarum 不断迭代更新，社区不断壮大，逐渐成长为论坛软件领域的一颗新星。

Flarum 的设计理念可以概括为 “现代、简约、优雅”。它摒弃了传统论坛软件臃肿、复杂的设计，转而追求简洁明了的界面布局和流畅自然的用户交互。

Flarum 采用了当今流行的前后端分离架构。后端基于PHP 和 Laravel 框架开发，提供 RESTful API 接口；前端则使用 JavaScript 语言和 Mithril.js 框架编写，实现了单页应用 (SPA) 的用户界面。这种现代化的架构设计赋予了 Flarum 更好的性能、灵活性和可维护性。

Flarum 的主要特点包括：

  • 扁平化、响应式的界面设计，适配不同尺寸的设备。
  • 简单直观的用户操作流程，降低使用门槛。
  • 细粒度的用户权限管理，满足社区的管理需求。
  • 丰富的社交互动功能，如点赞、@提及、实时通知等。
  • 强大的可扩展性，支持通过插件和 API 进行功能扩展。
  • 支持中文、英语、法语、俄语、日语等在内的20+种主流语言。

Flarum vs 传统 BBS 论坛：

特性Flarum传统 BBS 论坛
界面设计✅ 现代、简约、美观❌ 相对老旧、界面复杂
移动端适配✅ 响应式设计，自动适配不同屏幕❌ 大多未针对移动端优化
社交互动✅ 点赞、@提及、站内通知等丰富的互动功能❌ 互动形式相对单一
实时性✅ 内容更新近乎实时，无需刷新页面❌ 实时性相对较弱
可扩展性✅ 模块化设计，支持插件扩展功能❌ 可扩展性相对有限
用户权限管理✅ 细粒度的用户组权限设置✅ 通常也有比较完善的权限管理
功能丰富程度❌ 相对较新，功能还在不断完善中✅ 经过多年发展,功能非常丰富
用户习惯❌ 现代化的界面和交互方式可能需要用户适应✅ 很多用户已经习惯了传统 BBS 的使用方式

Flarum项目开源地址：https://github.com/flarum/flarum

1Panel简介

1Panel 是一款现代化、开源的 Linux 服务器运维管理面板，基于 Docker 容器化技术，旨在简化服务器管理和网站部署流程。其核心功能包括快速建站、高效管理、安全防护及一键备份恢复，尤其适合新手和开发者快速搭建个人或企业网站。

功能亮点：

  1. 一键建站：深度集成 WordPress、Halo 等主流建站程序，支持域名绑定、SSL 证书自动配置，用户可通过应用商店直接安装，无需手动部署环境。
  2. 可视化运维：提供 Web 端图形界面，支持文件管理、数据库操作、容器编排及实时监控（CPU、内存、磁盘等），降低 Linux 命令行操作门槛。
  3. 安全与扩展性：通过最小化漏洞暴露面、防火墙配置及容器隔离技术保障安全；同时支持反向代理、静态网站部署及多语言运行环境（PHP/Java/Python 等），满足多样化需求。
  4. 跨平台兼容：适配主流 Linux 发行版（如 Ubuntu/CentOS）及 ARM 架构，支持云服务器与本地虚拟机部署。

适用场景：个人博客、企业官网、论坛等轻量级站点搭建，尤其适合追求高效、安全且希望减少运维复杂度的用户。

1Panel官网: https://www.lxware.cn?code=zeruns （使用此链接或优惠码 zeruns 可以8折购买专业版，不过一般免费版都够用了）

为何选择Linux+Docker？

  • Linux：服务器主流操作系统，资源占用低且稳定性强；
  • Docker：容器化技术实现环境隔离，避免依赖冲突，部署效率提升80%。

其他建站教程推荐：

搭建流程概述

  1. 注册域名
  2. 购买云服务器
  3. 域名备案（如果不使用内地服务器可以忽略）
  4. 安装1Panel面板和Docker
  5. 安装OpenResty和MySQL
  6. 安装Docker版Flarum论坛程序
  7. 设置反向代理
  8. 设置网站

域名注册

什么是域名？

域名是网站的「门牌地址」，用于代替难记的IP地址数字串（如192.168.1.1）。例如输入 blog.zeruns.com 就能访问特定网站，无需记忆服务器IP。

域名结构分为三部分：

  1. 后缀（如.com）代表网站类型
  2. 主域名（zeruns）是自定义名称
  3. 子域名（blog）可自由设置

当用户输入域名时，DNS系统会自动将其转换为服务器IP地址完成访问。注册域名需通过阿里云等平台购买（年费约50元左右，部分小众的后缀会便宜点），然后将域名与服务器IP绑定解析即可开通网站。好的域名应简短易记，如taobao.com通过谐音让人印象深刻。

注册域名

可以去腾讯云、阿里云和雨云等平台注册域名，也可以使用雨云的免费二级域名。

下面以雨云的为例，注册一个zeruns.xyz的域名。

在云产品里找到域名服务。

点击域名注册，搜索你要注册的域名。

根据提示输入信息

填写完信息后点击立即注册，然后等待审核完成就行

如果你用的境内的服务器那还需要进行域名备案。

备案的流程就不细说，自己去了解一下就行。

温馨提示：购买3个月以上的腾讯云或阿里云等大厂的境内云服务器可以免费提供代备案服务，购买3个月以上雨云的境内服务器也可以免费提供代备案服务。

准备

首先需要一台云服务器，要有公网IP的，推荐雨云的：

雨云优惠注册地址：https://www.rainyun.com/A9527_?s=vpszj

优惠码：A9527

使用优惠码注册后绑定微信可获得5折优惠券

注册完账号后进到雨云控制台，云服务器入口可以在后台的 总览 和 云产品 部分找到：

点击购买云服务器，接着选择服务器区域，国内用户建议选择内地机房。但如果你没有备案域名那建议选择香港或美国的服务器（建议优先选择香港，延迟较低）。

我这里选了香港三区的。

配置选择2核2G一般够用了，如果你网站用户多就选高点的配置，也可以后期升级配置。

系统选择Debian12，都选好后就可以点击立即购买了，也可以选择1元试用1天。

购买后即可在我的云服务器这里看到你买的云服务器，点击管理。

接着就可以看到云服务器的信息了，在这里重装/切换系统，可以升级配置。等待服务器创建完成就可以进行下一步了。

连接服务器

下载安装并打开ssh客户端软件，ssh客户端软件推荐putty或mobaxterm。

SSH客户端软件下载地址：https://www.123pan.com/ps/2Y9Djv-UAtvH.html

我这里用mobaxterm，在SSH客户端中输入你的服务器的IP地址（控制台获取），还有SSH端口（默认是22），然后点击好的或者打开。

然后输入账号并按回车，账号一般默认为root，接着输入密码（密码在控制台获取）并按回车确定，输入密码时不会显示出来。

温馨提示：在SSH终端中按住鼠标左键选择文字，然后松开鼠标，再在空白处单击一下，这样就把选中的文字复制了；在SSH终端单击右键即为粘贴。

APT换源（境外服务器无需进行这步）

系统默认apt软件下载源是国外服务器，所以需要换国内镜像源，使用chsrc来换源。

在SSH终端，输入下面的指令（#开头的是注释，不用输入）。

# 下载安装chsrc
curl https://chsrc.run/posix | bash

# 自动测速，寻找最快者，换源
chsrc set debian

安装1Panel面板和Docker

在SSH终端里执行下面的命令，这个是1Panel的安装脚本，会自动把Docker也装上：

apt -y update && curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && bash quick_start.sh

如果出现这个选择语言，就按照提示输入编号并回车，我这里选 2. Chinese 中文(简体)

出现提示要设置安装目录的就直接回车使用默认的 /opt 目录

接着是设置面板的端口和账号密码，一般直接默认就行，账号密码可以自己输入一个，然后等待一会就安装好了，记住下面这个面板地址和账号密码。

在浏览器地址栏输入面板地址登陆进去。

设置域名解析

到域名解析控制台，添加记录，主机名称自己输入一个名字，比如输入blog，访问网站的时候就是blog.zeruns.top ，输入@，访问网站就直接访问 zeruns.top，记录值输入自己服务器的IP。

安装OpenResty和MySQL

OpenResty 是一个基于 Nginx 的高性能 Web 应用服务器，它将 Nginx 与 Lua 编程语言集成在一起，提供了强大的功能和灵活性。这里用来反代Halo程序。

MySQL是一个流行的开源关系型数据库管理系统（RDBMS），它提供了丰富的功能，适用于各种应用场景。

注意：如果是境内服务器需要先去 容器→配置 这里设置镜像加速（设置项下有文档链接教你如何设置）

点击应用商店，把OpenResty和MySQL都安装上，设置都默认就行。

MySQL的root密码可以自己设置一个，但建议用默认的随机生成的密码

安装Flarum

回到应用商店这里，安装Flarum，在右上角的搜索栏输入Flarum并回车，搜索出Flarum后点击安装。

版本默认选最新的就行，数据库服务选MySQL，数据库名、用户名、密码这些默认就行，你也可以自己修改，会自动创建对应的数据库（如果已经自己创建数据库了就改成你创建的），端口也默认，外部访问地址改成你自己的域名，比如我这里是 http://bbs.zeruns.xyz （不要漏了前面的 http:// ），改好后点击确认，等待安装完成。

完成 Flarum 应用的安装后，此时并不会自动创建一个网站，我们需要手动创建一个网站，然后将 Flarum 应用绑定到这个网站上才能使用域名访问。（其实就是设置反向代理）

点击 1Panel 菜单的 网站，进入网站列表页，点击 创建网站 按钮。

  1. 在已装应用中选择我们刚刚新建的 Flarum 应用。
  2. 正确填写主域名（我这里是 bbs.zeruns.xyz），需要注意的是需要提前解析好域名到服务器 IP。

最后，点击确认按钮，等待网站创建完成即可访问网站进行 初始化。

在浏览器地址栏输入你的域名并回车就可以进到你搭建的论坛网站首页了，接着点击右上角的 Log In 来登陆，默认管理员账号和密码都是 flarum 。（默认是英文，后面会讲如何改中文）

点击右上角的用户名，再点击 Administration 就可以打开管理员后台，可以对论坛进行各种自定义设置了。

修改 Flarum 软件源（境外服务器无需进行这步）

点击 应用商店→已安装→flarum→参数→高级设置

拉到最下面点击 编辑compose文件 ，在输入框最下面输入这串命令（注意代码缩进），然后点击确认，如下图所示

command: >
            /bin/bash -c "
            sed -i 's/dl-cdn.alpinelinux.org/mirrors.ustc.edu.cn/g' /etc/apk/repositories &&
            apk update &&
            apk add git &&
            composer config repo.packagist composer https://mirrors.aliyun.com/composer/ &&
            /init
            "

等待应用重启完成，便可重新打开论坛界面。

个性化设置

通过自定义主题，你可以让你的论坛独具一格，彰显社区的特色。配色方案、导航栏样式、Logo、背景图片，这些都可以自定义。

但首先，我们需要安装一个中文语言包。

安装中文语言包

在1Panel面板里点击容器，找到flarum对应的容器接着点击 终端→连接 ，然后将下面的命令复制到终端里并按回车运行，等待片刻就把中文语言包装好了。

extension require flarum-lang/chinese-simplified:dev-master

进入flarum的管理员后台可以看到多了个中文语言，直接点击这里开启中文语言：

然后点击 Basics，将 Default Language（默认语言） 改为简体中文，最后点击下方的 Save Changes，论坛的语言就变成中文了。如果没有切换就刷新一下页面。

常规设置

接下来进行一些常规的设置，例如论坛名称、论坛描述、欢迎横幅等等。

设置完成后，欢迎横幅是这个样子的：

如果想将改成欢迎横幅改成向左对齐，在 外观 中点击 编辑自定义 CSS，然后填入以下 CSS：

.Hero-close {
    float: right;
    margin-top: -10px;
    color: inherit;
    opacity: 0.5;
    visibility: hidden;
}
.Hero h1 {
    margin: 0;
    font-weight: bold;
    line-height: 1.5em;
}
.containerNarrow {
    max-width: none;
    margin: 0 auto;
    text-align: left;
}

保存之后再刷新页面就变成这个样子了：

页眉和页脚也是可以自定义的，例如：

<div class="footer" style="padding:0 15px;">
    <p style="text-align: center;">
        Copyright © 2023 by <a style="padding: 0 3px;" href="https://blog.zeruns.com/" target="_blank"><b>blog.zeruns.com</b></a>
    </p>
    <p style="text-align: center;">
        声明：除非另有说明，否则本站内容依据 <a rel="license" href="https://creativecommons.org/licenses/by-sa/4.0/deed.zh" target="_blank">CC BY-SA 4.0</a> 许可证进行授权，转载请附上出处链接。
    </p>
    <p style="text-align: center;">
        ⛵️🐳 <a href="https://blog.zeruns.com/" target="_blank" style="font-weight:bold; color:transparent;background-image:linear-gradient(to right,#0ea5e9,#2563eb);-webkit-background-clip: text;background-clip: text">Zeruns</a> | 💡 <a href="https://blog.zeruns.com" target="_blank">About</a>
    </p>
</div>

最终效果如下：

可以使用标签功能来划分论坛板块和分类，在flarum后台启用自带的Tags插件，然后设置好就行。

主题推荐

推荐一个主题，GitHub 地址：https://github.com/yannisme/flarum-oxo-theme

安装方法和之前一样，在1Panel面板里点击容器，找到flarum对应的容器接着点击 终端→连接 ，然后将下面的命令复制到终端里并按回车运行。

extension require yannisme/oxotheme

安装完成后，在管理员后台开启。

最终效果：

如果需要寻找其他主题安装可以去Flarum官方社区找找，提供的安装命令一般类似 composer require yannisme/oxotheme ，需将命令中的 composer 改成 extension

Flarum官方社区的主题板块地址：https://url.zeruns.com/XO3Rc

常用插件推荐

Flarum 的一大魅力在于它的可扩展性。通过安装各式各样的插件，你可以为你的论坛添加新的功能和特性，满足社区的特定需求。无论是增强 SEO 表现、集成第三方身份验证，还是支持全文搜索、实现实时聊天，总有一款插件能够满足你的需要。

以下是一些常用的优质插件：

  • FoF User Directory：为论坛添加用户目录页面，方便浏览和搜索用户。安装方法：extension require fof/user-directory:"*"
  • FoF Filter：帮助论坛管理员自动审核和过滤用户生成的内容。安装方法：extension require fof/filter:"*"
  • FoF Links：让你在论坛的导航栏、侧边栏或页脚添加自定义链接，方便用户快速访问论坛内外的重要页面。安装方法：extension require fof/links
  • SEO：专注于 SEO 优化。安装方法：extension require v17development/flarum-seo
  • Discussion views：显示每个话题 (讨论) 的浏览量，让用户和管理员一目了然地看到社区内容的受欢迎程度。安装方法：extension require michaelbelgium/flarum-discussion-views
  • Echo showfloor：像百度贴吧一样显示楼层。安装方法：extension require wanecho/showfloor:"*"
  • Emoji Picker：让用户在论坛中方便地插入表情符号，与论坛自带的 Emoji 插件冲突，需要先禁用默认的 Emoji 插件。安装方法：extension require clarkwinkelmann/flarum-ext-emojionearea
  • Fancybox-Plus：为 Flarum 论坛提供图片浏览增强功能，安装之后点击图片将会弹出一个优雅的图片浏览界面。安装方法：extension require tohsakarat/fancybox-plus
  • FoF Sitemap：为 Flarum 论坛提供站点地图 (Sitemap) 功能，提升网站的 SEO 表现。安装方法：extension require fof/sitemap

太多了，本文就不一一介绍了，更多插件可到 Flarum 插件市场去找：https://url.zeruns.com/flarum-extension

注意：安装插件时，一律将安装命令中的 composer 替换为 extension。例如以下插件的官方安装命令为 composer require michaelbelgium/flarum-discussion-views ，在flarum容器终端中安装时就需要改成 extension require michaelbelgium/flarum-discussion-views

安装好插件后在flarum后台启用插件就可以了。

开启HTTPS/SSL

开启SSL后可以以https形式访问网站，与网站之间的通信会加密，这样浏览器就不会显示不安全了。

如下图所示，在1Panel面板中找到证书，点击Acme账户，先创建一个Acme账户，账号类型选ZeroSSL（我个人偏向喜欢ZeroSSL的证书），然后输入你自己的邮箱地址后点确认。

接着在DNS账户这里添加雨云，可以自动设置域名解析方便自动续签SSL证书，你也可以不设置这一步，等会申请SSL证书时去雨云控制台手动设置域名解析就行。

去雨云控制台→账号设置那获取API密钥填进去，名称随便填一个就行

然后点击申请证书，选择上面创建的网站，确认。等待一会就可以看到证书申请成功了。

点击 网站→配置→HTTPS→启用HTTPS，选择刚刚申请的SSL证书，然后点击保存。

点击 应用商店→已安装 ，找到flarum应用，点击参数，将外部访问地址的 http 改成 https ，然后点击确定。

再次访问博客网站，可以看到地址栏上显示了一个小锁。

教程到此结束，可以自己慢慢探索建站的乐趣，比如可以使用CDN服务来加速网站访问等等。

推荐阅读

English Version of the Article: https://blog.zeruns.top/archives/52.html

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注