Meilisearch 是一个 Rust 写的搜索引擎,对外只有 HTTP 接口。官方发一个 exe,双击后监听 7700 端口,既能当站内搜索后端,也能接进 RAG 做向量与混合检索。这篇在 Windows 上起服务,灌四条文档,再跑三种查询,记下每一步的实际返回。

一个 353 MB 的可执行文件,2.41 秒起服务

Windows 包不是压缩包,直接就是一个 exe,没有依赖库也没有安装程序。启动时要用 --master-key 给一个主密钥,否则读写接口一律拒绝。

meilisearch-windows-amd64.exe   352,880,640 字节
启动命令                        meili.exe --master-key <key> --env development \
                                --db-path D:\wb_cache\lab\meili_data --http-addr 127.0.0.1:7700
/health 返回 200                 2.41 秒
版本                             1.55.0(commit 420ff13)

体积大是因为索引引擎与 Web 面板、鉴权都编进了同一个二进制。--env development 会打开自带面板,生产模式下面板不出现。

四条文档,索引 0.2 秒

直接 POST 到 /indexes/products/documents,索引不用提前建,第一次写入会自动创建。接口返回的是一个异步任务号,要再查一次任务状态才知道成没成。

POST /indexes/products/documents   4 条文档
返回                               taskUid=0, status=enqueued
查任务                              status=succeeded, duration=PT0.20650540
idnamedescprice
1实测库 机械键盘87 键,青轴,PBT 键帽399
2实测库 移动硬盘2TB USB3.2 便携559
3机械键盘腕托木质,适配 87 键79
4蓝牙耳机主动降噪,续航 30 小时699

三种查询的实际返回

同一个索引上换三个关键词,结果差别很明显,尤其是第三个。

查询命中数第一条
键盘2机械键盘腕托
键盘 青轴2实测库 机械键盘
jixie(拼音)0—

搜「键盘」时排第一的是腕托而不是键盘本体,因为它的标题更短、词占比更高。加上「青轴」之后顺序反过来,键盘本身排到了前面。排序按相关性算,不按插入顺序。

拼音那条是硬边界。文档里存的是中文,索引也会做中文分词,但不会把 jixie 映射回「机械」。要支持拼音得自己加同义词或额外字段。

自带面板要先填 key,才认得出索引

开发模式下访问根路径是 Mini Dashboard,页面写着三步:先填 API key,再选索引,然后搜。实际上不填 key 时第二步的下拉是空的,只显示 no index found 和一个「Need help?」按钮。

面板显示         Welcome to Meilisearch / Mini Dashboard
下拉状态         no index found
右侧栏           Start free trial / Export Dataset / Documentation
数据目录         8 个文件,0.4 MB

0.4 MB 是四条文档加索引结构的体积,数据落在 --db-path 指定的目录里,删目录就等于清库。

什么情况下搜不到

同一个索引上试了几个边界输入,能复现的只有拼音这一条。

q=jixie                     命中 0(中文文档里没有 jixie 这个词)
q=键盘 青轴                  命中 2(多词取交集后按相关性重排)
q=(空)                     返回全量前 20 条
输入结果原因
拼音 jixie0 条索引不把拼音映射回汉字
两个词空格分隔2 条多词按交集与相关性排序
错别字未测官方说明支持容错,本次没验证

要把拼音补上,得在写入文档时多加一个拼音字段,或者配同义词表。搜索端本身没有开关能做这件事。

适合谁用

仓库 59,617 星,Rust 编写,对外只暴露 HTTP。它不提供数据库,也不管业务逻辑,只负责「给一段文本,返回排好序的文档」。

场景结论理由
站内搜索合适写入即索引,HTTP 接口简单
中文拼音输入要自己补jixie 查不到「机械」
可视化调参勉强面板要先填 key,功能不多
单机小项目看体积一个 exe 353 MB

实测范围:Windows 10 22H2(10.0.19045.6466)、Meilisearch v1.55.0、开发模式。分面与地理搜索没有验证。向量检索、多索引、密钥分级也没有验证,都不作结论。