Поиск
Справочник

nginx для Laravel: готовый файл сайта

Документация Laravel даёт готовый файл сайта для nginx. Главное в нём — две строки: root указывает на папку public проекта, а try_files отправляет в Laravel все адреса, для которых нет файла на диске. Ниже — файл, подставленный под Ubuntu 24.04, и что значит каждая строка.

≈ 6 мин чтения
Содержание 12

Что сделать прямо сейчас

  1. Создайте файл сайта: sudo nano /etc/nginx/sites-available/example.com.
  2. Вставьте в него готовые настройки и замените example.com на свой домен.
  3. Включите сайт: sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/.
  4. Проверьте настройки: 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/publicnginx отдаёт файлы только из папки 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/
UbuntuPHPСтрока fastcgi_pass
24.048.3fastcgi_pass unix:/run/php/php8.3-fpm.sock;
26.048.5fastcgi_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

Источники

Сверено 13 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше