Установка Nginx Proxy Manager на Ubuntu 24.04

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску

Nginx Proxy Manager — веб-панель, которая превращает VDS в «входную дверь» для всех ваших сайтов и панелей: принимает запросы по доменным именам, раздаёт их нужным программам и сама получает и продлевает сертификаты Let's Encrypt. Править файлы настроек Nginx руками не нужно — всё делается в браузере. В статье — установка на VDS с Ubuntu 24.04, первый вход и публикация сайта по доменному имени с HTTPS. Всё проверено 17 ноября 2026 года на Ubuntu 24.04.4 с Nginx Proxy Manager 2.17.0; снимки экрана сняты с настоящего сервера.

Когда он нужен

На одном VDS часто живёт несколько программ с веб-интерфейсом: сайт проекта, панель мониторинга, панель управления контейнерами. Каждая слушает свой порт — 8080, 3001, 9443 — и работает без шифрования или с самоподписанным сертификатом. Nginx Proxy Manager решает это так:

Без него С ним
http://203.0.113.10:8080 https://site.example.com
http://203.0.113.10:3001 https://status.example.com
Сертификаты получать и продлевать вручную Получает и продлевает сам
Наружу открыто по порту на каждую программу Наружу открыты только 80 и 443

Если вам ближе настройка через файлы, то же самое делается обычным Nginx: Настройка Nginx веб-сервера и Настройка SSL сертификатов (Let's Encrypt).

Что понадобится

  • VDS с Ubuntu 24.04 LTS и установленным Docker — Установка и настройка Docker. Сам Nginx Proxy Manager занимает 100–150 МБ памяти; хватит младшего тарифа VDS, если остальным программам на нём тоже хватает.
  • Свободные порты 80 и 443. Если на VDS уже работает Nginx или Apache, они эти порты заняли — остановите их или ставьте Nginx Proxy Manager на другой VDS.
  • Доменное имя, запись A которого указывает на IP-адрес VDS. Для каждой программы — своё имя или поддомен: site.example.com, status.example.com.

1. Установка

sudo mkdir -p /opt/npm && cd /opt/npm
sudo nano compose.yaml
services:
  npm:
    image: jc21/nginx-proxy-manager:latest
    container_name: nginx-proxy-manager
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
      - "81:81"
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt
sudo docker compose up -d
sudo docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}" | grep -E "NAMES|nginx-proxy" | cut -c1-108
sudo ss -lntp | grep -E ":(80|81|443) " | awk '{print $1, $4}'

Порт Зачем
80, 443 Сайты: обычный и шифрованный доступ. Должны быть открыты всем
81 Сама панель управления. Открывайте только своему адресу
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow from ВАШ_IP to any port 81 proto tcp
sudo ufw enable

Замечание о файрволе: порты, опубликованные контейнером, Docker открывает в обход правил ufw, поэтому порт 81 фактически доступен всем, пока вы не ограничите его в самом файле Compose. Чтобы панель была доступна только с самого сервера и через SSH-туннель, замените строку на "127.0.0.1:81:81". Подробности — раздел «Docker обходит файрвол» статьи Установка и настройка Docker.

2. Первый вход

Откройте в браузере http://203.0.113.10:81, подставив адрес своего VDS. При первом входе панель просит создать администратора:

Укажите имя, адрес почты (он же будет именем для входа) и пароль. Сделайте это сразу после установки: пока администратор не создан, эту страницу видит каждый, кто откроет порт 81.

Язык панели переключается в правом верхнем углу — русский есть. После входа открывается обзор:

3. Сайт по доменному имени

Откройте «Хосты» → «Прокси-хосты» → «Добавить прокси-хост». Прокси-хост — это правило «запросы на такое-то имя передавать такой-то программе».

Поле Что указать
Домены Имя, по которому должен открываться сайт: site.example.com. После ввода нажмите Enter
Схема Как программа отвечает сама: обычно http. https — если у неё свой сертификат (например, Portainer на порту 9443)
Целевой хост Где работает программа — см. ниже
Целевой порт Порт программы: 8080, 3001 и так далее
Блокировать известные эксплойты Включите
Поддержка WebSocket Включите для панелей, которые обновляются на лету: Uptime Kuma, Portainer, игровые панели

Какой целевой хост указать. Nginx Proxy Manager работает в контейнере, поэтому 127.0.0.1 для него — он сам, а не ваш VDS:

Где программа Целевой хост
На этом же VDS, порт опубликован (обычная программа или контейнер с ports:) 172.17.0.1 — адрес VDS со стороны Docker
На другом сервере IP-адрес того сервера
В контейнере, подключённом к той же сети Docker, что и Nginx Proxy Manager Имя контейнера

