nixpkgs/nixos/doc/manual
Raito Bezarius 69bb0f94de nixos/nginx: first-class PROXY protocol support
PROXY protocol is a convenient way to carry information about the
originating address/port of a TCP connection across multiple layers of
proxies/NAT, etc.

Currently, it is possible to make use of it in NGINX's NixOS module, but
is painful when we want to enable it "globally".
Technically, this is achieved by reworking the defaultListen options and
the objective is to have a coherent way to specify default listeners in
the current API design.
See `mkDefaultListenVhost` and `defaultListen` for the details.

It adds a safeguard against running a NGINX with no HTTP listeners (e.g.
only PROXY listeners) while asking for ACME certificates over HTTP-01.

An interesting usecase of PROXY protocol is to enable seamless IPv4 to
IPv6 proxy with origin IPv4 address for IPv6-only NGINX servers, it is
demonstrated how to achieve this in the tests, using sniproxy.

Finally, the tests covers:

- NGINX `defaultListen` mechanisms are not broken by these changes;
- NGINX PROXY protocol listeners are working in a final usecase
  (sniproxy);
- uses snakeoil TLS certs from ACME setup with wildcard certificates;

In the future, it is desirable to spoof-attack NGINX in this scenario to
ascertain that `set_real_ip_from` and all the layers are working as
intended and preventing any user from setting their origin IP address to
any arbitrary, opening up the NixOS module to bad™ vulnerabilities.

For now, it is quite hard to achieve while being minimalistic about the
tests dependencies.
2023-05-26 19:48:26 +02:00
..
administration nixos-render-docs: add structural includes, use for manual 2023-02-12 13:02:42 +01:00
configuration tree-wide: buildFHSUserEnv -> buildFHSEnv 2023-04-16 10:15:13 +02:00
development lib.types.pkgs: init 2023-05-10 15:55:08 +02:00
installation nixos-render-docs: add examples support 2023-05-03 19:58:21 +02:00
manpages nixos: fix typos 2023-05-19 22:31:04 -04:00
release-notes nixos/nginx: first-class PROXY protocol support 2023-05-26 19:48:26 +02:00
contributing-to-this-manual.chapter.md nixos/manual: remove md-to-db 2023-02-10 06:40:15 +01:00
default.nix nixos/manual: fix cross-compilation 2023-04-05 04:49:26 +02:00
man-pages.xml nixos/manual: inline man-configuration.xml 2023-02-12 11:55:10 +01:00
manual.md nixos/manual: render html with nixos-render-doc if !allowDocBook 2023-02-21 18:26:41 +01:00
nixos-options.md nixos-render-docs: add structural includes, use for manual 2023-02-12 13:02:42 +01:00
preface.md manual: fix matrix room link (#231523) 2023-05-12 18:55:19 -04:00
README.md