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

Конфиг nginx для WordPress: готовый файл и порядок применения

Файл выше описывает один сайт на WordPress: корень, обработку PHP через php8.3-fpm, кеш статики и запрет доступа к xmlrpc.php и скрытым файлам. Замените домен, путь и сокет PHP на свои значения, подключите файл симлинком и проверьте конфигурацию через sudo nginx -t.

Конфиг Nginx 3 мин чтения

Конфиг

/etc/nginx/sites-available/example.com
server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;
    root /var/www/example.com;

    index index.php;
    client_max_body_size 64m;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }

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

    location = /xmlrpc.php {
        deny all;
    }

    location ~ /\.(?!well-known) {
        deny all;
    }
}

Что заменить под свой сервер

example.com
ваш домен
/var/www/example.com
папка с файлами WordPress
php8.3-fpm.sock
сокет установленной версии PHP
64m
лимит загрузки, он должен совпадать с upload_max_filesize в php.ini

Как применить и проверить

bash
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

Блок server и имена домена

Директива server открывает виртуальный хост. listen 80 и listen [::]:80 принимают HTTP на IPv4 и IPv6, server_name перечисляет домены, по которым nginx выбирает этот блок. Замените example.com и www.example.com на свои имена. Если сайт работает по HTTPS, этот блок остаётся для порта 80, а сертификат и listen 443 ssl добавляются отдельным блоком.

Корень сайта и индексный файл

root /var/www/example.com указывает папку с файлами WordPress, index index.php задаёт файл, который отдаётся при запросе каталога. Путь должен совпадать с тем, куда распакован WordPress, иначе nginx вернёт 404 на главную. Права на папку обычно www-data:www-data, иначе PHP не сможет писать в wp-content.

Лимит загрузки и php.ini

client_max_body_size 64m разрешает nginx принимать тела запросов до 64 МБ, это нужно для загрузки тем, плагинов и медиафайлов. То же значение задаётся в upload_max_filesize в php.ini, а post_max_size берут чуть больше. Если лимиты расходятся, большие файлы отклоняются с ошибкой 413 от nginx или с сообщением PHP о превышении размера.

ЧПУ WordPress через try_files

try_files $uri $uri/ /index.php?$args сначала ищет реальный файл или каталог, а всё остальное передаёт в index.php с сохранением параметров строки запроса. Без этой строки постоянные ссылки вида /sample-page/ отдают 404. Директива должна стоять в location /, до блока PHP.

Передача PHP в php8.3-fpm

Блок location ~ \.php$ включает snippets/fastcgi-php.conf и отправляет запросы в сокет unix:/run/php/php8.3-fpm.sock. Проверьте имя сокета командой ls /run/php/: у другой версии PHP оно будет другим, например php8.2-fpm.sock. Если сокет не совпадает, nginx отдаёт 502 Bad Gateway.

Кеш статики и запреты

Блок с расширениями css|js|gif|ico|jpeg|jpg|png|svg|webp|woff2 ставит заголовок expires 30d и отключает запись в access_log. location = /xmlrpc.php с deny all закрывает старый интерфейс WordPress, который часто используют для подбора паролей. Последний блок запрещает доступ к скрытым файлам, кроме /.well-known/, нужного для проверки сертификатов.

Подключение сайта и проверка

Файл кладут в /etc/nginx/sites-available/example.com, затем создают симлинк в sites-enabled. Перед перезагрузкой всегда запускайте sudo nginx -t: при ошибке в синтаксисе nginx продолжит работать со старой конфигурацией, а reload вернёт сообщение о проблеме. После успешной проверки выполните sudo systemctl reload nginx и откройте сайт в браузере.

Где ошибаются, когда правят конфиг

  • Сокет в fastcgi_pass не совпадает с установленной версией PHP, и сайт отвечает 502 Bad Gateway.

    Посмотрите имя файла в /run/php/ и подставьте его в fastcgi_pass, например unix:/run/php/php8.3-fpm.sock.

  • client_max_body_size меньше upload_max_filesize в php.ini, поэтому загрузка медиафайлов обрывается с ошибкой 413.

    Сделайте лимит nginx равным или большим, чем upload_max_filesize, и перезагрузите оба сервиса.

  • Блок location ~ \.php$ стоит раньше location /, и запросы к несуществующим страницам уходят в PHP без параметров, WordPress отдаёт 404.

    Оставьте try_files в location / и не добавляйте туда обработку PHP, порядок блоков в файле сохраняйте как в конфиге.

  • Симлинк создан, но sudo nginx -t не запускали, и reload применяет файл с опечаткой в директиве.

    Всегда проверяйте конфигурацию через sudo nginx -t и исправляйте строку, на которую указывает ошибка, до перезагрузки.

Deploykin

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

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

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

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

Куда класть этот конфиг в Ubuntu 24.04?

В /etc/nginx/sites-available/example.com, затем создать симлинк в /etc/nginx/sites-enabled/ и перезагрузить nginx. Имя файла может быть любым, важно совпадение с путём в команде ln -s.

Почему WordPress отдаёт 404 на внутренних страницах?

Чаще всего отсутствует try_files $uri $uri/ /index.php?$args в location / или не включены постоянные ссылки в настройках WordPress. Проверьте, что блок PHP не перехватывает запросы раньше основного location.

Какой сокет PHP указывать в fastcgi_pass?

Тот, который создан вашей версией PHP-FPM. Посмотрите список в /run/php/ и подставьте имя вида php8.3-fpm.sock в строку fastcgi_pass.

Нужно ли закрывать xmlrpc.php?

Для обычного сайта без приложений, использующих XML-RPC, доступ к xmlrpc.php лучше закрыть: через него перебирают пароли. Если мобильное приложение или Jetpack требуют этот файл, уберите блок deny all.

Ещё по теме

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

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