云信提供国内和海外数据中心，支持用户的国内外相关业务。

本节主要介绍海外数据中心的接入流程、国内外节点的迁移流程以及相关说明。

海外数据中心接入流程

1. 为接入海外数据中心的应用创建 App Key

2. 使用海外数据中心的专属 API 域名

3. 配置客户端 SDK 中的 link 域名和 LBS 域名

为接入海外数据中心的应用创建 App Key

1. 登录网易云信控制台。

2. 在左侧导航栏中找到应用，并单击创建。

3. 根据自身业务属性和需求，指定节点的服务区域，并填写其他基本信息。

   服务区域决定了该应用下产品的数据处理和存储，一旦指定服务区域，则不支持修改。若需要改变服务区域，则需要创建新的应用。

   IM 服务区域分为国内和海外，目前海外仅有新加坡节点，后续将拓展其他海外节点。

   

4. 单击创建。

   创建应用后，可以在左侧导航栏中查看。

5. 单击 App Key 管理，获取该应用的 App Key。

使用海外数据中心的专属 API 域名

目前云信服务器的默认 API 域名为api.netease.im，属于国内数据中心，而海外数据中心则需要使用海外指定的专属域名。

如：新加坡的 API 域名是api-sg.netease.im。

用户在对接云信服务器时需要自行替换 API 域名。

配置客户端 SDK 中的 link 域名和 LBS 域名

在海外数据中心， SDK 的部署方式默认为私有化部署，需要用户按照私有化方式配置 link 域名和 LBS 域名。

如：新加坡的 link 默认域名是link-sg.netease.im:7000；新加坡的 weblink 默认域名是weblink-sg.netease.im:443。

LBS 域名使用lbs.netease.im。

Web 端

初始化 SDK 时，在NIM.getInstance中添加 LBS 和 link 域名参数的配置。示例如下：

var nim = window.SDK.NIM.getInstance({
      "lbsUrl": "https://lbs.netease.im/lbs/webconf",
      "defaultLink": "weblink-sg.netease.im:443",
    })

相关参数说明如下：

iOS 端

初始化 SDK 时，在NIMServerSetting中配置 LBS 和 link 域名参数，NIMServerSetting需要开发者自己创建并注入。示例如下：

setting.lbsAddress =  @"https://lbs.netease.im/lbs/conf.jsp";
setting.linkAddress =  @"link-sg.netease.im:7000";

相关参数说明如下：

Android 端

初始化 SDK 时，通过SDKOptions配置私有化的服务器地址中的 LBS 和 link 域名相关信息。示例如下：

serverConfig.defaultLink = "link-sg.netease.im:7000"; 
serverConfig.lbs = "https://lbs.netease.im/lbs/conf.jsp"; 
serverConfig.nosUploadLbs = "http://wannos.127.net/lbs"; 
serverConfig.nosUploadDefaultLink = "https://nosup-hz1.127.net"; 
serverConfig.nosDownloadUrlFormat = "{bucket}-nosdn.netease.im/{object}"; 
serverConfig.nosUpload = "nosup-hz1.127.net"; 
serverConfig.nosSupportHttps = true;

相关参数说明如下：

PC 端

用户需要自行创建nim_server.conf文件，放至 SDK 的同级目录，SDK 会自动识别。nim_server.conf文件的内容，请参考以下示例：

{
    "lbs":"https://lbs.netease.im/lbs/conf.jsp",
    "lbs.backup":[
        "https://lbs.netease.im/lbs/conf.jsp"
    ],
    "link":"link-sg.netease.im:7000",
    "nos_lbs":"https://wanproxy.127.net/lbs?version=1.0",
    "nos_uploader":"http://nosup-hz1.127.net",
    "nos_uploader_host":"nosup-hz1.127.net",
    "nos_downloader":"{bucket}.nosdn.127.net/{object}",
    "https_enabled":true
}

在使用前，请先校验 json 格式是否正确。

增强版 Web / uni-app

初始化 SDK 时，添加 LBS 和长连接域名参数的配置。

new NIM({

  "lbsUrls": ["https://lbs.netease.im/lbs/webconf"],
  "linkUrl": "weblink-sg.netease.im:443"
  
})

getInstance({

  "lbsUrls": ["https://lbs.netease.im/lbs/webconf"],
  "linkUrl": "weblink-sg.netease.im:443"
  
})

相关参数说明如下：

Flutter 端

初始化 SDK 时，通过 NIMServerConfig 配置私有化的服务器地址中的 LBS 和 link 域名相关信息。示例如下：

NIMServerConfig config = NIMServerConfig(
    defaultLink: "link-sg.netease.im:7000",
    lbs: "https://lbs.netease.im/lbs/conf.jsp",
    nosUploadLbs: "http://wannos.127.net/lbs",
    nosUploadDefaultLink: "https://nosup-hz1.127.net",
    nosDownloadUrlFormat: "{bucket}-nosdn.netease.im/{object}",
    nosUpload: "nosup-hz1.127.net",
    nosSupportHttps: true);
