Рабочие заметки

Кеш статики в nginx: что на самом деле влияет

Каждый раз одна и та же история: выставил expires, а браузер всё равно ходит на сервер.

Заголовки

expires сам по себе добавляет Cache-Control: max-age и Expires. Отдельно прописывать оба не нужно, но и одного expires мало, если приложение выше по цепочке шлёт свой Cache-Control — тогда выигрывает он.

location /assets/ {
    expires 30d;
    add_header Cache-Control "public, immutable" always;
    access_log off;
}

immutable имеет смысл только вместе с версионированием имён файлов. Без него браузер всё равно перепроверит ресурс при обновлении страницы.

Почему не работает

Чаще всего — add_header без always: без него заголовок не добавляется к ответам 4xx и 5xx, и при отладке кажется, что настройка не применилась. Второе по частоте — вложенный location: директивы add_header не наследуются, если во вложенном блоке объявлен хотя бы один свой.

Проверка

curl -sI https://example.test/assets/app.js | grep -i 'cache-control\|expires'

Смотреть нужно именно на ответ сервера, а не на вкладку сети в браузере: там легко спутать память браузера с реальным заголовком.