跳到主要内容
VibrantLink 动联无限
Photon Server 5中文快速开始

5 分钟启动 Photon Server

Photon Server 的安装与启动非常直接:下载 SDK、放置许可、 启动 PhotonControl,然后运行 LoadBalancing 实例。 本文已按光子 Server 5 文档重新校对。

阅读约 8 分钟更新于 2026 年 11 月 15 日光子原文
深蓝色调服务器机房中打开的服务器机柜与工作台概念视觉
概念视觉 · Photon Server 可部署在你选择的 Windows 服务器或云主机上
本页目录
  1. 开始之前
  2. 下载与解压
  3. 获取并放置许可
  4. 启动 PhotonControl
  5. LoadBalancing 实例
  6. 配置服务器地址
  7. 中国区许可与部署
  8. 下一步与排查

无论你准备自建多人服务器、把现有项目迁移到自托管环境, 还是希望完全掌控网络拓扑,Photon Server 都提供与 Photon Cloud 相近的开发体验。下面是依据光子 Server 5 快速开始更新的中文步骤。

当前光子 SDK 的几个要点

  • 当前 SDK 使用自解压可执行文件,不再需要另外解压 zip。
  • 运行 Photon Server 需要先获取并放置有效的许可文件。
  • LoadBalancing 实例现在包含 NameServer、Master Server 与 Game Server 三个应用。
  • 地址配置文件更新为 Nameserver.json 与 GameServer.xml.config。

01开始之前

本文使用 Photon Server 5 的光子 SDK。你需要一台 Windows 环境来运行部署包中的可执行文件,并拥有 Photon 账号。 如果还没有账号,请先在 Photon 控制台 注册;下载与许可入口均在光子站点。

如果你尚未决定使用云服务还是自建服务器,建议先阅读 Photon Cloud 还是 Photon Server。中国区用户需要特别留意许可验证链路,见下文「中国区许可与部署」。

02下载与解压

Photon Server SDK 可在 光子下载页 获取。当前 Server SDK 以自解压可执行文件形式提供; 这样可避免部分解压工具把随包的 .dll 文件标记为 不可信来源。

把安装包解压到你准备好的空文件夹。解压后会看到 SDK 的几个主要目录:

  • deploy:运行服务器所需的二进制与配置, 至少包含这个目录即可启动 Photon。
  • doc、lib、src-server:开发文档、类库与应用示例。

运行所需的二进制位于 deploy\bin_Win64, 其中包括 PhotonSocketServer.exe、PhotonServer.config、PhotonControl.exe 与许可文件。 你也可以通过命令行参数启动服务器,详见 光子命令行手册。

03获取并放置许可

当前 Photon Server 需要有效许可才能运行。在 Photon 光子页面领取或获取许可后,把许可文件保存到 deploy\bin_Win64。许可类型、有效期与适用环境请以 光子许可页面 为准。

放置或替换许可文件后,建议重启 PhotonControl, 以便重新读取 CCU、到期时间等许可信息。 后续也可以在 PhotonControl 中查看许可状态。

中国区许可与网络连通性

Photon Server 仍需要有效的自托管许可。光子许可 文档列出的浮动许可监控端点为 licensespch.exitgames.com(香港)与 licensesp.exitgames.com;服务启动时及每 24 小时至少需要其中一个端点可达。若你的网络对跨境 HTTPS 有特殊限制,请在上线前完成连通性测试,并与我们确认适用的许可方案。 购买、续期或迁移许可前,请通过 与我们联系。

04启动 PhotonControl

在 deploy\bin_Win64 中运行 PhotonControl.exe,并确认它请求的管理员权限。 设置 Photon 为系统服务时需要这些权限。启动后,托盘区会出现 Photon 图标,点击图标即可打开控制菜单。

从 Photon 实例中选择 LoadBalancing (MyCloud), 然后选择 Start as Application。 当托盘图标变为 Photon 标志的蓝色时,服务器通常已经可以使用。 关于 PhotonControl 的完整菜单说明,请参阅 PhotonControl 文档。退出 PhotonControl 不会关闭已经启动的服务器。

PhotonControl 中选择 LoadBalancing (MyCloud) 并以应用方式启动的光子截图
光子文档截图:在 PhotonControl 中以应用方式启动 LoadBalancing (MyCloud)。

