Some more nginx documentation.

2026-04-24 11:55:42 +02:00
parent c635f5104e
commit 6d38e24afe
2 changed files with 302 additions and 0 deletions
--- a/README.install
+++ b/README.install
@@ -152,6 +152,8 @@ apt install ./jitsi-meet_2.0.6173-1_all.deb jitsi-meet-prosody_1.0.5211-1_all.de


 # !! Adjust nginx configuration !!
+#
+# see also: README.nginx

 # ----------
 #
@@ -181,6 +183,24 @@ apt install ./jitsi-meet_2.0.6173-1_all.deb jitsi-meet-prosody_1.0.5211-1_all.de
 #      echo $_file
 #   done
 #
+#
+#
+# WARN mesage (nginx -t):
+#  2026/04/24 11:08:21 [warn] 8273#8273: could not build optimal variables_hash, you should 
+#  increase either variables_hash_max_size: 1024 or variables_hash_bucket_size: 64; ignoring 
+#  variables_hash_bucket_size
+#
+# FIX:
+#
+#  meet:~ # cat <<EOF > /etc/nginx/conf.d/hash_variables.conf
+#  # Erhöht die maximale Größe der Hash-Tabelle für Variablen
+#  variables_hash_max_size 2048;
+#
+#  # Erhöht die "Eimer-Größe" pro Eintrag (optional, falls max_size allein nicht reicht)
+#  variables_hash_bucket_size 128;
+#  EOF
+#
+#
 # ----------


