Guide Docker Auto-Start/Stop

Système automatique de démarrage et arrêt des conteneurs Docker peu utilisés pour optimiser la RAM.

Architecture

Internet (HTTPS)
    ↓
Nginx (port 443) - Basic Auth
    ↓
Node.js Proxy (port 8890) - Auto-start/stop logic
    ↓
Docker Container (port variable)

Fonctionnement

1. Requête entrante : L'utilisateur accède à https://service.srv759970.hstgr.cloud
2. Nginx : Vérifie basic auth, puis proxifie vers port 8890
3. Node.js Proxy :
4. Vérifie si conteneurs running avec docker ps
5. Si arrêtés :
   • Mode Dynamic → Affiche page d'attente HTML (auto-refresh 3s)
   • Mode Blocking → Attend silencieusement (pour APIs)
   • Lance docker-compose start
6. Si running : Proxifie directement vers le conteneur
7. Idle checker (toutes les minutes) :
8. Si aucune requête depuis 30 min → docker-compose stop

Installation

Prérequis

• ✅ Node.js installé
• ✅ Docker et Docker Compose
• ✅ Nginx avec HTTPS/SSL configuré

Fichiers du système

/opt/docker-autostart/
├── server.js                   # Serveur Express (proxy + auto-start)
├── config.json                 # Configuration des services
├── package.json                # Dépendances npm
└── themes/                     # Pages d'attente HTML
    ├── hacker-terminal.html
    ├── ghost.html
    ├── matrix.html
    └── shuffle.html

Configuration d'un nouveau service

1. Ajouter dans config.json

{
  "port": 8890,
  "idleTimeout": 1800,
  "services": {
    "votreservice.srv759970.hstgr.cloud": {
      "name": "Nom Affiché",
      "composeDir": "/opt/chemin-vers-service",
      "proxyPort": 8080,
      "theme": "hacker-terminal",
      "containers": ["nom-conteneur"]
    }
  }
}

