--- title: "在 Vercel 中连接 OB Cloud 云数据库 - OB Cloud 云数据库 master | OceanBase 文档中心" description: 在 Vercel 中连接 OB Cloud 云数据库 Vercel 面向前端与全栈开发者，提供快速的构建、部署与全球分发能力。将 OB Cloud 与 Vercel 结合使用，可基于兼容 MySQL 的 OceanBase 数据库快速构建和扩展前端应用，并借助高可用、可扩展及具备数据安全与合规能力的云数据库保障业务数… image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*qbZXRo_94ZEAAAAAAAAAAAAADiGDAQ/original) OB Cloud 云数据库 # 在 Vercel 中连接 OB Cloud 云数据库 更新时间：2026-06-26 13:16:15 Vercel 面向前端与全栈开发者，提供快速的构建、部署与全球分发能力。将 OB Cloud 与 Vercel 结合使用，可基于兼容 MySQL 的 OceanBase 数据库快速构建和扩展前端应用，并借助高可用、可扩展及具备数据安全与合规能力的云数据库保障业务数据。 本文介绍如何通过配置环境变量，将 OB Cloud 云数据库连接到 Vercel 项目，使部署在 Vercel 上的应用能够访问 OceanBase 数据。 ## 前提条件 - 您的环境中有可用的事务型（MySQL）集群实例。请先参考 [创建租户](https://www.oceanbase.com/docs/common-oceanbase-cloud-10000000001780107) 完成租户创建后，再按下列步骤操作。 - 已存在可用的 MySQL 租户、MySQL 数据库及账号，且账号已具备读写权限。如需创建，请参见 [创建账号](https://www.oceanbase.com/docs/common-oceanbase-cloud-1000000001018091) 和 [创建数据库（仅 MySQL）](https://www.oceanbase.com/docs/common-oceanbase-cloud-1000000001018092)。 - 您具备项目管理员或实例管理员角色，可对项目中实例进行读写操作；如无权限，请联系组织管理员添加。 - 已注册 [Vercel 账号](https://vercel.com/signup)。若尚未注册，请参见 Vercel 文档 [创建个人账号](https://vercel.com/docs/account) 或 [创建团队](https://vercel.com/docs/teams)。 - 已在 Vercel 中创建或导入一个项目。若尚无可部署的前端应用，可在 Vercel 中从模板创建新项目或导入已有代码仓库；您也可使用 OceanBase 提供的 Next.js Vercel 示例项目进行体验。 #### 注意 Vercel 部署使用动态 IP 地址。若使用 OceanBase Cloud 集群实例，请在控制台中将实例的**IP 白名单**设置为允许所有 IP 访问（例如 `0.0.0.0/0`），否则 Vercel 上的应用可能无法连接数据库。 ## 步骤一：获取数据库连接信息 1. 登录 [OB Cloud 云数据库控制台](https://console-cn.oceanbase.com/)。在实例列表页面，展开目标事务型实例的信息，在目标租户下，单击 **连接** > **获取连接串**。 2. 在弹出框中选择 **公网连接**。 3. 在 **使用公共网络连接** 页面完成如下设置，生成连接串： 1. （可选）若租户没有已生成的公网地址，在 **步骤 1: 获取公网地址** 下，单击 **获取公网地址** 获取公网地址。若已有公网地址，可跳过此步骤。生成地址后，单击 **下一步**。 2. 在 **步骤 2: 安全设置** 下，完成以下配置后，单击 **下一步**： - **添加 IP 地址白名单组**：单击 **添加**，选择 **允许所有 IP 访问**，单击 **确定**。 - **下载证书**：单击 **下载 CA 证书** 下载证书并完成认证。 3. 在 **步骤 3: 访问数据库** 下，选择前提条件中创建的数据库和账号，并选择 **MySQL CLI** 作为连接方式。完成后，复制连接串，供后续配置使用。 ## 步骤二：在 Vercel 中配置环境变量并部署 1. 访问 [Vercel 控制台](https://vercel.com/dashboard)，选择 **Import Project** > **Import**。 ![vercel-1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/cloud/integrations/vercel-1.png) 2. 在 **Let's build something new** 下的对话框中输入示例项目代码，然后单击 **Continue**。 ```shell https://github.com/sc-source/oceanbase-nextjs-vercel-demo.git ``` ![vercel-2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/cloud/integrations/vercel-2.png) 3. 在部署页面中，在 **Environment Variables** 中添加 DATABASE_URL 环境变量： | 配置项 | 说明 | | --- | --- | | **Key** | `DATABASE_URL` | | **Value** | `mysql://:@:/` | 请将 ``、``、``、``、`` 替换为 **步骤一** 在 OB Cloud 控制台获取的连接信息（或从复制的连接串中对应取值）。 例如：`mysql://admin:YourPassword@xxx.oceanbase.cloud:3306/my_db` #### 说明 若在 `Import Project` 流程中配置集成，可在向导中直接填写 `DATABASE_URL`；若在已有项目中配置，请在 `Settings` > `Environment Variables` 中添加后，再重新部署以使变量生效。 ![vercel-3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/cloud/integrations/vercel-3.png) 4. 部署项目。部署成功后，您的 Vercel 应用即可通过 `DATABASE_URL` 连接 OB Cloud 云数据库进行读写。 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线