NodeBB继续折腾
本文最后更新于 2024-09-29，文章内容距离上一次更新已经过去了很久啦，可能已经过时了，请谨慎参考喵。
前情提要
部署好 nodebb 之后，发现一个很严重的问题，nodebb 原生的插件 nodebb-plugin-dbsearch 不支持中文搜索，是因为这个插件不支持中文分词，其次也是因为数据库不支持
我在 nodebb 官方论坛中看到貌似 mongo 新版本支持非拉丁文（中文，日文等）检索，但是我是虚拟机部署的，虚拟的 CPU 并不能支持 mongo 5.0版本及以上，所以并未尝试。
经过我熬了一周夜的探索，终于搞清楚怎么通过第三方来实现中文搜索了
顺便也摸清楚了另一个坑，下文会提到。
部署安装
目前（20240913）的解决方案是通过一个官方人员写的第三方插件 nodebb-plugin-meilisearch 来实现
nodebb 版本：v3.8.4，部署方式：Docker Compose
官方论坛对于该插件的讨论：
插件地址：
部署方式，docker-compose.yml ：
services:
nodebb:
image: ghcr.io/nodebb/nodebb:latest
restart: unless-stopped
ports:
- '4567:4567'
depends_on:
# - mongo
- postgres
# - redis
- meilisearch
volumes:
- nodebb-build:/usr/src/app/build
- nodebb-uploads:/usr/src/app/public/uploads
- nodebb-nodemodules:/usr/src/app/node_modules
- nodebb-config:/opt/config
networks:
- internal
- default
# mongo:
# image: 'mongo:7-jammy'
# restart: unless-stopped
# environment:
# MONGO_INITDB_ROOT_USERNAME: nodebb
# MONGO_INITDB_ROOT_PASSWORD: no1de2Bb3sQL4bbs
# MONGO_INITDB_DATABASE: nodebb
# volumes:
# - mongo-data:/data/db
# networks:
# - internal
postgres:
image: postgres:16.3-alpine
restart: unless-stopped
environment:
POSTGRES_USER: nodebb
POSTGRES_PASSWORD: xxxxxx
POSTGRES_DB: nodebb
volumes:
- postgres-data:/var/lib/postgresql/data
networks:
- internal
# redis:
# image: redis:7.2.4-alpine
# restart: unless-stopped
# command: ['redis-server', '--appendonly', 'yes', '--loglevel', 'warning']
# volumes:
# - redis-data:/data
# networks:
# - internal
meilisearch:
image: getmeili/meilisearch:v1.10
restart: unless-stopped
ports:
- '7700:7700'
environment:
MEILI_MASTER_KEY: xxxxxx
volumes:
- meili-data:/meili_data
networks:
- internal
networks:
internal:
name: nodebb-internal
volumes:
# mongo-data:
# driver: local
# driver_opts:
# o: bind
# type: none
# device: ./dataFiles/database/mongo/data
postgres-data:
driver: local
driver_opts:
o: bind
type: none
device: ./dataFiles/database/postgresql/data
# redis-data:
# driver: local
# driver_opts:
# o: bind
# type: none
# device: ./dataFiles/database/redis
meili-data:
driver: local
driver_opts:
o: bind
type: none
device: ./dataFiles/database/meili
nodebb-build:
driver: local
driver_opts:
o: bind
type: none
device: ./dataFiles/build
nodebb-uploads:
driver: local
driver_opts:
o: bind
type: none
device: ./dataFiles/public/uploads
nodebb-nodemodules:
driver: local
driver_opts:
o: bind
type: none
device: ./dataFiles/node_modules
nodebb-config:
driver: local
driver_opts:
o: bind
type: none
device: ./dataFiles/config别忘了设置数据库密码和 meilisearch 的授权密钥。
在 yml 文件同级下创建如下几个文件夹：
mkdir -p ./dataFiles/database/mongo/data
mkdir -p ./dataFiles/database/postgresql/data
mkdir -p ./dataFiles/database/redis
mkdir -p ./dataFiles/build
mkdir -p ./dataFiles/public/uploads
mkdir -p ./dataFiles/config
mkdir -p ./dataFiles/database/meili
mkdir -p ./dataFiles/node_modules启动容器：
docker-compose up -d每次启动容器的时候必须使用魔法，否则容器加载不到 npm 插件就会无限重启。
容器启动之后就可以关闭魔法了。
然后访问域名或者主机的 4567 端口进行设置管理员账号和安装，只有第一次启动会需要安装，第二次启动就不需要设置了（但是还是需要使用魔法哦）
搜索插件
安装完成之后进入后台，在插件中找到 nodebb-plugin-meilisearch ，点击安装
注意，必须在 ACP 面板（也就是 web 端的管理后台）进行安装，不要直接在命令行输入
npm i nodebb-plugin-meilisearch，我亲测这种安装方式会导致缺少依赖。安装插件的过程中也需要使用魔法，否则大概率安装失败，除非是国外可以直接访问 npm 源的 vps。
安装完成之后点击启用，会提示 nodebb 需要重启，这个时候点击左下角的重建和重启，等待重启完毕，刷新页面即可
注意，启用
nodebb-plugin-meilisearch插件的时候请务必确保没有启用其他任何的搜索相关的插件，包括官方自带的nodebb-plugin-dbsearch，因为可能带来兼容性问题。
重建和重启完成之后，刷新页面，点击插件的设置，转到插件设置页面，输入主机 IP 和 meilisearch 的端口，输入在 yml 文件中设置的授权密钥，如下：
设置完毕之后，点击右下角的 save 按钮进行保存，保存完毕之后会提示需要重启，点左下角的重建和重启，等待重启完毕之后刷新页面，回到管理后台的仪表盘页面，查看 meilisearch 是否连接成功：
如果显示连接成功，那么就可以回到论坛，尝试进行搜索了，点击论坛主页右边的搜索，点击搜索框右边的设置，来到搜索的主页面，不输入搜索词，直接点击搜索，查看索引是否成功：
如果显示没有任何内容，尝试回到插件的设置页面，点击红色 Reindex 按钮进行索引重建，或者尝试检查 nodebb 是否成功连接到了 meilisearch
验证搜索，在搜索框输入大于等于 5 个文字或字母，点击搜索，查看是否可以准确搜索到相关内容：
优化检索关键字，回到插件的设置页面，拉到最下面，修改模糊搜索的字符数限制：
第一个 2 代表在最少 2 个汉字或字母的检索词中，允许有一个“错字”，也就是说，如果我输入“用户”这一个词去进行检索，那么插件会进行两次查询，第一次查询“用户”这个词语，第二次单独查询“用”和“户”所匹配的索引
同样 5 也是在最少 5 个汉字或字母中允许有两个“错字”
插件默认应该是 5 和 9，我这里为了方便搜索词语，修改成了 2 和 5，不建议修改的比较小，会耗费很多的资源去进行数据库查询
修改好之后还是一样，点击 save，进行重建和重启，刷新页面即可
对于插件的其他配置项，不建议进行修改，不过可以查看 meilisearch 的官方文档进行了解：
容器重启丢失插件数据
docker 镜像版本：nodebb v3.8.4
在第一次容器启动正常之后，我关闭了容器，进行重新启动，发现所有安装的插件全部丢失，只有官方依赖的固定 15 个插件还在，这个问题困扰了我很久很久，我一直以为是我自己的部署方式有问题，在折腾了好几天之后，我尝试了各种 docker 持久化存储数据的方法，都失败了
我怀疑官方的 docker 镜像根本没做 package.json 的持久化存储，在查看了官方的 dockerfile 之后发现果然，每次容器重启必然会重新生成原始的 package.json，直接覆盖掉 /opt/cinfig 目录下的文件，导致插件的安装状态丢失，实际上插件的文件、配置信息都存在于挂载的数据卷中
目前没有好的解决方法，只有每一次 docker-compose down/up 之后手动再点击安装一次插件，插件的配置信息不需要重新设置，会自动读取到
已经有人给官方提了 issue，等待解决方案吧
20240918更新
重建容器丢失插件数据的解决方法，似乎无解，官方也给出了不保留插件的这么个解释，但是不排除以后会支持，但目前来看，只能重建容器之后手动再一个一个装
我的插件列表在这里：
20240919更新
上面那个链接应该是打不开了，因为今天发布了 3.9.0 新版本，我尝试使用 docker-compose 更新了一下新版本，不出意外，依赖全部炸掉了，部署失败，暂时放弃 docker 部署了，可能还是会转移到宝塔，使用原装部署了，唉。
20240921更新
还是放弃不了，继续用 docker-compose 部署吧，配置文件：
services:
nodebb:
# build: .
image: ghcr.io/nodebb/nodebb:latest
restart: unless-stopped
ports:
- '4567:4567' # comment this out if you don't want to expose NodeBB to the host, or change the first number to any port you want
volumes:
- ./nodebb-build:/usr/src/app/build
- ./nodebb-uploads:/usr/src/app/public/uploads
- ./nodebb-config:/opt/config
postgres:
image: postgres:16.4-alpine
restart: unless-stopped
ports:
- '5432:5432'
environment:
POSTGRES_USER: nodebb
POSTGRES_PASSWORD: 123456789
POSTGRES_DB: nodebb
volumes:
- ./postgres-data:/var/lib/postgresql/data
meilisearch:
image: getmeili/meilisearch:v1.10
restart: unless-stopped
ports:
- '7700:7700'
environment:
MEILI_MASTER_KEY: 123456789
volumes:
- ./meili-data:/meili_data第一次部署大概率会失败，因为权限的问题，部署失败之后把生成的几个目录和文件权限都改成
0777然后重新启动即可。
顺便在这里备份一下插件列表：
nodebb-plugin-custom-pages：自定义页面，主要用来生成根路径的首页；
nodebb-plugin-meilisearch：MeiliSearch搜索，主要用来支持中文搜索；
nodebb-plugin-question-and-answer：问答主题，主要用来生成问答风格的主题帖；
nodebb-plugin-poll：投票主题，主要用来生成投票主题帖；
nodebb-plugin-link-preview：链接预览，当鼠标悬浮在链接上时显示预览内容；
@nodebb/nodebb-plugin-user-level：用户等级，主要用来增加一个用户等级的显示；
nodebb-plugin-recent-cards：轮播卡片插件，用来生成主页顶部的帖子轮播；
@nodebb/nodebb-plugin-reactions：帖子反应，支持用户对帖子、回复以 emoji 的方式进行反应；
