FR

Applications

Installer Nginx Proxy Manager

Installer Nginx Proxy Manager avec Docker sur Debian ou Ubuntu, garder son interface hors d'Internet, publier un service en HTTPS, restreindre les accès, mettre à jour et sauvegarder.

10 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

Vos valeurs

Renseignez-les une fois, les commandes du guide se mettent à jour.

Nginx Proxy Manager (NPM) est un reverse proxy basé sur Nginx, piloté depuis une interface web. Il reçoit les visiteurs sur les ports 80 et 443, demande les certificats Let’s Encrypt et transmet les requêtes à vos services, sans que vous ayez à écrire de configuration Nginx.

À la fin du guide, NPM fonctionne dans Docker et son interface d’administration n’est accessible que par un tunnel SSH. Un service de test répond sur https://app.votre-domaine.com, et vous savez restreindre un accès, mettre à jour NPM et sauvegarder ses données.

La version utilisée est 2.17.0, la dernière version stable au moment de la rédaction, en novembre 2026.

Commander un serveur

Ce guide s’applique aux serveurs que vous administrez vous-même :

Prérequis

  • Un serveur sous Debian 12 ou 13, ou Ubuntu 22.04 ou 24.04, en architecture amd64 ou arm64
  • Un accès SSH avec un utilisateur disposant de sudo et membre du groupe docker
  • Docker Engine et Docker Compose, installés avec le guide Installer Docker Engine et Docker Compose
  • Un nom de domaine dont vous gérez la zone DNS
  • Aucun autre logiciel sur les ports 80 et 443, comme Nginx, Apache, Caddy ou Traefik

Ports utilisés

Port Sens Rôle À ouvrir
80/tcp Entrant Validation Let’s Encrypt et redirection vers HTTPS Oui
443/tcp Entrant Sites publiés en HTTPS Oui
81/tcp Local Interface d’administration, sur 127.0.0.1 Non

Étape 1 : faire pointer le domaine vers le serveur

Créez un enregistrement A pour app.votre-domaine.com vers VOTRE_IP_SERVEUR. Si votre domaine est géré chez HostMyServers, suivez le guide Créer un enregistrement A.

Vérifiez ensuite le résultat depuis le serveur :

Terminal
sudo apt update
sudo apt install -y bind9-dnsutils
dig +short A app.votre-domaine.com
dig +short AAAA app.votre-domaine.com

La première commande doit renvoyer l’adresse de votre serveur. Si la seconde renvoie une adresse IPv6, elle doit aussi correspondre à ce serveur. Dans le cas contraire, supprimez cet enregistrement AAAA.

Étape 2 : préparer le dossier et le réseau

Créez le dossier du projet, puis un réseau Docker partagé entre NPM et les services à publier :

Terminal
sudo install -d -o "$USER" -g "$USER" /opt/npm
docker network create proxy

Étape 3 : écrire le fichier Compose

Terminal
nano /opt/npm/compose.yaml
YAML
services:
  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
Élément Rôle
127.0.0.1:81:81 Rend l’interface accessible uniquement depuis le serveur
./data Base SQLite, clés de l’application, configuration des hôtes et journaux
./letsencrypt Certificats et clés privées
proxy Réseau par lequel NPM joint vos services

Étape 4 : démarrer NPM

Terminal
cd /opt/npm
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs -f npm

Le premier démarrage initialise la base de données et génère les clés, ce qui peut prendre quelques minutes. Quittez les journaux avec Ctrl+C puis contrôlez les ports :

Terminal
sudo ss -ltnp | grep -E ':(80|81|443) '

Le port 81 doit apparaître uniquement sur 127.0.0.1.

Étape 5 : vérifier le pare-feu

Docker publie les ports 80 et 443 avec ses propres règles, appliquées avant celles d’UFW. Ces deux ports sont donc joignables même sans ufw allow, et UFW ne peut pas les restreindre. C’est pour cette raison que le port 81 doit être limité dans compose.yaml, et non dans UFW. Le guide Configurer le pare-feu UFW détaille ce fonctionnement.

Si vous utilisez le firewall intégré de votre instance, autorisez aussi les ports 80 et 443 depuis votre espace client.

Étape 6 : créer le compte administrateur

Depuis votre poste, ouvrez un tunnel SSH et laissez ce terminal ouvert :

Terminal
ssh -N -L 8181:127.0.0.1:81 VOTRE_USER@VOTRE_IP_SERVEUR

