Кэширование статики в nginx на Ubuntu 24.04
Кэширование статики в nginx задаётся директивой expires в блоке location. Она добавляет заголовки Expires и Cache-Control: max-age, и браузер перестаёт запрашивать файлы при каждом переходе. Настройка занимает один блок конфига и проверяется через curl -I.
01Проверьте, что nginx установлен
На сервере уже должен работать nginx 1.24 из репозитория Ubuntu 24.04. Убедитесь в этом одной командой. Если пакета нет, установите его через sudo apt install nginx и вернитесь к настройке.
nginx -v
02Откройте конфиг сайта
Файлы сайтов лежат в /etc/nginx/sites-available/, включённые сайты подключены симлинком из /etc/nginx/sites-enabled/. Откройте конфиг нужного сайта, например /etc/nginx/sites-available/example.com, в редакторе. Все правки делайте в блоке server, который слушает нужный порт.
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 в одном ответе.
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 продолжит работать со старым конфигом, а текст ошибки покажет файл и строку.
sudo nginx -t
sudo systemctl reload nginx
05Проверьте заголовки ответа
Запросите статический файл через curl -I и посмотрите на строки Expires и Cache-Control. В Cache-Control должно быть max-age=2592000, а сам заголовок встречается один раз. Для файла с другим расширением, которого нет в списке, заголовков кэширования не будет.
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 Docker nginx: установка и настройка обратного прокси Пошагово: установка nginx в Docker на Ubuntu 24.04, конфиг обратного прокси, проверка через curl и разбор частых ошибок с логами.
- Руководство · Nginx Установка nginx на Ubuntu 24.04 и настройка сайта с PHP Пошаговая установка nginx на Ubuntu 24.04: apt, настройка PHP 8.3 через php-fpm, конфиг сайта, логи и проверка через nginx -t и systemctl status.
- Руководство · Nginx found nginx: почему nginx отдаёт 404 и как это исправить Пошаговая инструкция: как найти причину 404 Not Found в nginx на Ubuntu 24.04, проверить конфиг, пути и права, перезагрузить nginx и убедиться, что страница…
- Руководство · Nginx Nginx версии: установка и настройка на Ubuntu 24.04 Пошаговая настройка nginx на Ubuntu 24.04: установка версии 1.24, конфиг сайта, PHP 8.3, проверка nginx -t и reload, разбор ошибок 403, 502, 504.
- Руководство · Nginx Настройка nginx location на Ubuntu 24.04 Пошаговая настройка nginx на Ubuntu 24.04: установка, директива location, конфиг сайта, проверка синтаксиса и перезагрузка. Разбор частых ошибок.
- Руководство · Nginx Настройка сайта в nginx на Ubuntu 24.04 Пошаговая настройка сайта в nginx на Ubuntu 24.04: конфиг в sites-available, симлинк, проверка nginx -t, reload, права и PHP-FPM. Команды и проверка.
Настройка nginx на сервере: от установки до рабочего конфига: все материалы темы