Files
AndreaSlopFotografie/web/config/serverConfig.ts
T
SluijsensandClaude Opus 5.5 33334b889d Generates the nginx rules for prerendered pages
Pages now map to their html file, other forms get one redirect, unknown URLs
get a real 404 and responses are compressed. A browser-free test suite runs the
rules against a real nginx, in CI only so far.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-01 03:00:07 +01:00

266 lines
10 KiB
TypeScript

// 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 { gzipMimeTypes } from './compressibleTypes.ts';
import { 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, '&amp;')
.replace(/"/g, '&quot;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;');
// 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,
// SPA-fallback en caching. De www-regel staat vóór HTTPS, zodat
// http://www. in één stap op https://andreaslop.nl uitkomt.
// Bestanden in /assets hebben een hash in de naam en mogen lang gecachet
// worden; index.html nooit, zodat een nieuwe release direct zichtbaar is.
export function iisWebConfig(): string {
const headers = Object.entries(securityHeaders('production'))
.map(
([name, value]) =>
` <add name="${name}" value="${xmlAttribute(value)}" />`,
)
.join('\n');
return `<?xml version="1.0" encoding="utf-8"?>
<!-- ${generatedNotice} -->
<configuration>
<system.webServer>
<rewrite>
<rules>
<rule name="www naar ${productionHost}" stopProcessing="true">
<match url="(.*)" />
<conditions>
<add input="{HTTP_HOST}" pattern="^www\\.${productionHost.replace(/\./g, '\\.')}$" />
</conditions>
<action type="Redirect" url="https://${productionHost}/{R:1}" redirectType="Permanent" />
</rule>
<rule name="HTTPS" stopProcessing="true">
<match url="(.*)" />
<conditions>
<add input="{HTTPS}" pattern="^OFF$" />
</conditions>
<action type="Redirect" url="https://{HTTP_HOST}/{R:1}" redirectType="Permanent" />
</rule>
<rule name="SPA fallback" stopProcessing="true">
<match url=".*" />
<conditions logicalGrouping="MatchAll">
<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
<add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
</conditions>
<action type="Rewrite" url="/index.html" />
</rule>
</rules>
</rewrite>
<httpProtocol>
<customHeaders>
<remove name="X-Powered-By" />
${headers}
</customHeaders>
</httpProtocol>
<staticContent>
<remove fileExtension=".woff2" />
<mimeMap fileExtension=".woff2" mimeType="font/woff2" />
<clientCache cacheControlMode="DisableCache" />
</staticContent>
</system.webServer>
<location path="assets">
<system.webServer>
<staticContent>
<clientCache cacheControlMode="UseMaxAge" cacheControlMaxAge="365.00:00:00" />
</staticContent>
</system.webServer>
</location>
</configuration>
`;
}
// 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');
// Exacte canonieke vormen winnen van de reguliere expressies eronder, dus
// het canonieke pad zelf wordt nooit doorverwezen. 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(' ')};
# 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;