Connexion

Paramètres → Connexion définit la façon dont ROMKADE Manager joint la console. La première configuration est décrite pas à pas dans Connecter votre console ; cette page en détaille les champs et les modifications ultérieures.

Champs

Champ	Valeur par défaut	Remarques
Adresse IP ou nom	—	Peut changer après un redémarrage de la box : réservez-la dans la box (réservation DHCP).
Port SSH	22
Utilisateur	—	Souvent root sur les firmwares de consoles portables.
Authentification	Mot de passe	Mot de passe ou Clé SSH. Le dernier champ change en conséquence.
Dossier des ROMs	selon le firmware	/mnt/mmc/Roms sur Anbernic. Paramètres → Système propose le dossier trouvé sur la console.

Mot de passe ou clé SSH

• Mot de passe : enregistré avec Enregistrer dans le trousseau (avec Docker, dans le volume de données ; sinon, dans le trousseau du système). Il n'est plus jamais affiché ; Remplacer le mot de passe permet de le changer.

• Clé SSH : saisissez le chemin de la clé privée (par exemple ~/.ssh/id_ed25519 à partir du code source). Sa clé publique doit figurer dans ~/.ssh/authorized_keys sur la console :

  ssh-copy-id -i ~/.ssh/id_ed25519.pub root@192.168.1.42
  

Clé SSH avec Docker

ROMKADE Manager tourne dans un conteneur : il ne voit que son volume de données, pas le dossier ~/.ssh de votre ordinateur. Copiez une fois la clé privée dans le volume, depuis le dossier romkade (macOS, Linux, ou WSL sous Windows) :

docker compose exec -T romkade sh -c 'cat > /data/id_ed25519 && chmod 600 /data/id_ed25519' < ~/.ssh/id_ed25519

Saisissez ensuite /data/id_ed25519 dans Chemin de la clé privée. La clé reste dans le volume, lisible uniquement par le compte du conteneur. Sous Windows sans WSL, le mot de passe est plus simple.

Identité de la console

La clé SSH de la console est vérifiée à chaque connexion. La première fois, vous comparez son empreinte et l'approuvez. Si elle change par la suite, la connexion est bloquée : ROMKADE Manager ne dialogue pas avec un appareil qu'il ne reconnaît pas.

Pour approuver une nouvelle clé après un changement légitime (firmware réinstallé, nouvelle carte), vérifiez de nouveau l'empreinte avec ssh-keyscan comme lors de la première configuration, puis approuvez-la.

Chaque console a sa propre identité : les favoris y sont rattachés.

Test de connexion

Paramètres → Test de connexion → Tester vérifie, dans l'ordre :

Étape	Vérifie	Solution habituelle
Réseau (port 22)	La console répond sur le réseau	Console allumée, même Wi-Fi, adresse correcte
Serveur SSH	Un serveur SSH répond	Activer SSH dans les réglages de la console
Clé de la console	La clé est bien celle approuvée	L'approuver (étape 2) ou chercher pourquoi elle a changé
Identifiants	L'utilisateur et le mot de passe ou la clé sont acceptés	Mettre à jour le mot de passe ou la clé
Commande sur la console	Une commande simple s'exécute	—
Dossier des ROMs	Le dossier existe	Corriger le chemin ; vérifier que la carte est en place

Quand une étape échoue, les suivantes ne sont pas testées, et la page indique quoi faire. Rien n'est modifié sur la console.

Fonctionnement de la connexion

Une seule connexion SSH est partagée par toutes les fonctions et reste ouverte 90 secondes après sa dernière utilisation. Si la console cesse de répondre, les requêtes suivantes échouent immédiatement pendant 15 secondes, au lieu d'attendre chacune un délai d'expiration.