# 在 PUN 中设置中国区域：固定区域、NameServer 与开发区域

在 Unity PUN 2 中配置中国区：PhotonServerSettings、Fixed Region cn、Use Name Server、ns.photonengine.cn，以及 Dev Region 与 Best Region 的取舍。

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

## 关键要点

- 为中国区准备 Realtime AppID，并先完成中国区解锁。
- 中国区客户端需要 ns.photonengine.cn；Use Name Server 保持开启。
- Fixed Region = cn 固定中国区；留空则使用 Best Region。
- Dev Region 仅对 Editor / Development Build 有意义，发布构建不要依赖它。

## 1. PUN 2 的当前状态

光子将 PUN 2 置于 maintenance / LTS 模式。已有项目继续使用是合理的，但新项目应先评估 Fusion 或 Quantum。不要把 PUN 2 的新功能宣传建立在光子已停止投入的前提上。

## 2. 创建并解锁中国区 AppID

1. 在 Dashboard 创建 Realtime AppID。
2. 为国内项目申请解锁，并准备单独的构建。
3. 建议使用独立 AppID，便于隔离中国区缓存与白名单。
4. 不要把 PUN 1 的 CloudRegionCode.cn / CloudRegionFlag 作为当前配置方式。

## 3. PhotonServerSettings 关键字段

**PUN 2 中国区关键设置**
| 字段 | 建议值 | 说明 |
| --- | --- | --- |
| AppId Realtime | 中国区 AppID | Chat / Voice 另需各自 AppID |
| App Version | 固定版本号 | 参与匹配隔离 |
| Use Name Server | 开启 | 云端连接必须使用 NameServer |
| Fixed Region | cn 或留空 | 填写后固定中国区；留空则自动选择最佳区域 |
| Dev Region | 仅调试时设置 | 只在 Editor / Development Build 生效 |
| Server | ns.photonengine.cn | 本地 NameServer，不是游戏服务器 |
| Port | 0 | Photon Cloud 自动选择 |

Inspector 字段名可能随 PUN 版本变化；以目标版本的界面与光子文档为准。

## 4. 连接与运行时配置

**C# / PhotonServerSettings**
```
// Official docs: https://doc.photonengine.com/pun/current/connection-and-authentication/regions
// China differences: https://vibrantlink.com/resources/pun-china-region
// Quota & pricing: https://vibrantlink.com/pricing

// 通常直接在 Inspector 配置后调用
PhotonNetwork.ConnectUsingSettings();

// 需要运行时修改时，先取得 AppSettings
var settings = PhotonNetwork.PhotonServerSettings.AppSettings;
settings.AppIdRealtime = "<中国区 AppID>";
settings.FixedRegion = "cn";
settings.UseNameServer = true;
settings.Server = "ns.photonengine.cn";
PhotonNetwork.ConnectUsingSettings();
```

Fixed Region 和 Dev Region 的优先级在不同 PUN 版本中可能不同，光子文档没有给出统一保证。发布前需要在目标版本实测；编辑器里的表现只能作为参考。

## 5. Best Region 与缓存

如果希望保留运营期调整能力，可以清空 Fixed Region，并用 Dashboard 白名单约束可用区域。Best Region 会缓存上一次结果；延迟接近时，选择可能不同。调试时可清空缓存：

**C# / 清空 Best Region 缓存**
```
PhotonNetwork.BestRegionSummaryInPreferences = null;
```

## 6. 验收清单

- 确认 AppID 已解锁中国区，构建使用独立 AppID 或至少独立配置。
- 确认实际连接使用 ns.photonengine.cn 与 cn 区域。
- 用 Editor + Development Build + 正式构建分别测试。
- 检查 Dashboard 白名单与缓存是否同步。
- 验证自定义认证、Webhook 与 WebRPC 是否依赖境外服务。

## 7. 中国区注意事项

> **容量与语音**
>
> 中国区公开 Cloud 套餐为 500 CCU，更大规模需商务定制；付费方案通常不能在 Dashboard 直接购买。Photon Voice 中国区云不可用，语音项目需要评估 Photon Server 自建。

## 参考来源

- PUN 2 Regions: https://doc.photonengine.com/pun/current/connection-and-authentication/regions
- PUN 2 初始设置: https://doc.photonengine.com/pun/current/getting-started/initial-setup
- PUN 2 介绍: https://doc.photonengine.com/pun/current/getting-started/pun-intro

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