Nginx Proxy Manager na VPS: recenzja i przewodnik konfiguracji

NPM kontra Caddy kontra Traefik: które reverse proxy pasuje do Twojego VPS

Te trzy narzędzia różnią się według czterech osi, które decydują o wyborze: jak je konfigurujesz, jak obsługują HTTPS, jak skalują się wraz z liczbą usług i ile RAM zużywają w spoczynku. Oto porównanie.

Wartości RAM w spoczynku to przybliżone obserwacje z jednego porównania z 2026 roku, a nie stałe wymagania. Rzeczywiste zużycie zależy od wersji obrazu, włączonych funkcji, ruchu i rejestrowania.

Kryteria wyboru wynikają bezpośrednio z tej tabeli. Jeśli chcesz mieć panel i prowadzisz kilka usług, które nie zmieniają się często, NPM to właściwe narzędzie. Jeśli preferujesz konfigurację jako kod, chcesz najmniejszego zużycia zasobów lub cenisz sobie automatyczne wystawianie i odnawianie HTTPS w Caddy bez konfiguracji ACME, użyj Caddy. Sam sięgam po Caddy przy wdrożeniach pojedynczych witryn, ponieważ obsługa SSL jest automatyczna, a Caddyfile krótki. Jeśli często dodajesz, usuwasz lub ponownie wdrażasz kontenery, oparte na etykietach automatyczne wykrywanie w Traefik oznacza, że przestajesz ręcznie rejestrować każdy nowy host.

Istnieje również czysty Nginx z Certbot, który niektórzy administratorzy wolą ze względu na precyzyjną kontrolę lub wdrożenia bez Dockera. Certbot może zautomatyzować odnawianie certyfikatów, ale nadal samodzielnie zarządzasz routingiem hostów wirtualnych i konfiguracją Nginx. Jeśli głównym powodem rozważania NPM jest unikanie ręcznej konfiguracji proxy, czysty Nginx raczej nie będzie lepszym wyborem.

Jedna uwaga co do wyboru: porównanie byte-guard wskazuje Caddy jako najlżejszą opcję w tym zestawieniu, a dla świeżej konfiguracji z jednym hostem w 2026 roku to rozsądny wybór. Caddy wygrywa lekkością nad NPM, ale jeśli zależy Ci konkretnie na GUI, nie jest to najlepszy wybór.

Aby uzyskać dokładniejsze zestawienie leżących u podstaw silników, zobacz porównanie Caddy kontra Nginx na VPS.

Wymagania wstępne: czego będziesz potrzebować

Przed wdrożeniem przygotuj poniższe. To krótka lista, ale pominięcie którejkolwiek pozycji spowoduje później niepowodzenie kroku z certyfikatem.

• VPS z zainstalowanym Docker i Docker Compose (Ubuntu 22.04 LTS lub Debian 12 są odpowiednie).
• Nazwę domeny, z rekordem DNS A (oraz AAAA, jeśli używasz IPv6) wskazującym na publiczny adres IP Twojego VPS.
• Dostęp SSH do VPS.
• Porty 80 i 443 otwarte na internet w Twojej zaporze.
• Port 81 osiągalny wyłącznie przez Ciebie, nieotwarty publicznie (omówione w sekcji o bezpieczeństwie).

Konfiguracja Nginx Proxy Manager na Twoim VPS przy użyciu Docker Compose

Ta sekcja wdraża NPM przy użyciu Docker Compose. Gdy Twoje rekordy DNS rozwiązują się do VPS, sama konfiguracja kontenera przebiega szybko, choć propagacja DNS i wystawienie certyfikatu mogą potrwać dłużej.

Konfiguracja wykorzystuje jeden plik Docker Compose oraz jednorazowe polecenie tworzące współdzieloną sieć Docker. Utwórz katalog, utwórz sieć, dodaj poniższy docker-compose.yml plik i uruchom kontener.

