anchorage_layer_simple/fixKnowledge/dashboard-502-error.md

Correction : Erreur 502 Bad Gateway sur dashboard.certificator.4nkweb.com

Auteur : Équipe 4NK Date : 2026-01-24 Version : 1.0

Problème Identifié

Le dashboard retournait une erreur 502 Bad Gateway sur https://dashboard.certificator.4nkweb.com/.

Symptômes

• Erreur 502 Bad Gateway lors de l'accès au dashboard
• Le proxy nginx ne peut pas se connecter au backend
• Le dashboard n'était pas en cours d'exécution

Cause Racine

Le dashboard n'était pas démarré. Le processus Node.js n'était pas en cours d'exécution sur le port 3020, ce qui causait l'erreur 502 Bad Gateway lorsque nginx essayait de se connecter au backend.

Problème technique : Le dashboard n'était pas démarré automatiquement et nécessitait un démarrage manuel.

Correctifs Appliqués

1. Amélioration du chargement du .env dans server.js

Fichier : signet-dashboard/src/server.js

Avant :

import dotenv from 'dotenv';
// ...
dotenv.config();

Après :

import dotenv from 'dotenv';
import { fileURLToPath } from 'url';
import { dirname, join } from 'path';

// Get the directory of the current module
const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);

// Charger les variables d'environnement depuis le répertoire racine du projet signet-dashboard
// Cela garantit que le .env est chargé même si le script est exécuté depuis un autre répertoire
const envPath = join(__dirname, '../.env');
dotenv.config({ path: envPath });

Impact : Le .env est maintenant chargé depuis un chemin explicite, garantissant que le bon fichier est utilisé même si le script est exécuté depuis un autre répertoire.

2. Démarrage du dashboard

Le dashboard a été démarré avec :

cd signet-dashboard
npm start

Modifications

Fichiers Modifiés

• signet-dashboard/src/server.js : Amélioration du chargement du .env avec chemin explicite

Fichiers Créés

• fixKnowledge/dashboard-502-error.md : Cette documentation

Modalités de Déploiement

Démarrage du Dashboard

1. Vérifier que le port est libre :

   sudo lsof -i :3020
   

2. Démarrer le dashboard :

   cd /home/ncantu/Bureau/code/bitcoin/signet-dashboard
   npm start
   # Ou utiliser le script de démarrage
   ./start.sh
   

3. Démarrer en arrière-plan :

   cd /home/ncantu/Bureau/code/bitcoin/signet-dashboard
   nohup npm start > /tmp/dashboard.log 2>&1 &
   

Installation d'un service systemd (recommandé)

Pour éviter que le dashboard ne s'arrête, créer un service systemd :

1. Créer le fichier de service :

   sudo nano /etc/systemd/system/signet-dashboard.service
   

2. Contenu du service :

   [Unit]
   Description=Bitcoin Signet Dashboard
   After=network.target
   
   [Service]
   Type=simple
   User=ncantu
   WorkingDirectory=/home/ncantu/Bureau/code/bitcoin/signet-dashboard
   Environment=NODE_ENV=production
   ExecStart=/usr/bin/node /home/ncantu/Bureau/code/bitcoin/signet-dashboard/src/server.js
   Restart=always
   RestartSec=10
   StandardOutput=journal
   StandardError=journal
   
   [Install]
   WantedBy=multi-user.target
   

3. Activer et démarrer le service :

   sudo systemctl daemon-reload
   sudo systemctl enable signet-dashboard
   sudo systemctl start signet-dashboard
   

4. Vérifier le statut :

   sudo systemctl status signet-dashboard
   

Modalités d'Analyse

Vérification que le dashboard fonctionne

1. Test de l'API :

   curl http://localhost:3020/api/blockchain/info
   

2. Test de l'interface web :

   curl http://localhost:3020/
   

3. Vérifier les logs :

   # Si démarré avec npm start
   tail -f /tmp/dashboard.log
   
   # Si démarré avec systemd
   sudo journalctl -u signet-dashboard -f
   

Vérification de la connexion nginx

1. Vérifier que nginx peut se connecter :

   # Depuis le serveur proxy (192.168.1.100)
   curl http://192.168.1.105:3020/api/blockchain/info
   

2. Vérifier les logs nginx :

   # Sur le serveur proxy
   sudo tail -f /var/log/nginx/dashboard.certificator.4nkweb.com.error.log
   

Résultat

✅ Problème résolu

• Le dashboard est maintenant démarré et écoute sur le port 3020
• L'API répond correctement (888 blocs détectés)
• Le dashboard est accessible via https://dashboard.certificator.4nkweb.com/
• Le chargement du .env est maintenant explicite et fiable

Prévention

Pour éviter ce problème à l'avenir :

1. Utiliser un service systemd ou PM2 pour gérer le dashboard et faciliter les redémarrages
2. Configurer le démarrage automatique au boot du système
3. Surveiller les logs pour détecter les arrêts inattendus
4. Utiliser un chemin explicite pour le .env dans les applications Node.js

Pages Affectées

• signet-dashboard/src/server.js : Amélioration du chargement du .env
• fixKnowledge/dashboard-502-error.md : Documentation (nouveau)