v4GuardDocumentation
Getting Started

Proxy Protocol

v4Guard Tunnel allows you to rewrite the player's IP address to the original one by using the standardized Proxy Protocol. If you don't rewrite the IP address, you will see the IP address of the edge server that is forwarding the traffic to your upstream, causing issues with plugins that rely on the player's IP address (e.g. punishment plugins, analytics plugins...).

Security Notice

Make sure your server is properly firewalled and only accepts connections from our edge servers, otherwise you will be vulnerable to IP spoofing attacks. Please refer to Upstream Protection section for more info.

Configuring Proxy Protocol

Tunnel Dashboard

To enable the Proxy Protocol on your upstreams, you have to:

  1. Go to the Upstreams configuration page.
  2. Click on the desired upstream item.
  3. Enable the Proxy Protocol option.
  4. Click on the SAVE button.

Upstream Configuration

Follow the instructions below to enable the Proxy Protocol on your server software.

  1. Open velocity.toml configuration file.
  2. Find the following field and set it to true:
velocity.toml
haproxy-protocol = true

How is this guide?

On this page