网站 | 路线图 | Meilisearch Cloud | 博客 | 文档 | 常见问题 | Discord

⚡ 一款极速搜索（search engine）引擎，可轻松集成到你的应用、网站和工作流中 🔍

Meilisearch 能帮你快速打造出色的搜索体验，提供开箱即用的功能，加速你的开发流程。

🖥 示例

• Movies（电影） — 使用混合搜索（hybrid search）帮助你查找可在哪些流媒体平台观看电影的应用。
• Flickr — 利用语义搜索（semantic search）浏览一亿张 Flickr 图片。
• Ecommerce（电商） — 电商网站示例，使用析取式分面（facets）、范围与评分过滤以及分页功能。
• Songs（歌曲） — 搜索四千七百万首歌曲。
• SaaS — 在这个多租户（multi-tenant） CRM 应用中搜索联系人、交易和公司信息。

查看我们所有示例应用的完整列表，请访问我们的 demos 仓库。

✨ 功能特性

• 混合搜索（Hybrid search）：结合语义搜索与全文搜索的优势，获得最相关的结果
• 即时搜索（Search-as-you-type）：在不到 50 毫秒内查找并显示结果，提供直观流畅的用户体验
• 容错能力（Typo tolerance）：即使查询中包含拼写错误或错别字，也能返回相关匹配结果
• 过滤（Filtering）与分面搜索（Faceted search）：通过自定义过滤器提升用户搜索体验，并用几行代码即可构建分面搜索界面
• 排序（Sorting）：根据价格、日期或用户所需的任意字段对结果进行排序
• 同义词支持（Synonym support）：配置同义词以在搜索结果中包含更多相关内容
• 地理搜索（Geosearch）：基于地理位置数据对文档进行过滤和排序
• 广泛的语言支持（Extensive language support）：支持任意语言的数据集搜索，并针对中文、日文、希伯来语及使用拉丁字母的语言进行了优化
• 安全管理（Security management）：通过 API 密钥实现细粒度权限控制，决定哪些用户可以访问哪些数据
• 多租户（Multi-Tenancy）：为任意数量的应用租户个性化搜索结果
• 高度可定制：可根据具体需求自定义 Meilisearch，也可直接使用我们开箱即用、无需配置的预设方案
• RESTful API：通过我们的插件和 SDK 轻松集成到您的技术栈中
• AI 就绪（AI-ready）：开箱即用地支持 LangChain 和 Model Context Protocol (MCP)
• 易于安装、部署和维护

📖 文档

您可以在 meilisearch.com/docs 查阅 Meilisearch 的完整文档。

🚀 快速入门

如需了解如何设置 Meilisearch、向索引添加文档以及搜索文档的基本操作，请参阅我们的文档指南。

🌍 全面增强您的 Meilisearch 体验

告别服务器部署和手动更新，立即使用 Meilisearch Cloud。该服务还提供全球多个区域的分析与监控功能，且无需信用卡即可试用。

🧰 SDK 与集成工具

在您的项目中安装任一官方 SDK，即可实现 Meilisearch 与您喜爱的语言或框架的无缝集成！

请查看完整的 Meilisearch 集成列表。

⚙️ 高级用法

经验丰富的用户应随时参考我们的 API 参考文档。

我们还提供了大量专门介绍 Meilisearch 各项功能的指南，例如 过滤、排序、地理搜索、API 密钥 和 租户令牌（tenant tokens）。

最后，如需深入了解核心概念，请阅读我们关于 文档（documents） 和 索引（indexes） 的文章。

🧾 版本与许可

Meilisearch 提供两个版本：

🧪 社区版（Community Edition, CE）

• 在 MIT 许可证 下完全开源
• 包含核心搜索引擎，支持快速且精准的全文搜索、语义搜索或混合搜索
• 免费供任何人使用，包括商业用途

🏢 企业版（Enterprise Edition, EE）

• 包含高级功能，例如：
  • 分片（Sharding）
  • S3 流式快照（S3-streaming snapshots）
• 受 商业许可证 或 Business Source License 1.1 约束
• 未经与 Meilisearch 签订商业协议，不得在生产环境中使用。
  • 您仅可出于非生产目的（如测试、开发或评估）使用、修改和分发本许可作品。

想要使用企业版功能？→ 请联系我们：sales@meilisearch.com。

