使用Meilisearch实现全站搜索

简介

Meilisearch 是一个开源的轻量级全文搜索引擎，支持中文分词、模糊搜索、拼写纠错等。

与之相似的竞品有：Elasticsearch、Typesense、Algolia等。其中，Elasticsearch 是老牌搜索服务，但是运行起来太笨重了，除非数据量很大，否则其余轻量级的实现要更好。

后两者 Typesense、Algolia 和本文的主角 Meilisearch 都是更轻量级别的存在，但是 Algolia 不开源，只能使用他们的云服务，而我不太喜欢被平台给局限住，所以也放弃了。

Typesense 和 Meilisearch 都是开源的同时也都提供云服务。很可惜，前者的文档集存在 RAM 里，后者则主要放在磁盘里，虽然性能上确实是前者更出色，但是很明显 RAM 可比存储空间贵的多。

另外，Meilisearch 的社区开发环境也更好。截至本文发布，Meilisearch 有52K stars, 296 watching, 2.1K forks, 201 contributors，而 Typesense 只有23.6K stars, 132 watching, 773 forks, 46 contributors。

(另外，Meilisearch还是用我喜欢的Rust写的)

因此，本文主要讲 Meilisearch 的部署与使用。另附我找到的几个比较资料，或许能帮你选择合适自己的服务。

• Algolia vs ElasticSearch vs Meilisearch vs Typesense 之比较 | 日思录
• Meilisearch 与 Typesense - Meilisearch 搜索引擎

部署

Meilisearch 支持下载二进制和 Docker 部署两种方式。

二进制

另外，Meilisearch 还支持一键脚本安装：

curl -L https://install.meilisearch.com | sh

或者手动下载二进制文件：

Releases · meilisearch/meilisearch

下载完后，使用以下方式启动：

./meilisearch --master-key=YourMasterKey

其中，MasterKey 算是一个管理员密码，可以是 16 位以上的 UTF-8 字符串。获取 API 密钥需要通过此Key，访问管理后台也需要。

也可以自定义端口，默认是7700。

./meilisearch --http-addr '0.0.0.0:7700'

Docker

docker run -it --rm \
  -p 7700:7700 \
  getmeili/meilisearch \
  meilisearch --master-key='YourMasterKey' --http-addr '0.0.0.0:7700'

使用

使用也很简单，分4步，分别是查看当前的API Token、设置要搜索的数据类型、写入数据、搜索。 下面会用到很多curl，windows建议用Postman，直接粘贴进去就能解析。

查看当前API Token

curl -X GET 'https://Your_Meili_URL/keys' -H 'Authorization: YourMasterToken'

获取到的结果是：

{
    "results": [
        {
            "name": "Default Search API Key",
            "description": "Use it to search from the frontend",
            "key": "xxxxxxxx",
            "uid": "xxxxxxxx",
            "actions": [
                "search"
            ],
            "indexes": [
                "*"
            ],
            "expiresAt": null,
            "createdAt": "2025-06-25T11:08:45.729263258Z",
            "updatedAt": "2025-06-25T11:08:45.729263258Z"
        },
        {
            "name": "Default Admin API Key",
            "description": "Use it for anything that is not a search operation. Caution! Do not expose it on a public frontend",
            "key": "xxxxxxxx",
            "uid": "xxxxxxxx",
            "actions": [
                "*"
            ],
            "indexes": [
                "*"
            ],
            "expiresAt": null,
            "createdAt": "2025-06-25T11:08:45.726891008Z",
            "updatedAt": "2025-06-25T11:08:45.726891008Z"
        }
    ],
    "offset": 0,
    "limit": 20,
    "total": 2
}

简单来说会给你两个 Token，存在key字段里，上面是搜索用的，下面是管理用的。

设置数据类型

如果你想索引这样的一个东西：

model Post {
  id           Int      @id @default(autoincrement())
  title        String   @db.VarChar(50)
  content      String   @db.VarChar(200)
  userUid      Int?
  createdAt    DateTime @default(now())
  User         User?    @relation(fields: [userUid], references: [uid])
}

它包含一个主键:id，两个你想索引的东西:title,content。 那么，你首先应该创建这个项：

（这里的API Token既可以用MasterKey，也能用Default Admin API Key）

curl -X POST 'https://Your_Meili_URL/indexes' \
  -H 'Authorization: Bearer API_TOKEN' \
  -H 'Content-Type: application/json' \
  --data '{
    "uid": "posts",
    "primaryKey": "id"
}'

结果：

{

    "taskUid": 0,
    "indexUid": "posts",
    "status": "enqueued",
    "type": "indexCreation",
    "enqueuedAt": "2025-06-25T12:37:59.414437837Z"

}

然后，设置可被搜索的字段：

curl -X PUT 'https://Your_Meili_URL/indexes/posts/settings/searchable-attributes' \
  -H 'Authorization: Bearer API_KEY' \
  -H 'Content-Type: application/json' \
  --data '[
    "title", "content"
  ]'

你也可以设置一些可以用于排序的字段：

curl -X PUT 'https://Your_Meili_URL/indexes/posts/settings/sortable-attributes' \
  -H 'Authorization: Bearer API_KEY' \
  -H 'Content-Type: application/json' \
  --data '["createdAt"]'

类似的，设置用于过滤的字段：

curl -X PUT 'https://Your_Meili_URL/indexes/posts/settings/filterable-attributes' \
  -H 'Authorization: Bearer API_KEY' \
  -H 'Content-Type: application/json' \
  --data '["userUid"]'

写入数据

现在就可以写入数据了。可以用curl，或者是官方SDK：

curl -X POST 'https://Your_Meili_URL/indexes/posts/documents' \
  -H 'Authorization: Bearer API_KEY' \
  -H 'Content-Type: application/json' \
  --data '[
    {
      "id": 1,
      "createdAt": "2025-06-25T00:00:00Z",
      "title": "中文标题",
      "content": "中文内容",
      "userUid": 1,
    }
  ]'

import { MeiliSearch } from 'meilisearch';
import { Post } from '@/generated/prisma';

const client = new MeiliSearch({
  host: process.env.MEILI_HOST || "",
  apiKey: process.env.MEILI_API_KEY, 
})

const index = client.index('posts')

async function addSingleDocument(post: Post) {
  await index.addDocuments([post])
}

await addSingleDocument(post)

搜索

搜索也是，可以用curl，或者是官方SDK：

curl -X POST 'https://Your_Meili_URL/indexes/posts/search' \
  -H 'Authorization: Bearer API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
    "q": "关键词",
    "limit": 10,
    "offset": 0,
    "filter": "userUid = 1 AND title = xxx",
    "sort": ["createdAt:desc"]
}'

import { MeiliSearch } from 'meilisearch';

const client = new MeiliSearch({
  host: process.env.MEILI_HOST || "",
  apiKey: process.env.MEILI_API_KEY, 
})

async function searchPosts(query) {
  const index = client.index('posts')
  const result = await index.search(query, {
    limit: 10
  })
  console.log(result.hits)
}

searchPosts('中文')

评论