Proxy Protocol Support
by PanSzelescik
Proxy Protocol Support lets a Minecraft server accept PROXY protocol connections from trusted proxies while still accepting direct connections.
What it does
Reverse proxies such as HAProxy, TCPShield, Nginx and FRP can forward player traffic to a server while hiding its real IP address. Without PROXY protocol support, the server console only shows the proxy's address. Reading the PROXY protocol header lets the server record each player's real IP address.
The mod works with both proxied and direct connections at the same time. Its default deny policy rejects any incoming address that is not on the trusted list, which stops players from bypassing the proxy and connecting straight to the server's real IP. Local players can still connect directly. The mod runs on the server only, so players need nothing installed.
The mod is published for Fabric, Forge and Quilt. Fabric files cover 1.14 – 26.3, Forge files target 1.19.4 with a beta channel, and Quilt files are listed up to 1.21.11. Snapshot builds are published, and the code is released under the MIT License, so the project is open source.
Key features
Trusted proxy list
Only addresses and ranges listed in the configuration, such as 127.0.0.1 or 192.168.0.0/16, are accepted through the proxy.
Default deny policy
Any incoming address that is not explicitly whitelisted is rejected, so the server's real IP stays unreachable.
Real player addresses
The server reads the PROXY protocol header and shows each player's real IP address in its logs.
Direct and proxied access
Trusted proxied connections and direct connections from local players can be accepted at the same time.
Compatibility
Latest build for each game version and loader.
26.x5 of 5 versions with builds
1.21.x12 of 12 versions with builds
1.20.x7 of 7 versions with builds
1.19.x5 of 5 versions with builds
1.18.x3 of 3 versions with builds
1.17.x2 of 2 versions with builds
1.16.x6 of 6 versions with builds
1.15.x3 of 3 versions with builds
1.14.x5 of 5 versions with builds
This mod also publishes snapshot builds. Snapshots are not shown in the matrix.
Use cases
Hiding a server behind a proxy
Owners who route traffic through TCPShield, Nginx or FRP can keep their server's IP hidden while admins still see real player addresses.
Who it’s for: Server owners who run a reverse proxy or DDoS protection service in front of a Minecraft server, and admins who need the players' real IP addresses in logs.
Questions
Does Proxy Protocol Support need to be installed on the client?
Which loaders are supported?
Which Minecraft versions does the mod support?
In the catalog
Proxy Protocol Support is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 8,071 mods support Minecraft 26.3.
More from PanSzelescik
Similar mods
What the author says
Proxy Protocol Support is a Fabric and Quilt mod which adds support for Proxy Protocol (HAProxy)") for your Minecraft server. It allows to accept both proxied and direct connections simultaneously. For example you can use TCPShield or other software (Nginx, FRP) to forward traffic, and hide your server's IP address…
Official listing
- Modrinth page
- modrinth.com/mod/proxy-protocol-support
- Owner
- PanSzelescik
- Published
- 2022-05-16
- Updated on Modrinth
- 2026-05-14
- Facts verified
- 2026-10-15