NPM on Docker Lab

Page de maintenance Web

Sun, 26 Jul 2026 00:00:00 +0000

Introduction

Parfois, il est necessaire d’arrêter certains services pour effectuer des travaux divers. Nous allons utiliser une image docker basique pour afficher une page de maintenance configurable dans un fichier compose.yaml.

Il suffira dans NPM de rediriger votre domaine en maintenance vers cette page le temps de vos travaux.

Pour cette installation j’utilise cette image qui est présente ici : Simple maintenance page

Le fichier compose.yaml

Voici le fichier compose.yaml à deposer dans le répertoire contenant vos piles (par exemple /opt/docker/projects/) ou à coller dans votre interface de gestion (autre que Arcane).


services:
  maintenance:
    image: wickerlabs/maintenance
    container_name: maintenance
    environment:
      HEADLINE: "Maintenance serveur...."
      TEAM_NAME: "Yannick Informatik"
      TITLE: "Oops!"
      MAIL_ADDRESS: "contact@yannickinformatik.fr"
      LINK_COLOR: "#dc8100"
      THEME: "Light"
      PORT: 8080
      RESPONSE_CODE: "503 Service Unavailable"
      MESSAGE: "16 Juillet 2026 - Travaux en cours : Changement d'architecture et de moteur de blog..."
      CONTACT_LINK: "contact@yannickinformatik.fr"
    ports:
      - 8100:8080

Vous devrez adapter ce fichier en personnalisant le message affiché et le code HHTP retourné par le serveur. Vous pouvez aussi ajuster le port d’entré (8100 chez moi pour éviter les conflits potentiels sur le port 8080).

Test de la page de maintenance

Sélectionner l’hôte proxy à modifier sur NPM et faite le pointer vers le nouvel hôte sur le port 8100.

Vous devriez tomber sur cette page :

Personnaliser ses logs avec Nginx Proxy Manager

Sun, 26 Jul 2026 00:00:00 +0000

Introduction

Bien que NPM utilise Nginx ; il utilise son propre format de log ; ce qui le rend incompatible avec des outils tiers d’analyse de logs comme “fail2ban”

La personnalisation du format des logs n’est pas possible par l’interface de NPM ; il faudra donc les modifiers via un fichier de configuration accesible via un volume monté dans le fichier compose.yaml de NPM (voir Installation de Nginx Proxy Manager)

Ajout d’un template de log alternatif

Le volume monté “/opt/docker/data/npm” rend accessible les répertoires de configurations de bases de NPM.

Nous allons créer un fichier ‘http_top.conf’ dans le répertoire “nginx/custom” dont le contenu sera le suivant :


log_format nom_log '$remote_addr $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" $host';

Il faudra changer le paramètre “nom_log” à votre convenance. Le template est au format standard ‘Nginx’ ; mais je lui rajoute le parametre ‘$host’ en fin de ligne pour afficher l’URL demandée lors d’une requête au serveur proxy NPM.

Utilisation du log alternatif dans vos hôtes proxy

Pour chacun de vos hôtes proxy pour laquel vous souhaitez personnalisé les fichiers de log, il faudra allez dans la partie “Configuration Nginx personnalisé” et y ajouter la ligne suivante access_log /data/logs/dockerlab.log nom_log;

Remarque : J’ai monté un volume “/data/logs” pour pouvoir générer mes logs en dehors du container Docker pour qu’ils puissent être analyser par dse outils tiers sur mon hôte docker.

Il faut relancer votre container npm pour que les modifications soient prise en compte.

Installation de Nginx Proxy Manager

Thu, 23 Jul 2026 00:00:00 +0000

Introduction

NPM (Nginx Proxy Manager) est une image Docker contenant le proxy inverse ‘Nginx’ et une interface WebUI permettant une configuration simple et convivial du serveur proxy. Il permet entre autres de gérer simplement les cerificats SSL via Let’s Encrypt.

Pour cette installation j’utilise l’image officielle qui est présente ici : NginxProxyManager

Le fichier compose.yaml

