Add HTTP/3 support (#1531)

Author: strarsis

group_vars/all/helpers.yml

@@ -40,7 +40,9 @@ site_hosts: "{{ site_hosts_canonical | union(site_hosts_redirects) }}"
 multisite_subdomains_wildcards: "{{ item.value.multisite.subdomains | default(false) | ternary( site_hosts_canonical | map('regex_replace', '^(www\\.)?(.*)$', '*.\\2') | list, [] ) }}"
 ssl_enabled: "{{ item.value.ssl is defined and item.value.ssl.enabled | default(false) }}"
 cron_enabled: "{{ site_env.disable_wp_cron and (not item.value.multisite.enabled | default(false) or (item.value.multisite.enabled | default(false) and item.value.multisite.cron | default(true))) }}"
-sites_use_ssl: "{{ (wordpress_sites | select_sites('ssl.enabled', 'true') | length) > 0 }}"
+sites_using_ssl: "{{ wordpress_sites | dict2items | selectattr('value.ssl.enabled', 'equalto', true) | items2dict }}"
+first_site_using_ssl: "{{ (sites_using_ssl | dict2items | first | default(None, True)) }}"
+sites_use_ssl: "{{ sites_using_ssl | length > 0 }}"
 
 composer_authentications: "{{ vault_wordpress_sites[site].composer_authentications | default([]) }}"
 # Default `type` is `http-basic`.

group_vars/all/security.yml

@@ -8,6 +8,11 @@ ferm_input_list:
     dport: [https]
     filename: nginx_accept_https
     delete: "{{ not (sites_use_ssl | bool) }}"
+  - type: dport_accept
+    dport: ['443']
+    protocol: udp
+    filename: nginx_accept_http3
+    delete: "{{ not (nginx_http3_enabled and (sites_use_ssl | bool)) }}"
   - type: dport_accept
     dport: [ssh]
     saddr: "{{ ip_whitelist }}"

roles/wordpress-setup/defaults/main.yml

@@ -8,7 +8,7 @@ nginx_sites_confs:
     enabled: false
 
 nginx_http2_enabled: true
-nginx_http3_enabled: false
+nginx_http3_enabled: true
 
 # HSTS defaults
 nginx_hsts_max_age: 31536000

roles/wordpress-setup/tasks/nginx.yml

@@ -23,6 +23,13 @@
 
 - import_tasks: "{{ playbook_dir }}/roles/common/tasks/disable_challenge_sites.yml"
 
+- name: Copy Nginx Wordpress site include folder
+  copy:
+    src: templates/includes
+    dest: "{{ nginx_path }}"
+    mode: '0755'
+  notify: reload nginx
+
 - name: Create Nginx available sites
   template:
     src: "{{ item.src }}"
@@ -68,6 +75,8 @@
   loop: "{{ wordpress_sites | dict2items }}"
   loop_control:
     label: "{{ item.key }}"
+  vars:
+    is_first_site_use_ssl: "{{ (first_site_using_ssl.key == item.key) if first_site_using_ssl else false }}"
   notify: reload nginx
   tags: nginx-includes
 

roles/wordpress-setup/templates/includes/directive-only/http3-negotiate.conf

@@ -0,0 +1,2 @@
+# Add Alt-Svc header to negotiate HTTP/3.
+add_header alt-svc 'h3=":443"; ma=86400';

roles/wordpress-setup/templates/includes/directive-only/quic-tune.conf

@@ -0,0 +1,3 @@
+# QUIC transport (HTTP/3 specific)
+quic_retry on;
+quic_gso on;

roles/wordpress-setup/templates/wordpress-site.conf.j2

@@ -6,6 +6,15 @@ server {
   {% block server_id -%}
   listen {{ ssl_enabled | ternary('[::]:443 ssl', '[::]:80') }};
   listen {{ ssl_enabled | ternary('443 ssl', '80') }};
+
+  {% if nginx_http3_enabled and ssl_enabled -%}
+  # Listen on UDP for QUIC+HTTP/3
+  listen [::]:443 quic{% if is_first_site_use_ssl %} reuseport{% endif -%};
+  listen 443 quic{% if is_first_site_use_ssl %} reuseport{% endif -%};
+  {% if is_first_site_use_ssl -%}# there has to be one listen quic directive with `reuseport` for working QUIC responses in current nginx version, using the first site.
+  {% endif %}
+  {% endif %}
+
   http2 {{ nginx_http2_enabled | default(false) | ternary('on', 'off') }};
   http3 {{ nginx_http3_enabled | default(false) | ternary('on', 'off') }};
   server_name {{ site_hosts_canonical | union(multisite_subdomains_wildcards) | join(' ') }};
@@ -35,6 +44,11 @@ server {
   sendfile off;
 
   {% endif -%}
+
+  {% if nginx_http3_enabled and ssl_enabled -%}
+  include includes/directive-only/quic-tune.conf;
+  include includes/directive-only/http3-negotiate.conf;
+  {% endif %}
   {% endblock -%}
 
   {% block cache_conditions -%}
@@ -303,12 +317,24 @@ server {
   listen [::]:443 ssl;
   listen 443 ssl;
   {% endif -%}
+
   listen [::]:80;
   listen 80;
+
+  {% if nginx_http3_enabled and ssl_enabled -%}
+  # Listen on UDP for QUIC+HTTP/3
+  listen [::]:443 quic;
+  listen 443 quic;
+  {% endif %}
+
   http2 {{ nginx_http2_enabled | default(false) | ternary('on', 'off') }};
   http3 {{ nginx_http3_enabled | default(false) | ternary('on', 'off') }};
   server_name {{ host.redirects | join(' ') }};
 
+  {% if nginx_http3_enabled and ssl_enabled -%}
+  include includes/directive-only/quic-tune.conf;
+  {% endif %}
+
   {{ self.https() -}}
 
   {{ self.acme_challenge() -}}