4. Сертификат

Перейдите на вкладку «SSL» того же окна:

1. В списке «SSL-сертификат» выберите запрос нового сертификата Let's Encrypt.

2. Включите «Всегда SSL» — запросы по HTTP будут сами перенаправляться на HTTPS — и «Поддержка HTTP/2».

3. Нажмите «Сохранить». Панель получит сертификат (это занимает до минуты) и включит сайт. Продлевать сертификат она будет сама.

Условия, при которых сертификат выдаётся: доменное имя уже указывает на этот VDS, а порт 80 открыт всем. Если сертификат на это имя у вас уже есть, его можно загрузить вместо запроса нового: «Сертификаты» → «Добавить сертификат» → свой сертификат — понадобятся файлы сертификата (fullchain.pem) и ключа (privkey.pem).

Готовое правило появляется в списке:

А сертификат — в разделе «Сертификаты», со сроком действия:

5. Проверка

curl -sI http://wikitest.ark-hoster.ru/ | grep -E "^HTTP|^Location"
curl -sI https://wikitest.ark-hoster.ru/ | grep -E "^HTTP|^server"
echo | openssl s_client -connect wikitest.ark-hoster.ru:443 -servername wikitest.ark-hoster.ru 2> /dev/null | openssl x509 -noout -subject -issuer -enddate
curl -s https://wikitest.ark-hoster.ru/ | grep -o "<title>[^<]*"

Подставьте своё доменное имя. Что должно получиться, по строкам: запрос по HTTP перенаправляется на HTTPS (код 301); по HTTPS сайт отвечает кодом 200; сертификат выдан на ваше имя организацией Let's Encrypt и ещё не истёк; открывается именно та страница, которую отдаёт программа за прокси, — на проверке это была стартовая страница веб-сервера из контейнера на порту 8080.

После этого порт самой программы (8080 в примере) наружу больше не нужен — закройте его, чтобы сайт открывался только через Nginx Proxy Manager.

6. Ещё полезное

Раздел панели Для чего
Редирект-хосты Перенаправление с одного имени на другое: с www.example.com на example.com, со старого домена на новый
Потоки Проброс не сайтов, а «сырых» портов TCP и UDP на другой сервер
404-хосты Имена, на которые нужно отвечать «не найдено»
Списки доступа Ограничение сайта по паролю или по IP-адресам — например, закрыть панель мониторинга от посторонних. Список выбирается в окне прокси-хоста
Журнал аудита Кто и что менял в панели

7. Резервная копия и обновление

Настройки, учётные записи и сертификаты лежат в каталогах data и letsencrypt:

cd /opt/npm
sudo docker compose stop
sudo tar -czf /root/npm-backup-$(date +%F).tar.gz -C /opt/npm data letsencrypt compose.yaml
sudo docker compose start
ls -lh /root/npm-backup-*.tar.gz
sudo docker compose pull
sudo docker compose up -d

Последние две команды — обновление. Пока контейнер остановлен, все сайты за ним недоступны, поэтому копию и обновление делайте в часы, когда посетителей меньше.

Что не проверено

Проверены: установка, создание администратора, прокси-хост для доменного имени с перенаправлением на HTTPS, работа сайта по HTTPS с настоящим сертификатом Let's Encrypt, страницы панели, резервная копия и команды обновления. Сертификат при проверке был не запрошен из панели, а загружен готовый — недельный предел Let's Encrypt на тестовое доменное имя был исчерпан; сам запрос из панели и автоматическое продление не проверялись. Прокси-хост создавался через программный интерфейс панели — тем же действием, что и кнопка «Сохранить». Не проверены: списки доступа, редирект-хосты и потоки.

Если что-то пошло не так

Что видите Причина и решение
Контейнер не запускается, «address already in use» grep -E ":(80|443) ". Остановите его
Сертификат не выдаётся Доменное имя не указывает на этот VDS (dig +short имя), закрыт порт 80, либо исчерпан предел запросов Let's Encrypt — тогда подождите или проверьте, нет ли опечатки в имени
«502 Bad Gateway» Nginx Proxy Manager не достучался до программы: неверный целевой хост или порт, программа не запущена, либо указан 127.0.0.1 вместо 172.17.0.1
Страница открывается, но панель «не оживает», данные не обновляются Не включена «Поддержка WebSocket» в прокси-хосте
Бесконечное перенаправление Программа за прокси сама перенаправляет на HTTPS. Поменяйте схему назначения на https или отключите перенаправление в программе
Забыт пароль администратора Порядок сброса описан в документации Nginx Proxy Manager; восстановить панель можно и из резервной копии

Для размещения ваших проектов рекомендуем услуги ARK-HOSTER.RU: