RU

Приложения

Установка Nginx и PHP-FPM

Установите Nginx и PHP-FPM на Debian или Ubuntu: актуальные репозитории, виртуальный хост, отдельный пул, тест PHP, основные настройки, HTTPS, обновления и устранение неполадок.

6 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

Это руководство объясняет, как установить 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
<?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.ini
Конфигурация
memory_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.conf
Nginx
server_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.conf
Nginx
server {
    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:

Nginx
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 и настроенный домен.

Ссылки