白名单是数据库连接的安全防控手段。创建实例后，默认禁止所有 IP 地址访问实例。本文介绍如何手动将客户端 IP 地址或地址段添加到白名单，来实现成功访问 veDB MySQL 实例。 ## 背景信息无论是通过 VPC 内网还是通过公网访问实例，均需要在使用实例前配置实例的白名单，才能保证实例可连接。请定期维护白名单，将不需要访问 veDB MySQL 实例的设备 IP 地址清除，保障数据库连接的安全性。 ## 前提条件已[创建实例](https://www.volcengine.com/docs/6357/92773)，实例处于**运行中**状态。 ## 注意事项 * 同一地域下的单个账号最多可创建 100 个白名单，每个白名单中最多可包含 300 个 IP 地址或 IP 地址段，每个白名单最多可绑定 50 个实例。 * 单个实例最多可绑定 100 个白名单，最多可绑定 1000 个 IP 地址。 * 支持设置 CIDR 格式的 IP 段，如：`192.168.0.0/24`。当 IP 地址较多时，建议将零散的 IP 合并为 IP 段。 * 设置 `0.0.0.0/0`，允许所有地址访问；设置 `127.0.0.1`，禁止所有地址访问。若同时设置 `0.0.0.0/0` 和 `127.0.0.1`，则允许所有地址访问。 * 若通过本地设备访问 veDB MySQL，需填写本地设备的公网 IP。 * 若通过火山引擎 ECS 服务器访问 veDB MySQL，但不满足内网连接的条件，请填写 ECS 实例的公网 IP；若满足内网连接的条件，填写 ECS 实例的私网 IP。 * 每个白名单最多可绑定 10 个安全组。 * 绑定 ECS 安全组后，若已绑定的 ECS 安全组有更新，则需要在 veDB MySQL 白名单列表手动同步安全组，使该白名单获取安全组更新后的 IP。具体操作步骤，请参见[同步安全组](https://www.volcengine.com/docs/6357/2550778)。 ## 创建白名单 1. 登录[云数据库 veDB MySQL 版控制台](https://console.volcengine.com/db/vedb-mysql)。 2. 在顶部菜单栏选择实例所属的项目和地域。 3. 在左侧导航栏选择 **veDB\-MySQL** \> **白名单列表**。 4. 在**白名单列表**页面，单击**创建白名单**，配置如下参数。 |参数 |说明 | |---|---| |所属项目 |选择白名单所属的项目，根据您在顶部菜单栏选择的项目，会有以下默认情况：

* 若您选择的是**账号全部资源**，那么新建的白名单默认会加入 **default** 项目中，也可根据业务需要选择其他项目。

* 若您选择的是任意具体的项目，那么新建的白名单默认会加入该项目，也可根据业务需要选择其他项目。 | |白名单名称 |输入白名单名称。要求如下：

* 不能以数字、中划线（\-）开头。

* 长度为 1~128 个字符。

* 只能包含中文、字母、数字、下划线（_）、中划线（\-）。 | |描述 |填写白名单的描述，描述内容长度不得超过 200 个字符。 | |IP 地址 |输入 IP 地址或地址段，支持粘贴 IP 地址或地址段，以中英文逗号、空格或换行符隔开。

* 设置 IP 地址如：`192.168.0.1`，则仅允许该 IP 地址访问。

* 设置 `0.0.0.0/0`，表示允许所有地址访问，此时若开启公网连接地址或未设置数据库账号密码，会存在高安全风险，请谨慎设置。

* 当 IP 地址较多时，建议将零散的 IP 合并为 CIDR 格式的 IP 地址段，如：`192.168.0.0/24`（`/` 后面可输入 0~31 间的任一整数），允许该网段内 IP 地址访问。 | |安全组 |支持为白名单绑定 ECS 安全组，绑定 ECS 安全组后，可以将对应 ECS 安全组下所有的 ECS 实例的 IP 地址导入到该白名单中，使这些 ECS 安全组下的所有 ECS 实例都可以访问该白名单绑定的实例。

您可以按照如下步骤为当前白名单绑定 ECS 安全组：

1. 单击**选择安全组**。

2. 在弹出的对话框中，根据业务需要从任意安全组绑定模式下选择安全组进行绑定。支持两种绑定模式：

* **关联 ECSIP**：允许安全组内的云服务器访问数据库，当前仅支持主网卡的 IP 信息导入。

* **入方向 IP**：允许安全组入方向的源地址中 TCP 协议和 ALL 协议涉及的 IP 访问数据库，若源地址中配置为安全组将被忽略。

说明

绑定安全组时，支持选择任意一种绑定模式或同时选择上述两种绑定模式，但需保证所绑定的 ECS 安全组中存在至少一个 IP 或 IP 地址段。

每个白名单最多可绑定 10 个 ECS 安全组。

一个白名单最多支持 300 个 IP 或 IP 段，绑定安全组涉及的 IP 或 IP 段超过限制时会绑定失败，您可以调整安全组中的 IP 后重新绑定。

3. 单击**确定**。

说明

如需将已选择的 ECS 安全组从当前白名单中移除，单击安全组列表右侧操作列中的解绑即可。

绑定 ECS 安全组后，如果已绑定的 ECS 安全组有更新，您需要在 veDB MySQL 的白名单中手动同步 ECS 安全组，来获取 ECS 安全组中的最新 IP 列表。具体操作步骤，请参见同步安全组。

| 5. 单击**确定**。创建成功后，您可单击目标白名单进入**白名单信息**页查看白名单详情。 ## 后续操作 [绑定实例和白名单](https://www.volcengine.com/docs/6357/126046) ## 相关 API |API |描述 | |---|---| |[CreateAllowList](https://www.volcengine.com/docs/6357/128815) |调用 CreateAllowList 接口创建一个新的白名单。 | |[DescribeAllowLists](https://www.volcengine.com/docs/6357/128813) |调用 DescribeAllowLists 接口查询当前账号下指定地域内的所有白名单信息。 | |[DescribeAllowListDetail](https://www.volcengine.com/docs/6357/128814) |调用 DescribeInstanceAllowLists 接口查询实例绑定的白名单信息。 |