К содержимому

Docker nginx: установка и настройка обратного прокси

Nginx в Docker запускают одной командой docker run, а конфиг подключают через volume из каталога на хосте.

Руководство Nginx 2 мин чтения

01Установите Docker

Обновите список пакетов и поставьте Docker из репозитория Ubuntu. После установки проверьте, что служба запущена и клиент отвечает.

bash
sudo apt update
sudo apt install -y docker.io
sudo systemctl enable --now docker
sudo docker --version

02Создайте каталоги для конфига и сайта

Nginx в контейнере читает конфиги из /etc/nginx/conf.d. Создайте на хосте каталог, который вы смонтируете в контейнер, и каталог для статики.

bash
sudo mkdir -p /var/www/example.com/html
sudo mkdir -p /etc/nginx/conf.d
sudo chown -R www-data:www-data /var/www/example.com

03Напишите конфиг обратного прокси

Положите файл /etc/nginx/conf.d/example.com.conf на хосте. Он принимает запросы на 80 порту и передаёт их приложению, которое слушает 8080 на хосте. Заголовки Host и X-Real-IP нужны, чтобы приложение видело исходный домен и адрес клиента.

nginx
server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://172.17.0.1:8080;
        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;
    }
}

04Запустите контейнер nginx

Смонтируйте каталог с конфигом в контейнер только для чтения и опубликуйте порт 80. Флаг --restart unless-stopped поднимает контейнер после перезагрузки сервера.

bash
sudo docker run -d --name nginx --restart unless-stopped -p 80:80 -v /etc/nginx/conf.d:/etc/nginx/conf.d:ro nginx:stable

05Проверьте конфиг внутри контейнера

Синтаксис проверяется командой nginx -t внутри контейнера, а не на хосте: на хосте nginx может быть не установлен. Если проверка прошла, перезагрузите контейнер, чтобы он перечитал файлы.

bash
sudo docker exec nginx nginx -t
sudo docker exec nginx nginx -s reload

06Проверьте работу прокси

Отправьте запрос на домен и посмотрите код ответа. Код 502 означает, что приложение на 8080 недоступно, код 200 или 301 подтверждает, что nginx принял запрос и передал его дальше. Логи контейнера показывают, какие запросы дошли до nginx.

bash
curl -I http://example.com
sudo docker logs --tail 50 nginx

Частые ошибки

  • После правки конфига nginx в контейнере отдаёт старые настройки.

    Выполните sudo docker exec nginx nginx -s reload. Если файл смонтирован как каталог, изменения на хосте видны сразу, перезапуск контейнера не нужен.

  • В proxy_pass указан 127.0.0.1:8080, и nginx возвращает 502.

    Внутри контейнера 127.0.0.1 это сам контейнер. Укажите адрес хоста в сети Docker, обычно 172.17.0.1, или запустите приложение в той же пользовательской сети.

  • Порт 80 занят, контейнер падает с ошибкой bind: address already in use.

    Остановите системный nginx командой sudo systemctl stop nginx и отключите автозапуск через sudo systemctl disable nginx, либо публикуйте другой порт, например -p 8080:80.

  • nginx -t на хосте пишет command not found.

    Проверяйте конфиг внутри контейнера: sudo docker exec nginx nginx -t. На хосте nginx не установлен, и это нормально для схемы с контейнером.

Deploykin

Как это делается в Deploykin

В Deploykin контейнеры Docker создаются, запускаются и останавливаются из панели, там же видны их статусы и тома. Приложение на своём порту открывается через nginx панели: прокси на этот порт настраивается в настройках сайта.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Как перезапустить nginx в Docker после изменения конфига?

Выполните sudo docker exec nginx nginx -s reload. Полный перезапуск контейнера нужен только при смене портов или volume.

Почему nginx в контейнере не видит мой конфиг?

Файл должен лежать в каталоге, который смонтирован в /etc/nginx/conf.d. Проверьте путь в -v и имя файла: nginx читает только файлы с расширением .conf.

Как передать реальный IP клиента приложению за прокси?

Добавьте в location заголовки proxy_set_header X-Real-IP $remote_addr и proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for. Приложение должно читать IP из этих заголовков.

Можно ли поставить nginx и на хост, и в контейнер?

Можно, но порт 80 достанется только одному из них. Системный nginx удобно оставить как точку входа, а контейнеры публиковать на других портах.

Ещё по теме

Настройка nginx на сервере: от установки до рабочего конфига: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.