if (Platform.isAndroid) {
  final directory = await getExternalStorageDirectory();
  options = NIMAndroidSDKOptions(
      appKey: appKey,
      shouldSyncStickTopSessionInfos: true,
      serverConfig: config,
      sdkRootDir:
          directory != null ? '${directory.path}/NIMFlutter' : null);
} else if (Platform.isIOS) {
  final directory = await getApplicationDocumentsDirectory();
  options = NIMIOSSDKOptions(
    appKey: appKey,
    shouldSyncStickTopSessionInfos: true,
    sdkRootDir: '${directory.path}/NIMFlutter',
    apnsCername: 'ENTERPRISE',
    serverConfig: config,
    pkCername: 'DEMO_PUSH_KIT',
  );
}

相关参数说明如下：

国内节点迁移至海外节点

对于已上线的国内节点应用，如果您有海外业务需求，可将应用迁移至海外数据中心。

迁移说明

云信支持将已有的国内应用数据、用户信息、好友关系、会话列表、群组数据、超大群组数据、聊天室数据、漫游、历史消息、离线消息等内容，平滑迁移至对应的海外数据中心。

• 用户信息：已经在云信获取过 Token 的所有用户信息支持迁移至海外数据中心，包括用户 ID、用户名、用户头像等
• 群组数据：群基本信息、群成员信息
• 超大群组数据：超大群基本信息、超大群成员信息
• 聊天室数据：聊天室基本信息、聊天室固定成员信息
• 历史消息数据：针对应用发送过的历史消息支持迁移至海外数据中心，包含：单聊、群聊、聊天室消息
• 离线消息数据：针对用户未收取过的离线消息，支持迁移至海外数据中心

迁移准备

您需要向云信申请公有云专属服务，由云信负责部署专属云服务（具体费用可咨询商务经理）。

公有云专属服务主要用于迁移海外节点过程中为保证业务不受公有云流量干扰而产生的隔离资源。部署的时间范围以实际迁移时间为准，全部迁移完成后，可取消该服务部署。

迁移流程

1. 联系云信商务经理，申请将指定的 AppKey 迁移至对应海外数据中心，并与云信技术支持确认迁移范围。

2. 对于用户迁移前的国内数据中心公有云环境（api.netease.im），云信将部署专属云服务，并提供专属云对应的 API 域名和 link 域名。

3. 用户在对接云信服务器时需要将云信 API 公有云域名替换为专属云域名。

4. 将云信客户端 SDK 的 link 公有云域名替换为专属云域名，并发布客户端新版本。

5. 云信对迁移后的海外数据中心（api-sg.netease.im）部署专属云服务，然后将国内公有云数据中心的数据，迁移至海外数据中心。

6. 升级应用客户端。从国内迁移至海外数据中心，因涉及修改客户端 SDK 中的 link 服务地址，所以应用客户端必须强制升级到新的版本，才能连接到迁移后的数据中心。老版本将无法使用。

7. 用户需要与云信商务协商正式迁移的时间节点。协商好后，云信正式开始流量迁移。建议在线上业务低峰期时执行。

海外数据中心相关说明

• 接入海外数据中心的 App Key 的数据均存储于海外，包括但不限于：

  • 账号信息（accid、昵称、头像等）
  • 群组、聊天室等
  • 好友、黑名单等
  • 历史消息等
  • 图片/文件存储
  • 其他

• 国内数据中心和海外数据中心的关系：

  • 应用级别的信息全局共享，如 App Key 信息、功能开通关闭（包括云信侧功能，安全通等）。
  • 应用内的信息存储于所属数据中心。

• 安全通

  • 海外数据中心的安全通使用了对应的海外易盾能力，数据不回国。
  • 支持多语种的内容安全审核。

• 国内数据中心和海外数据中心的 link、weblink、chatlink、chatwl、以及 API 域名不互通，如果连接错误，会返回 403。

• 为了方便客户接入和提高接入效果，海外数据中心相关域名会添加国内加速代理和海外其他地区的加速代理，如：新加坡 API 域名api-sg.netease.im。

  • 在国内会解析到我们的国内 bgp 入口，但是所有数据最终都存储在新加坡。
  • 在美国地区会解析到美国的加速入口，但是所有数据最终都存储在新加坡。

数据迁移常见问题

Q：App 是否必须强制升级？

A：是，云信从 8.10.0 开始才支持海外节点且迁移需要更换为海外域名，所以必须强制升级到新的版本，才能连接到指定数据中心。

Q：漫游消息是否支持迁移？

A：支持，在正式迁移前 7 天，云信会开启双写，将漫游消息双写写到指定数据中心。

Q：存储在云信服务端的历史消息是否支持迁移？

A： 支持，需要和云信商务说明历史消息迁移时间范围。

Q：是否支持从海外节点迁移至国内节点？

A：不支持。

Q：迁移过程中服务是否不可用？

A：是的，在切换的瞬间所有客户端会强制下线，触发重连到海外单元。切换期间有分钟级服务不可用，正常不超过一分钟。

Q：是否支持历史图片和文件的迁移？

A：不支持。 历史图片和文件不会迁移，还是存储在国内数据中心，但是不影响访问。