Перейти к содержимому

Статья 97 из 141

Гайды

Nginx Proxy Manager на VPS: обратный прокси и SSL от Let's Encrypt через веб-интерфейс

Nginx Proxy Manager (NPM) — Nginx с веб-интерфейсом. Вы указываете домен и адрес сервиса, а NPM сам пишет конфиг Nginx и получает сертификат Let’s Encrypt. Удобно, если на сервере несколько приложений в Docker и не хочется править конфиги вручную.

Статья проверена на версии 2.17.0 (ноябрь 2026).

Ресурс Минимум
RAM 512 МБ свободной памяти (NPM занимает около 150 МБ)
vCPU 1
Диск 1 ГБ
ПО Docker и Docker Compose
Порты 80 и 443 свободны, 81 для панели

Для каждого сервиса нужен домен или поддомен с A-записью на IP сервера (DNS).

NPM занимает порты 80 и 443. Если на сервере уже работает Nginx, Caddy или Apache, контейнер не запустится с ошибкой address already in use. Выберите что-то одно: либо NPM, либо обычный Nginx с certbot. Проверить, кто слушает порты:

Окно терминала
ss -tlnp | grep -E ':(80|443) '
Окно терминала
mkdir -p /opt/npm && cd /opt/npm
nano docker-compose.yml
services:
app:
image: 'jc21/nginx-proxy-manager:2.17.0'
restart: unless-stopped
ports:
- '80:80'
- '443:443'
- '127.0.0.1:81:81'
environment:
TZ: "Europe/Moscow"
volumes:
- ./data:/data
- ./letsencrypt:/etc/letsencrypt
Окно терминала
docker compose up -d
docker compose logs -f

Первый запуск занимает до минуты: NPM создаёт базу SQLite и ключи. Когда в логе появится строка Backend PID ... listening on port 3000, панель готова. Выйдите из логов по Ctrl+C.

Порт 81 мы привязали к 127.0.0.1, чтобы панель не была видна из интернета. Откройте её через SSH-туннель с вашего компьютера:

Окно терминала
ssh -L 8181:127.0.0.1:81 root@IP_СЕРВЕРА

Затем перейдите в браузере на http://localhost:8181.

В старых версиях NPM создавал пользователя admin@example.com с паролем changeme и просил сменить их при входе. В версии 2.17 этого нет: при первом открытии панель показывает форму Добро пожаловать! и просит сразу создать учётную запись администратора.

Язык интерфейса переключается флажком в правом верхнем углу, русский есть в списке.

Заполните Полное имя, Адрес эл. почты и Новый пароль, нажмите Сохранить. Откроется Обзор со счётчиками прокси-хостов, редиректов и потоков.

Форма создания администратора при первом запуске Nginx Proxy Manager

В меню профиля справа сверху есть пункт Настроить 2FA. Включите двухфакторную аутентификацию сразу.

Допустим, на сервере в Docker работает приложение на порту 8080, а снаружи оно должно открываться как https://app.example.com.

  1. Откройте Хосты → Прокси-хосты и нажмите Добавить Прокси-хост.
  2. На вкладке Сведения заполните поля:
Поле Что указать
Домены app.example.com, затем Enter
Схема http
Целевой хост имя контейнера, если он в одной сети Docker с NPM, или IP сервера в сети Docker
Целевой порт порт приложения внутри контейнера, например 8080
  1. Включите Блокировать известные эксплойты. Для приложений с живыми обновлениями (панели, чаты, редакторы) включите Поддержка WebSocket.

Окно добавления прокси-хоста в Nginx Proxy Manager

  1. Перейдите на вкладку SSL. В поле SSL-сертификат выберите Получить новый сертификат (через Let’s Encrypt).
  2. Включите Всегда SSL, чтобы HTTP перенаправлялся на HTTPS, и Поддержка HTTP/2. Поддержка HSTS включайте, только когда убедитесь, что HTTPS работает стабильно.

