Docker nginx: установка и настройка обратного прокси
Nginx в Docker запускают одной командой docker run, а конфиг подключают через volume из каталога на хосте.
01Установите Docker
Обновите список пакетов и поставьте Docker из репозитория Ubuntu. После установки проверьте, что служба запущена и клиент отвечает.
sudo apt update
sudo apt install -y docker.io
sudo systemctl enable --now docker
sudo docker --version
02Создайте каталоги для конфига и сайта
Nginx в контейнере читает конфиги из /etc/nginx/conf.d. Создайте на хосте каталог, который вы смонтируете в контейнер, и каталог для статики.
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 нужны, чтобы приложение видело исходный домен и адрес клиента.
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 поднимает контейнер после перезагрузки сервера.
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 может быть не установлен. Если проверка прошла, перезагрузите контейнер, чтобы он перечитал файлы.
sudo docker exec nginx nginx -t
sudo docker exec nginx nginx -s reload
06Проверьте работу прокси
Отправьте запрос на домен и посмотрите код ответа. Код 502 означает, что приложение на 8080 недоступно, код 200 или 301 подтверждает, что nginx принял запрос и передал его дальше. Логи контейнера показывают, какие запросы дошли до nginx.
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 Установка nginx на Ubuntu 24.04 и настройка сайта с PHP Пошаговая установка nginx на Ubuntu 24.04: apt, настройка PHP 8.3 через php-fpm, конфиг сайта, логи и проверка через nginx -t и systemctl status.
- Руководство · Nginx found nginx: почему nginx отдаёт 404 и как это исправить Пошаговая инструкция: как найти причину 404 Not Found в nginx на Ubuntu 24.04, проверить конфиг, пути и права, перезагрузить nginx и убедиться, что страница…
- Руководство · Nginx Nginx версии: установка и настройка на Ubuntu 24.04 Пошаговая настройка nginx на Ubuntu 24.04: установка версии 1.24, конфиг сайта, PHP 8.3, проверка nginx -t и reload, разбор ошибок 403, 502, 504.
- Руководство · Nginx Настройка nginx location на Ubuntu 24.04 Пошаговая настройка nginx на Ubuntu 24.04: установка, директива location, конфиг сайта, проверка синтаксиса и перезагрузка. Разбор частых ошибок.
- Руководство · Nginx Настройка сайта в nginx на Ubuntu 24.04 Пошаговая настройка сайта в nginx на Ubuntu 24.04: конфиг в sites-available, симлинк, проверка nginx -t, reload, права и PHP-FPM. Команды и проверка.
- Руководство · Nginx Настройка WebSocket в nginx на Ubuntu 24.04 Настройте проксирование WebSocket в nginx на Ubuntu 24.04: директивы Upgrade и Connection, location, проверка через curl и браузер, типичные ошибки 400 и 502.
Настройка nginx на сервере: от установки до рабочего конфига: все материалы темы