一、文档说明
对于行业端设备接入的场景（例如车联网、直播机、MFi 设备等），往往采用定向物联网卡进行网络连接。定向物联网卡需要提前向运营商注册需要访问的域名/IP 地址（即“白名单”），未在白名单中的地址将无法访问。
本指南帮助您完成云聚通多网聚合加速（腾讯云聚通）服务所需的白名单配置，确保设备能正常连接加速网关。
方案总览
根据您的物联网卡白名单条目数量，本指南提供两种配置方案：
方案 | 适用场景 | 推荐程度 |
方案一：全量配置 | 白名单条目不受限 | ★★★ 首选 |
方案二：受限配置 | 白名单条目有限 | ★★☆ 比较推荐 |
二、配置前准备
在开始配置白名单之前，请先确认以下信息：
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（示例）一条覆盖以上所有域名。明确的泛域名格式需与运营商做具体确认，不同的运营商规则可能不同。四、方案一：全量配置（推荐）
适用场景
白名单条目数量不受限制，或条目足够多。这是最简单、效果最好的方案。所有地域白名单全部加完后，无需在控制台做任何设置，SDK 会自动就近选择最优的网关节点和运营商线路，无需手动指定。
步骤1 添加控制器域名
将第三节中的 4 个域名（或泛域名）全部加入白名单。
步骤2 添加全部接入点 IP 地址
将所有地域的 IP 地址加入白名单。
五、方案二：受限配置（条目有限时推荐）
适用场景
白名单条目有限，无法把所有地域的 IP 都加上。
工作原理
设备启动加速时，会先连接腾讯云的控制器。控制器会把可用的网关 IP 地址下发给设备，设备再去连接这些网关。默认情况下（即控制台可接入网关无配置时），控制器会下发所有地域的网关 IP。如果您的白名单没有把所有 IP 都加上，设备就可能收到一个没有加过白的 IP，导致连不通。
为了解决这个问题，您可以在腾讯云控制台配置“可接入网关”，这可以告诉控制器“我只加了哪些地域的白名单”。这样控制器就只会下发这些地域的网关 IP 给设备，不会下发其他地域的。设备收到的 IP 都是加过白的，就不会出现连不通的情况。
步骤1 添加控制器域名
步骤2 获取限定地域的 IP 列表并加入白名单
注意：
请确保将限定地域内每个节点的所有运营商线路 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 一条搞定。3. 只加限定地域/指定节点内某个运营商的线路可以吗？
不建议。请把对应地域或节点下所有运营商线路的 IP 都加上。SDK 会根据物联网卡的运营商自动选择对应线路，如果缺少某条线路的 IP，可能导致该运营商的卡无法正常加速。
4. 设备运营区域需要扩展怎么办？
方案一：无需操作。您已将全部 IP 加入白名单，新区域的网关 IP 已包含在内，SDK 会自动调度到新区域。
方案二：
1.1 将新地域的 IP 加入白名单。
1.2 在控制台勾选该地域。
5. 腾讯云地域节点增多了怎么办？
方案一：将新地域的 IP 补充到白名单即可，控制台无需配置，SDK 调度范围自动包含新地域。
方案二：如需使用新地域。
1.1 将新地域的 IP 加入白名单。
1.2 在控制台勾选该地域。
6. IP 地址会变化吗？
IP 地址相对稳定，但如果有节点扩容或调整，腾讯云会提前通知更新。建议定期与您的对接工程师确认是否有 IP 变更。
