Конфиг nginx для WordPress: готовый файл и порядок применения
Файл выше описывает один сайт на WordPress: корень, обработку PHP через php8.3-fpm, кеш статики и запрет доступа к xmlrpc.php и скрытым файлам. Замените домен, путь и сокет PHP на свои значения, подключите файл симлинком и проверьте конфигурацию через sudo nginx -t.
Конфиг
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
Как применить и проверить
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 Настройка nginx как reverse proxy: конфиг и проверка Готовый конфиг nginx как reverse proxy: что делает каждый блок, что заменить под свой сервер, как применить через symlink и reload, как проверить и какие ошибки…
- Конфиг · Nginx Конфиг nginx для Laravel: готовый файл и порядок применения Готовый конфиг nginx для Laravel: что делает каждый блок, что заменить под свой сервер, как включить сайт, проверить синтаксис и перезагрузить nginx.
- Ошибка · Nginx Ошибка 502 Bad Gateway в nginx: причины и исправление Разбираем ошибку 502 Bad Gateway в nginx: почему PHP-FPM не отвечает, как читать error.log, проверять сокет и права, чинить таймауты и буферы.
- Руководство · Nginx Docker nginx: установка и настройка обратного прокси Пошагово: установка nginx в Docker на Ubuntu 24.04, конфиг обратного прокси, проверка через curl и разбор частых ошибок с логами.
- Ошибка · Nginx Ошибка 403 Forbidden в nginx: причины и исправление Разбираем ошибку 403 Forbidden в nginx: как найти причину по error.log, проверить права через namei и sudo -u www-data, исправить chmod и deny. Команды для Ubuntu…
- Руководство · Nginx Установка nginx на Ubuntu 24.04 и настройка сайта с PHP Пошаговая установка nginx на Ubuntu 24.04: apt, настройка PHP 8.3 через php-fpm, конфиг сайта, логи и проверка через nginx -t и systemctl status.
Настройка nginx на сервере: от установки до рабочего конфига: все материалы темы