📦 外部 crate

Meilisearch 引入了以下采用 MIT 许可证的外部 crate，并对其代码进行了修改，以使用位于 crates/http-clients 中的 HTTP 客户端：

• 来自 https://github.com/64bit/async-openai 的 external-crates/async-openai 和 external-crates/async-openai-macros
• 来自 https://github.com/jpopesculian/reqwest-eventsource 的 external-crates/reqwest-eventsource

📊 遥测（Telemetry）

Meilisearch 会收集匿名化的用户数据，以帮助我们改进产品。您可以随时停用此功能。

如需请求删除已收集的数据，请发送邮件至 privacy@meilisearch.com。请务必在邮件中包含您的 Instance UID，这有助于我们快速定位并删除您的数据。

如果您想了解更多关于我们会收集哪些数据以及用途，请查阅文档中的遥测章节。

📫 联系我们！

Meilisearch 是由总部位于法国、团队成员遍布全球的软件公司 Meili 开发的搜索引擎。想进一步了解我们？欢迎访问我们的博客！

🗞 如果不想错过任何更新，订阅我们的新闻简报吧！我们承诺不会打扰您的收件箱：每两个月仅发送一期。

💌 想提出建议或反馈意见？您可以通过以下渠道联系我们：

• 功能请求请访问我们的 产品仓库
• 发现 bug？请提交一个 issue！
• 想加入我们的 Discord 社区？立即加入！

感谢您的支持！

👩‍💻 贡献

Meilisearch 是开源的，并将永远保持开源！如果您希望为项目做出贡献，请参阅我们的贡献指南。

📦 版本管理

Meilisearch 的发布版本及其对应的二进制文件可在项目的 releases 页面 获取。

二进制文件的版本遵循 SemVer 规范。更多详情请阅读我们的版本管理策略。

与二进制文件不同，本仓库中的 crate 目前未发布到 crates.io，也不遵循 SemVer 规范。

Meilisearch 快速上手指南

Meilisearch 是一个极速、开源的搜索引擎，支持全文搜索、语义搜索和混合搜索，开箱即用，适合集成到各类应用中。

环境准备

• 操作系统：Linux、macOS 或 Windows（推荐 Linux/macOS 获得最佳性能）
• 内存：建议至少 2GB RAM（数据量大时需更多）
• 磁盘空间：根据索引数据量而定
• 依赖：无需额外依赖（二进制版本自带运行时）

💡 国内用户建议使用 Meilisearch 官方 Docker 镜像 或从 GitHub Release 下载预编译二进制文件。暂无官方中国镜像，可配合代理或使用国内 Docker 加速器（如阿里云容器镜像服务）提升下载速度。

安装步骤

方法一：使用 Docker（推荐）

docker run -it --rm \
  -p 7700:7700 \
  -v $(pwd)/meili_data:/meili_data \
  getmeili/meilisearch:v1.9

方法二：下载预编译二进制（Linux/macOS）

# 下载最新版（以 v1.9 为例，请替换为实际版本）
curl -L https://github.com/meilisearch/meilisearch/releases/download/v1.9/meilisearch-linux-amd64 -o meilisearch
chmod +x meilisearch
./meilisearch --db-path ./meili_data

启动后默认监听 http://127.0.0.1:7700，首次启动会生成主密钥（Master Key），请妥善保存。

基本使用

以下示例使用 curl 演示最简流程：创建索引 → 添加文档 → 执行搜索。

1. 添加测试文档

# 创建索引并添加电影数据（无需提前声明 schema）
curl -X POST 'http://127.0.0.1:7700/indexes/movies/documents' \
  -H 'Content-Type: application/json' \
  -d '[{
    "id": 1,
    "title": "Interstellar",
    "genres": ["Sci-Fi", "Adventure"]
  }, {
    "id": 2,
    "title": "Inception",
    "genres": ["Action", "Sci-Fi"]
  }]'

2. 执行搜索

# 搜索关键词 "inter"
curl 'http://127.0.0.1:7700/indexes/movies/search?q=inter'

返回结果将包含匹配的电影，并自动处理拼写容错（如输入 "intrstrlr" 也能命中）。

📌 提示：生产环境请通过 --master-key 参数设置 API 密钥，并使用 HTTPS。详细配置请参考 官方文档。