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

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

- Canonical: https://vibrantlink.com/resources/realtime-china-region
- Markdown: https://vibrantlink.com/resources/realtime-china-region.md
- 分类：中国区
- 更新：2026-11-15
- 旧地址：https://vibrantlink.com/chinacloudrealtime/

## 关键要点

- 先在 Photon 侧解锁中国区 AppID，再谈客户端区域配置。
- 中国区客户端使用 ns.photonengine.cn；这是 NameServer 地址，不是游戏服务器 IP。
- 单独构建是光子对国内环境的要求；独立 AppID 是建议，便于隔离配置、白名单与计费。
- 截至 2026-11，Photon Voice 在中国区不可用；Realtime/PUN/Fusion/Quantum/Chat 可用性需按产品分别确认。

## 1. 一个 AppID，胜似几页代码

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

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

## 2. cn 区域与产品可用性

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

## 3. 使用本地 NameServer

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

**C# / AppSettings**
```
// 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);
```

## 4. Fixed Region、Best Region 与手动选择

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

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

## 5. Dashboard 区域白名单

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

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

## 6. 上线验收

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

## 7. 中国区常见陷阱

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

## 参考来源

- Realtime 5 Regions: https://doc.photonengine.com/realtime/current/connection-and-authentication/regions
- 如何获取 AppID: https://doc.photonengine.com/realtime/current/getting-started/obtain-your-app-id
- Realtime 5 C# 工作流: https://doc.photonengine.com/realtime/current/connection-and-authentication/realtime-workflow-cs
- Photon 价格页: https://www.photonengine.com/pricing

本页为中文接入参考，依据上述光子公开文档整理；具体 SDK、控制台和商业条款以实际使用的 Photon 版本、光子协议和订单为准。