Вкладка SSL: запрос нового сертификата Let’s Encrypt

  1. Нажмите Сохранить. NPM запросит сертификат, проверив домен по HTTP через порт 80, и применит конфиг. Хост появится в списке со статусом Онлайн.

Список прокси-хостов: хост в статусе Онлайн

Переключатель Проверка через DNS нужен для сертификатов на *.example.com и для серверов, где порт 80 закрыт. Тогда NPM подтверждает домен через API вашего DNS-провайдера.

Сертификат NPM продлевает сам, ничего настраивать не нужно.

Проще всего держать приложения в одной сети Docker с NPM. Создайте сеть и подключите к ней оба compose-проекта:

Окно терминала
docker network create proxy
networks:
default:
name: proxy
external: true

Этот блок добавьте в конец docker-compose.yml и NPM, и приложения, затем docker compose up -d в обоих каталогах. Теперь в Целевой хост пишите имя сервиса или контейнера, а публиковать порт приложения наружу не нужно.

Список доступа закрывает хост паролем, ограничивает по IP или делает и то и другое.

  1. Откройте Списки доступа и нажмите Добавить Список доступа.
  2. На вкладке Сведения задайте Имя. Переключатель Любое совпадение пускает пользователя, если выполнено хотя бы одно условие (пароль или IP). Без него нужны оба.
  3. На вкладке Авторизации добавьте Имя пользователя и Пароль для HTTP Basic Auth.
  4. На вкладке Правила выберите Разрешить и впишите IP или подсеть, например ваш домашний адрес. После правил NPM сам добавит Запретить all.

Правила списка доступа: разрешить один IP, запретить остальные

  1. Нажмите Сохранить, затем откройте нужный прокси-хост и выберите этот список в поле Список доступа.

Так удобно закрывать админки, у которых нет своей надёжной авторизации.

  • Не публикуйте порт 81 наружу. Если нужен доступ к панели по домену, создайте для неё прокси-хост на 127.0.0.1:81 с сертификатом и списком доступа по вашему IP.
  • В файрволе оставьте открытыми 22, 80 и 443. Учтите, что порты, опубликованные Docker, обходят UFW: публикуйте сервисы только на 127.0.0.1 или вообще без ports, через общую сеть.
  • Включите 2FA для администратора.

В официальном примере версия образа указана явно. Чтобы обновиться, поменяйте тег в docker-compose.yml на новый из списка релизов, затем:

Окно терминала
cd /opt/npm
docker compose pull
docker compose up -d

Всё состояние NPM лежит в двух каталогах:

Каталог Что там
data/database.sqlite база: хосты, пользователи, списки доступа
data/nginx/ сгенерированные конфиги Nginx
data/keys.json ключи подписи сессий
letsencrypt/ сертификаты и аккаунт Let’s Encrypt
Окно терминала
cd /opt/npm
docker compose stop
tar -czf /root/npm-$(date +%F).tar.gz data letsencrypt
docker compose start

Храните копии вне сервера: бэкапы.

Симптом Причина и решение
address already in use при запуске Порт 80 или 443 занят другим веб-сервером. Остановите его или откажитесь от NPM
Ошибка при получении сертификата A-запись домена не указывает на сервер, или порт 80 закрыт файрволом. Проверьте доступность порта
502 Bad Gateway Неверный целевой хост или порт. 127.0.0.1 внутри контейнера NPM указывает на сам NPM, а не на сервер
Не работают живые обновления в приложении Не включена Поддержка WebSocket
Панель на порту 81 не открывается Порт привязан к 127.0.0.1. Используйте SSH-туннель
Ждали вход admin@example.com, а видите форму регистрации В новых версиях администратора создают при первом входе

Если нужен прокси с автоматическими сертификатами без веб-панели, посмотрите Traefik и Caddy. Управлять самими контейнерами через веб можно в Portainer или Dockge.