前言

自从有了服务器之后一直有点蠢蠢欲动，纯静态博客已经满足不了我了，搭建一个轻社区的想法疯狂的在脑子里生长，今天突然有个机会了解到了Flarum这个开源轻社区，强大，方便，体积小，响应快

官方GitHub：https://github.com/flarum/flarum

官方的部署过程，，，emm，一言难尽

然后看到了宝塔面板的应用商店里居然有现成的docker版本，果断下载安装，结果，，，emm，根本就没反应啊喂，坐牢塔根本不给任何的提示，百度也搜不到相关教程，说是要缺少配置，到底要配置什么你倒是告诉我啊喂，果断放弃

继续百度，在茫茫人海里突然看到了一个大佬发布的使用docker手动部署的博文，简直就是天籁之音，思路一下子打开

教程原文：https://blog.csdn.net/qq_37887537/article/details/130071605

docker镜像地址：https://github.com/mondediefr/docker-flarum

注：这是第三方打包的地址，而且这个仓库已经好几年没有更新了，大概率版本是比较老旧了，但是我去dockerhub看了一眼，居然是三天前更新的，所以本文中下方等会要写的配置文件中的版本，就见仁见智了，可以自己尝试更新一下

开始部署

第一步：安装docker和docker-compose就不赘述了，可以看https://imbhj.com/posts/e5f6a19a/

第二步：拉取镜像

1
2
3
4
#最新版
sudo docker pull mondedie/flarum:latest
#稳定版（推荐）：
sudo docker pull mondedie/flarum:stable

第三步：写配置文件

在自己能看的顺眼的位置新建一个文件夹作为根目录，名字随意

cd进入新建好的文件夹

touch一个新的文件： docker-compose.yml （文件名必须是这个）

vim docker-compose.yml ：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
#未知含义的版本号
version: "3"
 
services:
  flarum:
  	#镜像及版本
    image: mondedie/flarum:stable
    #容器名称
    container_name: flarum
    #环境文件路径
    env_file:
      - ./envfile/flarum.env
    #挂载的其他文件路径
    volumes:
    #静态资源目录
      - ./assets:/flarum/app/public/assets
    #扩展/插件目录
      - ./extensions:/flarum/app/extensions
    #日志目录
      - ./logs:/flarum/app/storage/logs
    #nginx配置目录
      - ./nginx:/etc/nginx/flarum
    #容器端口映射
    ports:
      - 8000:8888
    #数据库依赖
    depends_on:
      - mariadb
 
  mariadb:
  	#数据库镜像及版本
  	#需要注意的是这里的数据库版本原作者用的是10.5版本，我这里修改到了11.3
    image: mariadb:11.3
    #数据库容器名称
    container_name: mariadb
    #数据库端口映射
    ports:
      - 3306:3306
    environment:
    #root密码
      - MYSQL_ROOT_PASSWORD=123456
    #数据表名称
      - MYSQL_DATABASE=flarum
    #用户名
      - MYSQL_USER=flarum
    #用户密码
      - MYSQL_PASSWORD=123456
    #数据库文件目录
    volumes:
      - ./db:/var/lib/mysql

建议删除注释食用

注：冒号前面的目录是挂载的宿主机目录，可以自己修改，冒号后面的目录是映射的容器内部的目录，不可以更改，否则读取不到数据

cd进入新建好的env_file文件夹

touch一个新的文件： flarum.env （文件名同你配置文件里的即可）

vim flarum.env ：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
#debug开关
DEBUG=false
#站点IP，如果绑定了域名的话，可以直接设置为访问的域名，如果在局域网内访问也必须更改为局域网的地址
#设置域名之后再用本地IP端口访问会产生跨域请求问题
FORUM_URL=http://127.0.0.1:8000

##数据库配置
#数据库域名，默认为容器名称
#如果要修改数据库端口，此项更改为宿主机域名，防火墙开更改后的端口
DB_HOST=mariadb
#数据表名称
DB_NAME=flarum
#数据库用户名
DB_USER=flarum
#数据库用户密码
DB_PASS=123456
#数据库索引
DB_PREF=flarum_
#数据库端口
DB_PORT=3306
 
##站点配置
#管理员用户名
FLARUM_ADMIN_USER=admin
#管理员密码（必须大于8个字符）
FLARUM_ADMIN_PASS=123456789a
#管理员邮箱
FLARUM_ADMIN_MAIL=admin@domain.tld
#站点标题
FLARUM_TITLE=myflarum

建议删除注释食用

第四步：启动

1
2
3
4
#需要有网络的情况下执行，会自动下载数据库镜像
sudo docker compose up -d mariadb
#启动flarum
sudo docker compose up -d flarum

第五步：访问

直接访问配置文件中的IP地址即可，本机访问127即可，局域网必须设置好局域网IP才可以，自定义域名同理

关闭容器：（在我们创建的根目录下执行）