--- a/README.nginx
+++ b/README.nginx
@@ -0,0 +1,282 @@
+# ===========================================================================
+# nginx Beispielkonfiguration
+# ===========================================================================
+
+# /etc/nginx/conf.d/hash_variables.conf
+#
+-- snip
+# Erhöht die maximale Größe der Hash-Tabelle für Variablen
+variables_hash_max_size 2048;
+
+# Erhöht die "Eimer-Größe" pro Eintrag (optional, falls max_size allein nicht reicht)
+variables_hash_bucket_size 128;
+-- snap
+
+# /etc/nginx/sites-available/meet.akweb.de.conf
+#
+-- snip
+server_names_hash_bucket_size 64;
+
+types {
+# nginx's default mime.types doesn't include a mapping for wasm or wav.
+    #application/wasm     wasm;
+    audio/wav            wav;
+}
+upstream prosody {
+    zone upstreams 64K;
+    server 127.0.0.1:5280;
+    keepalive 2;
+}
+upstream jvb1 {
+    zone upstreams 64K;
+    server 127.0.0.1:9090;
+    keepalive 2;
+}
+map $arg_vnode $prosody_node {
+    default prosody;
+    v1 v1;
+    v2 v2;
+    v3 v3;
+    v4 v4;
+    v5 v5;
+    v6 v6;
+    v7 v7;
+    v8 v8;
+}
+# Matches any URI or Referer with some matches and redacts the whole
+# query string. log_format and map must be at the http context level.
+map $request_uri $loggable_uri {
+    ~^(?P<path>[^?]*)\?.*(?:jwt|token)=  "${path}?[params_redacted]";
+    default $request_uri;
+}
+
+map $http_referer $loggable_referer {
+    ~^(?P<url>[^?]*)\?.*(?:jwt|token)=  "${url}?[params_redacted]";
+    default $http_referer;
+}
+
+log_format jitsi_log '$remote_addr - $remote_user [$time_local] '
+    '"$request_method $loggable_uri $server_protocol" '
+    '$status $body_bytes_sent "$loggable_referer" "$http_user_agent"';
+
+server {
+    listen 80;
+    listen [::]:80;
+    server_name meet.akweb.de;
+
+#    location ^~ /.well-known/acme-challenge/ {
+#        default_type "text/plain";
+#        root         /usr/share/jitsi-meet;
+#    }
+#    location = /.well-known/acme-challenge/ {
+#        return 404;
+#    }
+    location / {
+        return 301 https://$host$request_uri;
+    }
+}
+server {
+    listen 443 ssl ;
+    listen [::]:443 ssl ;
+    server_name meet.akweb.de;
+
+    # Include location directive for Let's Encrypt ACME Challenge
+    #
+    # Needed for (automated) updating certificate
+    #
+    include snippets/letsencrypt-acme-challenge.conf;
+
+    # Diffie-Hellman parameter for DHE ciphersuites, recommended 2048 bits
+    #
+    # To generate a dhparam.pem file, run in a terminal
+    #    openssl dhparam -dsaparam -out /etc/nginx/ssl/dhparam.pem 2048
+    #
+    ssl_dhparam /etc/nginx/ssl/dhparam.pem;
+
+    # Erhöht die maximale Größe der Hash-Tabelle für Variablen
+    #variables_hash_max_size 2048;
+
+    # Erhöht die "Eimer-Größe" pro Eintrag (optional, falls max_size allein nicht reicht)
+    #variables_hash_bucket_size 128;
+
+    # Mozilla Guideline v5.4, nginx 1.17.7, OpenSSL 1.1.1d, intermediate configuration
+    ssl_protocols TLSv1.2 TLSv1.3;
+    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
+    ssl_prefer_server_ciphers off;
+
+    ssl_session_timeout 1d;
+    #ssl_session_cache shared:SSL:10m;  # about 40000 sessions
+    ssl_session_tickets off;
+
+    add_header Strict-Transport-Security "max-age=63072000" always;
+    set $prefix "";
+    set $custom_index "";
+    set $config_js_location /etc/jitsi/meet/meet.akweb.de-config.js;
+
+    ssl_certificate /etc/ssl/meet.akweb.de.crt;
+    ssl_certificate_key /etc/ssl/meet.akweb.de.key;
+
+    root /usr/share/jitsi-meet;
+
+    access_log /var/log/nginx/access.log jitsi_log;
+
+    # ssi on with javascript for multidomain variables in config.js
+    ssi on;
+    ssi_types application/x-javascript application/javascript;
+
+    index index.html index.htm;
+    error_page 404 /static/404.html;
+
+    gzip on;
+    gzip_types text/plain text/css application/javascript application/json image/x-icon application/octet-stream application/wasm;
+    gzip_vary on;
+    gzip_proxied no-cache no-store private expired auth;
+    gzip_min_length 512;
+
+    include /etc/jitsi/meet/jaas/*.conf;
+
+    location = /config.js {
+        alias $config_js_location;
+    }
+
+    location = /external_api.js {
+        alias /usr/share/jitsi-meet/libs/external_api.min.js;
+    }
+
+    location = /_api/room-info {
+        proxy_pass http://prosody/room-info?prefix=$prefix&$args;
+        proxy_http_version 1.1;
+        proxy_set_header X-Forwarded-For $remote_addr;
+        proxy_set_header Host $http_host;
+    }
+
+    location ~ ^/_api/public/(.*)$ {
+        autoindex off;
+        alias /etc/jitsi/meet/public/$1;
+    }
+
+    # ensure all static content can always be found first
+    location ~ ^/(libs|css|static|images|fonts|lang|sounds|.well-known)/(.*)$
+    {
+        add_header 'Access-Control-Allow-Origin' '*';
+        alias /usr/share/jitsi-meet/$1/$2;
+
+        # cache all versioned files
+        if ($arg_v) {
+            expires 1y;
+        }
+    }
+
+    # BOSH
+    location = /http-bind {
+        proxy_pass http://$prosody_node/http-bind?prefix=$prefix&$args;
+        proxy_http_version 1.1;
+        proxy_set_header X-Forwarded-For $remote_addr;
+        proxy_set_header Host $http_host;
+        proxy_set_header Connection "";
+    }
+
+    # xmpp websockets
+    location = /xmpp-websocket {
+        proxy_pass http://$prosody_node/xmpp-websocket?prefix=$prefix&$args;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_set_header Host $http_host;
+        tcp_nodelay on;
+    }
+
+    # colibri (JVB) websockets for jvb1
+    location ~ ^/colibri-ws/default-id/(.*) {
+        proxy_pass http://jvb1/colibri-ws/default-id/$1$is_args$args;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        tcp_nodelay on;
+    }
+
+    # load test minimal client, uncomment when used
+    #location ~ ^/_load-test/([^/?&:'"]+)$ {
+    #    rewrite ^/_load-test/(.*)$ /load-test/index.html break;
+    #}
+    #location ~ ^/_load-test/libs/(.*)$ {
+    #    add_header 'Access-Control-Allow-Origin' '*';
+    #    alias /usr/share/jitsi-meet/load-test/libs/$1;
+    #}
+
+    location = /_unlock {
+        add_header 'Access-Control-Allow-Origin' '*';
+        add_header Strict-Transport-Security 'max-age=63072000; includeSubDomains';
+        add_header "Cache-Control" "no-cache, no-store";
+    }
+
+    location ~ ^/conference-request/v1(\/.*)?$ {
+        proxy_pass http://127.0.0.1:8888/conference-request/v1$1;
+        add_header "Cache-Control" "no-cache, no-store";
+        add_header 'Access-Control-Allow-Origin' '*';
+        add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
+        add_header 'Access-Control-Allow-Headers' 'DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Content-Type';
+    }
+    location ~ ^/([^/?&:'"]+)/conference-request/v1(\/.*)?$ {
+        rewrite ^/([^/?&:'"]+)/conference-request/v1(\/.*)?$ /conference-request/v1$2;
+    }
+
+    location ~ ^/([^/?&:'"]+)$ {
+        set $roomname "$1";
+        try_files $uri @root_path;
+    }
+
+    location @root_path {
+        rewrite ^/(.*)$ /$custom_index break;
+    }
+
+    location ~ ^/([^/?&:'"]+)/config.js$
+    {
+        set $subdomain "$1.";
+        set $subdir "$1/";
+
+        alias $config_js_location;
+    }
+
+    # Matches /(TENANT)/pwa-worker.js or /(TENANT)/manifest.json to rewrite to / and look for file
+    location ~ ^/([^/?&:'"]+)/(pwa-worker.js|manifest.json)$ {
+        set $subdomain "$1.";
+        set $subdir "$1/";
+        rewrite ^/([^/?&:'"]+)/(pwa-worker.js|manifest.json)$ /$2;
+    }
+
+    # BOSH for subdomains
+    location ~ ^/([^/?&:'"]+)/http-bind {
+        set $subdomain "$1.";
+        set $subdir "$1/";
+        set $prefix "$1";
+
+        rewrite ^/(.*)$ /http-bind;
+    }
+
+    # websockets for subdomains
+    location ~ ^/([^/?&:'"]+)/xmpp-websocket {
+        set $subdomain "$1.";
+        set $subdir "$1/";
+        set $prefix "$1";
+
+        rewrite ^/(.*)$ /xmpp-websocket;
+    }
+
+    location ~ ^/([^/?&:'"]+)/_api/room-info {
+        set $subdomain "$1.";
+        set $subdir "$1/";
+        set $prefix "$1";
+
+        rewrite ^/(.*)$ /_api/room-info;
+    }
+
+    # Anything that didn't match above, and isn't a real file, assume it's a room name and redirect to /
+    location ~ ^/([^/?&:'"]+)/(.*)$ {
+        set $subdomain "$1.";
+        set $subdir "$1/";
+        rewrite ^/([^/?&:'"]+)/(.*)$ /$2;
+    }
+}
+
+-- snap