在本指南中,您将学习如何将 Meilisearch Cloud 实例链接到您的 Vercel 项目。

工具介绍

什么是 Vercel?

Vercel 是一个用于构建和部署 Web 应用程序的云平台。它与大多数流行的 Web 开发工具开箱即用。

什么是 Meilisearch Cloud?

Meilisearch Cloud 提供可扩展、可靠的托管搜索服务,旨在满足各类企业的需求。

将 Meilisearch 集成到 Vercel 项目中

创建并部署 Vercel 项目

从 Vercel 仪表板创建一个新项目。您可以从模板创建项目,或导入 Git 仓库。

选择您的项目,然后点击 Deploy。部署完成后,返回项目仪表板。

添加 Meilisearch 集成

进入项目设置选项卡,点击屏幕左侧边栏菜单中的 Integrations

在搜索栏中查找 Meilisearch 集成。点击 Add integration 按钮。

选择要添加集成的 Vercel 账户或团队以及项目。在此菜单中,您可以将 Meilisearch 集成添加到一个或多个项目。

点击 Continue。Vercel 将显示集成正常运行所需的权限列表。请仔细查看后点击 Add Integration

设置 Meilisearch Cloud

Vercel 会将您重定向至 Meilisearch Cloud 页面。登录或创建账户,新账户可享受 14 天免费试用期。

您可以选择现有项目或创建新项目。如需创建新项目,请填写项目名称和区域信息完成表单。

点击创建项目后,您将看到提示信息:“您的 Meilisearch + Vercel 集成即将完成”。点击”完成 Vercel 集成设置”,Meilisearch 会将您重定向回 Vercel 集成页面。

理解并使用 Meilisearch API 密钥

Meilisearch 会创建两个默认 API 密钥:Default Search API KeyDefault Admin API Key

管理员 API 密钥

使用 Default Admin API Key 可控制谁有权访问或创建文档、索引,以及修改索引设置。请谨慎保管管理员密钥,避免在公共环境中暴露。

搜索 API 密钥

使用 Default Search API Key 来访问搜索路由。这是您需要在前端使用的密钥。

这两个密钥都会与 Meilisearch URL 一起自动添加到 Vercel 中。

主密钥(master key)——尚未添加到 Vercel 中——授予用户对实例的完全控制权。您可以在 Meilisearch Cloud 仪表盘的项目概览中找到它。了解更多关于 Meilisearch 安全的信息。

检查项目设置

返回您的项目设置,查看新增的 Meilisearch 环境变量:

  • MEILISEARCH_ADMIN_KEY
  • MEILISEARCH_URL
  • MEILISEARCH_SEARCH_KEY

使用 Next.js 时,请确保为面向浏览器的环境变量添加 NEXT_PUBLIC_ 前缀。这会使它们在应用的浏览器端可用。

利用 Meilisearch Cloud 仪表盘

使用 Meilisearch Cloud 仪表盘 来索引文档并管理您的项目设置。

资源与后续步骤

查看快速入门指南,了解如何使用 Meilisearch 的简短介绍。我们还提供了许多SDK 和工具,让您可以用喜欢的语言或框架来使用 Meilisearch。

现在您可以开始进行搜索了!