文本描述
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 日志。
请勿在评论区域寻求技术支持;请先使用配置好的支持渠道。
Text Description
PAL Proxy
PAL Proxy is the Velocity/BungeeCord companion addon for PAL. It protects proxy networks before players reach backend servers, routes unauthenticated players to auth, remembers their requested destination, validates signed PAL sessions and handles proxy-side premium/Bedrock identity decisions.
Addon notice: PAL Proxy is not a standalone authentication plugin. It requires PAL on a Bukkit-compatible auth server and a shared bridge configuration.
Beta notice: PAL Proxy
0.1.0is intended for staging and controlled beta networks. Test Velocity/BungeeCord, Redis/SQL bridge behavior and failover rules on your own topology before public production use.
What PAL Proxy adds
PAL handles the account and session system on Bukkit. PAL Proxy adds the network guard in front of your backend servers. It decides whether a connecting player already has a valid signed session, whether a verified premium or Bedrock identity may create one, and where the player should be sent next.
It supports Velocity and BungeeCord from one shared proxy core, with optional hooks for FastLogin and Floodgate.
Main features
- Proxy-side auth guard for protected backend servers.
- Velocity and BungeeCord support.
- Auth redirect for unauthenticated players.
- Remembered destination handoff after authentication.
- Verified Java premium identity support.
- Bedrock identity detection through Floodgate.
- Optional proxy-created sessions for verified identities.
- Redis bridge mode with signed sessions and Pub/Sub updates.
- DATABASE bridge mode through shared SQL polling when Redis is unavailable.
- MEMORY mode for isolated proxy-only tests.
- HMAC-signed bridge payloads with shared secret validation.
- Optional hashed IP values and IP binding.
- Auth, lobby and limbo logical realm messages sent to Bukkit PAL.
- Backend failover handling with fallback/auth redirects.
- Protection against redirect loops after backend kicks.
- Configurable proxy messages.
- Same behavior model across Velocity and BungeeCord.
Bridge modes
- REDIS — recommended for production networks. Provides signed session payloads and Pub/Sub notifications.
- DATABASE — works without Redis when the proxy and Bukkit server share the same remote SQL database. The proxy detects updates by polling.
- MEMORY — local proxy memory only. Useful for tests and proxy-local checks, but it does not sync Bukkit sessions across processes.
- DISABLED — turns the bridge off.
Requirements
- PAL installed on the Bukkit auth/lobby server.
- Velocity or BungeeCord proxy.
- The same
bridge.sec.secreton Bukkit and proxy. - Redis for the recommended bridge mode, or shared remote SQL for DATABASE mode.
- Backend servers protected by firewall rules and proxy forwarding secrets.
Optional integrations:
- FastLogin — premium login-mode decisions.
- Floodgate — Bedrock player detection.
Network login flow
- Player connects to the proxy.
- PAL Proxy checks FastLogin, Floodgate or native premium identity support.
- If a valid signed PAL session exists, the player is allowed to reach the requested backend.
- If no valid session exists, the player is routed to the auth server.
- Bukkit PAL authenticates the player and saves a session.
- In REDIS mode, Bukkit publishes the signed session immediately.
- In DATABASE mode, the proxy sees the signed session on its next poll.
- PAL Proxy sends the player to the original destination.
Failover behavior
When a backend kicks or fails, PAL Proxy validates the configured fallback against the current PAL session.
- Valid session: the player can be moved to fallback and stays authenticated.
- Missing or expired session: the player is sent to auth.
- Failed backend: PAL Proxy avoids redirecting back to the same server, preventing loops.
If auth is unavailable, bridge.fail.new-login should stay false unless you intentionally want to allow unauthenticated players during auth outages.
Configuration highlights
Key settings live in the proxy 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
For secure networks, use a long random shared secret, keep signed payload validation enabled and protect backend servers at the network/proxy layer.
Compatibility status
PAL Proxy has explicit support for Velocity and BungeeCord. The current beta has been verified primarily with Velocity, PAL on Bukkit/Purpur, Floodgate/Geyser, SQLite/local staging, and ViaVersion/ViaBackwards. BungeeCord, Redis in a live multi-process setup, remote SQL bridge behavior and some FastLogin flows should be tested on your target network before public release.
Support
When requesting support, include:
- Proxy software and version.
- PAL Proxy version.
- Bukkit PAL version.
- Bridge mode.
- Storage type.
- Auth/lobby/fallback server names.
- Whether FastLogin/Floodgate/Geyser are installed.
- Relevant proxy and Bukkit logs.
Do not use review sections for support; use the configured support channel first.
下载 PAL Proxy - 附加模组
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PAL Proxy - 附加模组
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PAL Proxy - 附加模组
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PAL Proxy - 附加模组
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PAL Proxy - 附加模组
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PAL Proxy - 附加模组
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PAL Proxy - 附加模组
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PAL Proxy - 附加模组
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PAL Proxy - 附加模组
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PAL Proxy - 附加模组
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
版本对齐
本次更新对代理端没有任何改动,仅使其版本与 PAL 0.1.5 保持一致。
说明 / 建议
- 是否更新为可选操作。新增的首次加入高级检测功能仅适用于没有代理的独立服务器。
速度踢出消息修复
修复了单服务器 Velocity 网络中误导性的踢出消息。
已修复
- Velocity:当唯一的后端服务器踢出玩家时,他们看到的是“认证服务器不可用”,而不是真正的原因。现在他们会看到实际的踢出消息。
备注 / 建议
- 更新后请重启你的代理服务器。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