Flarum开源论坛部署终极指南：Docker Compose 安装、中文设置与进阶管理详解

Flarum 是一款轻量级、界面优雅的开源论坛系统，专为现代化社区打造。它响应极快、上手简单，提供构建成功社区所需的一整套功能。

核心特性

• 高速易用：基于 PHP 构建，无冗余设计，部署门槛低。
• 美观适配：界面经过精心打磨，自动适应电脑和移动设备，体验一致流畅。
• 扩展力强：提供强大的扩展 API，开发者可深度定制和增强平台功能。

在线演示：https://demo.flarum.site

安装

使用 Docker Compose 一键部署：

services:  
  mariadb:  
    image: mariadb:10  
    container_name: flarum-db  
    environment:  
      - MYSQL_DATABASE=flarum  
      - MYSQL_ROOT_PASSWORD=MYSQL_ROOT_PASSWORD  
    volumes:  
      - ./db:/var/lib/mysql  
    restart: always  
  
  flarum:  
    image: crazymax/flarum:latest  
    container_name: flarum  
    depends_on:  
      - mariadb  
    ports:  
      - 8000:8000  
    environment:  
      - TZ=Asia/Shanghai  
      - PUID=1000  
      - PGID=1000  
      - FLARUM_BASE_URL=http://192.168.31.90:8000  
      - DB_HOST=mariadb  
      - DB_NAME=flarum  
      - DB_USER=root  
      - DB_PASSWORD=MYSQL_ROOT_PASSWORD  
    volumes:  
      - ./data:/data  
    restart: always

重要参数说明（更多细节请查阅官方文档）：

• MYSQL_DATABASE：创建指定名称的数据库。
• MYSQL_ROOT_PASSWORD：Root 帐户的密码。
• /var/lib/mysql：数据库持久化存储路径。
• TZ：时区设置，示例中为上海时区。
• PUID / PGID（可选）：用于权限映射的用户 ID 和组 ID，设为 0 会导致启动失败。
• FLARUM_BASE_URL：填写你的 NAS 局域网 IP 和端口，用于生成站点链接。
• DB_HOST：MariaDB 容器名或 IP。
• DB_NAME / DB_USER / DB_PASSWORD：与上方数据库信息保持一致。
• /data：Flarum 配置与数据的存储路径。

启动与初始化

在浏览器中输入 http://NAS的IP:8000 即可打开安装完成后的界面。

点击右上角“登录”按钮。

使用默认帐号 flarum 和密码 flarum 完成登录。

设置中文

首先进入管理后台，准备调整语言选项。

界面语言目前仅显示英文，但支持通过命令行安装中文包。

进入容器终端，执行下面两条命令：

composer require "flarum-lang/chinese-simplified:*"  
php flarum cache:clear

刷新页面，语言选项中就会出现“简体中文”。

勾选“简体中文”以启用语言包。

然后将站点默认语言设为中文。

保存后刷新，整个界面切换为中文。

修改默认帐号信息

返回论坛首页，点击左上角按钮，我们需要先把默认的用户名和密码更改掉，提高安全性。

点击右上角头像，选择“设置”。

此处可直接修改用户名。

修改密码和邮箱时可能会遇到限制（因为未配置邮件服务）。可采用“迂回战术”：

回到管理后台。

先新建一个管理员用户。

选中刚刚创建的新用户，编辑其权限。

将所有管理权限赋予该用户，这样一来，新帐号实际上拥有了与原管理员同等的控制力。

使用新帐户登录，再次进入后台。

此时便可编辑原始默认用户的密码和邮箱，完成安全加固。

基础操作

在“设置”中可以自定义头像。

“安全”页面记录了登录时间和设备信息，方便监督帐号动态。

返回首页，尝试发一个新帖。

默认帖子编辑器不支持图片上传（只能使用外链），功能较为基础。

滑动至页面最下方，可对帖子进行修改或删除。

其他用户可以在下方发表评论。

整体来看，初始外观较为简洁，功能也显得有限。

后台管理

进入管理后台，可对论坛信息、扩展等进行设置。

“常规”选项允许修改论坛名称、简介等基本信息。

邮件配置不仅支持常见的 SMTP，还兼容多种驱动协议。

“权限”部分可以创建用户组，精细化分配操作权限。

“外观”提供个性化配色方案，甚至支持夜间模式。

可以自定义站点图标，还能注入自定义 HTML 代码。

“用户”管理可添加、编辑用户信息。

扩展功能页面列出了已安装和可启用的插件。

开启某些扩展后，页面会新增分类等模块。

发帖编辑器随之升级，支持 Markdown 语法。

此时图片显示正常（但仍需使用外链，不支持本地上传）。

手机端同样具备良好的适配效果。

总结

Flarum 作为一款轻量开源论坛，界面清爽、移动端适配出色，部署相对便捷。不过也存在一些不足：无法直接本地上传图片、缺少嵌套回复功能，且修改密码时通常需要依赖邮件系统或采用变通方法。它非常适合那些对功能要求不复杂、希望快速建立轻量社区的场合。

综合推荐指数：⭐⭐⭐（无广告、轻量易建）
使用体验：⭐⭐⭐（界面简洁，上手门槛低）
部署难度：⭐⭐⭐⭐（配置参数较多，稍显复杂）