haproxy-clientip.md (1165B)
1 --- 2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 SPDX-License-Identifier: curl 4 Long: haproxy-clientip 5 Arg: <ip> 6 Help: Set address in HAProxy PROXY 7 Protocols: HTTP 8 Added: 8.2.0 9 Category: http proxy 10 Multi: single 11 See-also: 12 - proxy 13 Example: 14 - --haproxy-clientip $IP 15 --- 16 17 # `--haproxy-clientip` 18 19 Set a client IP in HAProxy PROXY protocol v1 header at the beginning of the 20 connection. 21 22 For valid requests, IPv4 addresses must be indicated as a series of exactly 23 4 integers in the range [0..255] inclusive written in decimal representation 24 separated by exactly one dot between each other. Heading zeroes are not 25 permitted in front of numbers in order to avoid any possible confusion 26 with octal numbers. IPv6 addresses must be indicated as series of 4 hexadecimal 27 digits (upper or lower case) delimited by colons between each other, with the 28 acceptance of one double colon sequence to replace the largest acceptable range 29 of consecutive zeroes. The total number of decoded bits must be exactly 128. 30 31 Otherwise, any string can be accepted for the client IP and get sent. 32 33 It replaces --haproxy-protocol if used, it is not necessary to specify both flags.