# Configure Load Balancer
Load Balancer (LB) balances the load among multiple network components and optimizes resource usage to avoid system malfunctions caused by overload. LB is not a mandatory component in EMQX, but it can bring some obvious system benefits, for example:
- Balance the load of EMQX to avoid single node overload;
- Simplify client configuration, the client only needs to connect to the LB and need not worry about the scaling within the cluster;
- Reduce the load of EMQX clusters by TLS/SSL termination;
- Improve cluster security, with LB configured at the front end of the cluster, unwanted traffic can be blocked to protect the EMQX cluster from malicious attacks.
This chapter introduces how to configure LB in EMQX.
# Architecture
For an EMQX cluster configured with LB, the LB handles the incoming TCP traffic and then distributes the received MQTT connection requests and messages to different EMQX nodes. The typical deployment architecture is as follows:

If SSL/TLS is enabled, it is recommended to terminate the SSL/TLS connection at LB, that is, to use SSL/TLS to secure the connection between clients and LB and then use TCP connection between LB and EMQX nodes, maximizing the performance of the EMQX cluster. The architecture is as follows:

TIP
You can also use DNS polling for load balancing for test or development purposes.
# Select an LB Product
Many load-balancing products are currently available, including open-source and commercial editions, and public cloud providers also have their load-balancing services.
LB products for public cloud:
LB products for private cloud:
The following section takes the HAProxy or NGINX as an example to illustrate how to configure an LB in EMQX cluster.
# Configure HAProxy/NGINX in EMQX
Suppose you have a cluster with 2 EMQX nodes, with emqx1 on 192.168.0.2
and emqx2 on 192.168.0.3
, you can follow the steps below to add HAProxy or NGINX as the LB.
# Enable Proxy Protocol
To configure the HAProxy or Nginx on port 1883, you first need to enable the configuration item proxy_protocol
in emqx.conf
by setting it to true
, also specify the true source IP and the port number of the client:
Code Example:
listeners.tcp.default {
bind = "0.0.0.0:1883"
max_connections = 1024000
proxy_protocol = true
}
2
3
4
5
6
Where:
listeners.tcp.default
is the name or identifier of the TCP listener configuration.bind
is the network interface and port the LB is bound, default:1883
max_connections
is the maximum number of concurrent connections allowed by the listener, default:infinity
proxy_protocol
is to enable/disable the proxy protocol, it is a boolean, default:false
.
TIP
For proxy protocols and that used in Nginx, see:
Proxy protocol: https://www.haproxy.com/blog/haproxy/proxy-protocol
Nginx: https://docs.nginx.com/nginx/admin-guide/load-balancer/using-proxy-protocol/ (opens new window)