Najpierw utwórz współdzieloną sieć Docker:

docker network create proxy

Następnie utwórz poniższy docker-compose.yml plik:

# docker-compose.yml
services:
  npm:
    image: 'jc21/nginx-proxy-manager:<PATCHED_VERSION>'
    restart: unless-stopped
    ports:
      - '80:80'                 # public HTTP
      - '443:443'               # public HTTPS
      - '127.0.0.1:81:81'       # admin UI, reachable only from the VPS itself
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt
    networks:
      - proxy
networks:
  proxy:
    external: true

Podłącz każdy kontener backendowy, do którego NPM musi docierać po nazwie usługi, do tej samej zewnętrznej sieci proxy . Pozwala to NPM rozwiązywać kontener po jego nazwie usługi bez publikowania portu aplikacji backendowej na VPS.

Wykonaj kopię zapasową obu ./data oraz ./letsencrypt przed aktualizacjami. Katalog danych zawiera bazę danych NPM i wygenerowaną konfigurację, natomiast katalog Let's Encrypt zawiera materiał certyfikatów.

Kilka słów o tym pliku. Obraz domyślnie korzysta z bazy danych SQLite przechowywanej w woluminie ./data . To domyślny backend i jest poprawny dla większości wdrożeń na pojedynczym VPS. Jeśli potrzebujesz zewnętrznej bazy danych, NPM obsługuje MariaDB/MySQL oraz PostgreSQL, co oznacza dodanie usługi bazy danych i odpowiadających jej zmiennych środowiskowych. Dla pojedynczego VPS SQLite pozostaje najprostszym domyślnym rozwiązaniem, chyba że masz wyraźny powód, aby przenieść bazę danych poza wolumin danych. Zasada restart: unless-stopped oznacza, że NPM wraca do działania po ponownym uruchomieniu VPS, co jest pożądane dla usługi znajdującej się przed wszystkim innym.

Uruchom go i potwierdź, że działa:

docker compose up -d
docker compose ps

Oczekiwane dane wyjściowe: kontener npm ze stanem Up, porty 80 i 443 zmapowane publicznie oraz port 81 powiązany wyłącznie z 127.0.0.1. Pierwsze uruchomienie zajmuje kilka minut, podczas gdy NPM generuje klucz JWT, inicjalizuje bazę danych i tworzy domyślnego użytkownika administratora. Oficjalna dokumentacja konfiguracji opisuje tę sekwencję pierwszego uruchomienia.

Utwórz tunel SSH z lokalnego komputera przed otwarciem interfejsu administracyjnego:

ssh -L 8181:127.0.0.1:81 user@your-vps

Następnie otwórz http://127.0.0.1:8181 w przeglądarce. Przy świeżej instalacji zaloguj się przy użyciu [email protected] oraz changeme, a następnie natychmiast zmień domyślny adres e-mail i hasło. Nie udostępniaj panelu publicznie, dopóki aktywne są domyślne poświadczenia.

Po zmianie poświadczeń administratora dodaj swój pierwszy host proxy:

1. W panelu przejdź do Hosts, następnie Proxy Hosts, następnie Add Proxy Host.
2. Ustaw Domain Name na swoją subdomenę (na przykład cloud.example.com).
3. Ustaw Forward Hostname / IP na nazwę lub IP kontenera backendowego, oraz Forward Port na port, na którym nasłuchuje.
4. Zapisz. Host proxy pojawia się na liście, a ruch do tej subdomeny dociera teraz do Twojego kontenera.

Jeśli obok tego prowadzisz interfejs zarządzania Docker, obowiązuje ten sam wzorzec: skieruj subdomenę na narzędzie do zarządzania kontenerami w ten sam sposób i zrób to samo dla stosem monitorującym Prometheus i Grafana które ma znajdować się za proxy.

Konfiguracja automatycznego HTTPS dla subdomeny

