Установка Nginx и PHP-FPM
Установите Nginx и PHP-FPM на Debian или Ubuntu: актуальные репозитории, виртуальный хост, отдельный пул, тест PHP, основные настройки, HTTPS, обновления и устранение неполадок.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
Это руководство объясняет, как установить Nginx из официального репозитория nginx.org и PHP-FPM в актуальной версии, а затем опубликовать сайт с собственным виртуальным хостом и собственным пулом PHP.
Заказать сервер
Для размещения ваших сайтов HostMyServers предлагает несколько вариантов:
Предварительные требования
- Сервер под управлением Debian 12/13 или Ubuntu 22.04/24.04
- SSH-доступ под
rootили пользователем с правамиsudo - Доменное имя, записи которого указывают на сервер (см. создание записи A)
- Открытые TCP-порты 80 и 443
PHP-FPM взаимодействует с Nginx через локальный сокет: ему не нужны открытые порты. Если вы используете UFW (см. Настройка UFW):
sudo ufw allow 80,443/tcp comment 'Web'Шаг 1: установите Nginx
Если Nginx уже установлен из пакетов вашего дистрибутива, сохраните резервную копию /etc/nginx, затем удалите его командой sudo apt remove nginx nginx-common.
Установите необходимые инструменты. В Debian:
sudo apt update
sudo apt install curl gnupg2 ca-certificates lsb-release debian-archive-keyringВ Ubuntu:
sudo apt update
sudo apt install curl gnupg2 ca-certificates lsb-release ubuntu-keyringИмпортируйте ключ подписи и выведите его отпечатки:
curl -fsSL https://nginx.org/keys/nginx_signing.key | gpg --dearmor | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg > /dev/null
gpg --show-keys /usr/share/keyrings/nginx-archive-keyring.gpgВ списке должен быть отпечаток 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62. Если его нет, удалите файл и на этом остановитесь.
Добавьте репозиторий стабильной ветки, задайте ему приоритет, затем установите Nginx:
. /etc/os-release
echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://nginx.org/packages/$ID $(lsb_release -cs) nginx" | sudo tee /etc/apt/sources.list.d/nginx.list
printf 'Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n' | sudo tee /etc/apt/preferences.d/99nginx
sudo apt update
sudo apt install nginx
sudo systemctl enable --now nginx
nginx -vШаг 2: установите PHP-FPM
Проект PHP не публикует APT-репозиторий. Чтобы получить актуальную версию на всех этих системах, в этом руководстве используется репозиторий packages.sury.org, который поддерживает Ондржей Сурый (Ondřej Surý), также сопровождающий пакеты PHP в Debian. Это сторонний репозиторий: добавляйте его, только если вы ему доверяете.
sudo apt install lsb-release ca-certificates curl
curl -fsSLo /tmp/debsuryorg-archive-keyring.deb https://packages.sury.org/debsuryorg-archive-keyring.deb
sudo dpkg -i /tmp/debsuryorg-archive-keyring.deb
echo "deb [signed-by=/usr/share/keyrings/debsuryorg-archive-keyring.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/php.list
sudo apt updateУстановите PHP 8.5 с наиболее распространёнными расширениями:
sudo apt install php8.5-fpm php8.5-cli php8.5-curl php8.5-mbstring php8.5-xml php8.5-zip php8.5-intl php8.5-gd php8.5-mysql
php -v
sudo systemctl status php8.5-fpmУстанавливайте именно php8.5-fpm, а не универсальный пакет php, который может добавить Apache.
Шаг 3: создайте сайт
Здесь у каждого сайта есть собственный системный пользователь. PHP может читать код, но писать может только в uploads:
sudo useradd --system --user-group --home-dir /var/www/ваш-домен.com --shell /usr/sbin/nologin webapp
sudo mkdir -p /var/www/ваш-домен.com/public/uploads
sudo chown -R "$USER":webapp /var/www/ваш-домен.com
sudo find /var/www/ваш-домен.com -type d -exec chmod 755 {} +
sudo chown webapp:webapp /var/www/ваш-домен.com/public/uploadsСоздайте тестовую страницу:
nano /var/www/ваш-домен.com/public/index.php<?php
header('Content-Type: text/plain; charset=utf-8');
echo 'PHP ', PHP_VERSION, ' (', PHP_SAPI, ')', PHP_EOL;
echo 'User: ', posix_getpwuid(posix_geteuid())['name'], PHP_EOL;
echo 'OPcache: ', (function_exists('opcache_get_status') && opcache_get_status(false)) ? 'on' : 'off', PHP_EOL;Шаг 4: создайте пул PHP-FPM
sudo nano /etc/php/8.5/fpm/pool.d/ваш-домен.com.conf[ваш-домен.com]
user = webapp
group = webapp
listen = /run/php/ваш-домен.com.sock
listen.owner = nginx
listen.group = nginx
listen.mode = 0660
pm = dynamic
pm.max_children = 10
pm.start_servers = 2
pm.min_spare_servers = 1
pm.max_spare_servers = 3
pm.max_requests = 500
request_terminate_timeout = 120s
catch_workers_output = yes
php_admin_flag[log_errors] = onОтключите пул по умолчанию, который больше не нужен:
sudo mv /etc/php/8.5/fpm/pool.d/www.conf /etc/php/8.5/fpm/pool.d/www.conf.disabledШаг 5: настройте PHP
Разместите свои настройки в отдельном файле, который не будет затронут обновлениями:
sudo nano /etc/php/8.5/fpm/conf.d/90-custom.inimemory_limit = 256M
upload_max_filesize = 32M
post_max_size = 32M
max_execution_time = 60
date.timezone = Europe/Paris
expose_php = Off
display_errors = Off
log_errors = On
session.use_strict_mode = 1
session.cookie_httponly = 1
opcache.enable = 1
opcache.memory_consumption = 128
opcache.max_accelerated_files = 10000
opcache.validate_timestamps = 1
opcache.revalidate_freq = 2Проверьте и перезапустите PHP-FPM:
sudo php-fpm8.5 -t
sudo systemctl restart php8.5-fpm
ls -l /run/php/Сокет ваш-домен.com.sock должен принадлежать nginx:nginx.
Шаг 6: настройте Nginx
Отключите пример конфигурации, затем создайте общие настройки:
sudo mv /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.disabled
sudo nano /etc/nginx/conf.d/00-defaults.confserver_tokens off;
gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_types text/plain text/css application/javascript application/json application/xml image/svg+xml;
server {
listen 80 default_server;
listen [::]:80 default_server;
server_name _;
return 444;
}
server {
listen 443 ssl default_server;
listen [::]:443 ssl default_server;
server_name _;
ssl_reject_handshake on;
}Эти два блока закрывают соединение, когда запрос не соответствует ни одному из ваших доменов. Затем создайте виртуальный хост:
sudo nano /etc/nginx/conf.d/ваш-домен.com.confserver {
listen 80;
listen [::]:80;
server_name ваш-домен.com www.ваш-домен.com;
root /var/www/ваш-домен.com/public;
index index.php index.html;
access_log /var/log/nginx/ваш-домен.com.access.log;
error_log /var/log/nginx/ваш-домен.com.error.log;
client_max_body_size 32m;
location ~ /\.(?!well-known) {
deny all;
}
location ^~ /uploads/ {
location ~ \.php$ {
deny all;
}
}
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
try_files $uri =404;
fastcgi_pass unix:/run/php/ваш-домен.com.sock;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
fastcgi_param DOCUMENT_ROOT $realpath_root;
}
}Эта конфигурация запрещает доступ к скрытым файлам вроде .env и выполнение PHP в uploads. Проверьте и перезагрузите:
sudo nginx -t
sudo systemctl reload nginxШаг 7: проверьте сайт
С сервера:
curl -i -H 'Host: ваш-домен.com' http://127.0.0.1/Ответ должен быть 200 OK с версией PHP, пользователем webapp и OPcache: on. Проверьте также защиту:
echo 'test' > /var/www/ваш-домен.com/public/.test
curl -s -o /dev/null -w '%{http_code}\n' -H 'Host: ваш-домен.com' http://127.0.0.1/.test
rm /var/www/ваш-домен.com/public/.testОжидаемый код: 403. Затем откройте http://ваш-домен.com в браузере. Прямой запрос на IP-адрес не получает ответа: это задуманное действие блока по умолчанию.
Шаг 8: включите HTTPS
Следуйте руководству Установка SSL-сертификата с Let's Encrypt, раздел про Nginx. Пропустите его часть про sites-available: ваш файл — /etc/nginx/conf.d/ваш-домен.com.conf. Основная команда:
sudo certbot --nginx -d ваш-домен.com -d www.ваш-домен.comПосле установки сертификата включите HTTP/2, добавив эту строку в блок server, содержащий listen 443 ssl:
http2 on;Добавьте также эту строку в /etc/php/8.5/fpm/conf.d/90-custom.ini, чтобы сессионные cookie передавались только по HTTPS:
session.cookie_secure = 1Примените и проверьте:
sudo nginx -t
sudo systemctl reload nginx
sudo systemctl restart php8.5-fpm
curl -I https://ваш-домен.com
sudo certbot renew --dry-runПосле завершения тестов замените тестовую страницу вашим приложением.
Расчёт параметров PHP-FPM
pm.max_children ограничивает число одновременно обрабатываемых запросов PHP. Слишком большое значение может исчерпать память. Измерьте среднее потребление, желательно под реальной нагрузкой:
ps --no-headers -o rss -C php-fpm8.5 | awk '{s+=$1; n++} END {printf "%.0f Mo\n", s/n/1024}'
free -mЗатем рассчитайте: память, доступная для PHP ÷ среднее потребление одного процесса. Например, 1 024 МБ ÷ 60 МБ дают примерно 17 процессов. Оставьте запас для системы и базы данных, затем перезагрузите командой sudo systemctl reload php8.5-fpm.
Обновления
sudo apt update
sudo apt upgrade
sudo nginx -t
sudo systemctl status nginx php8.5-fpmЧтобы перейти на новую ветку PHP, установите её пакеты, скопируйте ваш пул и 90-custom.ini в каталог новой версии, остановите старую службу, затем запустите новую. Поскольку имя сокета остаётся прежним, виртуальный хост не меняется. Заранее протестируйте ваше приложение.
Резервное копирование
Сохраните сайт и его конфигурацию, затем скопируйте архив за пределы сервера:
sudo tar czf site-backup.tar.gz /var/www/ваш-домен.com /etc/nginx /etc/php/8.5/fpm /etc/letsencrypt
sudo chmod 600 site-backup.tar.gzАрхив содержит закрытые ключи ваших сертификатов. Если сайт использует базу данных, сохраняйте её отдельно, например с помощью mariadb-dump (см. Установка и защита MariaDB).
Если что-то пошло не так
Полезные журналы: /var/log/nginx/ваш-домен.com.error.log и /var/log/php8.5-fpm.log.
502 Bad Gateway с connect() ... failed (13: Permission denied)
У Nginx нет доступа к сокету. Проверьте listen.owner и listen.group в пуле, затем перезапустите PHP-FPM.
502 Bad Gateway с connect() ... failed (2: No such file or directory)
PHP-FPM остановлен, либо путь к сокету в пуле и в fastcgi_pass различается. Посмотрите sudo systemctl status php8.5-fpm и sudo php-fpm8.5 -t.
File not found. или Primary script unknown
Файл отсутствует по пути, указанному в root, либо пользователь webapp не может его прочитать. Проверьте путь и права командой namei -l /var/www/ваш-домен.com/public/index.php.
Браузер скачивает файл PHP
Блок location ~ \.php$ не применяется. Убедитесь, что домен соответствует server_name, затем перезагрузите Nginx.
413 Request Entity Too Large
Увеличьте client_max_body_size в Nginx, а также upload_max_filesize и post_max_size в PHP, подобрав согласованные значения.
504 Gateway Timeout
Скрипт превышает тайм-аут Nginx. По возможности оптимизируйте его или согласованно измените fastcgi_read_timeout, max_execution_time и request_terminate_timeout.
server reached pm.max_children setting
Все места в пуле заняты. Сначала найдите медленные запросы, затем увеличьте pm.max_children, если позволяет память.
bind() to 0.0.0.0:80 failed (98: Address already in use)
Другая служба, часто Apache, занимает порт. Определите её командой sudo ss -ltnp | grep ':80 '.
curl: (52) Empty reply from server
Запрос не соответствует ни одному server_name, и блок по умолчанию закрыл соединение. Проверьте заголовок Host и настроенный домен.