文档中心

数据库工作台

接入实例

外部实例管理

数据库工作台 DBW 支持通过公网接入您在 IDC、ECS 或其他环境中自建的外部数据库实例，实现统一纳管，并提供集中权限控制、操作审计与高效协作能力，有效降低运维复杂度，助力满足合规要求。本文将介绍如何在 DBW 控制台管理外部数据库实例。

前提条件

当需要通过公网自建的方式接入自建的数据库实例，且实例开启了访问限制，那么在录入目标实例前，您需要将 DBW 的服务器 IP 地址添加至目标实例的白名单或安全组中。DBW 的服务器 IP 地址为 101.126.49.16/28、101.126.49.32/28。

注意事项

当前仅支持接入您在 IDC、ECS 或其他环境中自建的 MySQL 和 PostgreSQL 实例。

单个 Region 下，每个账号可纳管的实例数量暂定上限为 2000 个。

当前支持通过公网自建的形式接入 MySQL 或 PostgreSQL 实例进行纳管。

DBW 接入建议使用专用账号，遵循最小权限原则，按需授予实例或库级的 DML、DDL 及对象操作权限。

推荐开启实例的安全管控，若不开启，每次登录都需手动输入账号密码，且无法使用免密登录等功能。

为避免干扰，请勿在录入信息的前后添加空格等符号。

公网环境的数据库容易受到攻击，请在数据库中增加访问 IP 白名单，以提高数据库的安全性。

添加的实例默认归属于“账号全部资源”，而 DBW 默认进入到 default（默认项目）中。若添加成功后未找到实例，请将项目切换至“账号全部资源”查看。

当前功能属于白名单功能，如需使用，请提交工单联系技术支持。

优势

统一管理入口

无论数据库部署在火山引擎、其他公有云（例如阿里云、AWS、腾讯云）、本地 IDC 还是 ECS 自建环境，均可通过 DBW 集中管理，避免多套工具切换。

增强安全性

支持安全托管：数据库账号密码由 DBW 加密托管，您无需知晓明文凭证，降低泄露风险。

提升协作效率

支持免密登录（需开启安全托管），简化日常操作。

新增外部实例

在左侧导航栏，单击实例列表。

在顶部菜单栏，选择项目和地域。

在实例列表页面，单击新增外部实例。

在创建数据库实例的控制面板，配置以下参数信息。

MySQL 引擎

PostgreSQL 引擎

参数	说明
实例名称	自定义实例名称需满足以下规则：长度不超过 128 个字符，且不能为空。仅支持中文、字母、数字、下划线（_）和中划线（-）。不能以数字或中划线（-）开头。
数据库类型	按需选择数据库类型，该示例以 MySQL 为例。
访问方式	当前仅支持通过公网自建 MySQL 的方式接入外部实例。
地域	该地域由顶部菜单栏左上角所选地域决定，且不可修改。
主机地址	输入目标实例的公网 IP 地址或可解析的域名。
端口	输入目标实例的端口。
数据库账号	输入目标实例的数据库账号，建议使用专用账号，遵循最小权限原则，按需授予实例或库级的 DML、DDL 及对象操作权限。
数据库密码	输入目标实例的数据库账号密码。
测试连通性	单击测试连通性，验证是否成功连接实例。当测试连接失败时，根据失败提示信息修改相关配置后，再次单击测试连通性，验证是否可以成功连接实例。具体提示信息如下：连接认证失败，请检查网络是否正常：当出现该报错提示时，请确认网络的连通性。连接认证失败，请检查用户名和密码是否正确：当出现该报错提示时，您需要确认用户名和密码的准确性。无效的 IP 地址：当出现该报错提示时，请确认 IP 地址的正确性。
安全管控模式	按需选择是否开启安全管控模式。建议您开启实例的安全管控，若不开启，每次登录都需手动输入账号密码，且无法使用免密登录等功能。
安全规则集	从下拉列表中选择安全规则。支持模糊搜索。关于安全规则集的详细信息，请参见安全规则集管理。
实例 DBA	从下拉列表中选择实例 DBA，管理员角色和普通用户角色均可设置为实例 DBA，实例 DBA 将拥有数据库实例下所有读写权限。当审批流程设置为系统默认模板时，实例 DBA 默认为流程的二级审批人。
实例 Owner	从下拉列表中选择实例 Owner，管理员角色和普通用户角色均可设置为实例 Owner，实例 Owner 将拥有数据库实例下所有读写权限。当审批流程设置为系统默认模板时，实例 Owner 默认为流程的一级审批人。
审批流程	从下拉列表中选择目标审批流程。主账号默认可以审批所有工单。关于审批流程的详细信息，请参见审批流程管理。

