Basic Config

Config file looks like

global
    nuster cache on data-size 100m
    nuster nosql on data-size 200m
defaults
    mode http
frontend fe
    bind *:8080
    #bind *:4433 ssl crt example.com.pem alpn h2,http/1.1
    use_backend be2 if { path_beg /_kv/ }
    default_backend be1
backend be1
    nuster cache on
    nuster rule img ttl 1d if { path_beg /img/ }
    nuster rule api ttl 30s if { path /api/some/api }
    server s1 127.0.0.1:8081
    server s2 127.0.0.1:8082
backend be2
    nuster nosql on
    nuster rule r1 ttl 3600

There are four basic sections: global, defaults, frontend and backend.

• global
  • defines process-wide and often OS-specific parameters
  • nuster cache on or nuster nosql on must be declared in this section in order to use cache or nosql functionality
• defaults
  • defines default parameters for all other frontend, backend sections
  • and can be overwritten in specific frontend or backend section
• frontend
  • describes a set of listening sockets accepting client connections
• bankend
  • describes a set of servers to which the proxy will connect to forward incoming connections
  • nuster cache on or nuster nosql on must be declared in this section
  • nuster rule must be declared here

You can define multiple frontend or backend sections.

You can find HAProxy documentation in /doc, and Online HAProxy Documentation