HAProxyCompat
by the_atmerek
HAProxyCompat restores the real client IP for a modded server that sits behind a reverse proxy such as FRP, nginx, HAProxy or Traefik.
What it does
Without this, a Minecraft server behind a reverse proxy logs every player under the proxy's address, so IP bans and IP logs point at the wrong machine. Given a PROXY protocol header in v1 or v2 form, HAProxyCompat parses it, extracts the client's real IP address, and passes that address to Minecraft as though the connection came straight from the player. Real IPs then show in logs, IP bans work on the right address, and geolocation is accurate.
The mod is server-side only, so players join without installing anything. It runs on NeoForge and Fabric dedicated servers, and one jar covers each supported loader version; it includes one Netty piece that Minecraft does not ship. Files are published for 1.21 – 26.3 under the GNU General Public License v3.0 or later, and the source code is open source. Server owners only need to drop the jar into the mods folder and tell the proxy to send the PROXY header. If the proxy runs on a different machine, that machine's address has to be added to the trusted proxies list.
Key features
Real client IP recovery
The real address of each player is extracted from the PROXY header and used in place of the proxy's address.
Trusted proxy list
Only connections from addresses listed as trusted proxies are read, so a header from anyone else is ignored and dropped.
Strict mode
A master switch can be set to accept only connections that carry a valid PROXY header, which blocks direct connections that try to fake an IP.
Accurate IP bans and logs
Bans, logs and geolocation act on the player's real address instead of the proxy's, so one banned player cannot be replaced by a fake header from someone else.
Gallery
Compatibility
Latest build for each game version and loader.
26.x5 of 5 versions with builds
1.21.x12 of 12 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
How it compares
Fabric PROXY protocol Wrapper is a Fabric-only option for 1.21.11 – 26.3, server-side only and open source under the GNU General Public License v3.0 or later. NG HaProxy Support is for Forge 1.20.1 only, server-side only and released under the MIT License, but it is not open source. ProperProxyProtocol covers Fabric, Forge and NeoForge for 1.20 – 1.21.11 and is server-side only, but it is not open source and All rights reserved applies. NeoForged Velocity Support is NeoForge-only for 1.21.1 – 26.1.2, server-side only and open source under the MIT License.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| HAProxyCompat | Fabric and NeoForge | 1.21 – 26.3 | Server-side only | 2026-09-24 |
| PROXY protocol Wrapper | Fabric | 1.21.11 – 26.3 | Server-side only | 2026-10-13 |
| NG HaProxy Support | Forge | 1.20.1 | Server-side only | 2026-03-15 |
| ProperProxyProtocol | Fabric, Forge and NeoForge | 1.20 – 1.21.11 | Server-side only | 2026-05-27 |
| NeoForged Velocity Support | NeoForge | 1.21.1 – 26.1.2 | Server-side only | 2026-07-10 |
Questions
Does HAProxyCompat need to be installed on players' computers?
What setup is needed when the proxy runs on the same machine as the server?
What happens if a connection without a valid PROXY header arrives?
In the catalog
HAProxyCompat is one of 36,990 Utility mods on ModsFinder, and one of 25,772 Utility mods for Fabric. 8,071 mods support Minecraft 26.3.
More from the_atmerek
Similar mods
What the author says
Stop seeing 127.0.0.1. See who's actually connecting. When your Minecraft server sits behind a reverse proxy like FRP, nginx, HAProxy, or Traefik, every player looks like they're connecting from the proxy. Bans, logs, and IP tools all see the proxy's address instead of the real one. HAProxyCompat fixes that. It reads…
Official listing
- Modrinth page
- modrinth.com/mod/haproxycompat
- Owner
- the_atmerek
- Published
- 2026-06-06
- Updated on Modrinth
- 2026-09-24
- Facts verified
- 2026-10-15