Configuration Docker Auto-Start/Stop

Vue d'ensemble

Le système d'auto-start/stop automatique est un proxy Node.js custom qui gère le démarrage/arrêt automatique des services Docker en fonction de l'activité. Il remplace l'ancien système Sablier.

Emplacement : /opt/docker-autostart/ Port : 8890 Configuration : /opt/docker-autostart/config.json Timeout d'inactivité : 1800 secondes (30 minutes) Services configurés : 22

Services configurés

Tableau récapitulatif

Détails des paramètres

1. Mode Dynamic vs Blocking

Dynamic Mode (défaut)

• Comportement : Affiche une page d'attente animée pendant le démarrage
• Utilisation : Sites web, dashboards, applications UI
• Services : SolidarLink, Clémence, Support Dashboard, SharePoint, Cristina, MemVid UI
• Thèmes disponibles :
• matrix - Animation Matrix (pluie de caractères verts)
• ghost - Fantômes flottants avec effets de particules
• hacker-terminal - Terminal de hacking avec commandes simulées
• shuffle - Cartes qui se mélangent et se révèlent
• cyberpunk - Grille néon avec effet glitch
• synthwave - Grille rétro années 80

Blocking Mode ("blocking": true)

• Comportement : Démarre le service AVANT de répondre à la requête (pas de page d'attente)
• Utilisation : APIs qui doivent répondre immédiatement
• Services : Tika API, Whisper API, WhisperX API, MemVid API, RAGFlow, RAG-Anything
• Avantage : Le client reçoit directement la réponse API (pas d'HTML intermédiaire)

2. Paramètres de configuration

port (global)

"port": 8890

idleTimeout (global)

"idleTimeout": 1800

composeDir (par service)

Répertoire contenant le docker-compose.yml du service.

composeFile (optionnel)

Nom du fichier compose si différent de docker-compose.yml. Exemple : RAGFlow utilise docker-compose-full.yml.

proxyPort (par service)

Port du service Docker vers lequel le proxy redirige après démarrage.

containers (par service)

Liste des conteneurs Docker à surveiller pour détecter l'état du service.

Configuration Nginx

Chaque service configuré utilise un bloc upstream et proxy_pass dans Nginx :

upstream docker-autostart-solidarlink {
    server 127.0.0.1:8890;
}

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

    location / {
        proxy_pass http://docker-autostart-solidarlink;
        proxy_set_header Host $host;
        proxy_set_header X-Autostart-Target "solidarlink.srv759970.hstgr.cloud";
    }
}

Le header X-Autostart-Target permet au proxy d'identifier quel service démarrer.

Commandes de gestion

Vérifier l'état du proxy

systemctl status docker-autostart

Redémarrer le proxy

systemctl restart docker-autostart

Consulter les logs

journalctl -u docker-autostart -f

Modifier la configuration

nano /opt/docker-autostart/config.json
systemctl restart docker-autostart

Tester un service

curl -I https://dashboard.srv759970.hstgr.cloud
# Le service démarre automatiquement

Synchronisation dynamique

Ce document peut être mis à jour automatiquement depuis la configuration serveur.

Script de mise à jour

Utiliser le script scripts/sync-autostart-config.sh pour synchroniser :

./scripts/sync-autostart-config.sh

Ce script : 1. Récupère /opt/docker-autostart/config.json depuis le serveur 2. Génère automatiquement le tableau récapitulatif 3. Met à jour cette documentation 4. Commit les changements si nécessaire

Architecture technique

Internet → Nginx (443) → docker-autostart (8890) → Service Docker (port spécifique)
                ↓
           X-Autostart-Target header
                ↓
        1. Check service status
        2. Start containers if stopped
        3. Wait for healthcheck
        4. Proxy request to service

Flux Dynamic Mode

1. Requête arrive sur Nginx
2. Nginx redirige vers docker-autostart:8890
3. Proxy détecte service arrêté
4. Renvoie immédiatement page d'attente HTML avec thème
5. JavaScript dans la page poll /status toutes les 2 secondes
6. Démarre les conteneurs Docker en arrière-plan
7. Quand healthcheck OK → JavaScript redirige vers le service

Flux Blocking Mode

1. Requête arrive sur Nginx
2. Nginx redirige vers docker-autostart:8890
3. Proxy détecte service arrêté
4. Démarre les conteneurs et ATTEND le healthcheck
5. Une fois prêt → Proxy la requête vers le service
6. Client reçoit directement la réponse API

Références

• Guide complet : GUIDE_DOCKER_AUTOSTART.md
• Code source : /opt/docker-autostart/index.js
• Systemd service : /etc/systemd/system/docker-autostart.service
• Inventory complet : server-configs/INVENTORY.md

Dernière synchronisation : 2025-10-21 Config serveur : /opt/docker-autostart/config.json Total services : 22 (incluant stack collaboration: Nextcloud, ONLYOFFICE, Rocket.Chat, Jitsi Meet)