3689 字
18 分钟
失落的龙约私服联机教程:用开源项目实现共斗

前言#

上一篇《失落的龙约私服部署教程》部署完成后,游戏只能单人游玩。共斗任务、竞速排行榜这类多人内容需要额外一套「联机服务器」,负责房间创建、玩家加入和战斗内实时消息。

联机服务器实现的是 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大厅与匹配,引导客户端连接 GameServerUDP 5055
Game Server房间逻辑与消息转发UDP 5056
游戏 API(Dawnshard)登录时下发联机入口地址;提供战绩上报等接口HTTP
GluonPlugin 插件注入房间业务逻辑:建房写入 RoomId、入房注入 ViewerId、战斗结算回调 API与 API / StateManager 走 HTTP
StateManager房间状态存取(配合 photon-redis)HTTP 8081

三个关键事实决定了部署方式:

  1. 联机入口由 API 下发。客户端登录时,API 在登录响应里原样返回 .env 中 PHOTON_SERVER_URL 的值。该值必须以 :5055 结尾且不带协议头。
  2. GameServer 地址由 Master 广播。GameServer 启动时向 Master 注册自己的对外地址(Photon 里是 PublicIPAddress,Luxon 里是 external_address),客户端建房后按此地址直连 5056 端口。
  3. 没有插件就没有共斗。客户端建房后会校验响应中的插件标识和玩家身份字段(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 追加两项:

Terminal window
# 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,完整可运行)。

部署步骤#

  1. sparse clone 上述仓库的 server/ 目录,把其中的 deploy 树复制到本机,例如 C:\photon\deploy\。确认 deploy\bin_Win64\PhotonSocketServer.exe 存在。

  2. 编译插件。安装 .NET SDK 后,clone Dawnshard 仓库,进入 PhotonPlugin 目录执行:

    Terminal window
    dotnet build DragaliaAPI.Photon.Plugin/DragaliaAPI.Photon.Plugin.csproj -c Release
  3. 分发插件产物。把 bin\Release\net481\ 下的 DLL 复制到两处:deploy\Plugins\GluonPlugin\bin\,以及 deploy\LoadBalancing\GameServer\bin\(v4 的插件依赖只会从宿主 bin 目录解析,两处都要有完整一份)。宿主自带的 PhotonHivePlugin.dll 保持 SDK 版本,不要覆盖。

  4. 修改 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。

  5. 同文件中找到 Photon.LoadBalancing.GameServerSettings,把 PublicIPAddress 设为客户端可达的对外地址。Windows 主机在 NAT 后时填 VPS 公网 IP 203.0.113.10(配合后文的中继转发),有公网直连条件时填自身公网 IP。

  6. 安装为 Windows 服务并放行防火墙(管理员 PowerShell,工作目录 deploy\bin_Win64):

    Terminal window
    .\PhotonSocketServer.exe /install LoadBalancing
    New-NetFirewallRule -DisplayName "photonserver" -Direction Inbound `
    -Program "C:\photon\deploy\bin_Win64\PhotonSocketServer.exe" `
    -Action Allow -Profile Any
    Start-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 的值
5StateManager 连通VPS 上 curl http://127.0.0.1:8081/health200

五项全过后,把 .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 为例:

Terminal window
git clone https://github.com/niansa/LuxonServer.git
cd LuxonServer
git submodule update --init --depth 1 --recursive
mkdir build && cd build
cmake .. -DLUXON_SERVER_ENABLE_PLUGINS=ON \
-DLUXON_PLUGINS=/opt/luxon-plugin \
-DLUXON_SERVER_USE_SANMAKE=OFF
cmake --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: 5088

external_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 + 数量 + 元素 的字节
4GameServer 的 InitResponse 缺 ResponseObject连上房间服务器后无动作v4 固定在此响应携带字符串对象 "ResponseObject",补上同样的负载(Master 的 InitResponse 保持默认)
5Join 事件的 ActorProperties 缺 ViewerId房间阶段静默卡 30 秒后弃房(致命项)插件注入的 ViewerId 会被随后的请求属性落库整表覆盖,必须在落库之后再补注入

第五处是最难锁定的根因:前四处各自单独修复都无效(必要非充分),五处齐备后真机建房、进房全部通过。如果只复现一处,优先确认这一处的注入时机。

验证#

启动后按顺序检查:

  1. curl http://203.0.113.10:5088/stats 能打开监控面板,三个组件显示监听正常;
  2. 日志无持续 ERROR;
  3. 真机建房:客户端建房成功、第二台设备能加入同一房间,即主链路已通。

验证过程中最有用的工具是 Wireshark 加社区 Photon 协议 dissector(Lua 脚本,wireshark -X lua_script:photon.lua 加载),可以直接对照两边的响应字节。

公网开联机#

两条路线最终都要让外网客户端连上 UDP 5055/5056。按部署拓扑分两种情况。

联机服务器与游戏栈同机(路线二推荐)#

  1. 云服务商安全组放行 UDP 5055、5056(用了 NameServer 再加 5058);
  2. PHOTON_SERVER_URL 与 external_address 都填 VPS 公网 IP;
  3. docker compose up -d 重建 API 使新地址下发。

联机服务器在内网(路线一常见)#

Photon 跑在家里 Windows 主机上时,用一台公网 VPS 做 UDP 中继。在 VPS 上把 5055/5056 的入站流量 DNAT 到内网主机(内网主机经 WireGuard、EasyTier 等组网隧道与 VPS 连通,下例中隧道地址为 10.0.0.10):

Terminal window
iptables -t nat -A PREROUTING -i eth0 -p udp -m multiport \
--dports 5055:5056 -j DNAT --to-destination 10.0.0.10
iptables -t nat -A POSTROUTING -d 10.0.0.10 -p udp -m multiport \
--dports 5055:5056 -j MASQUERADE
iptables -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)不受影响,域名照常用。

