Img-ssh-proxy/doc/REDEMARRAGE_QUICK_REFERENCE.md

🔄 REDÉMARRAGE — Quick reference

🚀 Scénarios courants

Scénario 1: Arrêter et relancer (code modifié)

# 1. Arrêter les conteneurs
docker compose down

# 2. Supprimer l'entrée host (important!)
ssh-keygen -f ~/.ssh/known_hosts -R "[localhost]:2222"

# 3. Relancer
docker compose up -d

# 4. Tester
ssh -p 2222 -i keys/lab_rsa testuser@localhost 'hostname'

Scénario 2: Reconstruire les images (Dockerfile modifié)

# 1. Arrêter et supprimer les conteneurs
docker compose down

# 2. Supprimer l'entrée host
ssh-keygen -f ~/.ssh/known_hosts -R "[localhost]:2222"

# 3. Reconstruire les images
docker compose build --no-cache

# 4. Relancer
docker compose up -d

# 5. Tester
ssh -p 2222 -i keys/lab_rsa testuser@localhost 'hostname'

Scénario 3: Hard reset complet (tout supprimer)

# 1. Arrêter et supprimer tout
docker compose down -v

# 2. Supprimer les images (optionnel)
docker rmi build_sshproxy_gordon-gateway build_sshproxy_gordon-dest1 build_sshproxy_gordon-dest2

# 3. Supprimer l'entrée host
ssh-keygen -f ~/.ssh/known_hosts -R "[localhost]:2222"

# 4. Relancer
docker compose up -d

# 5. Tester
ssh -p 2222 -i keys/lab_rsa testuser@localhost 'hostname'

---

⚠️ ERREUR COURANTE: Host key changed

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

Cause: Container recréé avec nouvelle clé d'hôte

Solution rapide (3 options):

Option 1: Nettoyer l'entrée (RECOMMANDÉ)

ssh-keygen -f ~/.ssh/known_hosts -R "[localhost]:2222"

Option 2: Supprimer tout known_hosts

rm ~/.ssh/known_hosts
# Attention: perd aussi les autres entrées!

Option 3: Ignorer la vérification (PAS RECOMMANDÉ)

ssh -o StrictHostKeyChecking=no -p 2222 testuser@localhost

---

🔑 Clés SSH perdues?

Si vous avez supprimé les fichiers dans keys/:

# Régénérer les clés
.\init-keys.ps1

# Reconstruire les images
docker compose build --no-cache

# Relancer
docker compose down -v
docker compose up -d

---

📊 Commandes utiles

# Voir l'état des conteneurs
docker ps

# Voir les logs en direct
docker compose logs -f gateway

# Voir les logs sshproxy
docker exec sshproxy-gateway tail -f /tmp/sshproxy-testuser.log

# Arrêter proprement
docker compose down

# Arrêter et supprimer tout (volumes, images, etc.)
docker compose down -v

# Tester une commande
ssh -p 2222 -i keys/lab_rsa testuser@localhost 'echo "OK"'

# Tester le round-robin
for i in {1..5}; do ssh -p 2222 -i keys/lab_rsa testuser@localhost hostname; done

---

✅ Checklist redémarrage

☐ docker compose down
☐ ssh-keygen -f ~/.ssh/known_hosts -R "[localhost]:2222"
☐ docker compose up -d
☐ Attendre 2-3 secondes
☐ ssh -p 2222 testuser@localhost 'hostname'
☐ Voir dest1 ou dest2 ✓

---

🆘 Ça ne marche pas?

1. Vérifier docker ps:

   docker ps
   # Doivent être RUNNING: sshproxy-gateway, sshproxy-dest1, sshproxy-dest2
   

2. Vérifier les logs:

   docker compose logs gateway
   

3. Vérifier la clé lab_rsa:

   ls -la keys/lab_rsa
   # Doit exister
   

4. Vérifier known_hosts:

   ssh-keygen -f ~/.ssh/known_hosts -R "[localhost]:2222"
   

5. Reconstruire complètement:

   docker compose down -v
   docker compose build --no-cache
   docker compose up -d
   

---

Besoin d'aide? Voir SETUP_INITIAL.md