1
sudo docker compose down

第二次启动容器的时候就可以一键执行：（在我们创建的根目录下执行）

1
sudo docker compose up -d

容器关闭后重新启动，插件需要重新启用并且设置也会重置，但不需要重新安装

更新

在创建的根目录下先关闭容器（如果开启的话）

编辑yml配置文件，将flarum和数据库的版本号都更改为latest

1
sudo docker compose up -d

直接拉取最新的镜像并部署

查看日志：

1
sudo docker logs -f [容器名]

安装插件

插件商店：https://extiverse.com/

安装插件：

1
sudo docker exec -ti flarum extension require [扩展名/扩展名]

移除插件：

1
sudo docker exec -ti flarum extension remove [扩展名/扩展名]

列出扩展列表：

1
sudo docker exec -ti flarum extension list

首先安装中文插件：

1
sudo docker exec -ti flarum extension require flarum-lang/chinese-simplified

该命令实际上就是进入容器中调用该容器已经写好的extension脚本，来进行安装插件

登录管理页面：127.0.0.1:8000/admin（需要在首页登录配置好的管理员账户才有权限访问）

然后点击下方的保存，刷新即可显示为中文

安装标题搜索插件：

1
sudo docker exec -ti flarum extension require ganuonglachanh/flarum-ext-search

点击右上角头像，点击后台管理，启用该插件：

安装图片上传插件：

1
sudo docker exec -ti flarum extension require fof/upload

如果安装失败，执行下列安装指定版本的：

1
sudo docker exec -ti flarum extension require fof/upload:1.3

注意，我这里开启这个上传插件之后就导致无法发帖无法回复，请慎用

应该是docker镜像的作者锁死了该插件的版本，以防php版本不适配

注意：实测直接使用最新版镜像，可以使用文件上传插件

启用之后进行自定义的设置即可

帖子直链插件：https://github.com/PipecraftNet/flarum-ext-id-slug/blob/main/README-cn.md

你也不想你的生成的链接这么长吧，安装：（安装后在常规设置里更改链接引擎）

1
sudo docker exec -ti flarum extension require pipecraft/flarum-ext-id-slug

开启后效果：

其他推荐插件：（安装第三方插件要慎重，尽量安装fof官方插件）

注：插件的加载是有顺序的，可能某些插件会导致其他插件不可用，所以安装插件一定要慎重！

注：不保准这些插件的兼容性，更多插件可以去插件商店看看~

注：安装任何插件之前请务必确保自己的站点的版本，插件是否兼容

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
## 已安装
#黑暗模式
fof/nightmode
#导航栏添加额外链接/菜单
fof/links
#添加一个简单的站点统计widget
#20240318更新，这个插件与下方的一个小插件重复，已卸载
fof/forum-statistics-widget
#用户更改名称插件（配合官方自带的的用户昵称插件使用）
#（安装成功但无法更新插件列表，是网络问题，重新安装一下就可以）
#20240318更新，该插件与官方的昵称插件冲突，已卸载，安装请慎重
fof/username-request
#第三方登录
fof/oauth
#自定义页面
fof/pages
#标记最佳回复
fof/best-answer
#用户或用户组私密帖子（私聊）功能
fof/byobu
#注册邀请码功能
fof/doorman
#过滤帖子敏感词插件（安装完启用后敏感词列表不能为空）
fof/filter
#更改默认发信邮箱的通知权限
fof/default-user-preferences
#删除发信邮箱设置，默认邮箱只用于注册新用户（可能与其他需要邮箱的插件冲突）
clarkwinkelmann/flarum-ext-no-email-notifications
#拦截用乱七八糟的邮箱注册
clarkwinkelmann/flarum-ext-email-whitelist
#更多的emoji表情（开启后建议关闭原生的emoji插件）
clarkwinkelmann/flarum-ext-emojionearea
#用户个人主页添加一个个性签名的字段
fof/user-bio
#在主页面展示一些小部件（配合下面这四个对应的小组件食用）
afrux/forum-widgets-core
afrux/news-widget
afrux/top-posters-widget
afrux/online-users-widget
afrux/forum-stats-widget（这个组件和官方的forum-statistics-widget冲突，建议关闭其中一个）
#给用户个人主页添加社交媒体信息配置
fof/socialprofile
#添加一个返回顶部按钮（二选一）
becod/flarum-backtotop
datlechin/flarum-scroll-buttons（推荐）
#用户列表
fof/user-directory
#帖子浏览量
flarumite/simple-discussion-views
#展示热门帖子（配合afrux/forum-widgets-core食用）
justoverclock/hot-discussions
#添加关注用户功能
ianm/follow-users
#更改自定义翻译
fof/linguist
#将某个帖子设置为头版头条，类似于精华帖
fof/frontpage
#生成sitemap插件
fof/sitemap
#SEO插件
v17development/flarum-seo
#用户协议和隐私政策
fof/terms
#长文目录功能（有小bug，慎用）
tohsakarat/table-of-content
#发帖/文草稿箱/定时发布
fof/drafts
#关注标签插件：
fof/follow-tags
#图片灯箱
darkle/fancybox
#用户资料图片允许裁剪
fof/profile-image-crop
#个人资料背景
sycho/flarum-profile-cover
#用户徽章
v17development/flarum-user-badges
#用户资产（和签到插件依赖）
antoinefr/flarum-ext-money
#签到
ziiven/flarum-daily-check-in
#移动端底部导航
acpl/mobile-tab
#代码风格
ffans/clipboardjs
#屏蔽黑名单IP地址
fof/ban-ips
#用户投票
fof/polls
#个人主页留言板
fof/moderator-notes
#博客板块功能
v17development/flarum-blog
#添加PWA功能
askvortsov/flarum-pwa
#合并主题
fof/merge-discussions
#展示帖子已经阅读了百分之多少
justoverclock/thread-read-time
#用户等级
foskym/flarum-custom-levels

