Nginx add_header: security-заголовки без потерь
add_header добавляет заголовок к ответу, но по умолчанию только для успешных статусов. Флаг always включает его и для 4xx/5xx. Главная ловушка — наследование: если в location есть свой add_header, заголовки из server туда не попадают. Поэтому security-заголовки приходится повторять или выносить в include.
Выдать security-заголовки и кеш
server {
listen 80;
add_header X-Content-Type-Options nosniff always;
add_header X-Frame-Options DENY always;
add_header Referrer-Policy strict-origin-when-cross-origin always;
location /assets/ {
add_header X-Content-Type-Options nosniff always;
add_header X-Frame-Options DENY always;
add_header Cache-Control "public, max-age=31536000, immutable" always;
root /var/www;
}
}В /assets/ заголовки повторены, потому что собственный add_header отключает наследование родительских. Если не повторить, ответ на статику потеряет X-Frame-Options и Referrer-Policy. always важен для страниц ошибок: без него 404 может уйти без защиты.
Для одинаковых наборов используйте include /etc/nginx/snippets/security-headers.conf; в каждом location. Не добавляйте add_header внутрь if: это работает нестабильно. Для HSTS (Strict-Transport-Security) нужен HTTPS и понимание последствий: браузер запомнит требование на месяцы.
CSP лучше выдавать осознанно: Content-Security-Policy может сломать inline-скрипты и сторонние виджеты. Начните с Content-Security-Policy-Report-Only, соберите отчёты, затем включайте блокировку. Не ставьте X-Frame-Options: DENY на страницы, которые должны встраиваться в iframe.
Проверьте ответы через curl -I для 200, 301 и 404. add_header не заменяет заголовки, которые уже прислал upstream; для управления используйте proxy_hide_header и add_header. После изменения конфигурации выполните nginx -t.
Документация: ngx_http_headers_module: add_header, OWASP Secure Headers.