Ta sekcja zapewnia Ci ważny, automatycznie odnawiany certyfikat Let's Encrypt dla Twojej subdomeny. Warunkiem wstępnym, który zaskakuje wiele osób, jest to, że rekord DNS A dla tej subdomeny musi już wskazywać na Twój VPS, a port 80 musi być osiągalny z internetu, ponieważ Let's Encrypt weryfikuje domenę, łącząc się z nią z powrotem.

Po utworzeniu hosta proxy poproś o certyfikat:

1. Edytuj host proxy, otwórz zakładkę SSL karta.
2. Pod Certyfikat SSL, wybierz Request a new SSL Certificate.
3. Włącz Force SSL oraz HTTP/2 Support. Włącz HSTS dopiero po potwierdzeniu, że HTTPS działa poprawnie, ponieważ przeglądarki mogą buforować tę politykę i utrudnić naprawę po błędzie certyfikatu lub konfiguracji proxy.
4. Zaakceptuj warunki Let's Encrypt i zapisz.

Domyślnie NPM używa wyzwania HTTP-01 dla nazw bez symboli wieloznacznych, walidując każdą żądaną nazwę hosta przez port 80. Certyfikat może zawierać wiele nazw bez symboli wieloznacznych, ale HTTP-01 nie może wystawiać certyfikatów wieloznacznych. Nazwy wieloznaczne, takie jak *.example.com wymagają wyzwania DNS-01 z obsługiwanym dostawcą DNS. Dla zwykłej konfiguracji z jedną subdomeną na usługę wystarcza HTTP-01, a odnowienia są automatyczne.

Dobór rozmiaru VPS pod Nginx Proxy Manager

Sam NPM jest lekki; kwestia doboru rozmiaru dotyczy tak naprawdę NPM wraz z usługami działającymi za nim. Zużycie proxy w spoczynku rzadko stanowi ograniczenie. Instancja Nextcloud lub blog Ghost zużyją więcej zasobów niż samo proxy.

Oto jak poziomy sprawdzają się w praktyce:

• Minimalny praktyczny poziom bazowy: 1 GB RAM, 1 vCPU i 10 GB pamięci masowej. Jeden przewodnik doboru rozmiaru firmy zewnętrznej korzysta z tego samego poziomu bazowego, ale traktuj go jako wskazówkę do planowania, a nie oficjalne wymaganie NPM. Wystarcza dla NPM, systemu operacyjnego i kilku lekkich usług, ale pozostawia ograniczony zapas.
• Komfortowo: 2 GB RAM, 1 vCPU, 20 GB pamięci masowej. NPM plus trzy do pięciu usług z zapasem miejsca. To złoty środek dla większości osób hostujących samodzielnie.
• Wyższy poziom: 4 GB RAM, 2 vCPU. Dla ośmiu do dwunastu usług lub konfiguracji ze znaczącym ruchem, gdzie potrzebujesz zapasu CPU na zakończenie TLS.

Wartość, względem której dobierasz rozmiar, to suma proxowanych aplikacji, a nie NPM. Zsumuj zużycie RAM usług, które zamierzasz uruchomić, dodaj niewielki narzut proxy w spoczynku i wybierz poziom wyższy z zapasem.

Dobór rozmiaru serwera to najprostsza część. Uruchomienie NPM nadal oznacza przygotowanie VPS, instalację Dockera, pobranie obrazu i przejście przez konfigurację pierwszego uruchomienia. Jeśli wolisz pominąć kroki przygotowawcze, marketplace Cloudzy oferuje wdrożenie Nginx Proxy Manager jednym kliknięciem na VPS z NVMe. Uruchamia kontener na świeżym serwerze, dzięki czemu przechodzisz od razu do panelu i swojego pierwszego hosta proxy. Tak czy inaczej, powyższe poziomy rozmiaru są tym, względem czego przygotowujesz zasoby.

Często zadawane pytania