mirror of https://github.com/opnsense/docs
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
55 lines
2.1 KiB
ReStructuredText
55 lines
2.1 KiB
ReStructuredText
===========================
|
|
nginx: Basic Load Balancing
|
|
===========================
|
|
|
|
1) Create Upstream Servers
|
|
--------------------------
|
|
|
|
.. image:: images/nginx_upstream_servers.png
|
|
|
|
.. image:: images/nginx_edit_upstream_dialog.png
|
|
|
|
Create a server with a description and IP of the server. The priority is not important if you have a single server.
|
|
It is used as a weight for round robin. Servers with a higher weight will receive more traffic.
|
|
|
|
2) Create An Upstream
|
|
---------------------
|
|
|
|
.. image:: images/nginx_edit_upstream_with_verify.png
|
|
|
|
Group upstream servers to an upstream. An upstream is a group of servers to load balance between.
|
|
Give it a useful name and choose the previously created server.
|
|
|
|
.. Warning::
|
|
|
|
Upstream verification is enabled by default (**TLS: Verify Certificate** checkbox). Server names in the upstream certificate are compared with the name in the **TLS: Servername override** field. For successful verification, it is necessary that OPNsense trusts the certificate of the certification authority that issued the upstreams certificate. You can further restrict the list of trusted CA's in the **TLS: Trusted Certificate** field.
|
|
|
|
3) Create A Location
|
|
--------------------
|
|
|
|
.. image:: images/nginx_edit_location_dialog2.png
|
|
|
|
Locations are are used to map URLs to upstreams, directories, settings and so on.
|
|
In our case we want to proxy the request to the previously created upstream.
|
|
If we want to match everything, we use "/" without a special matcher.
|
|
Now save the location.
|
|
|
|
4) Create A HTTP Server
|
|
-----------------------
|
|
|
|
.. image:: images/nginx_edit_http_server_dialog.png
|
|
|
|
In the last step, we have to create a port.
|
|
This happens in a "http" block, which contains some basic configuration and the location blocks.
|
|
|
|
Enter the domain name into the "Server Name" field and select the previously created location.
|
|
If you want to use support TLS, you have to add a certificate.
|
|
|
|
5) Restart nginx
|
|
----------------
|
|
|
|
.. image:: images/nginx_reload.png
|
|
|
|
Click the reload button and you are done. You may need to open some ports in the firewall if you have not done that yet.
|
|
Since you are directly on the firewall, There is no need to use NAT similar workaround.
|