Настройка Nginx Virtual Host: примеры конфигурации

Виртуальный хост в Nginx — это блок server, который описывает, как обрабатывать запросы к конкретному домену. На одном VPS может работать сколько угодно сайтов, каждый со своим блоком. Ниже — три готовых шаблона и порядок их подключения в Ubuntu и Debian.
Где лежат конфигурации
/etc/nginx/sites-available/— файлы всех сайтов;/etc/nginx/sites-enabled/— символические ссылки на включённые сайты;/etc/nginx/nginx.conf— общие настройки сервера.
В примерах замените example.com на свой домен. Его A-запись должна указывать на IP-адрес сервера.
Статический сайт
Создайте каталог сайта и файл конфигурации:
sudo mkdir -p /var/www/example.com
sudo nano /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.html;
location / {
try_files $uri $uri/ =404;
}
access_log /var/log/nginx/example.com.access.log;
error_log /var/log/nginx/example.com.error.log;
}
Сайт на PHP
Для WordPress и других PHP-приложений запросы к .php передаются в PHP-FPM:
server {
listen 80;
listen [::]:80;
server_name example.com www.example.com;
root /var/www/example.com;
index index.php index.html;
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 ~ /\.ht {
deny all;
}
}
Имя сокета зависит от версии PHP: в Ubuntu 24.04 это php8.3-fpm.sock, в Debian 12 — php8.2-fpm.sock. Точное имя покажет команда ls /run/php/.
Обратный прокси
Так публикуют приложения, которые слушают локальный порт: Node.js, Python, контейнеры Docker.
server {
listen 80;
listen [::]:80;
server_name app.example.com;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
Последние две строки нужны приложениям, использующим WebSocket.
Включение сайта
Создайте ссылку, проверьте синтаксис и перечитайте конфигурацию:
sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
Команда nginx -t обязательна: при ошибке в конфигурации reload не применит изменения, а restart остановит все сайты на сервере.
Бесплатный SSL-сертификат
Certbot получит сертификат Let’s Encrypt и сам допишет в конфигурацию блок для HTTPS и перенаправление с HTTP:
sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d example.com -d www.example.com
Сертификат продлевается автоматически. Проверить продление можно командой sudo certbot renew --dry-run.
Перенаправление с www
Чтобы сайт открывался по одному адресу, добавьте отдельный блок:
server {
listen 80;
listen [::]:80;
server_name www.example.com;
return 301 $scheme://example.com$request_uri;
}
и уберите www.example.com из server_name основного блока.
Частые ошибки
- Открывается страница «Welcome to nginx». Запрос попал в сайт по умолчанию: проверьте
server_nameи наличие ссылки вsites-enabled. - 502 Bad Gateway. Приложение или PHP-FPM не запущено, либо указан неверный порт или сокет.
- 403 Forbidden. У пользователя
www-dataнет прав на каталог сайта или отсутствует индексный файл. - Изменения не применяются. Выполните
sudo nginx -t— скорее всего, в конфигурации ошибка.
Если не хочется править файлы вручную, Nginx Proxy Manager делает то же самое через веб-интерфейс.


