Skip to content

Enables compatibility between Spigot and HAProxy's PROXY v2 protocol

Notifications You must be signed in to change notification settings

riku6460/SpigotProxy

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SpigotProxy

SpigotProxy is a Spigot plugin that enables compatibility with HAProxy's PROXY v2 protocol.

What's HAProxy?

HAProxy is a high performance, open-source Load Balancer and Reverse Proxy for TCP-based services.

What's the PROXY protocol?

The PROXY protocol was designed to transmit a HAProxy client's connection information to the destination through other proxies or NAT routing (or both). HAProxy must be configured to send PROXY packets to your Spigot backend(s) in the backend or server configuration using the send-proxy-v2 option.

Installing HAProxy 1.5 / 1.6 on Ubuntu or Debian

HAProxy 1.5 or above is required to use the PROXY protocol.

Please see https://haproxy.debian.net for instructions on how to obtain a more recent package of HAProxy on Ubuntu or Debian.

Example configuration

listen minecraft
	bind :25565
	mode tcp
	balance leastconn
	option tcp-check
	server minecraft1 192.168.0.1:25565 check-send-proxy check send-proxy-v2
	server minecraft2 192.168.0.2:25565 check-send-proxy check send-proxy-v2
	server minecraft3 192.168.0.3:25565 check-send-proxy check send-proxy-v2
	server minecraft4 192.168.0.4:25565 check-send-proxy check send-proxy-v2
	server minecraft5 192.168.0.5:25565 check-send-proxy check send-proxy-v2
	server minecraft6 192.168.0.6:25565 check-send-proxy check send-proxy-v2
	server minecraft7 192.168.0.7:25565 check-send-proxy check send-proxy-v2
	server minecraft8 192.168.0.8:25565 check-send-proxy check send-proxy-v2

How do I know it's working?

In the Spigot server (with late-bind on false), you should see the actual IP of players connecting through HAProxy.

Other uses:

  • With the nginx stream module with proxy_protocol on.
  • With infrared, a minecraft focused lightweight reverse proxy written in Go.
  • With lazymc, a reverse proxy to put your Minecraft server to rest when idle.

Note

This plugin is inspired by /MinelinkNetwork/BungeeProxy. Go to that repo to see the bungee version of this plugin

About

Enables compatibility between Spigot and HAProxy's PROXY v2 protocol

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 100.0%