参数	说明
实例名称	自定义实例名称需满足以下规则：长度不超过 128 个字符，且不能为空。仅支持中文、字母、数字、下划线（_）和中划线（-）。不能以数字或中划线（-）开头。
数据库类型	按需选择数据库类型，该示例以 PostgreSQL 为例。
访问方式	当前仅支持通过公网自建 PostgreSQL 的方式接入外部实例。
地域	该地域由顶部菜单栏左上角所选地域决定，且不可修改。
主机地址	输入目标实例的公网 IP 地址或可解析的域名。
端口	输入目标实例的端口。
数据库账号	输入目标实例的数据库账号，建议使用专用账号，遵循最小权限原则，按需授予实例或库级的 DML、DDL 及对象操作权限。
数据库密码	输入目标实例的数据库账号密码。
测试连通性	单击测试连通性，验证是否成功连接实例。当测试连接失败时，根据失败提示信息修改相关配置后，再次单击测试连通性，验证是否可以成功连接实例。具体提示信息如下：连接认证失败，请检查网络是否正常：当出现该报错提示时，请确认网络的连通性。连接认证失败，请检查用户名和密码是否正确：当出现该报错提示时，您需要确认用户名和密码的准确性。无效的 IP 地址：当出现该报错提示时，请确认 IP 地址的正确性。
安全管控模式	按需选择是否开启安全管控模式。建议您开启实例的安全管控，若不开启，每次登录都需手动输入账号密码，且无法使用免密登录等功能。
安全规则集	从下拉列表中选择安全规则。支持模糊搜索。关于安全规则集的详细信息，请参见安全规则集管理。
实例 DBA	从下拉列表中选择实例 DBA，管理员角色和普通用户角色均可设置为实例 DBA，实例 DBA 将拥有数据库实例下所有读写权限。当审批流程设置为系统默认模板时，实例 DBA 默认为流程的二级审批人。
实例 Owner	从下拉列表中选择实例 Owner，管理员角色和普通用户角色均可设置为实例 Owner，实例 Owner 将拥有数据库实例下所有读写权限。当审批流程设置为系统默认模板时，实例 Owner 默认为流程的一级审批人。
审批流程	从下拉列表中选择目标审批流程。主账号默认可以审批所有工单。关于审批流程的详细信息，请参见审批流程管理。

单击确定。

管理外部实例

在左侧导航栏，单击实例列表。

在顶部菜单栏，选择项目和地域。

在实例列表页面，单击接入正常页签。

在接入正常页签，筛选数据库类型为公网自建数据库。

您可以在实例列表页面左上角根据实例 ID 或实例名称查询目标实例，也可以通过安全管控筛选符合条件的实例。

操作	说明
查看实例信息	在实例列表中，您可以查看实例列表的实例名称/ID、数据库类型、安全管控、创建时间、DBW 中状态等信息。实例列表中的字段支持定制，因此列表中展示的字段可能不同。
自定义列表字段	在列表右上角区域，单击⚙️图标，在自定义列表字段对话框，可以自定义勾选需要展示在列表中的字段。实例列表中默认的资源有实例名称/ID、数据库类型、安全管控、自动巡检、主节点可用区、实例类型、数据库版本、所属项目、创建时间和 DBW 中状态。置灰字段，表示不可修改字段。
开启安全管控	DBW 支持对数据库实例进行统一纳管。开启安全管控，可以使数据库变更走工单审批流程，简化和规范数据库管理操作提升数据管理的流程。开启安全管控的具体操作和注意事项，请参见开启外部实例的安全管控。
登录数据交互台	在目标实例的操作列单击登录，就可以登录该实例的数据交互台。在数据库交互台即 SQL 窗口，您可以执行各类 SQL 语句和管理库表结构。详细信息，请参见外部实例数据管理。
编辑实例详情	支持对已添加的公网实例编辑：选择目标实例操作 > ...，单击编辑实例详情。在编辑数据库实例控制面板，按需编辑实例信息。具体参数信息，请参见新增外部实例。
解除 DBW 纳管	支持删除已添加的公网实例：选择目标实例操作 > ...，单击删除。在删除实例对话框，单击确认。此处的删除仅解除 DBW 对该实例的纳管关系，不会对云平台上的实例实体造成任何影响。

最近更新时间：2026.06.25 16:40:23

这个页面对您有帮助吗？

有用

无用