跳到主要内容
VibrantLink 动联无限
中国区中文指南

在 Realtime 中选择中国区域:cn、NameServer 与白名单

说明 Realtime 中国区 cn 的独立 AppID、ns.photonengine.cn、区域白名单与 Best Region 行为,并列出跨境连接和计费注意事项。

SDK 用法、API 参考、代码示例、区域表与平台支持矩阵以光子官方文档为准;本站只维护中国区可用性、额度、价格与合同口径、上线合规和支持渠道。

阅读约 8 分钟更新于 2026 年 11 月 15 日光子原文
本页目录
  1. 01 · 一个 AppID,胜似几页代码
  2. 02 · cn 区域与产品可用性
  3. 03 · 使用本地 NameServer
  4. 04 · Fixed Region、Best Region 与手动选择
  5. 05 · Dashboard 区域白名单
  6. 06 · 上线验收
  7. 07 · 中国区常见陷阱

国内区域代码是 cn,节点位于中国境内。AppID 需要先开通中国区权限,客户端要使用本地 NameServer,并为国内环境准备单独构建;否则代码看起来没错,却可能一直连不上或连到境外。

先在 Photon 侧解锁中国区 AppID,再谈客户端区域配置。

中国区客户端使用 ns.photonengine.cn;这是 NameServer 地址,不是游戏服务器 IP。

单独构建是光子对国内环境的要求;独立 AppID 是建议,便于隔离配置、白名单与计费。

截至 2026-11,Photon Voice 在中国区不可用;Realtime/PUN/Fusion/Quantum/Chat 可用性需按产品分别确认。

01一个 AppID,胜似几页代码

如果 AppID 还没有开通中国区,单纯把客户端区域设为 cn,通常不会自动连到国内节点。先在光子侧确认 AppID 的中国区权限,再准备独立构建会更省时间。解锁流程和处理时间以光子当前流程为准;我们的申请表单可以协助提交,但不是唯一入口。

单独构建必需,独立 AppID 建议

为国内环境制作单独构建是光子要求;独立 AppID 是光子建议,有助于隔离中国区缓存、白名单和计费。

02cn 区域与产品可用性

按 Realtime 文档,国内区域的代码为 cn,节点位于中国境内。Realtime、PUN、Fusion、Quantum 与 Chat 的中国区可用性需按产品确认;光子明确 Photon Voice 在中国区不可用。中国区公开 Cloud 订阅为 500 CCU,更大规模需定制。

03使用本地 NameServer

中国区客户端必须使用 ns.photonengine.cn 作为 NameServer。不要修改 SDK 源码里的 NameServerHost;在当前 Realtime C# 路径中,通过 AppSettings.ServerAddress 设置。

C# / AppSettings

verify against target SDK
// Official docs: https://doc.photonengine.com/realtime/current/connection-and-authentication/regions
// China differences: https://vibrantlink.com/resources/realtime-china-region
// Quota & pricing: https://vibrantlink.com/pricing

var china = new AppSettings {
    AppIdRealtime = "<中国区 AppID>",
    AppVersion = "1.0",
    UseNameServer = true,
    ServerAddress = "ns.photonengine.cn",
    FixedRegion = "cn" // 需要固定中国区时
};

client.ConnectUsingSettings(china);

04Fixed Region、Best Region 与手动选择

FixedRegion 会跳过区域列表与 ping,连接更快,但区域被写进构建。Best Region 会 ping 区域并缓存结果,适合希望运营期调整的发行版本。手动选择时,应使用当前 SDK 的区域列表与 ConnectToRegionMaster 流程,而不是旧版已移除的 API。

  • 固定中国区:FixedRegion = "cn",适合确定只服务国内用户的构建。
  • 希望以后调整:使用 Best Region,并在 Dashboard 白名单中限制可用区域。
  • Best Region 缓存可能在延迟接近时选到不同区域;调试时清空缓存再测。
  • 区域代码大小写不敏感,规范写法使用小写 cn。

05Dashboard 区域白名单

在 Dashboard 的 Manage → Edit Allowlist 中,用分号分隔区域代码,例如只保留 cn。白名单变更通常需要少量时间到达 Name Server;Best Region 会按允许列表重新筛选。空值或错误格式可能意味着允许全部区域,发布前务必确认。

中国区缓存同步

当前中国区应用缓存不会自动同步所有 Dashboard 变更。修改白名单、配置或应用信息后,需要按当前光子流程请求更新,并在发布前用真实中国区客户端复核。

06上线验收

  1. 从国内网络连接,确认落到 cn 区域并完成房间流程。
  2. 验证客户端实际使用的 NameServer 为 ns.photonengine.cn。
  3. 检查白名单、FixedRegion 与缓存配置一致。
  4. 测试自定义认证、Webhook、WebRPC 等跨境回调。
  5. 确认峰值 CCU、流量与付费套餐匹配当期合同。

07中国区常见陷阱

  • 海外客户端默认连中国区:通常延迟与稳定性不理想,应做区域分流。
  • 境外认证/回调:中国区服务器访问境外服务可能失败,需提供境内替代。
  • Dashboard 直接购买:中国区付费方案通常需要工单或商务报价。
  • Voice:光子明确 Voice 中国区云不可用,不能沿用旧资料中的可用说法。
  • 把 NameServer 地址当成游戏服务器 IP:它是入口,不是房间服务器。

Official sources

本文依据上述光子文档整理与翻译,仅供中文接入参考。若与光子英文文档、SDK 实际行为或双方合同不一致,以光子资料与合同为准。

旧地址 /chinacloudrealtime/ 会永久跳转到本页,原有链接仍可访问。

Need help?

把文档里的步骤,落到你的项目里。

中国区 AppID、区域、许可与部署问题,可以带着项目背景直接询问。 我们不会索要账号密码。