Configuration reference
Backend CRD
Selected version
Available since
version 1.7
The Backend custom resource extends the Kubernetes API to let you manage how traffic is load balanced across pods.
Install the Backend custom resource Jump to heading
Before you can use the Backend custom resource, you must install its definition into your Kubernetes cluster.
-
Download the v1-10 Backend custom resource filev1-9 Backend custom resource filev1-8 Backend custom resource filev1-7 Backend custom resource file.
-
Install the custom resource definition with
kubectl apply
:Community ingress controller
bashkubectl apply -f backends.core.haproxy.org.yamlbashkubectl apply -f backends.core.haproxy.org.yamlbashkubectl apply -f backends.core.haproxy.org.yamlbashkubectl apply -f backends.core.haproxy.org.yamlbashkubectl apply -f backend.yamlbashkubectl apply -f backend.yamlbashkubectl apply -f backend.yamlbashkubectl apply -f backend.yaml -
Verify that the installation worked by listing custom resources defined in your cluster:
bashkubectl get crdbashkubectl get crdoutputbashNAME CREATED ATbackends.core.haproxy.org 2022-01-21T20:00:31ZoutputbashNAME CREATED ATbackends.core.haproxy.org 2022-01-21T20:00:31Z
Use the Backend custom resource Jump to heading
With the Backend custom resource, you can manage how traffic is load balanced across pods. To use it:
-
Create a YAML file that declares a
Backend
resource and add properties to itsspec.config
section.In the example below, the
balance.algorithm
property changes the load balancing algorithm to least connections.example-backend.yamlyamlapiVersion: "core.haproxy.org/v1alpha2"kind: Backendmetadata:name: example-backendnamespace: defaultspec:config:balance:algorithm: "leastconn"example-backend.yamlyamlapiVersion: "core.haproxy.org/v1alpha2"kind: Backendmetadata:name: example-backendnamespace: defaultspec:config:balance:algorithm: "leastconn"example-backend.yamlyamlapiVersion: "core.haproxy.org/v1alpha2"kind: Backendmetadata:name: example-backendnamespace: defaultspec:config:balance:algorithm: "leastconn"example-backend.yamlyamlapiVersion: "core.haproxy.org/v1alpha2"kind: Backendmetadata:name: example-backendnamespace: defaultspec:config:balance:algorithm: "leastconn"example-backend.yamlyamlapiVersion: "core.haproxy.org/v1alpha1"kind: Backendmetadata:name: example-backendnamespace: defaultspec:config:balance:algorithm: "leastconn"example-backend.yamlyamlapiVersion: "core.haproxy.org/v1alpha1"kind: Backendmetadata:name: example-backendnamespace: defaultspec:config:balance:algorithm: "leastconn"example-backend.yamlyamlapiVersion: "core.haproxy.org/v1alpha1"kind: Backendmetadata:name: example-backendnamespace: defaultspec:config:balance:algorithm: "leastconn"example-backend.yamlyamlapiVersion: "core.haproxy.org/v1alpha1"kind: Backendmetadata:name: example-backendnamespace: defaultspec:config:balance:algorithm: "leastconn" -
Deploy it to your cluster using
kubectl apply
.bashkubectl apply -f example-backend.yamlbashkubectl apply -f example-backend.yaml -
Decide which Kubernetes services the resource should apply to. Do one of the following:
-
To have the properties apply to all services, create a new ConfigMap with the name
haproxy-kubernetes-ingress
to override the one that ships with the ingress controller. Add thecr-backend
key to thedata
section to implement the backend properties.example-configmap.yamlyamlapiVersion: v1kind: ConfigMapmetadata:name: haproxy-kubernetes-ingressnamespace: haproxy-controllerdata:cr-backend: default/example-backendexample-configmap.yamlyamlapiVersion: v1kind: ConfigMapmetadata:name: haproxy-kubernetes-ingressnamespace: haproxy-controllerdata:cr-backend: default/example-backendUpdate the ConfigMap in your cluster by using
kubectl apply
:bashkubectl apply -f example-configmap.yamlbashkubectl apply -f example-configmap.yaml -
To have the properties apply to all services that the Ingress routes traffic to, add the
cr-backend
annotation to your Ingress definition. The Ingress below applies to the services example-service1 and example-service2:example-ingress.yamlyamlapiVersion: networking.k8s.io/v1kind: Ingressmetadata:name: example-ingressannotations:haproxy.org/cr-backend: default/example-backendspec:rules:- http:paths:- path: /example1pathType: Prefixbackend:service:name: example-service1port:number: 80- path: /example2pathType: Prefixbackend:service:name: example-service2port:number: 80example-ingress.yamlyamlapiVersion: networking.k8s.io/v1kind: Ingressmetadata:name: example-ingressannotations:haproxy.org/cr-backend: default/example-backendspec:rules:- http:paths:- path: /example1pathType: Prefixbackend:service:name: example-service1port:number: 80- path: /example2pathType: Prefixbackend:service:name: example-service2port:number: 80Update the Ingress in your cluster by using
kubectl apply
:bashkubectl apply -f example-ingress.yamlbashkubectl apply -f example-ingress.yaml -
To have the properties apply to only a specific Kubernetes service, add the
cr-backend
annotation to your Service definition. The Service below applies the properties only to the service named example-service1.example-service.yamlyamlapiVersion: v1kind: Servicemetadata:labels:run: appname: example-service1annotations:haproxy.org/cr-backend: default/example-backendspec:selector:run: appports:- name: httpport: 80protocol: TCPtargetPort: 8080example-service.yamlyamlapiVersion: v1kind: Servicemetadata:labels:run: appname: example-service1annotations:haproxy.org/cr-backend: default/example-backendspec:selector:run: appports:- name: httpport: 80protocol: TCPtargetPort: 8080Update the Service in your cluster by using
kubectl apply
:bashkubectl apply -f example-service.yamlbashkubectl apply -f example-service.yaml
-
Backend custom resource reference Jump to heading
- CRD version:
- API version:
abortonclose
- enabled
- disabled
accept_invalid_http_response
- enabled
- disabled
adv_check
- ssl-hello-chk
- smtpchk
- ldap-check
- mysql-check
- pgsql-check
- tcp-check
- redis-check
- httpchk
allbackups
- enabled
- disabled
balance
- algorithm string Values
- roundrobin
- static-rr
- leastconn
- first
- source
- uri
- url_param
- hdr
- random
- rdp-cookie
- hdr_name string
- hdr_use_domain_only boolean
- random_draws integer
- rdp_cookie_name string Constraints
- Must match pattern: ^[^\s]+$
- uri_depth integer
- uri_len integer
- uri_path_only boolean
- uri_whole boolean
- url_param string Constraints
- Must match pattern: ^[^\s]+$
- url_param_check_post integer
- url_param_max_wait integer
bind_process
- Must match pattern: ^[^\s]+$
check_timeout
compression
- algorithms array
- offload boolean
- types array
connect_timeout
cookie
- domain array
- dynamic boolean
- httponly boolean
- indirect boolean
- maxidle integer
- maxlife integer
- name string Constraints
- Must match pattern: ^[^\s]+$
- nocache boolean
- postonly boolean
- preserve boolean
- secure boolean
- type string Values
- rewrite
- insert
- prefix
default_server
- address string Constraints
- Must match pattern: ^[^\s]+$
- agent-addr string Constraints
- Must match pattern: ^[^\s]+$
- agent-check string Values
- enabled
- disabled
- agent-inter integer
- agent-port integer
- agent-send string
- allow_0rtt boolean
- alpn string Constraints
- Must match pattern: ^[^\s]+$
- backup string Values
- enabled
- disabled
- ca_file string
- check string Values
- enabled
- disabled
- check-send-proxy string Values
- enabled
- disabled
- check-sni string Constraints
- Must match pattern: ^[^\s]+$
- check-ssl string Values
- enabled
- disabled
- check_alpn string Constraints
- Must match pattern: ^[^\s]+$
- check_proto string Constraints
- Must match pattern: ^[^\s]+$
- check_via_socks4 string Values
- enabled
- disabled
- ciphers string
- ciphersuites string
- cookie string Constraints
- Must match pattern: ^[^\s]+$
- crl_file string
- disabled string Values
- enabled
- disabled
- downinter integer
- enabled string Values
- enabled
- disabled
- error_limit integer
- fall integer
- fastinter integer
- force_sslv3 string Values
- enabled
- disabled
- force_tlsv10 string Values
- enabled
- disabled
- force_tlsv11 string Values
- enabled
- disabled
- force_tlsv12 string Values
- enabled
- disabled
- force_tlsv13 string Values
- enabled
- disabled
- health_check_port integer
- init-addr string Constraints
- Must match pattern: ^[^\s]+$
- inter integer
- log_proto string Values
- legacy
- octet-count
- max_reuse integer
- maxconn integer
- maxqueue integer
- minconn integer
- name string Constraints
- Must match pattern: ^[^\s]+$
- namespace string
- no_sslv3 string Values
- enabled
- disabled
- no_tlsv10 string Values
- enabled
- disabled
- no_tlsv11 string Values
- enabled
- disabled
- no_tlsv12 string Values
- enabled
- disabled
- no_tlsv13 string Values
- enabled
- disabled
- no_verifyhost string Values
- enabled
- disabled
- npn string
- observe string Values
- layer4
- layer7
- on-error string Values
- fastinter
- fail-check
- sudden-death
- mark-down
- on-marked-down string Values
- shutdown-sessions
- on-marked-up string Values
- shutdown-backup-sessions
- pool_low_conn integer
- pool_max_conn integer
- pool_purge_delay integer
- port integer
- proto string Constraints
- Must match pattern: ^[^\s]+$
- proxy-v2-options array
- redir string
- resolve-net string Constraints
- Must match pattern: ^[^\s]+$
- resolve-prefer string Values
- ipv4
- ipv6
- Must match pattern: ^[^\s]+$
- resolve_opts string Constraints
- Must match pattern: ^[^,\s][^\,]*[^,\s]*$
- resolvers string Constraints
- Must match pattern: ^[^\s]+$
- rise integer
- send-proxy string Values
- enabled
- disabled
- send-proxy-v2 string Values
- enabled
- disabled
- send_proxy_v2_ssl string Values
- enabled
- disabled
- send_proxy_v2_ssl_cn string Values
- enabled
- disabled
- slowstart integer
- sni string Constraints
- Must match pattern: ^[^\s]+$
- socks4 string Constraints
- Must match pattern: ^[^\s]+$
- source string
- ssl string Values
- enabled
- disabled
- ssl_certificate string Constraints
- Must match pattern: ^[^\s]+$
- ssl_max_ver string Values
- SSLv3
- TLSv1.0
- TLSv1.1
- TLSv1.2
- TLSv1.3
- ssl_min_ver string Values
- SSLv3
- TLSv1.0
- TLSv1.1
- TLSv1.2
- TLSv1.3
- ssl_reuse string Values
- enabled
- disabled
- stick string Values
- enabled
- disabled
- tcp_ut integer
- tfo string Values
- enabled
- disabled
- tls_tickets string Values
- enabled
- disabled
- track string
- verify string Values
- none
- required
- verifyhost string
- weight integer
dynamic_cookie_key
- Must match pattern: ^[^\s]+$
external_check
- enabled
- disabled
external_check_command
- Must match pattern: ^[^\s]+$
external_check_path
- Must match pattern: ^[^\s]+$
forwardfor
- enabled string Values
- enabled
- except string Constraints
- Must match pattern: ^[^\s]+$
- header string Constraints
- Must match pattern: ^[^\s]+$
- ifnone boolean
h1_case_adjust_bogus_server
- enabled
- disabled
hash_type
- function string Values
- sdbm
- djb2
- wt6
- crc32
- method string Values
- map-based
- consistent
- modifier string Values
- avalanche
http-buffer-request
- enabled
- disabled
http-check
- addr string Constraints
- Must match pattern: ^[^\s]+$
- alpn string Constraints
- Must match pattern: ^[^\s]+$
- body string
- body_log_format string
- check_comment string
- default boolean
- error_status string Values
- L7OKC
- L7RSP
- L7STS
- L6RSP
- L4CON
- exclamation_mark boolean
- headers array
- index integer
- linger boolean
- match string Values
- status
- rstatus
- hdr
- fhdr
- string
- rstring
- Must match pattern: ^[^\s]+$
- method string
- min_recv integer
- ok_status string Values
- L7OK
- L7OKC
- L6OK
- L4OK
- on_error string
- on_success string
- pattern string
- port integer
- port_string string
- proto string
- send_proxy boolean
- sni string
- ssl boolean
- status-code string
- tout_status string Values
- L7TOUT
- L6TOUT
- L4TOUT
- type string Values
- comment
- connect
- disable-on-404
- expect
- send
- send-state
- set-var
- set-var-fmt
- unset-var
- uri string
- uri_log_format string
- var_expr string
- var_format string
- var_name string Constraints
- Must match pattern: ^[^\s]+$
- var_scope string Constraints
- Must match pattern: ^[^\s]+$
- version string
- via_socks4 boolean
http-keep-alive
- enabled
- disabled
http-no-delay
- enabled
- disabled
http-server-close
- enabled
- disabled
http-use-htx
- enabled
- disabled
- Must match pattern: ^[^\s]+$
http_connection_mode
- httpclose
- http-server-close
- http-keep-alive
http_keep_alive_timeout
http_pretend_keepalive
- enabled
- disabled
http_proxy
- enabled
- disabled
http_request_timeout
http_reuse
- aggressive
- always
- never
- safe
httpchk_params
- method string Values
- HEAD
- PUT
- POST
- GET
- TRACE
- PATCH
- uri string Constraints
- Must match pattern: ^[^ ]*$
- version string
httpclose
- enabled
- disabled
log_health_checks
- enabled
- disabled
log_tag
- Must match pattern: ^[^\s]+$
mode
- http
- tcp
mysql_check_params
- client_version string Values
- pre-41
- post-41
- username string
name
- Must match pattern: ^[A-Za-z0-9-_.:]+$
pgsql_check_params
- username string
queue_timeout
redispatch
- enabled string Values
- enabled
- disabled
- interval integer
retries
server_timeout
smtpchk_params
- domain string
- hello string
srvtcpka
- enabled
- disabled
stats_options
- stats_admin boolean
- stats_admin_cond string Values
- if
- unless
- stats_admin_cond_test string
- stats_enable boolean
- stats_hide_version boolean
- stats_maxconn integer
- stats_refresh_delay integer
- stats_show_desc string
- stats_show_legends boolean
- stats_show_node_name string Constraints
- Must match pattern: ^[^\s]+$
- stats_uri_prefix string Constraints
- Must match pattern: ^[^\s]+$
stick_table
- expire integer
- keylen integer
- nopurge boolean
- peers string Constraints
- Must match pattern: ^[^\s]+$
- size integer
- store string Constraints
- Must match pattern: ^[^\s]+$
- type string Values
- ip
- ipv6
- integer
- string
- binary
tcpka
- enabled
- disabled
tunnel_timeout
abortonclose
- enabled
- disabled
accept_invalid_http_response
- enabled
- disabled
adv_check
- ssl-hello-chk
- smtpchk
- ldap-check
- mysql-check
- pgsql-check
- tcp-check
- redis-check
- httpchk
allbackups
- enabled
- disabled
balance
- algorithm string Values
- roundrobin
- static-rr
- leastconn
- first
- source
- uri
- url_param
- hdr
- random
- rdp-cookie
- hdr_name string
- hdr_use_domain_only boolean
- random_draws integer
- rdp_cookie_name string Constraints
- Must match pattern: ^[^\s]+$
- uri_depth integer
- uri_len integer
- uri_path_only boolean
- uri_whole boolean
- url_param string Constraints
- Must match pattern: ^[^\s]+$
- url_param_check_post integer
- url_param_max_wait integer
bind_process
- Must match pattern: ^[^\s]+$
check_timeout
compression
- algorithms array
- offload boolean
- types array
connect_timeout
cookie
- domain array
- dynamic boolean
- httponly boolean
- indirect boolean
- maxidle integer
- maxlife integer
- name string Constraints
- Must match pattern: ^[^\s]+$
- nocache boolean
- postonly boolean
- preserve boolean
- secure boolean
- type string Values
- rewrite
- insert
- prefix
default_server
- address string Constraints
- Must match pattern: ^[^\s]+$
- agent-addr string Constraints
- Must match pattern: ^[^\s]+$
- agent-check string Values
- enabled
- disabled
- agent-inter integer
- agent-port integer
- agent-send string
- allow_0rtt boolean
- alpn string Constraints
- Must match pattern: ^[^\s]+$
- backup string Values
- enabled
- disabled
- ca_file string
- check string Values
- enabled
- disabled
- check-send-proxy string Values
- enabled
- disabled
- check-sni string Constraints
- Must match pattern: ^[^\s]+$
- check-ssl string Values
- enabled
- disabled
- check_alpn string Constraints
- Must match pattern: ^[^\s]+$
- check_proto string Constraints
- Must match pattern: ^[^\s]+$
- check_via_socks4 string Values
- enabled
- disabled
- ciphers string
- ciphersuites string
- cookie string Constraints
- Must match pattern: ^[^\s]+$
- crl_file string
- disabled string Values
- enabled
- disabled
- downinter integer
- enabled string Values
- enabled
- disabled
- error_limit integer
- fall integer
- fastinter integer
- force_sslv3 string Values
- enabled
- disabled
- force_tlsv10 string Values
- enabled
- disabled
- force_tlsv11 string Values
- enabled
- disabled
- force_tlsv12 string Values
- enabled
- disabled
- force_tlsv13 string Values
- enabled
- disabled
- health_check_port integer
- init-addr string Constraints
- Must match pattern: ^[^\s]+$
- inter integer
- log_proto string Values
- legacy
- octet-count
- max_reuse integer
- maxconn integer
- maxqueue integer
- minconn integer
- name string Constraints
- Must match pattern: ^[^\s]+$
- namespace string
- no_sslv3 string Values
- enabled
- disabled
- no_tlsv10 string Values
- enabled
- disabled
- no_tlsv11 string Values
- enabled
- disabled
- no_tlsv12 string Values
- enabled
- disabled
- no_tlsv13 string Values
- enabled
- disabled
- no_verifyhost string Values
- enabled
- disabled
- npn string
- observe string Values
- layer4
- layer7
- on-error string Values
- fastinter
- fail-check
- sudden-death
- mark-down
- on-marked-down string Values
- shutdown-sessions
- on-marked-up string Values
- shutdown-backup-sessions
- pool_low_conn integer
- pool_max_conn integer
- pool_purge_delay integer
- port integer
- proto string Constraints
- Must match pattern: ^[^\s]+$
- proxy-v2-options array
- redir string
- resolve-net string Constraints
- Must match pattern: ^[^\s]+$
- resolve-prefer string Values
- ipv4
- ipv6
- Must match pattern: ^[^\s]+$
- resolve_opts string Constraints
- Must match pattern: ^[^,\s][^\,]*[^,\s]*$
- resolvers string Constraints
- Must match pattern: ^[^\s]+$
- rise integer
- send-proxy string Values
- enabled
- disabled
- send-proxy-v2 string Values
- enabled
- disabled
- send_proxy_v2_ssl string Values
- enabled
- disabled
- send_proxy_v2_ssl_cn string Values
- enabled
- disabled
- slowstart integer
- sni string Constraints
- Must match pattern: ^[^\s]+$
- socks4 string Constraints
- Must match pattern: ^[^\s]+$
- source string
- ssl string Values
- enabled
- disabled
- ssl_certificate string Constraints
- Must match pattern: ^[^\s]+$
- ssl_max_ver string Values
- SSLv3
- TLSv1.0
- TLSv1.1
- TLSv1.2
- TLSv1.3
- ssl_min_ver string Values
- SSLv3
- TLSv1.0
- TLSv1.1
- TLSv1.2
- TLSv1.3
- ssl_reuse string Values
- enabled
- disabled
- stick string Values
- enabled
- disabled
- tcp_ut integer
- tfo string Values
- enabled
- disabled
- tls_tickets string Values
- enabled
- disabled
- track string
- verify string Values
- none
- required
- verifyhost string
- weight integer
dynamic_cookie_key
- Must match pattern: ^[^\s]+$
external_check
- enabled
- disabled
external_check_command
- Must match pattern: ^[^\s]+$
external_check_path
- Must match pattern: ^[^\s]+$
forwardfor
- enabled string Values
- enabled
- except string Constraints
- Must match pattern: ^[^\s]+$
- header string Constraints
- Must match pattern: ^[^\s]+$
- ifnone boolean
h1_case_adjust_bogus_server
- enabled
- disabled
hash_type
- function string Values
- sdbm
- djb2
- wt6
- crc32
- method string Values
- map-based
- consistent
- modifier string Values
- avalanche
http-buffer-request
- enabled
- disabled
http-check
- addr string Constraints
- Must match pattern: ^[^\s]+$
- alpn string Constraints
- Must match pattern: ^[^\s]+$
- body string
- body_log_format string
- check_comment string
- default boolean
- error_status string Values
- L7OKC
- L7RSP
- L7STS
- L6RSP
- L4CON
- exclamation_mark boolean
- headers array
- index integer
- linger boolean
- match string Values
- status
- rstatus
- hdr
- fhdr
- string
- rstring
- Must match pattern: ^[^\s]+$
- method string
- min_recv integer
- ok_status string Values
- L7OK
- L7OKC
- L6OK
- L4OK
- on_error string
- on_success string
- pattern string
- port integer
- port_string string
- proto string
- send_proxy boolean
- sni string
- ssl boolean
- status-code string
- tout_status string Values
- L7TOUT
- L6TOUT
- L4TOUT
- type string Values
- comment
- connect
- disable-on-404
- expect
- send
- send-state
- set-var
- set-var-fmt
- unset-var
- uri string
- uri_log_format string
- var_expr string
- var_format string
- var_name string Constraints
- Must match pattern: ^[^\s]+$
- var_scope string Constraints
- Must match pattern: ^[^\s]+$
- version string
- via_socks4 boolean
http-keep-alive
- enabled
- disabled
http-no-delay
- enabled
- disabled
http-server-close
- enabled
- disabled
http-use-htx
- enabled
- disabled
- Must match pattern: ^[^\s]+$
http_connection_mode
- httpclose
- http-server-close
- http-keep-alive
http_keep_alive_timeout
http_pretend_keepalive
- enabled
- disabled
http_proxy
- enabled
- disabled
http_request_timeout
http_reuse
- aggressive
- always
- never
- safe
httpchk_params
- method string Values
- HEAD
- PUT
- POST
- GET
- TRACE
- PATCH
- uri string Constraints
- Must match pattern: ^[^ ]*$
- version string
httpclose
- enabled
- disabled
log_health_checks
- enabled
- disabled
log_tag
- Must match pattern: ^[^\s]+$
mode
- http
- tcp
mysql_check_params
- client_version string Values
- pre-41
- post-41
- username string
name
- Must match pattern: ^[A-Za-z0-9-_.:]+$
pgsql_check_params
- username string
queue_timeout
redispatch
- enabled string Values
- enabled
- disabled
- interval integer
retries
server_timeout
smtpchk_params
- domain string
- hello string
srvtcpka
- enabled
- disabled
stats_options
- stats_admin boolean
- stats_admin_cond string Values
- if
- unless
- stats_admin_cond_test string
- stats_enable boolean
- stats_hide_version boolean
- stats_maxconn integer
- stats_refresh_delay integer
- stats_show_desc string
- stats_show_legends boolean
- stats_show_node_name string Constraints
- Must match pattern: ^[^\s]+$
- stats_uri_prefix string Constraints
- Must match pattern: ^[^\s]+$
stick_table
- expire integer
- keylen integer
- nopurge boolean
- peers string Constraints
- Must match pattern: ^[^\s]+$
- size integer
- store string Constraints
- Must match pattern: ^[^\s]+$
- type string Values
- ip
- ipv6
- integer
- string
- binary
tcpka
- enabled
- disabled
tunnel_timeout
name
- Must match pattern: ^[A-Za-z0-9-_.:]+$
balance
- algorithm string Values
- roundrobin
- static-rr
- leastconn
- first
- source
- uri
- url_param
- hdr
- random
- rdp-cookie
- uri_whole boolean
- uri_len integer
- uri_depth integer
- url_param string Constraints
- Must match pattern: ^[^\s]+$
- url_param_check_post integer
- url_param_max_wait integer
- hdr_name string
- hdr_use_domain_only boolean
- random_draws integer
- rdp_cookie_name string Constraints
- Must match pattern: ^[^\s]+$
- uri_path_only boolean
hash_type
- method string Values
- map-based
- consistent
- function string Values
- sdbm
- djb2
- wt6
- crc32
- modifier string Values
- avalanche
http-check
- type string Values
- disable-on-404
- expect
- send-state
- exclamation_mark boolean
- match string Values
- status
- rstatus
- string
- rstring
- Must match pattern: ^[^\s]+$
- pattern string
bind_process
- Must match pattern: ^[^\s]+$
mode
- http
- tcp
allbackups
- enabled
- disabled
http-buffer-request
- enabled
- disabled
log_tag
- Must match pattern: ^[^\s]+$
http_connection_mode
- httpclose
- http-server-close
- http-keep-alive
http_pretend_keepalive
- enabled
- disabled
abortonclose
- enabled
- disabled
forwardfor
- enabled string Values
- enabled
- except string Constraints
- Must match pattern: ^[^\s]+$
- header string Constraints
- Must match pattern: ^[^\s]+$
- ifnone boolean
cookie
- name string Constraints
- Must match pattern: ^[^\s]+$
- type string Values
- rewrite
- insert
- prefix
- indirect boolean
- nocache boolean
- postonly boolean
- preserve boolean
- httponly boolean
- secure boolean
- domain array
- maxidle integer
- maxlife integer
- dynamic boolean
default_server
- init-addr string Constraints
- Must match pattern: ^[^\s]+$
- inter integer
- fastinter integer
- downinter integer
- rise integer
- fall integer
- check-sni string Constraints
- Must match pattern: ^[^\s]+$
- slowstart integer
- sni string Constraints
- Must match pattern: ^[^\s]+$
- check-ssl string Values
- enabled
- disabled
- check-send-proxy string Values
- enabled
- disabled
- ca_file string
- enabled string Values
- enabled
- disabled
- disabled string Values
- enabled
- disabled
- port integer
- resolvers string Constraints
- Must match pattern: ^[^\s]+$
- resolve-prefer string Values
- ipv4
- ipv6
- Must match pattern: ^[^\s]+$
- resolve-net string Constraints
- Must match pattern: ^[^\s]+$
- name string Constraints
- Must match pattern: ^[^\s]+$
- address string Constraints
- Must match pattern: ^[^\s]+$
- health_check_port integer
- ssl_certificate string Constraints
- Must match pattern: ^[^\s]+$
- agent-check string Values
- enabled
- disabled
- agent-send string
- agent-inter integer
- agent-addr string Constraints
- Must match pattern: ^[^\s]+$
- agent-port integer
- allow_0rtt boolean
- alpn string Constraints
- Must match pattern: ^[^\s]+$
- backup string Values
- enabled
- disabled
- check string Values
- enabled
- disabled
- check_alpn string Constraints
- Must match pattern: ^[^\s]+$
- check_proto string Constraints
- Must match pattern: ^[^\s]+$
- check_via_socks4 string Values
- enabled
- disabled
- ciphers string
- ciphersuites string
- cookie string Constraints
- Must match pattern: ^[^\s]+$
- crl_file string
- error_limit integer
- force_sslv3 string Values
- enabled
- disabled
- force_tlsv10 string Values
- enabled
- disabled
- force_tlsv11 string Values
- enabled
- disabled
- force_tlsv12 string Values
- enabled
- disabled
- force_tlsv13 string Values
- enabled
- disabled
- log_proto string Values
- legacy
- octet-count
- maxconn integer
- maxqueue integer
- max_reuse integer
- minconn integer
- namespace string
- no_sslv3 string Values
- enabled
- disabled
- no_tlsv10 string Values
- enabled
- disabled
- no_tlsv11 string Values
- enabled
- disabled
- no_tlsv12 string Values
- enabled
- disabled
- no_tlsv13 string Values
- enabled
- disabled
- no_verifyhost string Values
- enabled
- disabled
- npn string
- observe string Values
- layer4
- layer7
- on-error string Values
- fastinter
- fail-check
- sudden-death
- mark-down
- on-marked-down string Values
- shutdown-sessions
- on-marked-up string Values
- shutdown-backup-sessions
- pool_low_conn integer
- pool_max_conn integer
- pool_purge_delay integer
- proto string Constraints
- Must match pattern: ^[^\s]+$
- redir string
- resolve_opts string Constraints
- Must match pattern: ^[^,\s][^\,]*[^,\s]*$
- send-proxy string Values
- enabled
- disabled
- send-proxy-v2 string Values
- enabled
- disabled
- proxy-v2-options array
- send_proxy_v2_ssl string Values
- enabled
- disabled
- send_proxy_v2_ssl_cn string Values
- enabled
- disabled
- source string
- ssl string Values
- enabled
- disabled
- ssl_max_ver string Values
- SSLv3
- TLSv1.0
- TLSv1.1
- TLSv1.2
- TLSv1.3
- ssl_min_ver string Values
- SSLv3
- TLSv1.0
- TLSv1.1
- TLSv1.2
- TLSv1.3
- ssl_reuse string Values
- enabled
- disabled
- stick string Values
- enabled
- disabled
- socks4 string Constraints
- Must match pattern: ^[^\s]+$
- tcp_ut integer
- tfo string Values
- enabled
- disabled
- track string
- tls_tickets string Values
- enabled
- disabled
- verify string Values
- none
- required
- verifyhost string
- weight integer
check_timeout
adv_check
- ssl-hello-chk
- smtpchk
- ldap-check
- mysql-check
- pgsql-check
- tcp-check
- redis-check
- httpchk
smtpchk_params
- hello string
- domain string
mysql_check_params
- username string
- client_version string Values
- pre-41
- post-41
pgsql_check_params
- username string
external_check
- enabled
- disabled
external_check_path
- Must match pattern: ^[^\s]+$
external_check_command
- Must match pattern: ^[^\s]+$
queue_timeout
connect_timeout
http_request_timeout
http_keep_alive_timeout
retries
redispatch
- enabled string Values
- enabled
- disabled
- interval integer
server_timeout
tunnel_timeout
httpchk_params
- method string Values
- HEAD
- PUT
- POST
- GET
- TRACE
- PATCH
- uri string Constraints
- Must match pattern: ^[^ ]*$
- version string
http_reuse
- aggressive
- always
- never
- safe
stick_table
- type string Values
- ip
- ipv6
- integer
- string
- binary
- keylen integer
- size integer
- expire integer
- nopurge boolean
- peers string Constraints
- Must match pattern: ^[^\s]+$
- store string Constraints
- Must match pattern: ^[^\s]+$
http-use-htx
- enabled
- disabled
- Must match pattern: ^[^\s]+$
stats_options
- stats_enable boolean
- stats_hide_version boolean
- stats_maxconn integer
- stats_refresh_delay integer
- stats_show_desc string
- stats_show_legends boolean
- stats_show_node_name string Constraints
- Must match pattern: ^[^\s]+$
- stats_uri_prefix string Constraints
- Must match pattern: ^[^\s]+$
name
- Must match pattern: ^[A-Za-z0-9-_.:]+$
balance
- algorithm string Values
- roundrobin
- static-rr
- leastconn
- first
- source
- uri
- url_param
- hdr
- random
- rdp-cookie
- uri_whole boolean
- uri_len integer
- uri_depth integer
- url_param string Constraints
- Must match pattern: ^[^\s]+$
- url_param_check_post integer
- url_param_max_wait integer
- hdr_name string
- hdr_use_domain_only boolean
- random_draws integer
- rdp_cookie_name string Constraints
- Must match pattern: ^[^\s]+$
- uri_path_only boolean
hash_type
- method string Values
- map-based
- consistent
- function string Values
- sdbm
- djb2
- wt6
- crc32
- modifier string Values
- avalanche
http-check
- type string Values
- disable-on-404
- expect
- send-state
- exclamation_mark boolean
- match string Values
- status
- rstatus
- string
- rstring
- Must match pattern: ^[^\s]+$
- pattern string
bind_process
- Must match pattern: ^[^\s]+$
mode
- http
- tcp
allbackups
- enabled
- disabled
http-buffer-request
- enabled
- disabled
log_tag
- Must match pattern: ^[^\s]+$
http_connection_mode
- httpclose
- http-server-close
- http-keep-alive
http_pretend_keepalive
- enabled
- disabled
abortonclose
- enabled
- disabled
forwardfor
- enabled string Values
- enabled
- except string Constraints
- Must match pattern: ^[^\s]+$
- header string Constraints
- Must match pattern: ^[^\s]+$
- ifnone boolean
cookie
- name string Constraints
- Must match pattern: ^[^\s]+$
- type string Values
- rewrite
- insert
- prefix
- indirect boolean
- nocache boolean
- postonly boolean
- preserve boolean
- httponly boolean
- secure boolean
- domain array
- maxidle integer
- maxlife integer
- dynamic boolean
default_server
- init-addr string Constraints
- Must match pattern: ^[^\s]+$
- inter integer
- fastinter integer
- downinter integer
- rise integer
- fall integer
- check-sni string Constraints
- Must match pattern: ^[^\s]+$
- slowstart integer
- sni string Constraints
- Must match pattern: ^[^\s]+$
- check-ssl string Values
- enabled
- disabled
- check-send-proxy string Values
- enabled
- disabled
- ca_file string
- enabled string Values
- enabled
- disabled
- disabled string Values
- enabled
- disabled
- port integer
- resolvers string Constraints
- Must match pattern: ^[^\s]+$
- resolve-prefer string Values
- ipv4
- ipv6
- Must match pattern: ^[^\s]+$
- resolve-net string Constraints
- Must match pattern: ^[^\s]+$
- name string Constraints
- Must match pattern: ^[^\s]+$
- address string Constraints
- Must match pattern: ^[^\s]+$
- health_check_port integer
- ssl_certificate string Constraints
- Must match pattern: ^[^\s]+$
- agent-check string Values
- enabled
- disabled
- agent-send string
- agent-inter integer
- agent-addr string Constraints
- Must match pattern: ^[^\s]+$
- agent-port integer
- allow_0rtt boolean
- alpn string Constraints
- Must match pattern: ^[^\s]+$
- backup string Values
- enabled
- disabled
- check string Values
- enabled
- disabled
- check_alpn string Constraints
- Must match pattern: ^[^\s]+$
- check_proto string Constraints
- Must match pattern: ^[^\s]+$
- check_via_socks4 string Values
- enabled
- disabled
- ciphers string
- ciphersuites string
- cookie string Constraints
- Must match pattern: ^[^\s]+$
- crl_file string
- error_limit integer
- force_sslv3 string Values
- enabled
- disabled
- force_tlsv10 string Values
- enabled
- disabled
- force_tlsv11 string Values
- enabled
- disabled
- force_tlsv12 string Values
- enabled
- disabled
- force_tlsv13 string Values
- enabled
- disabled
- log_proto string Values
- legacy
- octet-count
- maxconn integer
- maxqueue integer
- max_reuse integer
- minconn integer
- namespace string
- no_sslv3 string Values
- enabled
- disabled
- no_tlsv10 string Values
- enabled
- disabled
- no_tlsv11 string Values
- enabled
- disabled
- no_tlsv12 string Values
- enabled
- disabled
- no_tlsv13 string Values
- enabled
- disabled
- no_verifyhost string Values
- enabled
- disabled
- npn string
- observe string Values
- layer4
- layer7
- on-error string Values
- fastinter
- fail-check
- sudden-death
- mark-down
- on-marked-down string Values
- shutdown-sessions
- on-marked-up string Values
- shutdown-backup-sessions
- pool_low_conn integer
- pool_max_conn integer
- pool_purge_delay integer
- proto string Constraints
- Must match pattern: ^[^\s]+$
- redir string
- resolve_opts string Constraints
- Must match pattern: ^[^,\s][^\,]*[^,\s]*$
- send-proxy string Values
- enabled
- disabled
- send-proxy-v2 string Values
- enabled
- disabled
- proxy-v2-options array
- send_proxy_v2_ssl string Values
- enabled
- disabled
- send_proxy_v2_ssl_cn string Values
- enabled
- disabled
- source string
- ssl string Values
- enabled
- disabled
- ssl_max_ver string Values
- SSLv3
- TLSv1.0
- TLSv1.1
- TLSv1.2
- TLSv1.3
- ssl_min_ver string Values
- SSLv3
- TLSv1.0
- TLSv1.1
- TLSv1.2
- TLSv1.3
- ssl_reuse string Values
- enabled
- disabled
- stick string Values
- enabled
- disabled
- socks4 string Constraints
- Must match pattern: ^[^\s]+$
- tcp_ut integer
- tfo string Values
- enabled
- disabled
- track string
- tls_tickets string Values
- enabled
- disabled
- verify string Values
- none
- required
- verifyhost string
- weight integer
check_timeout
adv_check
- ssl-hello-chk
- smtpchk
- ldap-check
- mysql-check
- pgsql-check
- tcp-check
- redis-check
- httpchk
smtpchk_params
- hello string
- domain string
mysql_check_params
- username string
- client_version string Values
- pre-41
- post-41
pgsql_check_params
- username string
external_check
- enabled
- disabled
external_check_path
- Must match pattern: ^[^\s]+$
external_check_command
- Must match pattern: ^[^\s]+$
queue_timeout
connect_timeout
http_request_timeout
http_keep_alive_timeout
retries
redispatch
- enabled string Values
- enabled
- disabled
- interval integer
server_timeout
tunnel_timeout
httpchk_params
- method string Values
- HEAD
- PUT
- POST
- GET
- TRACE
- PATCH
- uri string Constraints
- Must match pattern: ^[^ ]*$
- version string
http_reuse
- aggressive
- always
- never
- safe
stick_table
- type string Values
- ip
- ipv6
- integer
- string
- binary
- keylen integer
- size integer
- expire integer
- nopurge boolean
- peers string Constraints
- Must match pattern: ^[^\s]+$
- store string Constraints
- Must match pattern: ^[^\s]+$
http-use-htx
- enabled
- disabled
- Must match pattern: ^[^\s]+$
stats_options
- stats_enable boolean
- stats_hide_version boolean
- stats_maxconn integer
- stats_refresh_delay integer
- stats_show_desc string
- stats_show_legends boolean
- stats_show_node_name string Constraints
- Must match pattern: ^[^\s]+$
- stats_uri_prefix string Constraints
- Must match pattern: ^[^\s]+$
If this page was useful, please, Leave the feedback.