Voici le fichier compose.yaml à deposer dans le répertoire contenant vos piles (par exemple /opt/docker/projects/) ou à coller dans votre interface de gestion (Arcane, Dockge, Portainer…).


services:
  app:
    image: 'docker.io/jc21/nginx-proxy-manager:latest'
    restart: unless-stopped
    container_name: npm
    environment:
      - TZ=Europe/Paris    
    ports:
      - 80:80   # Vous pouvez spécifier l'IP de l'Hote ; Par défaut 0.0.0.0
      - 81:81   # Port pour l'interface WebUI
      - 443:443
    volumes:
      - /opt/docker/data/npm:/data
      - /opt/docker/data/log:/data/logs   # Pour analyser les logs en dehors du container
      - /opt/docker/data/npm/letsencrypt:/etc/letsencrypt

Vous devrez adapter ce fichier à votre environnement de travail Docker. J’utilise le chemin /opt/docker/data/mon_container pour tous mes containers docker.

Le volume ‘/opt/docker/data/log’ me permet de visualiser et d’externalyser les logs produits par NPM pour qu’ils puissent être analysés par des outils tiers (fail2ban, reaction… etc).

Remarque : Vous pouvez rajouter l’adresse IP de votre hôte au niveau des ports pour restreindre l’accès à votre seul hôte (exemple : 192.168.x.x:80:80).

Une fois le fichier créer ; déployer l’image soit en ligne de commande : sudo docker compose up -d ; soit via votre interface de gestion.

Vous pouvez maintenant accèder à l’interface de NPM : http://votreip:81

Configuration

1er Lancement

Il faut dans un premier temps créer un compte Administrateur :

Une fois le compte créé, vous arrivez au niveau du tableau de Bord :

Création d’un certificat

NPM gère la création de certificat via Let’s Encrypt. Nous utiliserons comme exemple la méthode via DNS avec l’hébergeur OVH.

Une fois le choix sélectioné, nous arrivons sur l’écran de création du certificat pour votre domaine.

Je choisi mon hébergeur (Provider DNS) et je choisi mon domaine.

Remarque : J’utilise ici un wildcard ‘*’ pour générer un certificat pour tous les sous/sous domaines de mon domaine ‘subdomain.domain.fr’. Le wildcard permet de cacher les services derriere le Proxy et seul les personnes connaissants le lien complet (service.subdomain.domain.fr par exemple) pourront traverser le proxy.

Chaque hébergeur à sa propre procédure de création de certificat et les informations demandées sur l’écran précédant seront différents.

Pour OVH, il faut vous connecter et aller à cette adresse : OVH Creation Token

Vous devez remplir le formulaire tel quel :

Il faut utilisez pour chaque ligne le texte suivant : /domain/zone/*

Vous aurez en retour les 3 Tokens nécessaires à remplacer dans l’écran plus haut au niveau de la zone ‘Credentials File Content:

Application Key
Application Secret
Consumer Key

Une fois cela fait, vous pourrez voir vos certificats au niveau du tableau de bord :

Création d’un hôte proxy

Le hôte proxy permet d’exposer de facon sécurisé votre service interne avec le monde extérieur. Il fait le lien entre une URL externe publique et votre service privé situé derriere votre serveur proxy.

Nous allons créér un hôte proxy en prenant comme exmple le nom de domaine “exemple.subdomain.domain.fr” :

Il vous faudra compléter la zone ‘Forward’ de votre formulaire en ajoutant l’adresse IP de votres service interne, ainsi que son port.

Cocher aussi l’option “Block Common Exploits”

On passe maintenant à l’onglet ‘SSL’ :

Sélectionner le certificat associé à votre domaine et cocher les 4 options.

Une fois la validation du formulaire effectué ; votre service exposé apparaitra dans la liste des Hôtes proxy :

Pour aller plus loin

Nous avons vus l’installation et la configuration de bases de NPM. Pour plus de sécurité et de personnalisations, il est nécessaire parfois de passer par l’édition manuelle des fichiers de configurations quand cela n’est pas possible par l’interface graphique (la personnalisation reste possible, mais est fortement limitée).

Nous verrons cela dans d’autres articles à paraitre sur le blog.