Ouvrez ensuite http://127.0.0.1:8181 dans votre navigateur. Le trafic passe dans le tunnel chiffré.

NPM affiche un écran Welcome! de création du compte. Renseignez Full Name, Email address et Password (8 caractères au minimum, mais choisissez-en un long et unique), puis validez. Cette adresse e-mail sert aussi à l’inscription auprès de Let’s Encrypt : indiquez-en une valide.

Les menus sont cités ici en anglais, langue par défaut de l’interface. Vous pouvez en changer depuis l’interface.

Renforcez ensuite l’installation :

  1. Ouvrez le menu de votre compte, en haut à droite, puis Two-Factor Auth. Activez la double authentification et conservez les codes de secours.
  2. Dans Settings, ouvrez Default Site et choisissez No Response (444). Les requêtes qui ne correspondent à aucun de vos noms ne recevront plus de page d’accueil.

Étape 7 : publier un service

Créez un service de test relié au réseau proxy. Il ne publie aucun port sur le serveur :

Terminal
sudo install -d -o "$USER" -g "$USER" /opt/whoami
nano /opt/whoami/compose.yaml
YAML
services:
  whoami:
    image: traefik/whoami:v1.12.0
    restart: unless-stopped
    networks:
      - proxy

networks:
  proxy:
    external: true
Terminal
cd /opt/whoami
docker compose up -d

Dans NPM, ouvrez Hosts, puis Proxy Hosts, et cliquez sur Add Proxy Host. Dans l’onglet Details :

Champ Valeur
Domain Names app.votre-domaine.com
Scheme http
Forward Hostname / IP whoami
Forward Port 80
Access List Publicly Accessible
Block Common Exploits Activé

Le nom whoami est celui du service Compose, et 80 son port dans le conteneur. Activez Websockets Support si votre application en a besoin. Ne reliez au réseau proxy que des services de confiance : ils peuvent joindre le port 81 de NPM à l’intérieur de ce réseau.

Dans l’onglet SSL :

  1. Dans SSL Certificate, choisissez Request a new Certificate.
  2. Activez Force SSL et HTTP/2 Support.
  3. Laissez Use DNS Challenge désactivé : la validation passe par le port 80.

Cliquez sur Save. N’activez HSTS Enabled qu’une fois sûr de garder ce nom en HTTPS : les navigateurs mémorisent ce choix.

NPM vérifie chaque heure les certificats et renouvelle ceux qui expirent dans moins de 30 jours.

Vérifier le résultat

Depuis le serveur ou votre poste :

Terminal
curl -I http://app.votre-domaine.com
curl -I https://app.votre-domaine.com
echo | openssl s_client -connect app.votre-domaine.com:443 -servername app.votre-domaine.com 2>/dev/null | openssl x509 -noout -issuer -dates

La requête HTTP doit renvoyer une redirection vers HTTPS, et la requête HTTPS un code 200. L’émetteur du certificat doit être Let’s Encrypt.

Depuis votre poste, le port d’administration ne doit pas répondre :

Terminal
curl -m 5 http://VOTRE_IP_SERVEUR:81

Restreindre l’accès à un service

Dans Access Lists, cliquez sur Add Access List :

  1. Dans Details, donnez un nom à la liste. Laissez Satisfy Any désactivé pour exiger toutes les conditions, et Pass Auth to Upstream désactivé.
  2. Dans Authorizations, ajoutez un nom d’utilisateur et un mot de passe.
  3. Dans Rules, ajoutez une règle Allow avec VOTRE_IP. NPM ajoute un deny all final dès qu’une règle existe.

Enregistrez, puis sélectionnez cette liste dans le champ Access List du Proxy Host.

Accéder à l’interface par un nom de domaine

Le tunnel SSH reste la solution la plus sûre. Si vous préférez un nom de domaine, placez l’interface derrière NPM et limitez-la à votre adresse IP :

  1. Créez un enregistrement A pour npm.votre-domaine.com, sans enregistrement AAAA. Une connexion en IPv6 peut arriver avec l’adresse de la passerelle Docker et serait refusée.
  2. Créez une liste d’accès contenant uniquement la règle Allow VOTRE_IP, sans utilisateur : l’interface de NPM utilise elle-même l’en-tête Authorization.
  3. Créez un Proxy Host npm.votre-domaine.com en http vers 127.0.0.1, port 81, avec cette liste d’accès.
  4. Dans SSL, demandez un certificat et activez Force SSL.

