К содержимому

Кэширование статики в nginx на Ubuntu 24.04

Кэширование статики в nginx задаётся директивой expires в блоке location. Она добавляет заголовки Expires и Cache-Control: max-age, и браузер перестаёт запрашивать файлы при каждом переходе. Настройка занимает один блок конфига и проверяется через curl -I.

Руководство Nginx 2 мин чтения

01Проверьте, что nginx установлен

На сервере уже должен работать nginx 1.24 из репозитория Ubuntu 24.04. Убедитесь в этом одной командой. Если пакета нет, установите его через sudo apt install nginx и вернитесь к настройке.

bash
nginx -v

02Откройте конфиг сайта

Файлы сайтов лежат в /etc/nginx/sites-available/, включённые сайты подключены симлинком из /etc/nginx/sites-enabled/. Откройте конфиг нужного сайта, например /etc/nginx/sites-available/example.com, в редакторе. Все правки делайте в блоке server, который слушает нужный порт.

bash
sudo nano /etc/nginx/sites-available/example.com

03Добавьте блок location для статики

Внутри server создайте location, который совпадает по расширениям файлов. Директива expires 30d выставляет Expires и Cache-Control: max-age=2592000. Отдельный add_header Cache-Control не добавляйте: получится два заголовка Cache-Control в одном ответе.

nginx
location ~* \.(jpg|jpeg|png|gif|ico|css|js|svg|woff2?)$ {
    expires 30d;
    access_log off;
}

04Проверьте конфиг и перезагрузите nginx

Сначала проверьте синтаксис всех файлов через sudo nginx -t. Если проверка прошла, примените конфиг командой sudo systemctl reload nginx: соединения не оборвутся. При ошибке nginx продолжит работать со старым конфигом, а текст ошибки покажет файл и строку.

bash
sudo nginx -t
sudo systemctl reload nginx

05Проверьте заголовки ответа

Запросите статический файл через curl -I и посмотрите на строки Expires и Cache-Control. В Cache-Control должно быть max-age=2592000, а сам заголовок встречается один раз. Для файла с другим расширением, которого нет в списке, заголовков кэширования не будет.

bash
curl -I http://example.com/style.css

Частые ошибки

  • В блоке с expires добавлен add_header Cache-Control "public";. В ответе оказываются два заголовка Cache-Control, и браузер может выбрать не тот.

    Оставьте только expires 30d. Директива сама выставляет Cache-Control: max-age.

  • Блок location для статики стоит после location / с try_files, и запросы к файлам уходят в PHP или отдают 404.

    Разместите блок с регулярным выражением по расширениям до location / или используйте location ~* с явным списком расширений: регулярные выражения проверяются раньше префиксных.

  • После правки конфига выполнен только sudo systemctl reload nginx без sudo nginx -t, и nginx молча работает со старым конфигом.

    Всегда запускайте sudo nginx -t перед reload. При ошибке команда покажет файл и строку, а nginx продолжит работу со старым конфигом.

Deploykin

Как это делается в Deploykin

В Deploykin сайт создаётся из панели, и конфиг nginx под Laravel, WordPress или PHP панель пишет сама. Править конфиги можно в редакторе панели: перед сохранением конфиг проверяется на сервере, а прежняя версия уходит в резервную копию.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Чем expires отличается от add_header Cache-Control?

expires сразу выставляет и Expires, и Cache-Control: max-age. add_header Cache-Control добавляет ещё один заголовок, и в ответе их становится два. Для срока жизни статики достаточно expires.

Какие расширения включить в блок кэширования?

Картинки, стили, скрипты и шрифты: jpg, jpeg, png, gif, ico, css, js, svg, woff, woff2. HTML и JSON кэшировать не нужно, их содержимое меняется.

Почему после настройки curl -I не показывает Cache-Control?

Файл не попал под регулярное выражение в location, или запрос идёт на другой server. Проверьте расширение файла и порт в запросе, затем снова выполните sudo nginx -t и sudo systemctl reload nginx.

Как отключить кэширование для отдельного файла?

Добавьте expires -1; в location для этого файла или каталога. Директива выставит Cache-Control: no-cache, и браузер будет проверять файл при каждом запросе.

Ещё по теме

Настройка nginx на сервере: от установки до рабочего конфига: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.