MeiliSearch 1.55 介绍与选型指南

本文为 MeiliSearch 的认知篇（A1），基于官方公开资料编写，只做介绍与选型分析，不包含本地安装与实测内容。

一、信息基准

1.1 基本信息

1.2 版本依据

1.3 官方来源清单

二、软件概述

Meilisearch 1.55 是本次介绍的版本号（2026-10-19 官方最新稳定版 v1.55.0）。Meilisearch 是一个面向终端用户搜索体验的搜索引擎：单个可执行文件即可启动，默认零配置，围绕「键入即搜（search-as-you-type）」设计，内置拼写容错、前缀匹配、分面与筛选、地理搜索等站内搜索所需的主流能力，并通过 REST API 与多语言 SDK 对接应用。

其定位是「应用内搜索」而非「大数据检索平台」：以中小规模数据集、低运维投入、开箱即用为目标，适合开发者快速为产品加上一个体验优秀的搜索框。项目采用 MIT（核心）与 BUSL-1.1（企业版功能）混合许可，选型时需留意企业版功能的许可边界。

三、核心概念

3.1 索引与文档

• 索引（Index）：文档的集合，每个索引绑定一个主键属性（primaryKey），用于唯一标识文档与增量更新去重。
• 文档（Document）：JSON/CSV/NDJSON 对象数组，字段无需预定义 schema，任意字段均可参与检索；可通过 settings 控制可搜索（searchableAttributes）与可展示（displayedFields）字段。

3.2 检索相关设置

3.3 分词与多语言

Meilisearch 的分词由其开源分词库 charabia 提供，支持包括中文、日文在内的多语言切分与归一化（部分语言能力需在构建时启用特性开关），中文场景应在官方「Language support」文档中核对当前支持级别。

3.4 安全模型

• 主密钥（master key）：实例级根密钥，启动时通过 --master-key 指定，用于派生 API 密钥。
• API keys：区分 admin 与 search 权限，可设置过期时间与索引范围。
• 租户令牌（tenant tokens）：面向多租户场景，在前端安全下发、按规则过滤搜索结果。

四、功能特性

1. 键入即搜：前缀匹配与拼写容错开箱即用，无需配置即可容忍键入错误并返回建议。
2. 筛选与分面：通过 filter 表达式（布尔、范围、IN 列表）组合过滤，facets 返回分面统计。
3. 排序与相关性：内置默认相关性规则链，支持 sort 参数与自定义 rankingRules、可配置展示字段与高亮（highlightPreTag 等）。
4. 地理搜索：文档携带 _geo 字段后可按坐标过滤与排序（_geoRadius、_geoBoundingBox）。
5. 混合搜索：1.x 引入 embedders 设置，可为索引配置官方内置或外部向量来源，执行关键词与语义混合检索，调节 semanticRatio。
6. 多租户与权限：API keys + tenant tokens 组合实现按用户/租户的数据隔离搜索。
7. 运维界面：开发模式下自带浏览器 mini dashboard，便于调试索引与查询。
8. 官方 SDK：meilisearch-js、meilisearch-python、meilisearch-php、meilisearch-go、meilisearch-rust、meilisearch-java、meilisearch-dotnet 等（官方 SDK 目录实查）。

五、快速上手

以下示例引自官方文档《Quick Start》（来源：https://www.meilisearch.com/docs/learn/getting_started/quick_start ），不涉及本地实测输出。

5.1 安装并启动

# 官方安装脚本（Quick Start 提供，另有各平台软件包与静态二进制）
curl -L https://install.meilisearch.com | sh

# 以主密钥启动（官方示例命令）
./meilisearch --master-key "aSampleMasterKey"

5.2 添加文档

# 向 movies 索引推送 JSON 文档（官方示例）
curl -X POST 'http://127.0.0.1:7700/indexes/movies/documents?primaryKey=id' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer aSampleMasterKey' \
  --data-binary @movies.json

5.3 执行搜索

# 关键词搜索（官方示例，键入即搜默认开启）
curl 'http://127.0.0.1:7700/indexes/movies/search?query=botman' \
  -H 'Authorization: Bearer aSampleMasterKey'

六、适用场景与限制

6.1 适用场景

1. 电商、内容站、SaaS 应用的站内搜索与商品检索，需要拼写容错与分面导航。
2. 文档站、帮助中心的即时搜索框，对首字延迟与键入即搜体验敏感。
3. 多租户 SaaS 的数据隔离搜索（tenant tokens + filter 规则）。
4. 希望在关键词检索之上叠加轻量语义/混合搜索的应用（embedders 混合检索）。
5. 无专职搜索运维团队的中小团队：单文件部署、默认零配置、REST API 直连。

6.2 限制与注意

1. 以单实例为设计基准，官方未提供内建的数据分片与多节点复制集群能力，超大规模数据与高可用需求需另行评估架构。
2. 企业版功能（如部分高级能力）以 BUSL-1.1 许可发布，采用前需核对 LICENSE 与 LICENSE-EE 边界。
3. 中文等多语言切分依赖 charabia 的语言支持级别，特定语言场景应先在官方语言支持文档确认效果。
4. 与 Elasticsearch/OpenSearch 相比，聚合分析、SQL 化查询、日志场景能力不在其定位内。
5. 主版本迭代快、多条版本线并行维护，升级时应关注官方变更日志中的破坏性变更。

七、同类选型对比

7.1 候选与版本基准

7.2 量化对比

7.3 选型建议

一句话建议：中小数据规模、追求开箱即用与低运维的站内/应用内搜索选 Meilisearch；需要分布式扩展、聚合分析与完整生态工具链，在许可合规前提下选 Elasticsearch（或 Apache 2.0 的 OpenSearch）；数据集较小但对延迟极敏感、可接受内存占用与 GPLv3 的场景选 Typesense。

八、参考链接

1. Meilisearch 官网：https://www.meilisearch.com/
2. 官方文档（Quick Start）：https://www.meilisearch.com/docs/learn/getting_started/quick_start
3. 官方设置项参考：https://www.meilisearch.com/docs/reference/api/settings
4. GitHub 仓库与发行 feed：https://github.com/meilisearch/meilisearch
5. 官方 SDK 目录：https://www.meilisearch.com/docs/learn/what_is_meilisearch/sdks
6. 官方文档入口（可检索 Language support 等主题）：https://www.meilisearch.com/docs
7. 本文对比对象官方站点：Elasticsearch https://www.elastic.co/elasticsearch/ 、OpenSearch https://opensearch.org/ 、Typesense https://typesense.org/