Gardez la publication 127.0.0.1:81:81 : elle vous permet de revenir par le tunnel SSH en cas d’erreur. Si votre adresse IP change souvent, préférez un réseau privé avec WireGuard ou Tailscale.

Mettre à jour

Lisez d’abord les notes de version. La version 2.17.0 met par exemple à jour Certbot et peut casser certains plugins DNS. Sauvegardez ensuite NPM, modifiez le tag de l’image dans compose.yaml, puis exécutez :

Terminal
cd /opt/npm
docker compose pull
docker compose up -d
docker compose logs --tail 50 npm

Vérifiez ensuite la connexion à l’interface et l’accès à vos services.

Sauvegarder et restaurer

Tout se trouve dans /opt/npm : le fichier compose.yaml, data et letsencrypt. Arrêtez NPM le temps de l’archive pour obtenir une base SQLite cohérente :

Terminal
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

Cette archive contient des clés privées : copiez-la hors du serveur dans un emplacement chiffré. Si vous avez configuré une validation DNS, elle peut aussi contenir vos identifiants d’API.

Pour restaurer l’archive, en remplaçant AAAA-MM-JJ par sa date, créez le réseau s’il n’existe pas encore sur ce serveur :

Terminal
cd /opt/npm 2>/dev/null && docker compose down
sudo tar -xzf /root/npm-AAAA-MM-JJ.tar.gz -C /opt
docker network create proxy
cd /opt/npm
docker compose up -d

En cas de problème

Les journaux généraux s’affichent avec docker compose logs --tail 100 npm, depuis /opt/npm. Ceux de chaque Proxy Host se trouvent dans /opt/npm/data/logs/, sous la forme proxy-host-1_access.log et proxy-host-1_error.log. Lisez-les avec sudo.

port is already allocated ou address already in use

Un autre service occupe le port 80 ou 443 :

Terminal
sudo ss -ltnp | grep -E ':(80|443) '

Arrêtez ce service s’il n’est plus utile, par exemple avec sudo systemctl disable --now nginx.

Address family not supported by protocol

Le serveur n’a pas d’IPv6. Ajoutez cette variable dans environment, puis relancez avec docker compose up -d :

YAML
DISABLE_IPV6: "true"

channel 2: open failed: connect failed: Connection refused

Le tunnel SSH fonctionne, mais rien n’écoute sur le port 81. NPM démarre encore ou s’est arrêté : vérifiez docker compose ps et ses journaux.

502 Bad Gateway

NPM ne joint pas le service. Vérifiez que le conteneur est démarré, qu’il est relié au réseau proxy, puis que le nom et le port du Proxy Host sont exacts :

Terminal
docker network inspect proxy --format '{{range .Containers}}{{.Name}} {{end}}'

Dans Forward Hostname / IP, 127.0.0.1 désigne le conteneur NPM lui-même, et non le serveur. Le service doit aussi écouter sur 0.0.0.0 dans son conteneur.

Le certificat n’est pas délivré

Depuis la version 2.17, l’interface affiche la raison donnée par Certbot :

  • NXDOMAIN : le nom n’existe pas encore dans le DNS.
  • Timeout during connect ou Connection refused : le port 80 n’est pas joignable depuis Internet. Vérifiez les enregistrements A et AAAA, puis le firewall de votre instance. Si tout est correct, contactez le support depuis votre espace client.
  • CAA record : un enregistrement CAA interdit Let’s Encrypt.
  • too many certificates ou too many failed authorizations : une limite de Let’s Encrypt est atteinte. Attendez la date indiquée dans le message.

403 Forbidden sur un service protégé

Votre adresse n’est pas dans la liste d’accès. Comparez-la à celle inscrite dans le journal d’accès du Proxy Host, puis corrigez la règle.

La connexion à l’application boucle après l’ajout d’un mot de passe

C’est le conflit sur l’en-tête Authorization décrit plus haut. Retirez les utilisateurs de la liste d’accès et gardez uniquement les règles d’adresses IP.

Boucle de redirections

L’application force HTTPS sans reconnaître l’en-tête X-Forwarded-Proto. Activez l’option « trust proxy » ou son équivalent dans l’application. Si le domaine passe par le proxy de Cloudflare, réglez le mode SSL/TLS sur Full (strict).

Références