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

Установка Nginx Proxy Manager через Docker Compose на Ubuntu 24.04

Nginx Proxy Manager запускается как контейнер и управляет прокси-хостами через веб-интерфейс. Для работы нужен Docker Compose v2 и свободные порты 80, 81 и 443.

Руководство Docker 3 мин чтения

01Проверьте Docker и Docker Compose

На сервере уже должен быть установлен Docker с плагином Compose v2. Убедитесь, что команда docker compose доступна и работает без sudo. Если Docker не установлен, его ставят из репозитория Docker пакетами docker-ce, docker-ce-cli, containerd.io, docker-buildx-plugin и docker-compose-plugin.

bash
docker --version
docker compose version

02Освободите порты 80, 81 и 443

Nginx Proxy Manager публикует порты 80 и 443 для трафика и 81 для веб-интерфейса. Если на хосте уже работает nginx или другой контейнер, порт будет занят. Проверьте, кто слушает эти порты, и остановите конфликтующий сервис.

bash
sudo ss -ltnp | grep -E ':(80|81|443)\b'

03Создайте каталог и файл compose.yaml

Создайте отдельный каталог для проекта и перейдите в него. В нём будет храниться compose.yaml и данные приложения. Файл compose.yaml, имя по умолчанию для Docker Compose v2.

bash
mkdir -p ~/npm && cd ~/npm

04Опишите сервис в compose.yaml

В файле опишите сервис app с образом jc21/nginx-proxy-manager:latest. Пробросьте порты 80, 81 и 443, а данные и сертификаты сохраните в именованных томах. Ключ version: в Compose v2 не нужен.

yaml
services:
  app:
    image: jc21/nginx-proxy-manager:latest
    container_name: npm
    restart: unless-stopped
    ports:
      - "80:80"
      - "81:81"
      - "443:443"
    volumes:
      - npm_data:/data
      - npm_letsencrypt:/etc/letsencrypt

volumes:
  npm_data:
  npm_letsencrypt:

05Проверьте compose.yaml

Перед запуском проверьте файл командой docker compose config. Она печатает итоговый конфиг и показывает ошибки YAML с номером строки. Если в выводе нет ошибок, можно запускать.

bash
docker compose config

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

Запустите сервис в фоне командой docker compose up -d. Docker скачает образ и создаст контейнер. Проверьте, что контейнер в состоянии running.

bash
docker compose up -d
docker compose ps

07Проверьте работу веб-интерфейса

Откройте в браузере http://203.0.113.10:81. Появится страница входа Nginx Proxy Manager. Логин по умолчанию admin@example.com, пароль changeme. Смените пароль сразу после первого входа.

08Проверьте логи и порты

Если страница не открывается, посмотрите логи контейнера. Команда docker compose logs -f app показывает вывод приложения в реальном времени. Убедитесь, что порты 80, 81 и 443 слушаются на хосте.

bash
docker compose logs -f app
sudo ss -ltnp | grep -E ':(80|81|443)\b'

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

  • При запуске появляется ошибка Bind for 0.0.0.0:80 failed: port is already allocated.

    Порт 80 уже занят nginx на хосте или другим контейнером. Найдите процесс командой sudo ss -ltnp и остановите его, либо измените публикуемый порт в compose.yaml.

  • Команда docker compose завершается с ошибкой permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock.

    Пользователь не входит в группу docker. Выполните sudo usermod -aG docker $USER и войдите в систему заново.

  • При запуске появляется ошибка no configuration file provided: not found.

    В текущем каталоге нет compose.yaml или docker-compose.yml. Перейдите в каталог с файлом или укажите путь через -f.

  • Веб-интерфейс на порту 81 не открывается, контейнер перезапускается.

    Посмотрите логи командой docker compose logs -f app. Частая причина, нехватка памяти, код выхода 137 означает, что процесс убит сигналом SIGKILL.

Deploykin

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

В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.

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

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

Нужен ли отдельный nginx на хосте для Nginx Proxy Manager?

Нет. Nginx Proxy Manager сам содержит nginx и слушает порты 80 и 443. Если на хосте уже работает nginx, его нужно остановить или освободить порты.

Где хранятся данные Nginx Proxy Manager при использовании compose.yaml?

В именованных томах npm_data и npm_letsencrypt. Они переживают docker compose down, но удаляются командой docker compose down -v.

Какой пароль по умолчанию у Nginx Proxy Manager?

Логин admin@example.com, пароль changeme. Смените пароль сразу после первого входа в веб-интерфейс.

Можно ли запустить Nginx Proxy Manager без Docker Compose?

Да, контейнер можно запустить командой docker run, но Compose удобнее для хранения настроек и томов. В рамках этой инструкции используется docker compose.

Ещё по теме

Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

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