arbusto/nginx repository overview

⁠Nginx (Custom Build) — Ubuntu 24.04

Легковесный образ Nginx, собранный из исходников на базе Ubuntu 24.04 с использованием многоэтапной сборки (multi-stage build). Финальный образ не содержит инструментов сборки — только необходимые runtime-зависимости.

⁠Особенности

• Базовый образ: ubuntu:24.04
• Версия Nginx: 1.27.3 (собирается из официальных исходников nginx.org)
• Многоэтапная сборка — итоговый образ очищен от компиляторов и dev-библиотек, что уменьшает размер и снижает поверхность атаки
• Поддержка HTTP/2
• Поддержка SSL/TLS (http_ssl_module, stream_ssl_module)
• Модуль stream для проксирования TCP/UDP-трафика, включая stream_ssl_preread_module
• Модуль realip для корректной обработки реальных IP за прокси/балансировщиками
• Модуль sub для замены содержимого ответов на лету

⁠Собранные модули Nginx

⁠Пути и расположение файлов

⁠Открытые порты

• 80 — HTTP
• 443 — HTTPS

⁠Запуск

docker run -d \
  --name nginx \
  -p 80:80 \
  -p 443:443 \
  -v $(pwd)/nginx.conf:/etc/nginx/nginx.conf:ro \
  arbusto/nginx:v1.27.3

⁠Пример с монтированием конфигурации и сертификатов

docker run -d \
  --name nginx \
  -p 80:80 \
  -p 443:443 \
  -v $(pwd)/conf/nginx.conf:/etc/nginx/nginx.conf:ro \
  -v $(pwd)/conf/stream-enabled:/etc/nginx/stream-enabled:ro \
  -v $(pwd)/certs:/etc/nginx/ssl:ro \
  arbusto/nginx:v1.27.3

⁠Остановка

Образ использует STOPSIGNAL SIGQUIT, что обеспечивает graceful shutdown — Nginx корректно завершает обработку текущих соединений перед остановкой.

docker stop nginx

⁠Сборка образа

docker build -t nginx:v1.27.3 .

Версию Nginx можно переопределить через build-arg:

docker build --build-arg NGINX_VERSION=1.27.3 -t nginx:v1.27.3 .

⁠Примечания

• Для процесс-менеджмента внутри контейнера добавлен пакет procps.
• Все временные файлы сборки и списки пакетов apt удаляются в рамках одного RUN, чтобы минимизировать размер слоёв.
• Образ не включает конфигурацию по умолчанию — рекомендуется монтировать собственный nginx.conf.