数据源IP白名单配置指南

应用场景

当数据源部署在内网环境或具有严格的安全管控要求时，需在源端数据库/服务器配置 IP 白名单：

1. 仅允许数据同步服务IP段访问源数据
2. 防止未经授权的网络访问
3. 满足企业网络安全审计要求

前置准备

• 确认目标数据源支持IP白名单机制
• 获取数据同步服务所在服务器的公网IP地址
• 确保具备数据源管理权限

配置流程

如果在配置数据源、测试连通性或者同步任务运行时，遇到因白名单限制导致的报错，可以按照此文档进行操作。

步骤1：获取数据同步服务出口IP地址

根据实际使用服务所在的云和地域，获取对应的IP地址：

步骤2：源端数据库白名单配置

1. 登录源数据库管理控制台

   • MySQL：通过安全组或数据库参数设置
   • Oracle：通过 SQLNET.ORA 文件配置
   • SQL Server：通过服务器防火墙设置

2. 添加IP白名单规则 以阿里云 RDS MySQL 版为例，以下是基于阿里云控制台界面的详细操作步骤：

   步骤 1：登录阿里云控制台 打开浏览器，访问阿里云官网，使用您的阿里云账号登录。

   步骤 2：进入RDS管理控制台 登录后，点击顶部菜单中的“产品与服务”，然后选择“数据库” > “关系型数据库 RDS”。

   步骤 3：选择目标RDS实例 在RDS控制台页面，找到你想要操作的RDS实例。点击实例名称，进入实例详情页面。

   步骤 4：进入“白名单设置” 在实例详情页面，找到左侧菜单中的“安全设置”。点击“白名单设置”选项。

   步骤 5：添加白名单 在“白名单设置”页面，您会看到当前的白名单配置。点击“添加白名单分组”按钮，或在已有的白名单分组中直接添加IP地址。

   步骤 6：配置白名单 在弹出的对话框中，输入白名单分组名称（可选）。在“白名单内容”框中，输入允许访问的 IP 地址或 IP 段。可以输入多个 IP 地址或 IP 段，用英文逗号分隔，例如：47.100.176.72。然后点击“确定”完成添加。

   步骤 7：保存白名单设置 添加完成后，点击页面底部的“保存”按钮，保存白名单设置。

步骤3：数据同步验证

1. 在数据源配置中，点击“测试连通性”。如果成功，通常表明配置已正常。
2. 为保险起见，可以创建测试同步任务并手动执行。
3. 观察任务日志是否显示连接成功。
4. 失败时检查同步任务日志和数据库审计日志。

注意事项

具体配置方式可能因数据源类型（MySQL/Oracle等）而异，请参考对应数据源的官方文档。如需访问云产品，请前往各云产品帮助中心查看其添加白名单的注意事项。白名单设置通常会立即生效，但也可能需要几分钟。

常见问题

Q1：已添加IP白名单仍无法连接

• 检查 IP 地址是否准确（建议通过 curl ifconfig.me 验证出口 IP）
• 确认数据源防火墙已开放对应端口
• 检查白名单配置是否已生效（部分数据库需重启生效）

Q2：白名单维护最佳实践

1. 为数据同步服务单独创建访问账号。
2. 按最小权限原则配置访问范围。
3. 定期审计白名单中的IP地址。
4. 建议配合VPN/专线提升安全性。
5. 不要将 0.0.0.0/0（允许所有 IP 访问）添加到生产环境的白名单中，除非绝对必要。