配置文件默认参数

UID Flarum user id optional 991
GID Flarum group id optional 991
DEBUG Flarum debug mode optional false
FORUM_URL Forum URL required none
DB_HOST MariaDB instance ip/hostname optional mariadb
DB_USER MariaDB database username optional flarum
DB_NAME MariaDB database name optional flarum
DB_PASS MariaDB database password required none
DB_PREF Flarum tables prefix optional none
DB_PORT MariaDB database port optional 3306
FLARUM_PORT Port to run Flarum on inside the container optional 8888
UPLOAD_MAX_SIZE The maximum size of an uploaded file optional 50M
PHP_MEMORY_LIMIT PHP memory limit optional 128M
OPCACHE_MEMORY_LIMIT OPcache memory size in megabytes optional 128
LOG_TO_STDOUT Enable nginx and php error logs to stdout optional false
GITHUB_TOKEN_AUTH Github token to download private extensions optional false
PHP_EXTENSIONS Install additional php extensions optional none

debug

插件状态数据丢失

目前mondediefr的这个镜像，存在一个问题，就是容器重载之后插件启用状态的丢失

在GitHub里有人提出了这个问题，且给出了解决方案：https://github.com/mondediefr/docker-flarum/issues/81

如果你已经运行了，并且配置了一些东西，先使用 docker cp 命令，将下面两个文件和一个文件夹所有的内容拷贝到宿主机：

1
2
3
/flarum/app/vendor
/flarum/app/composer.json
/flarum/app/composer.lock

然后在yml配置文件中添加下这三个路径：

1
2
3
4
5
6
7
8
 volumes:
       - /mnt/docker/flarum/assets:/flarum/app/public/assets
       - /mnt/docker/flarum/extensions:/flarum/app/extensions
       - /mnt/docker/flarum/storage/logs:/flarum/app/storage/logs
       - /mnt/docker/flarum/nginx:/etc/nginx/flarum
+      - /mnt/docker/flarum/vendor:/flarum/app/vendor
+      - /mnt/docker/flarum/composer.json:/flarum/app/composer.json
+      - /mnt/docker/flarum/composer.lock:/flarum/app/composer.lock

重启容器，就可以解决这个bug了

如果你没有运行，站点还没有配置，建议直接加上这三个路径，一劳永逸 （这个我没试过可不可以，如果直接配置这三个目录后发现容器启动不起来，那么可以先不加，启动之后复制出来再添加）

用户无法注册

用户注册时候显示注册失败，但是后台已经注册好了用户的数据：

该报错是因为后台管理-邮箱界面没有配置邮箱服务导致的

删除用户

在后台管理-用户页面，点击用户名进入用户主页，点击编辑，删除：

生产环境和测试环境分离

更改yml配置文件中的端口以及容器名称

更改envfile中的数据库host为当前主机的IP

防火墙放行更改后的端口即可同时运行两个站点（记得备份）

现已放弃docker部署，改为主机部署

下面将是在主机部署遇到的一些问题

主页PHP警告

1
2
3
4
5
afrux/forum-widgets-core
afrux/news-widget
afrux/top-posters-widget
afrux/online-users-widget
afrux/forum-stats-widget

上面这几个插件安装之后访问主页会有php的警告

在站点php设置里，把警告提示输出关闭即可：

返回顶部/底部按钮

采用 datlechin/flarum-scroll-buttons 插件，CSS样式优化：

1
2
3
4
5
/* flarum-scroll-buttons返回顶部/底部按钮样式优化 */ 
.ScrollButtons-button {
    background: @primary-color !important;
    opacity: 1 !important;
  }

优化搜索高亮

1
2
3
4
/* 搜索结果关键字高亮 */
.DiscussionListItem-main mark {
    background: #ffff80 !important;
}