故障排查#

外网联机失败按「流量到底走到了哪一层」三分:

  1. HTTP 入口都不通:域名解析、证书、反代问题,与联机无关,先修上篇的链路。
  2. 能登录但建房秒败:客户端还没发出任何 UDP。检查 PHOTON_SERVER_URL 是否符合「数字 IP + :5055 结尾」,客户端是否有旧地址缓存(重装或清数据后重试)。
  3. 建房转圈 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 v4GSGame.log 是否出现插件加载成功;PublicIPAddress 是否为客户端可达地址;BearerToken 与 .env 是否一致;换 DLL 后是否删过 bin\Cache
LuxonServer是否以插件模式编译;五处兼容补丁是否齐全(重点是 Join 事件 ViewerId 的注入时机);external_address 是否为公网 IP

已知边界#

  • Photon v4 评估授权:官方语义为 20 并发连接的内网评估用途,公网使用处于授权灰区,介意者选路线二;
  • LuxonServer 插件移植:本文覆盖建房/进房主链路;开局握手、战斗结算、房间复用与房间列表推送的完整移植和部署,见下篇《Luxon 联机插件的完整移植与部署》;
  • 房间状态不持久化:联机服务器重启即丢房间,关停前确认没有进行中的对局;
  • 升级联动:游戏 API 与联机侧没有版本协商,API 大版本更新后若联机行为异常,优先怀疑两侧的协议假定不再一致。

参考#

最后,感谢 Dawnshard 社区与 LuxonServer 作者 tuxifan 的开源工作。联机服务从「付不起授权费」到「全开源栈跑在 Linux 上」,两条路线都站在这些项目的肩膀上。

失落的龙约私服联机教程:用开源项目实现共斗
https://blog.anyul.cn/posts/dragalia-multiplayer-server/
作者
安雨落
发布于
2026-09-03
许可协议
CC BY-NC-SA 4.0

分享文章

生成精美分享图或复制链接,与更多人分享本文。

继续阅读

沿着主题读

基于共同的标签与分类