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
| id | name | desc | price |
|---|---|---|---|
| 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 条
| 输入 | 结果 | 原因 |
|---|---|---|
| 拼音 jixie | 0 条 | 索引不把拼音映射回汉字 |
| 两个词空格分隔 | 2 条 | 多词按交集与相关性排序 |
| 错别字 | 未测 | 官方说明支持容错,本次没验证 |
要把拼音补上,得在写入文档时多加一个拼音字段,或者配同义词表。搜索端本身没有开关能做这件事。
适合谁用
仓库 59,617 星,Rust 编写,对外只暴露 HTTP。它不提供数据库,也不管业务逻辑,只负责「给一段文本,返回排好序的文档」。
| 场景 | 结论 | 理由 |
|---|---|---|
| 站内搜索 | 合适 | 写入即索引,HTTP 接口简单 |
| 中文拼音输入 | 要自己补 | jixie 查不到「机械」 |
| 可视化调参 | 勉强 | 面板要先填 key,功能不多 |
| 单机小项目 | 看体积 | 一个 exe 353 MB |
实测范围:Windows 10 22H2(10.0.19045.6466)、Meilisearch v1.55.0、开发模式。分面与地理搜索没有验证。向量检索、多索引、密钥分级也没有验证,都不作结论。









