1. Блог
  2. Мануалы

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

Настройка 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 делает то же самое через веб-интерфейс.

Эта статья на других языках:EnglishУкраїнська