Documentation

Démarrage rapide + description des fonctionnalités module par module et appareil par appareil (mise à jour continue)

Questions fréquentes (FAQ)

Cet article regroupe les problèmes les plus courants rencontrés lors de l'utilisation du panneau et leurs méthodes de diagnostic.

Installation et connexion

Q: Quelles sont les conditions requises pour installer le panneau ?

Un serveur Linux doté d'une IP publique (de préférence une distribution majeure comme Debian / Ubuntu / CentOS), avec au moins 512 Mo de mémoire pour fonctionner de façon fluide. Les serveurs gérés n'ont besoin de rien installer : il suffit qu'ils soient joignables en SSH.

Q: Quels sont le compte et le mot de passe par défaut ?

Compte par défaut admin, mot de passe 123456. Modifiez-les immédiatement après la première connexion (icône d'utilisateur en haut à droite du panneau → Paramètres utilisateur).

Q: J'ai oublié mon mot de passe de connexion, que faire ?

Si vous l'avez modifié et oublié, vous pouvez le réinitialiser sur le serveur du panneau. Exécutez la commande suivante pour revenir au mot de passe par défaut (ou définir un nouveau mot de passe) :

# Entrez dans le répertoire d'installation du panneau et utilisez le script intégré pour réinitialiser le mot de passe
cd /opt/ssh-everywhere
python3 -c "from app import reset_password; reset_password('nouveau-mot-de-passe')"

> Le nom exact du script peut changer selon les versions ; vous pouvez aussi modifier directement la table users de la base de données data/ssheverywhere.db.

Q: Comment modifier le port du panneau (5501) ?

Modifiez Environment=PORT=5501 dans le service systemd, puis rechargez :

systemctl edit ssh-everywhere.service
# Ajoutez ou modifiez : Environment=PORT=votre-port
systemctl daemon-reload && systemctl restart ssh-everywhere.service

Pensez à ouvrir le nouveau port dans le pare-feu cloud / le groupe de sécurité.

Q: Impossible d'accéder au panneau (port 5501) ?

Diagnostiquez dans l'ordre :

1. Vérifiez que le service du panneau tourne : systemctl status ssh-everywhere.service

2. Vérifiez si le pare-feu cloud / groupe de sécurité du serveur du panneau autorise le port 5501 (c'est la cause la plus fréquente)

3. Vérifiez que l'adresse d'accès est bien http://IP-publique-du-serveur:5501 (pas https, sauf si vous avez configuré un proxy inverse)

À propos des serveurs

Q: Le serveur apparaît « hors ligne », que faire ?

« Hors ligne » signifie seulement que le panneau ne parvient pas à s'y connecter en SSH, cela ne veut pas dire que le serveur est en panne. Diagnostiquez dans l'ordre :

1. Vérifiez que le serveur est bien allumé : consultez l'état d'alimentation dans la console du fournisseur

2. Testez la joignabilité du port SSH : depuis le serveur du panneau, exécutez nc -zv <IP cible> <port> pour voir si le port répond

3. Vérifiez le pare-feu / groupe de sécurité : le pare-feu cloud / groupe de sécurité du serveur cible autorise-t-il le port SSH ?

4. Pour un serveur NAT, vérifiez le mappage de port : assurez-vous que le mappage de port NAT existe toujours et que l'IP interne cible est correcte

5. Vérifiez la liste blanche d'IP source : certains fournisseurs restreignent l'accès au port SSH par IP source ; ajoutez alors l'IP du serveur du panneau à la liste blanche

6. Vérifiez le compte et le mot de passe : nom d'utilisateur, mot de passe/clé privée corrects ?

Q: Impossible de se connecter lors de l'ajout d'un serveur ?

  • Vérifiez que le port SSH, le nom d'utilisateur et le mot de passe sont corrects
  • Vérifiez que sshd tourne sur le serveur cible
  • Vérifiez que le pare-feu autorise le port SSH
  • Les grands clouds (Tencent Cloud/Alibaba Cloud) désactivent root par défaut : connectez-vous avec un utilisateur standard (par ex. ubuntu)

Q: Impossible de se connecter à un serveur NAT (port autre que 22) ?

Le mappage de port du serveur NAT doit être joignable depuis le réseau du serveur du panneau. Causes fréquentes :

  • Le mappage de port n'est plus valide (vérifiez/reconstruisez-le dans la console du fournisseur)
  • Le fournisseur applique une liste blanche d'IP sources (ajoutez l'IP du serveur du panneau)
  • L'IP/le port interne cible du mappage est mal renseigné

À propos du tunnel de ports / de la redirection

Q: Le tunnel de ports affiche « hors ligne » ?

  • Le tunnel dépend de l'Agent en ligne. Si l'Agent est hors ligne (appareil éteint, réseau coupé, Agent arrêté), le tunnel est interrompu
  • Après un redémarrage du service du panneau, le tunnel se rétablit automatiquement à la reconnexion de l'Agent : patientez un instant
  • Vérifiez que le pare-feu cloud du serveur du panneau autorise le port d'écoute

Q: La redirection d'un port autre que 22 ne fonctionne pas ?

Rediriger un port autre que SSH (par ex. 9117) exige que le serveur à percer ait la nouvelle version de l'Agent (l'ancienne ne prend en charge que le 22). Réinstallez l'Agent.

