// Genereert de webserverconfiguratie voor test (nginx op de Raspberry Pi) en // productie (IIS bij de webhoster) uit dezelfde securityheaders als de Vite // dev- en preview-server. Zo bestaat de headerset maar op één plek. // Schrijven: `pnpm server-config`. Een test controleert dat de bestanden in // deploy/ gelijk zijn aan wat deze functies opleveren. import { compressibleTypes, gzipMimeTypes } from './compressibleTypes.ts'; import { escapeRegex, redirectNames, variantPattern } from './canonicalUrls.ts'; import { securityHeaders } from './securityHeaders.ts'; const generatedNotice = 'Gegenereerd door web/config/serverConfig.ts (pnpm server-config). Niet handmatig aanpassen.'; const xmlAttribute = (value: string) => value .replace(/&/g, '&') .replace(/"/g, '"') .replace(//g, '>'); // De enige productiehost: www stuurt hierheen door, zodat monitoring (alleen // op deze hostname) en zoekmachines één adres zien export const productionHost = 'andreaslop.nl'; // IIS (productie): www-doorverwijzing, security headers, HTTPS-redirect, de // URL-regels uit de paginalijst (BR-HST-01 tot 08), compressie en caching. // De www-regel staat vóór HTTPS, zodat http://www. in één stap op // https://andreaslop.nl uitkomt. Deze regels zijn nog op geen echte IIS-host // geprobeerd: de open punten U1 tot U6 staan in infrastructure-design.md. // Bestanden in /assets hebben een hash in de naam en mogen lang gecachet // worden; de pagina's nooit, zodat een nieuwe release direct zichtbaar is. // MIME-types die IIS standaard anders of niet kent, worden vastgezet op de // waarden uit compressibleTypes.ts, zodat statische compressie ze oppakt. const iisPinnedExtensions = ['.js', '.svg', '.json', '.xml']; export function iisWebConfig(): string { const headers = Object.entries(securityHeaders('production')) .map( ([name, value]) => ` `, ) .join('\n'); const mimePins = compressibleTypes .filter((type) => iisPinnedExtensions.includes(type.extension)) .map( (type) => ` \n` + ` `, ) .join('\n'); // Paginanamen zonder voorste slash. De canonieke vorm is kleine letters; // alleen een afwijkende schrijfwijze (hoofdletters, .html, slashes) wordt // doorverwezen, ToLower raakt dus nooit de hash-namen in /assets. const pageNames = redirectNames .map((path) => escapeRegex(path.replace(/^\//, ''))) .join('|'); return ` ${headers} ${mimePins} `; } // nginx (test): dezelfde headers, plus noindex zodat de testsite nooit in // zoekmachines komt. nginx erft add_header niet als een location er zelf een // zet, daarom staan de headers in elk location-blok, elk met de volledige set // en zijn eigen Cache-Control. De URL-regels (BR-HST-01 tot 08) komen uit de // paginalijst, zodat nginx, IIS en de previewserver dezelfde pagina's kennen. // // listen en root zijn instelbaar voor de serverregeltests (e2e/serverRules), // die een echte nginx op een vrije poort met een tijdelijke map starten. export function nginxTestConf( options: { listen?: string; root?: string } = {}, ): string { const { listen = '80', root = '/var/www/html/andreaslop-test' } = options; const securityLines = [ ...Object.entries(securityHeaders('production')).map( ([name, value]) => `add_header ${name} "${value}" always;`, ), 'add_header X-Robots-Tag "noindex, nofollow" always;', ]; const noCache = 'add_header Cache-Control "no-cache" always;'; const immutable = 'add_header Cache-Control "public, max-age=31536000, immutable" always;'; // Eén bron voor alle blokken met headers: de volledige set plus precies // één Cache-Control, zodat geen enkel blok een header kwijtraakt const block = (indent: string, cacheControl: string | undefined) => [...securityLines, ...(cacheControl ? [cacheControl] : [])] .map((line) => indent + line) .join('\n'); // De canonieke vormen komen eerst, als hoofdlettergevoelige regex: nginx // vergelijkt gewone tekstsleutels in een map zonder onderscheid tussen // hoofd- en kleine letters, dus een exacte sleutel /over-mij zou ook // /Over-Mij ongemoeid laten. De eerste regex die past wint. Geen regel // mag /404 of /404.html raken: error_page draait de server-regels // opnieuw met $uri=/404.html en zou van de 404-pagina een redirect maken. const canonicalEntries = redirectNames.map((path) => ` ~^${path}$ "";`); const variantEntries = [ ` ~*^/${variantPattern('/')}$ /;`, ...redirectNames.map( (path) => ` ~*^/${variantPattern(path)}$ ${path};`, ), ]; return `# ${generatedNotice} # Test-omgeving op de Raspberry Pi (hosting-Pi), achter de reverse-proxy-Pi # (die TLS afhandelt met certbot). Installatie: als # /etc/nginx/conf.d/andreaslop-test.conf; nginx.conf laadt conf.d binnen # http {}, er is geen sites-enabled. De globale nginx.conf hoeft niet te # veranderen: dit bestand brengt zijn eigen gzip-instellingen mee, want op de # Pi staat gzip nergens aan. Ze werken ook als de proxy HTTP/1.0 praat. # De proxy moet de Host-header doorgeven (proxy_set_header Host $host); het # blok wordt gekozen op server_name. Een onbekende host krijgt een 444 van # het standaardblok /etc/nginx/conf.d/00-default.conf. # Eigen server-blok naast de WordPress-site: bewust geen default_server, zodat # dit blok alleen de testhostname beantwoordt. # Pas server_name en root aan aan de server; de rest komt uit de generator. # Bekende pagina's in een afwijkende vorm (hoofdletters, .html, /index, # slashes aan het eind) gaan met één 301 naar het canonieke pad. De waarden # zijn constanten uit de paginalijst, nooit afgeleid van het verzoek. map $uri $andreaslop_canonical { default ""; ${canonicalEntries.join('\n')} ${variantEntries.join('\n')} } server { listen ${listen}; server_name test.andreaslop.nl; root ${root}; # Achter de reverse proxy: doorverwijzingen relatief houden, anders stuurt # nginx naar zijn eigen http://-adres in plaats van de https-hostname absolute_redirect off; # Geen index-directive en geen mappen tonen: index zou intern naar # /index.html gaan, dat hierboven naar / doorverwijst (lus) autoindex off; ${block(' ', noCache)} # Eigen compressie (de Pi heeft geen gzip aan). text/html is altijd aan. gzip on; gzip_vary on; gzip_proxied any; gzip_http_version 1.0; gzip_comp_level 5; gzip_min_length 256; gzip_types ${gzipMimeTypes().join(' ')}; # Een backslash vooraan zou na het weghalen van de slashes een Location # /\\host geven, en browsers lezen dat als //host. Dat pad bestaat niet # (BR-HST-06). \\x5c is de backslash; $uri is hier al gedecodeerd. if ($uri ~ "^/\\x5c") { return 404; } # Alleen return in een if is veilig. Het doel komt uit de map hierboven. if ($andreaslop_canonical) { return 301 $andreaslop_canonical$is_args$args; } # Slashes aan het eind van elk ander pad weg. Bewust rewrite en geen # return met $uri: de serverregeltests controleren dat een regeleinde of # backslash in het pad nooit in een Location terechtkomt. rewrite ^/(.+?)/+$ /$1 permanent; # Onbekend: de 404-pagina met status 404 (geen = achter de code) error_page 404 /404.html; # Testsite nooit indexeren location = /robots.txt { ${block(' ', noCache)} default_type text/plain; return 200 "User-agent: *\\nDisallow: /\\n"; } # Zonder dit zou $uri.html de pagina met 200 tonen location = /404 { ${block(' ', noCache)} return 404; } # Alleen bereikbaar via error_page; een direct verzoek geeft 404 location = /404.html { internal; ${block(' ', noCache)} } # Bestanden met een hash in de naam: lang cachen location /assets/ { ${block(' ', immutable)} try_files $uri =404; } # Geen index-directive: de beginpagina staat hier uitdrukkelijk location = / { ${block(' ', noCache)} try_files /index.html =404; } # Paginabestand zonder .html. $uri zonder slash is alleen een bestand, dus # een map naast soorten-fotoshoots.html wordt overgeslagen (BR-HST-07). # Nooit een slash achter de variabele zetten: dat geeft nginx' eigen # mapdoorverwijzing. location / { ${block(' ', noCache)} try_files $uri $uri.html =404; } } `; } // nginx op de reverse-proxy-Pi (test): alleen HTTP. certbot voegt daarna // HTTPS en de redirect toe (certbot --nginx -d test.andreaslop.nl). Geen // security headers hier: die zet de hosting-Pi al, dubbel geeft dubbele headers. // Intern adres van de hosting-Pi (waar het testblok en WordPress draaien) const hostingPiAddress = '192.168.1.103'; export function nginxProxyConf(): string { return `# ${generatedNotice} # Reverse proxy voor de testsite naar de hosting-Pi. certbot past dit bestand # aan voor HTTPS; kopieer het daarna dus niet opnieuw zonder certbot opnieuw te # draaien. server { listen 80; server_name test.andreaslop.nl; location / { proxy_pass http://${hostingPiAddress}; # Verplicht: de hosting-Pi kiest op basis van de hostname tussen het # testblok en WordPress proxy_set_header Host $host; proxy_set_header X-Forwarded-Proto $scheme; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Real-IP $remote_addr; } } `; } export const serverConfigFiles = { 'deploy/iis/web.config': iisWebConfig, 'deploy/nginx/andreaslop-test.conf': nginxTestConf, 'deploy/nginx/test.andreaslop.nl.proxy.conf': nginxProxyConf, } as const;