文本描述
PAL Proxy
PAL Proxy 是 PAL 的 Velocity/BungeeCord 配套插件。它在玩家到达后端服务器之前保护代理网络,将未认证的玩家路由至认证服务器,记住其请求的目标地址,验证已签名的 PAL 会话,并处理代理端的正版(Premium)/基岩版身份判定。
插件须知: PAL Proxy 并非独立的认证插件。它需要在兼容 Bukkit 的认证服务器上安装 PAL,并配置共享的桥接设置。
Beta 须知: PAL Proxy
0.1.0旨在用于预发布环境和受控的 Beta 测试网络。在公开生产环境使用前,请在您自己的拓扑结构上测试 Velocity/BungeeCord、Redis/SQL 桥接行为及故障转移规则。
PAL Proxy 新增功能
PAL 负责处理 Bukkit 上的账户和会话系统。PAL Proxy 则在您的后端服务器前增加了网络守卫。它决定连接的玩家是否拥有有效的已签名会话,经过验证的正版或基岩版身份是否可以创建新会话,以及应将玩家发送至何处。
它支持通过单个共享代理核心同时运行 Velocity 和 BungeeCord,并可选集成 FastLogin 和 Floodgate。
主要特性
- 针对受保护后端服务器的代理端认证守卫。
- 支持 Velocity 和 BungeeCord。
- 未认证玩家的认证重定向。
- 认证成功后记住目标地址并移交。
- 支持经过验证的 Java 正版身份。
- 通过 Floodgate 检测基岩版身份。
- 可为已验证身份创建可选的代理端会话。
- Redis 桥接模式,支持已签名会话和 Pub/Sub 更新。
- 当 Redis 不可用时,通过共享 SQL 轮询实现 DATABASE 桥接模式。
- MEMORY 模式,适用于仅限代理的隔离测试。
- HMAC 签名的桥接负载,带有共享密钥验证。
- 可选的哈希 IP 值和 IP 绑定。
- 向 Bukkit PAL 发送认证、大厅和 Limbo 的逻辑领域消息。
- 后端故障转移处理,包含回退/认证重定向。
- 防止后端踢出后的重定向循环。
- 可配置的代理消息。
- Velocity 和 BungeeCord 保持一致的行为模型。
桥接模式
- REDIS — 推荐用于生产网络。提供已签名会话负载和 Pub/Sub 通知。
- DATABASE — 在代理和 Bukkit 服务器共享同一远程 SQL 数据库且无 Redis 时可用。代理通过轮询检测更新。
- MEMORY — 仅本地代理内存。适用于测试和本地检查,但无法跨进程同步 Bukkit 会话。
- DISABLED — 关闭桥接功能。
要求
- 在 Bukkit 认证/大厅服务器上安装 PAL。
- Velocity 或 BungeeCord 代理。
- Bukkit 和代理端使用相同的
bridge.sec.secret。 - 推荐的桥接模式需要 Redis,或 DATABASE 模式需要共享的远程 SQL。
- 后端服务器需通过防火墙规则和代理转发密钥进行保护。
可选集成:
- FastLogin — 正版登录模式决策。
- Floodgate — 基岩版玩家检测。
网络登录流程
- 玩家连接到代理。
- PAL Proxy 检查 FastLogin、Floodgate 或原生正版身份支持。
- 如果存在有效的已签名 PAL 会话,允许玩家访问请求的后端服务器。
- 如果不存在有效会话,玩家将路由至认证服务器。
- Bukkit PAL 对玩家进行认证并保存会话。
- 在 REDIS 模式下,Bukkit 立即发布已签名会话。
- 在 DATABASE 模式下,代理在下一次轮询时看到已签名会话。
- PAL Proxy 将玩家发送至原始目标地址。
故障转移行为
当后端服务器踢出玩家或发生故障时,PAL Proxy 会根据当前 PAL 会话验证配置的回退方案。
- 会话有效:玩家可被移至回退服务器并保持认证状态。
- 会话缺失或过期:玩家将重新被发送至认证服务器。
- 后端失败:PAL Proxy 避免将玩家重定向回同一台服务器,从而防止循环。
如果认证服务器不可用,除非您有意在认证中断期间允许未认证玩家进入,否则应保持 bridge.fail.new-login 为 false。
配置要点
关键设置位于代理端的 bridge.yml 文件中:
bridge.enabledbridge.modebridge.net.authbridge.net.lobbybridge.guard.strictbridge.guard.requiredbridge.guard.proxy-auto-loginbridge.fail.fallbackbridge.sec.requirebridge.sec.secretbridge.redis.uribridge.database.remote
对于安全网络,请使用长随机共享密钥,保持已签名负载验证启用,并在网络/代理层面对后端服务器进行保护。
兼容性状态
PAL Proxy 已明确支持 Velocity 和 BungeeCord。当前测试版主要基于以下配置进行了验证:Velocity、运行于 Bukkit/Purpur 的 PAL、Floodgate/Geyser、SQLite/本地暂存存储,以及 ViaVersion/ViaBackwards。在公开发布前,请在目标网络环境中对 BungeeCord、多进程实时环境下的 Redis、远程 SQL 桥接行为及部分 FastLogin 流程进行测试。
技术支持
请求技术支持时,请提供以下信息:
- 代理软件及版本。
- PAL Proxy 版本。
- Bukkit PAL 版本。
- 桥接模式。
- 存储类型。
- 认证服/大厅服/回退服名称。
- 是否安装了 FastLogin/Floodgate/Geyser。
- 相关的代理与 Bukkit 日志。
请勿在评论区域寻求技术支持;请先使用配置好的支持渠道。
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