Установка Nginx Proxy Manager
Установка Nginx Proxy Manager с Docker на Debian или Ubuntu, закрытие его интерфейса от Интернета, публикация сервиса по HTTPS, ограничение доступа, обновление и резервное копирование.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
Nginx Proxy Manager (NPM) — это обратный прокси на основе Nginx, которым управляют через веб-интерфейс. Он принимает посетителей на портах 80 и 443, запрашивает сертификаты Let’s Encrypt и передаёт запросы вашим сервисам, а писать конфигурацию Nginx вам не нужно.
К концу руководства NPM будет работать в Docker, а его интерфейс администрирования будет доступен только через SSH-туннель. Тестовый сервис будет отвечать по адресу https://app.ваш-домен.com, а вы научитесь ограничивать доступ, обновлять NPM и резервировать его данные.
Используется версия 2.17.0 — последняя стабильная на момент написания, в ноябре 2026 года.
Заказать сервер
Это руководство подходит для серверов, которыми вы управляете самостоятельно:
Предварительные требования
- Сервер под управлением Debian 12 или 13 либо Ubuntu 22.04 или 24.04 на архитектуре amd64 или arm64
- Доступ по SSH под пользователем с правами
sudo, входящим в группуdocker - Docker Engine и Docker Compose, установленные по руководству Установка Docker Engine и Docker Compose
- Доменное имя, DNS-зоной которого вы управляете
- Отсутствие другого ПО на портах 80 и 443, например Nginx, Apache, Caddy или Traefik
Используемые порты
| Порт | Направление | Назначение | Нужно ли открывать |
|---|---|---|---|
| 80/tcp | Входящий | Проверка Let’s Encrypt и перенаправление на HTTPS | Да |
| 443/tcp | Входящий | Сайты, опубликованные по HTTPS | Да |
| 81/tcp | Локальный | Интерфейс администрирования, на 127.0.0.1 |
Нет |
Шаг 1: направьте домен на сервер
Создайте запись A для app.ваш-домен.com, указывающую на IP_ВАШЕГО_СЕРВЕРА. Если ваш домен обслуживается в HostMyServers, следуйте руководству Создание записи A.
Затем проверьте результат с сервера:
sudo apt update
sudo apt install -y bind9-dnsutils
dig +short A app.ваш-домен.com
dig +short AAAA app.ваш-домен.comПервая команда должна вернуть адрес вашего сервера. Если вторая возвращает адрес IPv6, он тоже должен принадлежать этому серверу. В противном случае удалите эту запись AAAA.
Шаг 2: подготовьте каталог и сеть
Создайте каталог проекта, затем сеть Docker, общую для NPM и публикуемых сервисов:
sudo install -d -o "$USER" -g "$USER" /opt/npm
docker network create proxyШаг 3: напишите файл Compose
nano /opt/npm/compose.yamlservices:
npm:
image: jc21/nginx-proxy-manager:2.17.0
container_name: nginx-proxy-manager
restart: unless-stopped
ports:
- "80:80"
- "443:443"
- "127.0.0.1:81:81"
environment:
TZ: "Europe/Paris"
volumes:
- ./data:/data
- ./letsencrypt:/etc/letsencrypt
networks:
- proxy
networks:
proxy:
external: true| Элемент | Назначение |
|---|---|
127.0.0.1:81:81 |
Делает интерфейс доступным только с самого сервера |
./data |
База SQLite, ключи приложения, конфигурация хостов и журналы |
./letsencrypt |
Сертификаты и закрытые ключи |
proxy |
Сеть, через которую NPM обращается к вашим сервисам |
Шаг 4: запустите NPM
cd /opt/npm
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs -f npmПри первом запуске инициализируется база данных и создаются ключи, что может занять несколько минут. Выйдите из журналов сочетанием Ctrl+C, затем проверьте порты:
sudo ss -ltnp | grep -E ':(80|81|443) 'Порт 81 должен отображаться только на 127.0.0.1.
Шаг 5: проверьте брандмауэр
Docker публикует порты 80 и 443 по собственным правилам, которые применяются раньше правил UFW. Поэтому эти два порта доступны даже без ufw allow, и UFW не может их ограничить. Именно поэтому порт 81 нужно ограничивать в compose.yaml, а не в UFW. Подробнее это описано в руководстве Настройка брандмауэра UFW.
Если вы используете встроенный брандмауэр вашего экземпляра, разрешите порты 80 и 443 также в личном кабинете.
Шаг 6: создайте учётную запись администратора
С вашего компьютера откройте SSH-туннель и оставьте этот терминал открытым:
ssh -N -L 8181:127.0.0.1:81 ВАШ_ПОЛЬЗОВАТЕЛЬ@IP_ВАШЕГО_СЕРВЕРАЗатем откройте в браузере http://127.0.0.1:8181. Трафик проходит через зашифрованный туннель.
NPM покажет экран Welcome! для создания учётной записи. Заполните Full Name, Email address и Password (не менее 8 символов, но выберите длинный и уникальный пароль), затем подтвердите. Этот адрес электронной почты используется и для регистрации в Let’s Encrypt: укажите действующий.
Названия меню приведены здесь на английском, языке интерфейса по умолчанию. Язык можно изменить в самом интерфейсе.
Затем усильте защиту установки:
- Откройте меню вашей учётной записи в правом верхнем углу, затем Two-Factor Auth. Включите двухфакторную аутентификацию и сохраните резервные коды.
- В Settings откройте Default Site и выберите No Response (444). Запросы, не соответствующие ни одному из ваших имён, больше не будут получать страницу приветствия.
Шаг 7: опубликуйте сервис
Создайте тестовый сервис, подключённый к сети proxy. Он не публикует на сервере ни одного порта:
sudo install -d -o "$USER" -g "$USER" /opt/whoami
nano /opt/whoami/compose.yamlservices:
whoami:
image: traefik/whoami:v1.12.0
restart: unless-stopped
networks:
- proxy
networks:
proxy:
external: truecd /opt/whoami
docker compose up -dВ NPM откройте Hosts, затем Proxy Hosts и нажмите Add Proxy Host. На вкладке Details:
| Поле | Значение |
|---|---|
| Domain Names | app.ваш-домен.com |
| Scheme | http |
| Forward Hostname / IP | whoami |
| Forward Port | 80 |
| Access List | Publicly Accessible |
| Block Common Exploits | Включено |
Имя whoami — это имя службы Compose, а 80 — её порт внутри контейнера. Включите Websockets Support, если он нужен вашему приложению. Подключайте к сети proxy только доверенные сервисы: внутри этой сети они могут обращаться к порту 81 NPM.
На вкладке SSL:
- В SSL Certificate выберите Request a new Certificate.
- Включите Force SSL и HTTP/2 Support.
- Оставьте Use DNS Challenge выключенным: проверка проходит через порт 80.
Нажмите Save. Включайте HSTS Enabled только тогда, когда уверены, что это имя всегда будет работать по HTTPS: браузеры запоминают этот выбор.
NPM ежечасно проверяет сертификаты и продлевает те, срок действия которых истекает менее чем через 30 дней.
Проверка результата
С сервера или с вашего компьютера:
curl -I http://app.ваш-домен.com
curl -I https://app.ваш-домен.com
echo | openssl s_client -connect app.ваш-домен.com:443 -servername app.ваш-домен.com 2>/dev/null | openssl x509 -noout -issuer -datesHTTP-запрос должен вернуть перенаправление на HTTPS, а HTTPS-запрос — код 200. Издателем сертификата должен быть Let’s Encrypt.
С вашего компьютера порт администрирования не должен отвечать:
curl -m 5 http://IP_ВАШЕГО_СЕРВЕРА:81Ограничение доступа к сервису
В разделе Access Lists нажмите Add Access List:
- В Details задайте имя списка. Оставьте Satisfy Any выключенным, чтобы требовалось выполнение всех условий, и Pass Auth to Upstream выключенным.
- В Authorizations добавьте имя пользователя и пароль.
- В Rules добавьте правило Allow с
ВАШ_IP. Как только появляется хотя бы одно правило, NPM добавляет в конецdeny all.
Сохраните список, затем выберите его в поле Access List у Proxy Host.
Доступ к интерфейсу по доменному имени
SSH-туннель остаётся самым безопасным вариантом. Если вы предпочитаете доменное имя, разместите интерфейс за NPM и ограничьте его вашим IP-адресом:
- Создайте запись A для
npm.ваш-домен.comбез записи AAAA. Подключение по IPv6 может прийти с адресом шлюза Docker и будет отклонено. - Создайте список доступа, содержащий только правило Allow
ВАШ_IP, без пользователя: сам интерфейс NPM использует заголовокAuthorization. - Создайте Proxy Host
npm.ваш-домен.comпоhttpна127.0.0.1, порт81, с этим списком доступа. - Во вкладке SSL запросите сертификат и включите Force SSL.
Сохраните публикацию 127.0.0.1:81:81: она позволит вернуться через SSH-туннель в случае ошибки. Если ваш IP-адрес часто меняется, лучше использовать частную сеть с WireGuard или Tailscale.
Обновление
Сначала прочитайте примечания к выпуску. Например, версия 2.17.0 обновляет Certbot и может нарушить работу некоторых плагинов DNS. Затем создайте резервную копию NPM, измените тег образа в compose.yaml и выполните:
cd /opt/npm
docker compose pull
docker compose up -d
docker compose logs --tail 50 npmЗатем проверьте вход в интерфейс и доступность ваших сервисов.
Резервное копирование и восстановление
Всё находится в /opt/npm: файл compose.yaml, data и letsencrypt. Остановите NPM на время создания архива, чтобы получить согласованную базу SQLite:
cd /opt/npm
docker compose stop
sudo tar -czf /root/npm-$(date +%F).tar.gz -C /opt npm
sudo chmod 600 /root/npm-$(date +%F).tar.gz
docker compose startЭтот архив содержит закрытые ключи: скопируйте его за пределы сервера в зашифрованное хранилище. Если вы настроили проверку через DNS, в нём могут также находиться ваши учётные данные API.
Чтобы восстановить архив, подставьте вместо ГГГГ-ММ-ДД его дату и создайте сеть, если её ещё нет на этом сервере:
cd /opt/npm 2>/dev/null && docker compose down
sudo tar -xzf /root/npm-ГГГГ-ММ-ДД.tar.gz -C /opt
docker network create proxy
cd /opt/npm
docker compose up -dЕсли что-то пошло не так
Общие журналы выводятся командой docker compose logs --tail 100 npm из каталога /opt/npm. Журналы каждого Proxy Host находятся в /opt/npm/data/logs/ в виде proxy-host-1_access.log и proxy-host-1_error.log. Читайте их с sudo.
port is already allocated или address already in use
Другая служба занимает порт 80 или 443:
sudo ss -ltnp | grep -E ':(80|443) 'Остановите эту службу, если она больше не нужна, например командой sudo systemctl disable --now nginx.
Address family not supported by protocol
На сервере нет IPv6. Добавьте эту переменную в environment, затем перезапустите командой docker compose up -d:
DISABLE_IPV6: "true"channel 2: open failed: connect failed: Connection refused
SSH-туннель работает, но на порту 81 никто не слушает. NPM ещё запускается или остановился: проверьте docker compose ps и его журналы.
502 Bad Gateway
NPM не может подключиться к сервису. Убедитесь, что контейнер запущен и подключён к сети proxy, а затем что имя и порт Proxy Host указаны верно:
docker network inspect proxy --format '{{range .Containers}}{{.Name}} {{end}}'В Forward Hostname / IP адрес 127.0.0.1 обозначает сам контейнер NPM, а не сервер. Сервис также должен слушать 0.0.0.0 внутри своего контейнера.
Сертификат не выдаётся
Начиная с версии 2.17 интерфейс показывает причину, сообщённую Certbot:
NXDOMAIN: имя ещё не существует в DNS.Timeout during connectилиConnection refused: порт 80 недоступен из Интернета. Проверьте записи A и AAAA, затем брандмауэр вашего экземпляра. Если всё верно, обратитесь в поддержку из личного кабинета.CAA record: запись CAA запрещает Let’s Encrypt.too many certificatesилиtoo many failed authorizations: достигнут лимит Let’s Encrypt. Дождитесь даты, указанной в сообщении.
403 Forbidden на защищённом сервисе
Вашего адреса нет в списке доступа. Сравните его с адресом в журнале доступа Proxy Host, затем исправьте правило.
Вход в приложение зацикливается после добавления пароля
Это конфликт из-за заголовка Authorization, описанный выше. Удалите пользователей из списка доступа и оставьте только правила по IP-адресам.
Цикл перенаправлений
Приложение принудительно включает HTTPS, не распознавая заголовок X-Forwarded-Proto. Включите в приложении параметр «trust proxy» или его аналог. Если домен работает через прокси Cloudflare, установите режим SSL/TLS Full (strict).