PAL Proxy - 附加模组

插件

原名 PAL Proxy - Addon · 作者 CroaBeast

官方插件,为 Velocity 和 BungeeCord 带来 PAL 认证功能:代理端会话保护、已验证的高级版与基岩版身份、记忆目标服务器以及后端宕机时的故障转移路由。

0 本站下载 0 关注 更新于 3 周前

最新 0.1.5 · 26.3 · Velocity

一键开服(送7天)
文本描述

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 — 基岩版玩家检测。

网络登录流程

  1. 玩家连接到代理。
  2. PAL Proxy 检查 FastLogin、Floodgate 或原生正版身份支持。
  3. 如果存在有效的已签名 PAL 会话,允许玩家访问请求的后端服务器。
  4. 如果不存在有效会话,玩家将路由至认证服务器。
  5. Bukkit PAL 对玩家进行认证并保存会话。
  6. 在 REDIS 模式下,Bukkit 立即发布已签名会话。
  7. 在 DATABASE 模式下,代理在下一次轮询时看到已签名会话。
  8. PAL Proxy 将玩家发送至原始目标地址。

故障转移行为

当后端服务器踢出玩家或发生故障时,PAL Proxy 会根据当前 PAL 会话验证配置的回退方案。

  • 会话有效:玩家可被移至回退服务器并保持认证状态。
  • 会话缺失或过期:玩家将重新被发送至认证服务器。
  • 后端失败:PAL Proxy 避免将玩家重定向回同一台服务器,从而防止循环。

如果认证服务器不可用,除非您有意在认证中断期间允许未认证玩家进入,否则应保持 bridge.fail.new-login 为 false。

配置要点

关键设置位于代理端的 bridge.yml 文件中:

  • bridge.enabled
  • bridge.mode
  • bridge.net.auth
  • bridge.net.lobby
  • bridge.guard.strict
  • bridge.guard.required
  • bridge.guard.proxy-auto-login
  • bridge.fail.fallback
  • bridge.sec.require
  • bridge.sec.secret
  • bridge.redis.uri
  • bridge.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 日志。

请勿在评论区域寻求技术支持;请先使用配置好的支持渠道。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源