nginx для Laravel: готовый файл сайта
Документация Laravel даёт готовый файл сайта для nginx. Главное в нём — две строки: root указывает на папку public проекта, а try_files отправляет в Laravel все адреса, для которых нет файла на диске. Ниже — файл, подставленный под Ubuntu 24.04, и что значит каждая строка.
Содержание 12
Что сделать прямо сейчас
- Создайте файл сайта:
sudo nano /etc/nginx/sites-available/example.com. - Вставьте в него готовые настройки и замените
example.comна свой домен. - Включите сайт:
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/. - Проверьте настройки:
sudo nginx -t— и примените:sudo systemctl reload nginx.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Проект должен лежать в /var/www/example.com — как его загрузить, написано в статье Установка Laravel.
Готовый файл сайта
Это файл из документации Laravel 13. В нём поменяны только папка проекта и путь к сокету PHP-FPM — под Ubuntu 24.04:
server {
listen 80;
listen [::]:80;
server_name example.com;
root /var/www/example.com/public;
add_header X-Frame-Options "SAMEORIGIN";
add_header X-Content-Type-Options "nosniff";
index index.php;
charset utf-8;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location = /favicon.ico { access_log off; log_not_found off; }
location = /robots.txt { access_log off; log_not_found off; }
error_page 404 /index.php;
location ~ ^/index\.php(/|$) {
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
fastcgi_buffer_size 32k;
fastcgi_buffers 8 32k;
fastcgi_busy_buffers_size 64k;
fastcgi_hide_header X-Powered-By;
}
location ~ \.php$ {
return 404;
}
location ~ /\.(?!well-known).* {
deny all;
}
}Сохраните файл: Ctrl+O, Enter, выход — Ctrl+X.
Что значит каждая строка
| Строка | Что делает |
|---|---|
listen 80 и listen [::]:80 | сайт принимает запросы на порт 80 по IPv4 и IPv6 |
server_name example.com | на какой домен отвечает этот блок — подробнее |
root /var/www/example.com/public | nginx отдаёт файлы только из папки public |
add_header X-Frame-Options "SAMEORIGIN" | чужие сайты не могут встроить ваш в рамку |
add_header X-Content-Type-Options "nosniff" | браузер не угадывает тип файла сам |
try_files $uri $uri/ /index.php?$query_string | есть файл — отдать его, нет — передать адрес в Laravel |
error_page 404 /index.php | страницу 404 показывает Laravel |
блок location для index.php | запускает через PHP-FPM только файл index.php |
fastcgi_pass unix:/run/php/php8.3-fpm.sock | адрес PHP-FPM — подробнее |
fastcgi_buffer_size 32k и две строки ниже | память для ответа PHP, в том числе для больших заголовков с длинными cookie |
fastcgi_hide_header X-Powered-By | не показывать посетителям версию PHP |
location ~ \.php$ { return 404; } | любой другой файл .php отвечает 404 |
location ~ /\.(?!well-known).* | закрывает файлы и папки с точкой в начале имени, кроме .well-known |
Почему root — папка public
В папке проекта лежат .env с паролями базы, код в app, журналы в storage. В папке public — только index.php, стили, скрипты и картинки. Если указать в root папку проекта, а не public, посетитель сможет скачать файлы, которые видеть не должен.
Документация Laravel предупреждает: не переносите index.php в корень проекта — сайт должен открываться из папки public.
Как устроены root и alias — в статье root и alias.
Почему try_files ведёт в index.php
У Laravel один вход — файл public/index.php. Адрес /about — не файл на диске, а маршрут из routes/web.php. Строка try_files сначала ищет файл, потом папку, а если их нет — передаёт запрос в index.php вместе с параметрами после ?.
Без этой строки главная откроется, а остальные страницы ответят 404. Как читать строку — в статье try_files.
Какой сокет указать
Путь к сокету зависит от версии PHP. Проверьте, какой файл есть на сервере:
ls /run/php/| Ubuntu | PHP | Строка fastcgi_pass |
|---|---|---|
| 24.04 | 8.3 | fastcgi_pass unix:/run/php/php8.3-fpm.sock; |
| 26.04 | 8.5 | fastcgi_pass unix:/run/php/php8.5-fpm.sock; |
В документации Laravel путь начинается с /var/run/php/. В Ubuntu /var/run — ссылка на /run, поэтому годятся оба пути.
Как включить сайт
nginx читает только сайты из папки sites-enabled. Сделайте там ссылку на ваш файл и проверьте настройки:
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
sudo nginx -tОтвет без ошибок:
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successfulПримените настройки:
sudo systemctl reload nginxКак устроены папки nginx — в статье Настройки nginx.
Как проверить
curl -I http://example.com/up
curl -I http://example.com/.envПервый адрес должен ответить 200 — Laravel запустился. Второй — 403 или 404: файл .env посетителям не отдаётся. Если /.env ответил 200 — в файле сайта нет последнего блока с deny all, а в root указана папка проекта: верните блок, поправьте root и снова выполните sudo nginx -t и sudo systemctl reload nginx.
HTTPS
Когда сайт откроется по http, получите бесплатный сертификат — инструкция. Certbot сам допишет в этот файл строки для порта 443. Как перенаправить посетителей с http на https — в статье Редирект на HTTPS.
После перехода на https поправьте в .env строку APP_URL=https://example.com и выполните sudo -u www-data php artisan config:cache.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
404 Not Found на всех страницах, кроме главной | нет строки try_files | проверьте блок location / |
502 Bad Gateway | неверный путь к сокету или PHP-FPM не запущен | Разбор |
403 Forbidden на главной | в root папка без index.php или нет прав | Разбор |
| браузер скачивает index.php вместо страницы | нет блока для index.php | проверьте файл |
страница 500 Server Error | ошибку записал Laravel | Разбор |
nginx -t пишет could not build server_names_hash | длинное имя сайта | Разбор |
| открывается страница Welcome to nginx | запрос попал в сайт по умолчанию | проверьте server_name и ссылку в sites-enabled |
Источники
- Документация Laravel: Deployment — на английском: файл сайта для nginx и предупреждение про index.php.
- Документация nginx: try_files — описание директивы.
- Документация nginx: fastcgi_pass и fastcgi_buffers — передача запросов в PHP-FPM.
- Пакет php8.3-fpm для Ubuntu 24.04 — на английском: версия PHP-FPM.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Laravel на серверевсе статьи о работе проекта на VPS.
- Установка Laravel на Ubuntuшаги до настройки nginx.
- fastcgi_passкак nginx передаёт запросы в PHP.