Using Proxy Protocol with NodeBalancers

Traducciones al Español
Estamos traduciendo nuestros guías y tutoriales al Español. Es posible que usted esté viendo una traducción generada automáticamente. Estamos trabajando con traductores profesionales para verificar las traducciones de nuestro sitio web. Este proyecto es un trabajo en curso.
Create a Linode account to try this guide with a $100 credit.
This credit will be applied to any valid services used during your first 60 days.

When a Linode NodeBalancer passes a request from a client to a backend Node, information regarding the original client is not included by default. While this is fine for many environments, your applications may require original client information such as IP address or port. For these cases, Linode NodeBalancers support Proxy Protocol for TCP connections so that you can pass client information to backend Nodes.

What is Proxy Protocol

Proxy Protocol is an internet protocol for various high availability and load balancing solutions to carry information about a client directly to backend servers.

When selecting TCP as your NodeBalancer protocol, you can enable Proxy Protocol to add a header containing client information to backend Nodes.


Backend Nodes must also have Proxy Protocol enabled on supported applications to receive the client information header.

Additional configuration options may need to be enabled on the application or service to accommodate traffic between the node and the NodeBalancer, including allowing IPv6 and/or IPv4 traffic, and enabling traffic on all necessary ports.

Currently, there are two available versions of Proxy Protocol, v1 and v2:

  • v1: Proxy Protocol v1 adds a human readable string to all requests, similar to the following:

    PROXY TCP4 56147 80

    The syntax for this output is as follows:

  • v2: Proxy Protocol v2 adds a more efficient binary data header to all requests, similar to the following:


More information on v1 and v2 is available in the Proxy Protocol Specification.

Configure NodeBalancer Proxy Protocol

To enable Proxy Protocol for your Linode NodeBalancer:

  1. Visit the NodeBalancers page in the Linode Cloud Manager.

  2. Select the desired NodeBalancer, or Create and Configure a New One using TCP mode.

  3. Select the Configurations tab for your NodeBalancer followed by the desired configuration.

  4. Ensure that the Protocol option is set to TCP to access the Proxy Protocol dropdown menu. Select the desired Proxy Protocol version.

  5. Click the Save button on the bottom of the page to Save your changes.

Configure Backend Node Proxy Protocol

Once Proxy Protocol is configured for your NodeBalancer, ensure that it is also enabled for the receiving software on your backend Nodes. You can find a list of compatible software in the Proxy Protocol documentation.

Here are links to guidance for enabling Proxy Protocol for common software:

This page was originally published on

Your Feedback Is Important

Let us know if this guide made it easy to get the answer you needed.

Join the conversation.
Read other comments or post your own below. Comments must be respectful, constructive, and relevant to the topic of the guide. Do not post external links or advertisements. Before posting, consider if your comment would be better addressed by contacting our Support team or asking on our Community Site.