Infrared
github.com
- Free plan
- Windows
- macOS
- Linux
- API
- Self-hosted
What Infrared is
Infrared is a free, open-source Minecraft reverse proxy written in Go, designed for self-hosted deployment with Layer 7 protection. It can route multiple domain names to destination servers and use antibot checks based on IP lookups, encryption, authentication, protocol and username checks. A configuration file can define several domains, while Redis can cache lookups or provide proxy configurations across instances. An optional JSON HTTP API can list, retrieve, add and delete proxy configurations, but enabling Redis-based configuration disables that built-in API. A Prometheus exporter reports operational metrics such as connected players and handshake counts. Named components include MaxMind MMDB GeoIP databases, the Mojang API, HAProxy Proxy Protocol and TCPShield/RealIP Protocol. Infrared supports IPv4 and IPv6 and documents server version 1.18, protocol 757. The README recommends Linux kernel 5.8 or newer for its mitigation setup and shows systemd deployment. Optional tableflip upgrades can preserve existing connections during process replacement but require systemd. The project supports Linux, macOS, Windows and API use under the Apache License 2.0.
Who it suits
It suits Minecraft administrators who want a self-hosted reverse proxy with bot mitigation, routing and Prometheus metrics. It is also relevant to operators using Redis, GeoIP or compatible proxy protocols.
Good to know, and what to watch
- Free and open-source under Apache 2.0
- Supports IPv4 and IPv6
- Includes antibot checks and Layer 7 protection
- Prometheus exporter exposes proxy metrics
- Can preserve connections during upgrades
- Redis configuration disables the built-in API
- Mitigation setup recommends Linux kernel 5.8+
- Tableflip upgrades require systemd
- Self-hosted deployment requires administration
The verdict
Infrared combines Minecraft routing, configurable antibot checks and operational metrics in a self-hosted Go proxy. Its Redis and systemd options add deployment flexibility, with a documented trade-off when Redis configuration is enabled.
What the maker publishes
- Antibot
- Its antibot checks can use IP lookups, encryption, authentication, protocol, and username checks. source
- API
- An optional JSON HTTP API supports listing, retrieving, adding, and deleting proxy configurations. source
- API
- An optional JSON HTTP API provides routes to list, retrieve, add, and delete proxy configurations. source
- Availability
- The project documents live upgrades using tableflip that can preserve existing connections during the process swap. source
- Bot mitigation
- Its antibot checks use IP lookups, encryption checks, authentication checks, protocol checks, and username lookups. source
- Configuration
- One configuration file can define multiple domains, and proxy configurations can optionally be fetched from Redis. source
- Deployment
- The README documents Linux kernel 5.8 or later for its recommended mitigation setup and shows running Infrared as a systemd service. source
- GeoIP
- GeoIP lookup uses MaxMind MMDB files, and the README says the required GeoLite2 databases can be downloaded for free by creating an account. source
- Integrations
- The README names Redis, Prometheus, MaxMind MMDB GeoIP databases, the Mojang API, and HAProxy Proxy Protocol among supported integrations or components. source
- IP forwarding
- Proxy configurations support HAProxy Proxy Protocol and TCPShield/RealIP Protocol when the destination server is compatible. source
- License
- The repository lists the Apache License 2.0, whose terms grant no-charge copyright and patent licenses subject to its conditions. source
- License and warranty
- The repository includes an Apache License 2.0, which grants no-charge use rights and provides the work as-is without warranties. source
- Live upgrades
- The optional tableflip feature allows upgrading the Go application without closing existing connections and requires systemd, according to the README. source
- Metrics
- A built-in Prometheus exporter reports proxy metrics, including connected players and handshake counts. source
- Monitoring
- The built-in Prometheus exporter exposes operational metrics, including connected players and handshake counts. source
- Network support
- The project says it supports both IPv4 and IPv6. source
- Operational limit
- The README says enabling Redis based proxy configuration disables the built-in API. source
- Purpose
- Infrared is a Minecraft reverse proxy with Layer 7 protection, written in Go. source
- Purpose
- Infrared describes itself as a Minecraft reverse proxy with Layer 7 protection, written in Go. source
- Redis
- Redis can be used to cache lookups and to retrieve proxy configurations, including across multiple instances. source
- Routing
- A proxy configuration can map multiple domain names to a destination server. source
- System requirement
- The README recommends Linux kernel 5.8 or newer for mitigation setup. source
Checked against the maker's pages on 8 Oct 2026.