https://github.com/haveachin/infrared

An ultra lightweight minecraft reverse proxy and idle placeholder
https://github.com/haveachin/infrared

docker go java lightweight minecraft minecraft-proxy minecraft-server minecraft-server-proxy modded placeholder proxy proxy-protocol reverse-proxy vanilla

Last synced: 13 days ago
JSON representation

An ultra lightweight minecraft reverse proxy and idle placeholder

• Host: GitHub
• URL: https://github.com/haveachin/infrared
• Owner: haveachin
• License: agpl-3.0
• Created: 2019-11-23T14:27:12.000Z (about 5 years ago)
• Default Branch: main
• Last Pushed: 2024-06-19T13:27:42.000Z (6 months ago)
• Last Synced: 2024-06-19T23:49:17.733Z (6 months ago)
• Topics: docker, go, java, lightweight, minecraft, minecraft-proxy, minecraft-server, minecraft-server-proxy, modded, placeholder, proxy, proxy-protocol, reverse-proxy, vanilla
• Language: Go
• Homepage: https://infrared.dev
• Size: 14.3 MB
• Stars: 710
• Watchers: 12
• Forks: 59
• Open Issues: 40
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome - haveachin/infrared - An ultra lightweight minecraft reverse proxy and idle placeholder (Go)
• awesome - haveachin/infrared - An ultra lightweight minecraft reverse proxy and idle placeholder (Go)

README

        


  



Infrared

A Minecraft Reverse Proxy




  

  

  

  

  

  

  


  



> [!WARNING] 

> Infrared is currently under active development: bugs and breaking changes can happen.

> Feedback and contributions are welcome.

An ultra lightweight Minecraft reverse proxy and status placeholder:

Ever wanted to have only one exposed port on your server for multiple Minecraft servers?

Then Infrared is the tool you need!

Infrared works as a reverse proxy using a sub-/domains to connect clients to a specific Minecraft server.

## Features

- [X] Reverse Proxy

  - [X] Wildcards Support

  - [X] Multi-Domain Support

- [X] Status Response Caching

- [X] Proxy Protocol Support

- [X] Ratelimiter

## Useful Links

- **[Docs](https://infrared.dev)**

- **[Ask Questions](https://github.com/haveachin/infrared/discussions)**

- [Latest Release](https://github.com/haveachin/infrared/releases/latest)

- [Discord Invite](https://discord.gg/r98YPRsZAx)

- [Contributing](CONTRIBUTING.md)

## Build

Requirements:

- [Go](https://go.dev/) 1.21+

```

CGO_ENABLED=0 go build -ldflags "-s -w" -o ./out/infrared ./cmd/infrared

```

or `make all` (requires GNU Make). The binary is in the `out/` directory.

## Similar Projects

* https://github.com/itzg/mc-router

## Attributions

- [Free Software Foundation](https://commons.wikimedia.org/wiki/File:AGPLv3_Logo.svg), Public domain, via Wikimedia Commons

- [Tnze/go-mc](https://github.com/Tnze/go-mc) 🚀, MIT

- [IGLOU-EU/go-wildcard](https://github.com/IGLOU-EU/go-wildcard), Apache-2.0

- [cespare/xxhash](https://github.com/cespare/xxhash), MIT

- [google/uuid](https://github.com/google/uuid), BSD-3-Clause

- [pires/go-proxyproto](https://github.com/pires/go-proxyproto), Apache-2.0

- [spf13/pflag](https://github.com/spf13/pflag), BSD-3-Clause

- [go-yaml/yaml](https://github.com/go-yaml/yaml), Apache-2.0, MIT

- [vitepress](https://github.com/vuejs/vitepress), MIT

- [tollbooth](https://github.com/didip/tollbooth), MIT