将 Meilisearch Cloud 与 Vercel 集成

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

    介绍我们的工具

    什么是 Vercel?

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

    什么是 Meilisearch Cloud?

    Meilisearch Cloud 提供可扩展、可靠且旨在满足所有公司需求的托管搜索服务。

    将 Meilisearch 集成到您的 Vercel 项目中

    创建和部署 Vercel 项目

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

    Create a new project on Vercel dashboard

    选择您的项目,然后单击部署。部署完成后,返回到您项目的仪表盘。

    添加 Meilisearch 集成

    转到项目设置选项卡,然后单击屏幕左侧边栏菜单上的 集成

    Selecting the integration tab in the project settings

    在搜索栏中搜索 Meilisearch 集成。单击 添加集成 按钮。

    Meilisearch integration page in Vercel's marketplace

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

    Form to add Meilisearch integration, the "Specific projects" option is selected

    单击 继续。Vercel 将显示一个列表,其中包含集成正常工作所需的权限。查看它,然后单击 添加集成

    设置 Meilisearch Cloud

    Vercel 会将您重定向到 Meilisearch Cloud 页面。登录或创建一个帐户。新帐户享有 14 天的免费试用期。

    您可以选择现有项目或创建一个新项目。要创建新项目,请填写包含项目名称和区域的表单。

    Meilisearch Cloud form to create a project complete, with "search-app" as the project's name and "Frankfurt" as the region

    单击 创建项目 后,您应该会看到以下消息:“您的 Meilisearch + Vercel 集成只需单击一下即可完成。” 单击“完成 Vercel 集成设置”。然后,Meilisearch 会将您重定向回 Vercel 集成页面。

    Meilisearch integration page in Vercel's dashboard

    了解和使用 Meilisearch API 密钥

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

    Admin API 密钥

    使用 Default Admin API Key 来控制谁可以访问或创建新文档、索引和更改索引设置。请小心使用管理密钥,并避免在公共环境中公开它。

    Search API 密钥

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

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

    提示

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

    查看您的项目设置

    返回您的项目设置并检查新的 Meilisearch 环境变量

    Display the environment variables in the project settings

    提示

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

    利用 Meilisearch Cloud 仪表盘

    Meilisearch Cloud dashboard: overview of the "search-app" project

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

    资源和后续步骤

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

    您现在可以开始搜索了!