# Ordinis Integrator Guide — nginx serving static HTML на /docs/. # Diplodoc генерирует relative links — alias корректно работает без rewrite. server { listen 8080 default_server; listen [::]:8080 default_server; server_name _; access_log /dev/stdout; error_log /dev/stderr; # K8s probe. location = /healthz { access_log off; return 200 "ok\n"; add_header Content-Type text/plain; } # Static assets (Diplodoc CLI 4.60 bug: HTML refs hashed names типа # `_bundle/app-34c68624e23be7ce.css`, но actual файл — `app.css` (без # hash). Strip hash в nginx через rewrite: `name-.ext` → `name.ext`. location ~* "^/docs/(_bundle|_assets)/(.+?)-[a-f0-9]{8,}(\.[a-z0-9]+)$" { alias /usr/share/nginx/html/$1/$2$3; expires 1y; add_header Cache-Control "public, immutable"; } # Non-hashed assets (fallback). location ~* ^/docs/((_bundle|_assets)/.*\.(css|js|woff2?|ttf|eot|svg|png|jpg|jpeg|ico|map|json))$ { alias /usr/share/nginx/html/$1; expires 1y; add_header Cache-Control "public, immutable"; try_files $uri =404; } # Documentation pages (HTML). location /docs/ { alias /usr/share/nginx/html/; index index.html; try_files $uri $uri/ $uri.html =404; expires 5m; add_header Cache-Control "public, must-revalidate"; } # Redirect /docs (без trailing slash) → /docs/. location = /docs { return 301 /docs/; } # Security headers. add_header X-Content-Type-Options "nosniff" always; add_header X-Frame-Options "SAMEORIGIN" always; add_header Referrer-Policy "strict-origin-when-cross-origin" always; }