数据源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访问）添加到生产环境的白名单中，除非绝对必要。