2
0

haproxy-clientip.d 1.2 KB

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