mirrors/haproxy
1
0
Fork 0
mirror of https://git.haproxy.org/git/haproxy.git/ synced 2025-08-07 15:47:01 +02:00
Code Issues Projects Releases Wiki Activity

DOC: config: explain how to deal with "transparent" deprecation

Browse Source 
The explanations for the "option transparent" keyword were a bit scarce
regarding deprecation, so let's explain how to replace it with a server
line that does the same.
This commit is contained in:
Willy Tarreau 2025-06-26 14:50:44 +02:00
parent 16f382f2d9
commit 19140ca666
1 changed files with 15 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
doc/configuration.txt
View File

@ -11211,8 +11211,8 @@ option tcplog [clf]
See also : "option httplog", and section 8 about logging. See also : "option httplog", and section 8 about logging.
option transparent option transparent (deprecated)
no option transparent no option transparent (deprecated)
Enable client-side transparent proxying Enable client-side transparent proxying
May be used in the following contexts: tcp, http May be used in the following contexts: tcp, http
@ -11234,6 +11234,19 @@ no option transparent
Note that contrary to a common belief, this option does NOT make HAProxy Note that contrary to a common belief, this option does NOT make HAProxy
present the client's IP to the server when establishing the connection. present the client's IP to the server when establishing the connection.
As of 3.3, this option is now deprecated because it used to suffer from a
number of internal technical limitations. Using it will emit a warning, which
can be avoided if really needed via the "expose-deprecated-directives" global
keyword.
The correct approach is to declare a server on address 0.0.0.0, which will
take care of connecting to the expected destination address. A server will
also properly handle idle connections to the target servers.
Example:
# option transparent ## before 3.3
server transparent 0.0.0.0
See also: the "usesrc" argument of the "source" keyword, and the See also: the "usesrc" argument of the "source" keyword, and the
"transparent" option of the "bind" keyword. "transparent" option of the "bind" keyword.