Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Infrared

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
  • API
  • Self-hosted
7.4 Club score Visit github.com

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.