一、一、文档说明
本指南帮助你完成云聚通多网聚合加速（腾讯云聚通）服务所需的白名单配置，确保设备能正常连接加速网关。
二、方案总览
根据你的物联网卡白名单条目数量，本指南提供两种配置方案：
| 方案 | 适用场景 | 推荐程度 |
| 方案一：全量配置 | 白名单条目不受限 | ★★★ 首选 |
| 方案二：受限配置 | 白名单条目有限 | ★★☆ 比较推荐 |
三、二、配置前准备
在开始配置白名单之前，请先确认以下信息：
1. 确认设备运营区域
确认你的设备主要在哪些城市或区域运营（例如华东、华南等特定城市）。这将影响后续地域或网关节点的选择。
2. 确认物联网卡白名单条目上限
向你的物联网卡运营商了解白名单最多能添加多少条，无限制情况建议选择方案一。
四、三、白名单必加内容：控制器域名
无论你选择哪种方案，以下 4 个控制器域名都必须全部加入白名单。设备启动后需要先连接控制器完成注册和调度，缺少任何一个都可能导致无法正常接入。
| 域名 | 用途 |
| register.multipath.tencent-cloud.com | 注册中心主域名 |
| register-backup.multipath.tencent-cloud.com | 注册中心备域名 |
| reg-rest-pre.multipath.tencent-cloud.com | 预发布环境 REST 域名 |
| reg-rest.multipath.tencent-cloud.com | 现网 REST 域名 |
注意：说明：
注意：如果你的运营商支持泛域名，可直接用 *.multipath.tencent-cloud.com（示例）一条覆盖以上所有域名。明确的泛域名格式需与运营商做具体确认，不同的运营商规则可能不同。
六、适用场景
白名单条目数量不受限制，或条目足够多。这是最简单、效果最好的方案。所有地域白名单全部加完后，需在控制台选择全部地域（全选后取消 DEFAULT 选项），SDK 会自动就近选择最优的网关节点和运营商线路，无需手动指定。
七、步骤1 添加控制器域名
将第三节中的 4 个域名（或泛域名）全部加入白名单。
八、步骤2 添加全部接入点 IP 地址
将所有地域的 IP 地址加入白名单。
九、步骤3 配置接入地域范围
在腾讯云控制台全选除 DEFAULT 选项外所有“可接入网关”的地域。请确认所有地域的 IP 已在 Step 2 中加入白名单，否则设备收到未加白的 IP 会导致无法连通。
·在 腾讯云控制台 > 多网聚合加速（腾讯云聚通） > 设备管理，找到可接入网关，单击编辑。
·在弹出的窗口中全选地域，随后取消 DEFAULT 选项：
十一、适用场景
白名单条目有限，无法把所有地域的 IP 都加上。
十二、工作原理
·设备启动加速时，会先连接腾讯云的控制器。控制器会把可用的网关 IP 地址下发给设备，设备再去连接这些网关。默认情况下（即控制台可接入网关无配置时），控制器会下发所有地域的网关 IP。如果你的白名单没有把所有 IP 都加上，设备就可能收到一个没有加过白的 IP，导致连不通。
·为了解决这个问题，你可以在腾讯云控制台配置“可接入网关”，这可以告诉控制器“我只加了哪些地域的白名单”。这样控制器就只会下发这些地域的网关 IP 给设备，不会下发其他地域的。设备收到的 IP 都是加过白的，就不会出现连不通的情况。
十三、步骤1 添加控制器域名
将 三、白名单必加内容：控制器域名 中的 4 个域名（或泛域名）全部加入白名单。不可省略。
十四、步骤2 获取限定地域的 IP 列表并加入白名单
根据你的设备运营区域，确定需要接入的地域（通常选择距离运营区域最近的一个或多个地域节点）。通过 API 接口 自助获取或 联系我们 人工获取 IP 地址，并将获取的所有 IP 地址加入物联网卡白名单。
若选取调用 API 接口方式获取 IP，请确保调用接口前：
·已开通 MNA 服务。
·已 联系我们 开通接口访问权限。
注意：请确保将限定地域内每个节点的所有运营商线路 IP（BGP、移动、电信、联通）都加入白名单，不能只加其中某个运营商的。
十五、步骤3 配置接入地域范围
在腾讯云控制台选择“可接入网关”的地域。请确认所选地域的 IP 已在 Step 2 中加入白名单，否则设备收到未加白的 IP 会导致无法连通。
·在 腾讯云控制台 > 多网聚合加速（腾讯云聚通） > 设备管理，找到可接入网关，单击编辑。
·在弹出的窗口中选择你要接入的地域：
注意：说明：
注意：配置完成后，SDK 自动调度时只会选择这些允许的地域，不会连接其他地域的网关。此外，全选仅代表当前所有 IP，后续新增地域不会自动接入。
十六、示例：车联网场景，车辆在杭州运营
背景：车辆使用移动+电信双卡，主要在杭州及周边运营。
具体操作：
1. 4 个控制器域名全部加入白名单。
2. 工程师提供/自行查询杭州节点对应的 5 个 IP，将 5 个 IP （含 BGP*1/联通*2/电信*1/移动*1）全部加入白名单。
3. 腾讯云控制台配置接入地域限制为“杭州”。
即白名单总条数为4 个域名 + 5 个 IP = 共 9 条。
注意：如果后续设备运营区域扩展到其他城市，请在腾讯云控制台调整地域范围，并将新增地域的 IP 补充到白名单中。
十八、1. 业务服务器的 IP 需要加白名单吗？
不需要。白名单只管“设备到腾讯云加速网关”这一段。数据到了网关之后，由网关自己的网络去访问你的业务服务器，已经不走物联网卡了。
注意：说明：
注意：如果你的设备上有些流量不经过加速网关、直接通过物联网卡访问其他服务器，那些地址需要你自行添加到白名单中。本指南只涉及加速服务相关的白名单。
十九、2. 域名可以少加几个吗？
不可以。4 个控制器域名都必须添加。设备启动后需要先连接控制器完成注册和调度，任何一个域名缺失都可能导致无法正常接入。如果支持泛域名，用 *.multipath.tencent-cloud.com 一条搞定。
20、3. 只加限定地域/指定节点内某个运营商的线路可以吗？
不建议。请把对应地域或节点下所有运营商线路的 IP 都加上。SDK 会根据物联网卡的运营商自动选择对应线路，如果缺少某条线路的 IP，可能导致该运营商的卡无法正常加速。
21、4. 设备运营区域需要扩展怎么办？
1. 将新地域的 IP 加入白名单。
2. 在控制台勾选该地域。
22、5. 腾讯云地域节点增多了怎么办？
如需使用新地域，需要：
1. 将新地域的 IP 加入白名单。
2. 在控制台勾选该地域。
23、6. IP 地址会变化吗？
IP 地址相对稳定，但如果有节点扩容或调整，腾讯云会提前通知更新。建议定期与你的对接工程师确认是否有 IP 变更。