前言
上一篇《失落的龙约私服部署教程》部署完成后,游戏只能单人游玩。共斗任务、竞速排行榜这类多人内容需要额外一套「联机服务器」,负责房间创建、玩家加入和战斗内实时消息。
联机服务器实现的是 Photon Realtime 协议。官方 Photon Server 是商业产品,授权费用超出个人部署的合理范围。本文介绍两条不购买授权的路线:
| 路线 | 运行时 | 插件 | 操作系统 | 适合场景 |
|---|---|---|---|---|
| 路线一 | Photon Server v4(官方闭源运行时,评估模式免费) | Dawnshard 自带的 C# 插件,开箱即用 | 仅 Windows | 手头有 Windows 主机,想尽快玩上共斗 |
| 路线二 | LuxonServer(BSD-3-Clause 开源复刻) | 需要自行移植 C++ 插件 | Linux / Windows / macOS | 想要纯开源栈,与游戏服务端同机部署 |
[!WARNING] 免责声明 失落的龙约的商标与全部游戏资源归任天堂、Cygames 所有。Photon 是 Exit Games 的商标。部署私服仅供个人学习与 Preservation 研究用途,请勿将服务对公众开放运营。本文不涉及任何游戏资源分发。
联机架构
先弄清楚数据怎么流,后面的每一步配置才知道改的是什么。
| 组件 | 职责 | 通信 |
|---|---|---|
| 游戏客户端 | 发起建房、进房、战斗内实时消息 | 与联机服务器走 UDP |
| Master Server | 大厅与匹配,引导客户端连接 GameServer | UDP 5055 |
| Game Server | 房间逻辑与消息转发 | UDP 5056 |
| 游戏 API(Dawnshard) | 登录时下发联机入口地址;提供战绩上报等接口 | HTTP |
| GluonPlugin 插件 | 注入房间业务逻辑:建房写入 RoomId、入房注入 ViewerId、战斗结算回调 API | 与 API / StateManager 走 HTTP |
| StateManager | 房间状态存取(配合 photon-redis) | HTTP 8081 |
三个关键事实决定了部署方式:
- 联机入口由 API 下发。客户端登录时,API 在登录响应里原样返回
.env中PHOTON_SERVER_URL的值。该值必须以:5055结尾且不带协议头。 - GameServer 地址由 Master 广播。GameServer 启动时向 Master 注册自己的对外地址(Photon 里是
PublicIPAddress,Luxon 里是external_address),客户端建房后按此地址直连 5056 端口。 - 没有插件就没有共斗。客户端建房后会校验响应中的插件标识和玩家身份字段(ViewerId),缺失时静默等待约 30 秒,然后报「建房失败」。协议服务器本身只做转发,RoomId、ViewerId 都靠插件注入。
第零步:补齐联机容器
上篇的 compose 只包含单机组件。联机还需要 StateManager 和它专用的 Redis(Redis Stack,用到 Redis OM)。修改 docker-compose.yml,加入两个服务,并给 dragaliaapi 增加两个环境变量:
services: dragaliaapi: # ……原有配置保持不变,environment 段新增: environment: - PhotonOptions__StateManagerUrl=http://photonstatemanager:8080 - PhotonOptions__Token=${PHOTON_TOKEN}
photonstatemanager: image: ghcr.io/sapiensanatis/photon-state-manager:3.0.85 environment: - PhotonOptions__Token=${PHOTON_TOKEN} - ConnectionStrings__Redis=photon-redis:6379 ports: - "8081:8080" # 路线一(联机服务器在别的机器)需要;纯路线二可删 depends_on: - photon-redis
photon-redis: image: redis/redis-stack-server:latest.env 追加两项:
# API 与插件、StateManager 校验请求来源的共享令牌,32 位随机字符串PHOTON_TOKEN=<自定义随机 Token># 登录响应下发给客户端的联机入口,必须以 :5055 结尾PHOTON_SERVER_URL=203.0.113.10:5055镜像 tag 以 package 页面的最新版为准。执行 docker compose up -d 后,curl http://203.0.113.10:8081/health 返回 200 即为就绪。
PHOTON_SERVER_URL 的值在两条路线里都填实际对外的联机入口。路线一填 Windows 主机的公网入口,路线二填 VPS 自身 IP。地址里的坑(必须填数字 IP)见后文「公网开联机」。
路线一:Photon v4(Windows)
版本事实
- 不要用 v5。v5 无 license 文件直接拒绝启动;免费的 100 CCU license 属于 floating 类型,需要在线连接 Exit Games 许可服务器校验,国内直连不通,进程会被周期性自动关停。
- 使用 v4 评估模式。不放任何 license 文件即可稳定运行,官方语义为 20 并发连接的内网评估用途。私服规模足够,但请知悉这一限制的含义。
- v4 没有 Linux 引擎,只能跑在 Windows 上。官方下载需要付费会员,可用的二进制来源是社区仓库 hfujioka-aim/PhotonPluginTest 的
server/目录(v4.0.29.11263,完整可运行)。
部署步骤
-
sparse clone 上述仓库的
server/目录,把其中的deploy树复制到本机,例如C:\photon\deploy\。确认deploy\bin_Win64\PhotonSocketServer.exe存在。 -
编译插件。安装 .NET SDK 后,clone Dawnshard 仓库,进入
PhotonPlugin目录执行:Terminal window dotnet build DragaliaAPI.Photon.Plugin/DragaliaAPI.Photon.Plugin.csproj -c Release -
分发插件产物。把
bin\Release\net481\下的 DLL 复制到两处:deploy\Plugins\GluonPlugin\bin\,以及deploy\LoadBalancing\GameServer\bin\(v4 的插件依赖只会从宿主 bin 目录解析,两处都要有完整一份)。宿主自带的PhotonHivePlugin.dll保持 SDK 版本,不要覆盖。 -
修改
deploy\LoadBalancing\GameServer\bin\Photon.LoadBalancing.dll.config(v4 不读取 plugin.config,配置只能写在这个文件):<PluginSettings Enabled="True"><Plugins><Plugin Name="GluonPlugin" Version="v1"AssemblyName="DragaliaAPI.Photon.Plugin.dll"Type="DragaliaAPI.Photon.Plugin.Plugins.Gluon.GluonPluginFactory"ApiServerUrl="http://203.0.113.10/"StateManagerUrl="http://203.0.113.10:8081/"BearerToken="<与 .env 的 PHOTON_TOKEN 一致>"DungeonRecordMultiEndpoint="dungeon_record/record_multi"TimeAttackEndpoint="dungeon_record/record_time_attack"ReplayTimeoutSeconds="30"RandomMatchingStartDelayMs="30000"/></Plugins></PluginSettings>两个易错点:
Type必须写完整的命名空间路径,写短了会报 TypeLoadException;BearerToken必须等于 VPS.env里的PHOTON_TOKEN。 -
同文件中找到
Photon.LoadBalancing.GameServerSettings,把PublicIPAddress设为客户端可达的对外地址。Windows 主机在 NAT 后时填 VPS 公网 IP203.0.113.10(配合后文的中继转发),有公网直连条件时填自身公网 IP。 -
安装为 Windows 服务并放行防火墙(管理员 PowerShell,工作目录
deploy\bin_Win64):Terminal window .\PhotonSocketServer.exe /install LoadBalancingNew-NetFirewallRule -DisplayName "photonserver" -Direction Inbound `-Program "C:\photon\deploy\bin_Win64\PhotonSocketServer.exe" `-Action Allow -Profile AnyStart-Service "Photon Socket Server: LoadBalancing"
验证清单
| # | 检查项 | 方式 | 预期结果 |
|---|---|---|---|
| 1 | 服务状态 | Get-Service "Photon Socket Server: LoadBalancing" | Running |
| 2 | 监听端口 | netstat -ano | findstr ":5055 :5056" | 5055/5056 UDP LISTENING |
| 3 | 插件加载 | 查看 deploy\log\GSGame.log | 出现 GluonPluginFactory ... was successfuly created |
| 4 | 向 Master 注册 | 同上日志 | Successfully registered at master server,地址为 PublicIPAddress 的值 |
| 5 | StateManager 连通 | VPS 上 curl http://127.0.0.1:8081/health | 200 |
五项全过后,把 .env 的 PHOTON_SERVER_URL 指向这台主机的对外地址,docker compose up -d 重建 API,进游戏建房验证。
路线二:LuxonServer(纯开源)
LuxonServer 是对 Photon Realtime 服务端的 clean-room 复刻(BSD-3-Clause),基于 Luxon 项目对 ENET 协议和 Photon 二进制序列化格式的独立实现。它原生跑在 Linux 上,自带 Web 监控面板;作者将其定位为单线程的轻量实现,对私服的并发规模绰绰有余。
写作时其上游兼容列表尚未收录《失落的龙约》,本文内容是按 2018 版客户端实测打通的记录。官方 Photon 的使用方式(改 hosts 劫持 Photon 域名)这里不需要:客户端的联机地址本来就从游戏 API 获取。
编译安装
插件系统默认关闭,且插件以静态链接方式并入服务端,因此必须从源码编译。以 Ubuntu 为例:
git clone https://github.com/niansa/LuxonServer.gitcd LuxonServergit submodule update --init --depth 1 --recursivemkdir build && cd buildcmake .. -DLUXON_SERVER_ENABLE_PLUGINS=ON \ -DLUXON_PLUGINS=/opt/luxon-plugin \ -DLUXON_SERVER_USE_SANMAKE=OFFcmake --build . -j$(nproc)编译依赖 C++23 编译器(GCC 13+)与 CMake 3.16+;LUXON_PLUGINS 指向插件目录(见下文)。不打算折腾插件的话,官方也提供 Release 下载和 Debian 软件源,但那两种形态无法加载自定义插件。
配置
配置文件为 config.yml(构建后工作目录下的 config.yml,参考仓库内 config.example.yml)。三个监听组件加一个 HTTP 面板:
Servers: NameServer: - port: 5058 external_address: 203.0.113.10:5058 MasterServer: - port: 5055 external_address: 203.0.113.10:5055 GameServer: - port: 5056 external_address: 203.0.113.10:5056
MaxConnections: 20
HTTP: enabled: true address: 0.0.0.0 port: 5088external_address 就是广播给客户端的对外地址,语义等同 Photon 的 PublicIPAddress,直接填公网 IP。注意 YAML 列表项缩进要照抄示例文件的层级(比键名多两级),嵌套错位会导致配置解析失败。客户端实际只使用 5055/5056 两个端口;5058 是 NameServer(认证目前是桩实现),按示例保留即可。
GluonPlugin 移植
Dawnshard 的插件行为参考是 C# 版 GluonPlugin(MIT 协议,跑在 Photon 里)。Luxon 的插件用 C++ 编写,通过 luxon_register_plugin() 静态注册,接口为 PluginBase 上的若干回调。核心注入逻辑的骨架如下:
class GluonPlugin final : public game_plugins::PluginBase {public: Awaitable<game_plugins::Result> OnCreateGame( ser::OperationRequestMessage& req, OnCreateGameCallInfo&) override { // 建房:写入空房 TTL 与 RoomId(随机 7 位数),客户端据此进房 game_->empty_game_ttl = 500; const std::int32_t room_id = std::uniform_int_distribution<std::int32_t>{1'000'000, 9'999'999}(rng_); game_->insert_game_props(ser::Hashtable{ {ser::Value(std::string("RoomId")), ser::Value(room_id)}, }); lco_return game_plugins::Result::Continue; }
Awaitable<game_plugins::Result> OnJoinGame( ser::OperationRequestMessage& req, OnJoinGameCallInfo& info) override { // 入房:请求的 ActorProperties(249) 只有 PlayerId 时,补注入 ViewerId = PlayerId auto& props = *req.parameters.at(249).get<ser::HashtablePtr>(); auto viewer = props.find(ser::Value(std::string("ViewerId"))); auto player = props.find(ser::Value(std::string("PlayerId"))); if (viewer == props.end() && player != props.end()) { info.joiner->actor_props[ser::Value(std::string("ViewerId"))] = player->second; } lco_return game_plugins::Result::Continue; } // ……其余回调保持 Continue 透传};
LN_REGISTER_GAME_PLUGIN("GluonPlugin", GluonPlugin)cmake_minimum_required(VERSION 3.16)project(gluon_plugin LANGUAGES CXX)add_library(gluon_plugin STATIC gluon.cpp)target_compile_features(gluon_plugin PRIVATE cxx_std_23)luxon_register_plugin(gluon_plugin)C++ 插件完成的是 C# 版的主链路行为(建房、入房)。战斗结算回调 API 的部分(dungeon_record/record_multi、竞速上报等)需要按 C# 源码补齐对应的 HTTP 回调,属于进阶移植项。
服务端兼容补丁
光有插件还不够。用生产 Photon 的抓包做字节级对照,能发现 Luxon 与 Photon v4 在协议细节上有五处行为差异,每处都会让 2018 版客户端在建房阶段静默卡死 30 秒后退出。它们都在 LuxonServer 的 GameServer 处理器(handler_gameserver.cpp)里修改:
| # | 差异 | 客户端表现 | 修法 |
|---|---|---|---|
| 1 | 建房响应缺 PluginName(201)/PluginVersion(200) | 校验插件失败,静默退出 | 响应参数补 201="GluonPlugin"、200="1.0"(v4 的 Hive 宿主会自动注入,Luxon 没有) |
| 2 | 建房响应 GameProperties 混入 EmptyRoomTtl(245)/PlayerTtl(246)/CleanupCacheOnLeave(252) | 解析后状态异常 | v4 把 TTL 当房间选项而不进属性表,照做:从响应属性中剔除这三个键 |
| 3 | 广播列表(250)被编码为 StringArray(0x61) | 整包解析失败 | 客户端只认 GenericArray(0x79),用 PreSerializedValue 手工产出 0x79 + 数量 + 元素 的字节 |
| 4 | GameServer 的 InitResponse 缺 ResponseObject | 连上房间服务器后无动作 | v4 固定在此响应携带字符串对象 "ResponseObject",补上同样的负载(Master 的 InitResponse 保持默认) |
| 5 | Join 事件的 ActorProperties 缺 ViewerId | 房间阶段静默卡 30 秒后弃房(致命项) | 插件注入的 ViewerId 会被随后的请求属性落库整表覆盖,必须在落库之后再补注入 |
第五处是最难锁定的根因:前四处各自单独修复都无效(必要非充分),五处齐备后真机建房、进房全部通过。如果只复现一处,优先确认这一处的注入时机。
验证
启动后按顺序检查:
curl http://203.0.113.10:5088/stats能打开监控面板,三个组件显示监听正常;- 日志无持续 ERROR;
- 真机建房:客户端建房成功、第二台设备能加入同一房间,即主链路已通。
验证过程中最有用的工具是 Wireshark 加社区 Photon 协议 dissector(Lua 脚本,wireshark -X lua_script:photon.lua 加载),可以直接对照两边的响应字节。
公网开联机
两条路线最终都要让外网客户端连上 UDP 5055/5056。按部署拓扑分两种情况。
联机服务器与游戏栈同机(路线二推荐)
- 云服务商安全组放行 UDP 5055、5056(用了 NameServer 再加 5058);
PHOTON_SERVER_URL与external_address都填 VPS 公网 IP;docker compose up -d重建 API 使新地址下发。
联机服务器在内网(路线一常见)
Photon 跑在家里 Windows 主机上时,用一台公网 VPS 做 UDP 中继。在 VPS 上把 5055/5056 的入站流量 DNAT 到内网主机(内网主机经 WireGuard、EasyTier 等组网隧道与 VPS 连通,下例中隧道地址为 10.0.0.10):
iptables -t nat -A PREROUTING -i eth0 -p udp -m multiport \ --dports 5055:5056 -j DNAT --to-destination 10.0.0.10iptables -t nat -A POSTROUTING -d 10.0.0.10 -p udp -m multiport \ --dports 5055:5056 -j MASQUERADEiptables -A FORWARD -d 10.0.0.10 -p udp -m multiport \ --dports 5055:5056 -j ACCEPT此时 PHOTON_SERVER_URL 和 PublicIPAddress 都填 VPS 公网 IP 203.0.113.10。DNAT 规则重启即失,把这三条写进一个脚本并用 systemd 单元在开机时执行(After=network-online.target)。
必须用数字 IP
实测中,PHOTON_SERVER_URL 填域名(如 dl.example.com:5055)时,蜂窝网络下的客户端会瞬间建房失败,错误码 3008,联机服务器日志没有任何客户端痕迹。换成数字 IP 后同一环境立即成功。结论:2018 版客户端的 ENET 层对联机地址只认数字字面量。HTTP 入口(dl.example.com)不受影响,域名照常用。
故障排查
外网联机失败按「流量到底走到了哪一层」三分:
- HTTP 入口都不通:域名解析、证书、反代问题,与联机无关,先修上篇的链路。
- 能登录但建房秒败:客户端还没发出任何 UDP。检查
PHOTON_SERVER_URL是否符合「数字 IP +:5055结尾」,客户端是否有旧地址缓存(重装或清数据后重试)。 - 建房转圈 30 秒后失败:UDP 已到联机服务器,问题在响应内容。按后述对照表检查。
UDP 判活不要用「发个包看有没有回包」:Photon 对乱码探测不回应。可靠判据是行为对比——端口未放行时探测表现为秒回 ICMP 端口拒绝,放行后变为静默超时;或在服务器上用 iptables -t nat -L PREROUTING -v -n 看规则计数是否增长,配合 tcpdump -ni any 'udp port 5055 or udp port 5056' 抓包归因。另外 5055/5056 是全网扫描器常打端口,裸计数增长要先看源 IP。
「30 秒失败」在两条路线里的检查点:
| 路线 | 依次检查 |
|---|---|
| Photon v4 | GSGame.log 是否出现插件加载成功;PublicIPAddress 是否为客户端可达地址;BearerToken 与 .env 是否一致;换 DLL 后是否删过 bin\Cache |
| LuxonServer | 是否以插件模式编译;五处兼容补丁是否齐全(重点是 Join 事件 ViewerId 的注入时机);external_address 是否为公网 IP |
已知边界
- Photon v4 评估授权:官方语义为 20 并发连接的内网评估用途,公网使用处于授权灰区,介意者选路线二;
- LuxonServer 插件移植:本文覆盖建房/进房主链路;开局握手、战斗结算、房间复用与房间列表推送的完整移植和部署,见下篇《Luxon 联机插件的完整移植与部署》;
- 房间状态不持久化:联机服务器重启即丢房间,关停前确认没有进行中的对局;
- 升级联动:游戏 API 与联机侧没有版本协商,API 大版本更新后若联机行为异常,优先怀疑两侧的协议假定不再一致。
参考
- Dawnshard 仓库(含 C# 版 GluonPlugin 与 PhotonStateManager 源码)
- LuxonServer · Luxon 协议库
- hfujioka-aim/PhotonPluginTest(Photon v4 可运行二进制)
- AltspaceVR/wireshark-photon-dissector
- 上一篇:失落的龙约私服部署教程
最后,感谢 Dawnshard 社区与 LuxonServer 作者 tuxifan 的开源工作。联机服务从「付不起授权费」到「全开源栈跑在 Linux 上」,两条路线都站在这些项目的肩膀上。
分享文章
生成精美分享图或复制链接,与更多人分享本文。
继续阅读
最后更新于 ,距今已过 59 天
部分内容可能已过时