Paramètres : - name : Nom affiché sur la page d'attente - composeDir : Chemin absolu vers le dossier docker-compose.yml - proxyPort : Port du conteneur à proxifier - theme : Page d'attente (hacker-terminal, ghost, matrix, shuffle) - containers : Liste des noms de conteneurs (cf. container_name: dans docker-compose) - blocking : (optionnel) true pour mode API (pas de page d'attente)

2. Modifier docker-compose.yml

Important : Changer la restart policy :

services:
  votreservice:
    # ...
    restart: "no"  # ← Obligatoire pour auto-start

Recréer les conteneurs :

cd /opt/votreservice
docker-compose down
docker-compose up -d
docker-compose stop

3. Configurer Nginx

Exemple pour un site web (mode Dynamic) :

server {
    listen 443 ssl http2;
    server_name votreservice.srv759970.hstgr.cloud;

    ssl_certificate /etc/letsencrypt/live/votreservice.srv759970.hstgr.cloud/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/votreservice.srv759970.hstgr.cloud/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;

    # Basic Auth (optionnel)
    include snippets/basic-auth.conf;

    location / {
        proxy_pass http://127.0.0.1:8890;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_read_timeout 300;
        client_max_body_size 100M;
    }
}

server {
    listen 80;
    server_name votreservice.srv759970.hstgr.cloud;
    return 301 https://$host$request_uri;
}

Pour une API (mode Blocking), ajouter "blocking": true dans config.json.

4. Redémarrer le service

systemctl restart docker-autostart
nginx -t && systemctl reload nginx

Services configurés

Modes d'opération

Mode Dynamic (Sites web)

• Affiche une page d'attente pendant le démarrage (~15-20s)
• Auto-refresh toutes les 3 secondes
• Thèmes disponibles : hacker-terminal, ghost, matrix, shuffle
• Utilisation : Sites web, dashboards, admin panels

Mode Blocking (APIs)

• Attend silencieusement que les conteneurs démarrent
• Timeout : 30 secondes
• Pas de page d'attente (meilleur pour les API clients)
• Utilisation : APIs REST, services backend

Commandes utiles

Service systemd

# Statut
systemctl status docker-autostart

# Logs en temps réel
journalctl -u docker-autostart -f

# Redémarrer
systemctl restart docker-autostart

# Arrêter/Démarrer
systemctl stop docker-autostart
systemctl start docker-autostart

Debug

# Vérifier la config
cat /opt/docker-autostart/config.json | jq

# Tester manuellement (arrêter systemd avant)
systemctl stop docker-autostart
cd /opt/docker-autostart && node server.js

# Vérifier conteneurs arrêtés
docker ps -a | grep -E "(support|sharepoint|cristina|tika|solidarlink|clemence|whisper)"

# Forcer arrêt des conteneurs pour test
cd /opt/votreservice && docker-compose stop

Tester l'auto-start

# 1. Arrêter le conteneur
cd /opt/support-dashboard && docker-compose stop

# 2. Accéder à l'URL
curl -I https://dashboard.srv759970.hstgr.cloud

# 3. Vérifier les logs
journalctl -u docker-autostart -n 20 --no-pager

Thèmes des pages d'attente

hacker-terminal

• Fond noir avec gradient vert radial
• Texte vert phosphorescent style terminal
• Effet scanlines + CRT monitor
• Parfait pour : Sites techniques, outils dev

ghost

• Fond sombre avec animation de fantômes flottants
• Couleurs violettes/roses
• Effet mystérieux et élégant
• Parfait pour : Sites créatifs, portfolios

matrix

• Effet pluie de caractères Matrix
• Fond noir, caractères verts qui tombent
• Animation constante
• Parfait pour : APIs, services backend

shuffle

• Cartes qui se mélangent avec animation
• Coloré et dynamique
• Effet ludique
• Parfait pour : Dashboards, outils analytics

Personnalisation

Créer un nouveau thème

1. Créer /opt/docker-autostart/themes/montheme.html
2. Utiliser les placeholders :
3. {{SERVICE_NAME}} : Remplacé par le nom du service
4. {{DISPLAY_NAME}} : Alias de SERVICE_NAME
5. Ajouter auto-refresh :

   <meta http-equiv="refresh" content="3" />
   

6. Référencer dans config.json :

   "theme": "montheme"
   

Modifier le timeout d'inactivité

Éditer /opt/docker-autostart/config.json :

{
  "idleTimeout": 3600,  // 60 minutes au lieu de 30
  // ...
}

Puis redémarrer :

systemctl restart docker-autostart

Troubleshooting

Problème : Page d'attente ne s'affiche pas

Diagnostic :

journalctl -u docker-autostart -n 50 --no-pager

Solutions : - Vérifier que Nginx proxifie vers port 8890 - Vérifier le service tourne : systemctl status docker-autostart - Vérifier config.json valide : cat /opt/docker-autostart/config.json | jq

Problème : Conteneurs redémarrent automatiquement

Cause : Restart policy incorrecte dans docker-compose.yml

Solution :

cd /opt/votreservice
grep 'restart:' docker-compose.yml  # Doit afficher "no"
# Si ce n'est pas le cas :
sed -i 's/restart: unless-stopped/restart: "no"/g' docker-compose.yml
docker-compose down && docker-compose up -d && docker-compose stop

Problème : Conteneurs ne démarrent pas

Vérifier :

# Nom des conteneurs dans config.json
cat /opt/docker-autostart/config.json | jq '.services["votreservice.srv759970.hstgr.cloud"].containers'

# Nom réel des conteneurs
docker ps -a --format '{{.Names}}' | grep votreservice

Les noms doivent correspondre exactement (cf. container_name: dans docker-compose.yml).

Problème : 502 Bad Gateway après démarrage

Cause : Conteneurs pas encore prêts après docker-compose start

Solution : - Ajouter un healthcheck dans docker-compose.yml - Augmenter le délai d'attente dans server.js (waitForReady) - Pour les sites lents, utiliser mode Dynamic au lieu de Blocking

Optimisation RAM

Avant auto-start

RAM utilisée : 7.1GB / 8GB (89%)

Après auto-start (conteneurs arrêtés)

RAM utilisée : 2.4GB / 8GB (30%)
Économie : 4.7GB (66%)

Services concernés

• Support Dashboard : ~300MB
• SharePoint Dashboards : ~300MB
• Cristina Admin (Strapi) : ~400MB
• Tika API : ~800MB
• SolidarLink (WordPress) : ~200MB
• Clémence (WordPress) : ~200MB
• Whisper API (faster-whisper) : ~400MB
• WhisperX API : ~500MB

Total économisé : ~3.1GB de RAM quand tous arrêtés

Sécurité

Basic Auth

Tous les services sont protégés par basic auth Nginx. Les credentials sont dans /etc/nginx/.htpasswd.

Exposition des ports

Le proxy Node.js écoute uniquement sur 127.0.0.1:8890 (localhost), pas accessible depuis l'extérieur.

Accès Docker socket

Le service systemd tourne en tant que root pour accéder à Docker socket (/var/run/docker.sock).

Maintenance

Backup de la configuration

# Backup config
cp /opt/docker-autostart/config.json /opt/docker-autostart/config.json.backup

# Versionner dans Git (recommandé)
cd /opt/docker-autostart
git init
git add .
git commit -m "Configuration auto-start"

Mise à jour du serveur Node.js

# Éditer server.js
nano /opt/docker-autostart/server.js

# Test syntaxe
node -c /opt/docker-autostart/server.js

# Redémarrer
systemctl restart docker-autostart

Limites actuelles

Non supporté

• ❌ Ollama : Service systemd (pas Docker), nécessite approche différente
• ❌ MySQL shared : Doit rester actif (utilisé par plusieurs WordPress)
• ❌ Portainer/Dozzle/Netdata : Services de monitoring, doivent rester actifs

À venir

• Support Ollama via systemd socket activation
• Healthchecks personnalisables par service
• Notifications (email/webhook) au démarrage/arrêt
• Dashboard web pour voir l'état des services
• Métriques de démarrage/arrêt (logs structurés)

Liens utiles

• Documentation Sablier : https://sablierapp.dev (inspiration pour les thèmes)
• Node.js Express : https://expressjs.com
• Docker Compose : https://docs.docker.com/compose/
• Systemd : https://www.freedesktop.org/software/systemd/man/systemd.service.html