Q: La redirection de port est créée mais ne fonctionne pas ?

La redirection de ports classique doit être réalisée sur la machine même d'un serveur disposant de sa propre IP publique. Vérifiez :

1. Le serveur cible / le pare-feu intermédiaire autorise-t-il le port cible ?

2. L'IP cible renseignée est-elle bien une adresse réellement joignable ?

3. Le groupe de sécurité cloud bloque-t-il le port d'écoute ?

Q: Quelle est la différence entre le tunnel de ports et la redirection de ports ?

  • Tunnel de ports : pour les appareils sans IP publique, passe par le tunnel inverse et ouvre un port public sur le serveur du panneau.
  • Redirection de ports : pour les serveurs avec IP publique, passe par le DNAT du pare-feu système et s'effectue sur le serveur cible lui-même.

Voir en détail Tunnel de ports et Redirection de ports.

À propos de Docker / de l'installation d'applications

Q: L'installation depuis le Catalogue d'applications/Docker échoue, que faire ?

Le panneau affiche fidèlement le message d'erreur (il ne fait jamais croire à un faux succès). Causes fréquentes :

1. Distribution trop ancienne : sur des versions en fin de vie comme Fedora 32, les dépôts logiciels ne sont plus maintenus et l'installation expire ou échoue. Il est conseillé de mettre le système à niveau.

2. Réseau injoignable : le dépôt officiel Docker (get.docker.com / download.docker.com) peut être inaccessible dans certains environnements réseau (par ex. serveurs NAT en Chine continentale). Il faut alors configurer un miroir Docker régional, ou utiliser la fonction « Miroirs » pour basculer vers une source Alibaba Cloud.

3. Différences de noms de paquets : certaines applications (comme ufw, ou deb.nodesource pour Node.js) dépendent d'une distribution particulière et peuvent ne pas s'installer hors Debian/Ubuntu ; le message d'erreur l'indique clairement.

Q: Le téléchargement d'images Docker est très lent ou expire sur un serveur en Chine continentale ?

C'est un problème de réseau, pas de panneau. Il est conseillé de configurer un accélérateur de miroir Docker (accélérateurs publics comme docker.1ms.run / docker.m.daocloud.io), ou d'exécuter d'abord sur le serveur :

# Référence : configurer l'accélérateur personnel Alibaba Cloud (à remplacer par votre adresse d'accélérateur)
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<'EOF'
{ "registry-mirrors": ["https://votre-adresse-accelerateur"] }
EOF
sudo systemctl restart docker

Techniques de diagnostic générales

1. Testez d'abord si le port répond, puis vérifiez le compte et le mot de passe : nc -zv <IP> <port>

2. Comparez avec d'autres serveurs : si les serveurs du même type se connectent et que celui-ci non, le problème est propre à cette machine (pare-feu/mappage/liste blanche)

3. Consultez les journaux : les journaux du panneau se trouvent dans service.log ; les journaux de tunnel/Agent aident à localiser les problèmes de connexion