Flarum论坛中文搜索解决方案：轻量级搜索引擎meilisearch部署+配置

Flarum论坛程序默认的搜索功能对中文不是很好，想要友好的中文搜索效果只能自己解决，当前可用的flarum中文搜索解决方案有使用Elasticsearch、Meilisearch、sonic、Algolia这些搜索插件，本文介绍的是Meilisearch这个轻量级搜索引擎。

其他解决办法：Flarum论坛中文搜索解决方案 无需插件版。

Meilisearch搜索引擎介绍

之前写过一篇Algolia搜索插件的配置指南，配置确实简单，创建一个账号就行，不占用自己服务器，但是这个插件有免费额度，量大的情况就不划算了。因此有了这篇文章的诞生。使用Meilisearch的好处是：支持自部署，轻量，最主要的是部署简单+省钱。

Flarum论坛配置部署Meilisearch的步骤如下：

• 安装meilisearch；
• flarum网站服务器安装meilisearch sdk；
• flarum网站部署Scout Search 扩展；
• flarum后台配置meilisearch api；
• flarum网站创建索引；

安装meilisearch

以docker的方式部署(具体见官网)：

docker run -d --name flarum_meilisearch \
-p 7700:7700 \
-v $(pwd)/meili_data:/meili_data \
getmeili/meilisearch:v1.12 \
meilisearch --master-key="749eb456-xxxx-xxxx-xxxx-c7d9366135ea"

以docker compose方式部署：

services:
  meilisearch:
    image: getmeili/meilisearch:latest
    container_name: meilisearch
    restart: unless-stopped
    ports:
      - '7700:7700'
    volumes:
      - ./meilisearch-data:/meilisearch-data
    environment:
      MEILI_MASTER_KEY: 50eacc8c-c44c-xxxx-xxxx-2d121ebdb310
      # Optional: Disable analytics and Sentry
      MEILI_NO_ANALYTICS: 'true'
      MEILI_NO_SENTRY: 'true'

安装meilisearch sdk

需要在你网站目录(Flarum安装目录)运行下面命令：

composer require meilisearch/meilisearch-php

安装Scout Search 扩展

依旧是在网站目录(Flarum安装目录)运行下面命令：

composer require clarkwinkelmann/flarum-ext-scout

启用 Scout Search

登录网站后台，在设置里填写Meilisearch 的API，具体需要添加的选项为：

• 驱动：选择meilisearch；
• 索引名前缀（可选）：最好填写上，方便区分，比如ai_前缀。
• Meilisearch 主机地址：your_ip:7700
• Meilisearch 秘钥：部署时的配置；

创建索引

创建索引 ，在 Flarum 安装目录运行：

php flarum scout:import-all

更多命令，如删除索引等，参考项目。

参考文章：

• install_meilisearch_locally#docker
• meilisearch guide
• using-meilisearch-with-docker
• flarum配置中文搜索meilisearch