PROXY protocol Wrapper
作者：Novogodnich
A lightweight Fabric server-side mod that adds native support for the HAProxy PROXY protocol v2 to forward real player IPs.
介绍
中文介绍正在准备中，下面暂时显示原文。
Fabric PROXY v2 Base Wrapper (PPv2)
A lightweight Fabric server-side mod that adds native support for the HAProxy PROXY protocol v2. It injects custom handlers into the Netty pipeline to accurately forward real player IPs behind reverse proxies, CDNs, or DDoS protection layers (like HAProxy, Velocity, or cloud mitigation providers).
Features
- Native Netty Integration: Dynamically updates the channel pipeline during the handshake phase.
- Accurate IP Forwarding: Restores real client IPs in Minecraft server logs, bans, and whitelist systems instead of showing 127.0.0.1 or the proxy’s IP.
- Production Ready: Fixed common pipeline race conditions (NoSuchElementException) and safely shaded required Netty HAProxy codecs.
Installation & Requirements
- Drop the compiled .jar into your server’s
mods/directory. - Ensure your upstream proxy/load balancer has PROXY protocol v2 enabled for the Minecraft backend port (e.g.,
send-proxy-v2in HAProxy configuration).
Compatibility:
- Fabric Loader 0.18.4+
- Minecraft 1.21.11 or 26.3
- Fabric api 0.159.1+26.3 or newer_(for 26.3 only)_
常见问题
PROXY protocol Wrapper 支持哪些 Minecraft 版本？
PROXY protocol Wrapper 支持 Minecraft Java 版 1.21.11–26.3，共 2 个版本，可用的加载器：Fabric。下载时注意选择和你游戏版本一致的文件。
PROXY protocol Wrapper 怎么安装？
先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric，再把下载的 .jar 文件放进游戏目录的 mods 文件夹，重新启动游戏即可。开启了版本隔离的，mods 文件夹在 versions/版本名 下面。运行环境：仅服务端。
评论
登录后评论和评分