Установка Nginx Proxy Manager через Docker Compose на Ubuntu 24.04
Nginx Proxy Manager запускается как контейнер и управляет прокси-хостами через веб-интерфейс. Для работы нужен Docker Compose v2 и свободные порты 80, 81 и 443.
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.
docker --version
docker compose version
02Освободите порты 80, 81 и 443
Nginx Proxy Manager публикует порты 80 и 443 для трафика и 81 для веб-интерфейса. Если на хосте уже работает nginx или другой контейнер, порт будет занят. Проверьте, кто слушает эти порты, и остановите конфликтующий сервис.
sudo ss -ltnp | grep -E ':(80|81|443)\b'
03Создайте каталог и файл compose.yaml
Создайте отдельный каталог для проекта и перейдите в него. В нём будет храниться compose.yaml и данные приложения. Файл compose.yaml, имя по умолчанию для Docker Compose v2.
mkdir -p ~/npm && cd ~/npm
04Опишите сервис в compose.yaml
В файле опишите сервис app с образом jc21/nginx-proxy-manager:latest. Пробросьте порты 80, 81 и 443, а данные и сертификаты сохраните в именованных томах. Ключ version: в Compose v2 не нужен.
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 с номером строки. Если в выводе нет ошибок, можно запускать.
docker compose config
06Запустите контейнер
Запустите сервис в фоне командой docker compose up -d. Docker скачает образ и создаст контейнер. Проверьте, что контейнер в состоянии running.
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 слушаются на хосте.
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 docker images: работа с образами Docker на Ubuntu 24.04 Как работать с docker images на Ubuntu 24.04: проверить демон, скачать образ через docker pull, посмотреть список, запустить контейнер и проверить результат.
- Руководство · Docker Установка Docker и Docker Compose на Ubuntu 24.04 Пошаговая установка Docker и Docker Compose на Ubuntu 24.04: команды, настройка compose.yaml, проверка работы и разбор частых ошибок.
- Руководство · Docker Как запустить Docker container на Ubuntu 24.04: пошаговая инструкция Запустите контейнер через docker compose up -d, проверьте статус, посмотрите логи, войдите в контейнер через exec и остановите проект. Команды и проверка.
- Руководство · Docker Установка Portainer на Ubuntu 24.04: пошаговая настройка Установите Portainer в Docker Compose на Ubuntu 24.04: проверка Docker, compose-файл, запуск, доступ к панели и проверка через curl и docker compose ps.
- Руководство · Docker Docker volumes: настройка и проверка на Ubuntu 24.04 Пошаговая настройка docker volumes на Ubuntu 24.04: создание тома, подключение к контейнеру, проверка сохранности данных после перезапуска и типичные ошибки.
- Руководство · Docker Установка GitLab в Docker на Ubuntu 24.04 Установите GitLab в Docker на Ubuntu 24.04: подготовка, compose-файл, запуск, проверка и типичные ошибки с командами.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы