server { listen 80; listen [::]:80; server_name _; root /usr/share/nginx/html; index index.html; # React/Vue/Vite SPA routing location / { try_files $uri $uri/ /index.html; } # Do not aggressively cache index.html. # It references the latest hashed JS/CSS files. location = /index.html { try_files $uri =404; add_header Cache-Control "no-cache, must-revalidate"; } # Vite-generated assets normally contain content hashes. # They can safely be cached for a long time. location ~* \.(?:css|js|mjs|map|png|jpg|jpeg|gif|svg|ico|webp|avif|woff|woff2|ttf|otf)$ { try_files $uri =404; expires 30d; add_header Cache-Control "public, max-age=2592000, immutable"; } location = /favicon.ico { access_log off; log_not_found off; } location = /robots.txt { access_log off; log_not_found off; } # Content write path (spec-v4 §6.2, spec-v4-deploy-infra D11/D13): Basic-auth # at the proxy; ${GITEA_TOKEN} and ${GITEA_CONTENTS_API} are substituted by # the image's envsubst template step from the container environment (sourced # from the stack's secrets/site_config) — the SPA bundle and the repository # never carry the token or the Gitea host. location /api/content/ { auth_basic "Editor"; auth_basic_user_file /etc/nginx/htpasswd; # HTTP/2 to the upstream (nginx >= 1.29.4; the stack runs 1.31.x). The # edit-mode client issues its 12 document reads + 2 label reads as one # concurrent wave, and the Gitea host answers h2, so those requests # multiplex over a single upstream connection instead of one HTTP/1.1 # connection each. Upstream keepalive caching is already the default # since 1.29.7; the docs still require the Connection header to be # cleared for a reused upstream connection. proxy_http_version 2; proxy_set_header Connection ""; proxy_pass ${GITEA_CONTENTS_API}; proxy_ssl_server_name on; proxy_set_header Authorization "token ${GITEA_TOKEN}"; } }