05理解 LoadBalancing 实例

Photon 以「应用」运行游戏逻辑,定义客户端可以做什么, 例如匹配、创建房间等。开箱即用的 LoadBalancing (MyCloud) 是与 Photon Cloud 的 Realtime、PUN、Voice 等客户端兼容的推荐配置。

启动 LoadBalancing 实际上会运行三个 Photon 应用:

  • NameServer:接收初始连接,并把客户端引导到 Master Server。
  • Master Server:负责匹配与大厅;创建房间或加入已有房间后, 会把客户端转发到 Game Server。
  • Game Server:承载实际房间与实时通信。

默认情况下,三个角色都使用本机回环地址。因此,只有同一台机器上的客户端 才能直接连接;来自局域网其他设备或公网的客户端,需要完成下方的地址配置。

06配置服务器地址

要让其他设备或公网玩家连接,你需要分别配置 Master Server 与 Game Server 的可达地址。配置完成后,停止并重新启动服务器以应用更改。

Master Server 地址(Nameserver.json)

在 PhotonControl 菜单中选择 Edit Nameserver.json, 或者在文本编辑器中打开 deploy\Nameserver.json。 在可用节点中填写 Master Server 的 IP 地址或主机名; 如使用区域 token,需确保客户端的 Fixed Region 或手动区域选择与自托管配置一致。

Game Server 地址

打开 deploy\LoadBalancing\GameServer\bin\GameServer.xml.config,设置 PublicIPAddress 节点;如果需要域名, 同时设置 PublicHostName。你也可以使用 PhotonControl 菜单中的 Game Server IP Config, 从主机的公网或本地 IP 中选择。

选择 Autodetect public 时,Photon 会在启动时自动检测公网 IP。公网 IP 可能会变化,若没有静态 IP, 建议使用主机名或动态 DNS。

仅改配置还不够

无论选择局域网 IP 还是公网 IP,都需要同时检查防火墙、路由器和交换机规则。 如果服务器在局域网中,而客户端使用 WiFi,它们可能处于不同网段; 请确认设备间可以互通,并确保玩家侧能够访问所选端口。 光子配置项说明见 服务器配置文档。

07中国区许可与部署

Photon Server 不加入 Photon Cloud 的区域集群; 它运行在你选择的 Windows 服务器或云主机上。不过 Nameserver.json 仍可能使用 region token,客户端的 Fixed Region 或手动区域选择必须与自托管配置匹配, 否则会出现已启动却无法正确连接的情况。

部署前建议确认三件事:许可有效期与 CCU 规格、许可监控端点是否可达, 以及玩家客户端要连接的地址是否正确。光子许可页列出的监控端点为香港与全球端点; 如你的网络有跨境访问限制,请在上线前与我们一起完成连通性验证。

若项目计划在国内公开发行,还需按相关规定准备备案等资料。 这属于项目所在地的发行要求,不是 Photon Server 的技术前置条件。

自建服务器并希望同时使用 Photon Cloud? 两者可以共存,但需要使用同一套客户端开发方式并分别配置连接目标。 更多差异请阅读 Cloud 与 Server 对比。

08下一步与排查

启动成功之后,建议按以下顺序继续:

  1. 使用对应 SDK 的客户端 Demo 连接本机服务器,确认基础链路。
  2. 逐项验证房间创建、加入与事件同步,再扩大到局域网设备。
  3. 完成公网地址、防火墙与端口配置后,再从外部网络测试。
  4. 上线前进行性能与压力测试,并核对许可 CCU。 光子参考: Performance Tests。

如果客户端无法连接,优先检查:服务器地址是否仍为回环地址、 防火墙是否放行、Master Server 与 Game Server 的地址/端口, 以及 Nameserver.json 的 region token 是否与客户端区域选择一致;同时确认修改配置后是否重启过服务器。 仍无法解决时,可把日志、配置文件和 复现步骤通过 发送给我们。

Need a hand?

需要光子许可或中国区开通?

我们提供 Photon Server 许可采购,以及 Photon Cloud 中国区开通。

申请免费光子云

来源与更新说明

本文依据光子文档 Starting Photon in 5 Minutes(Server 5) 校对更新,光子页面最后更新时间为 2026-08-04。 产品路径与选项可能随版本变化,部署前请以光子文档为准。