Mobile SSH

Dépannage

Cette page couvre les problèmes courants de Mobile SSH et les premières vérifications à faire avant de modifier les réglages SSH côté serveur.

Impossible de se connecter

Vérifiez :

Si le même hôte fonctionne depuis un autre appareil, comparez exactement l’hôte, le port, le nom d’utilisateur, la clé et le chemin réseau.

Échec de l’authentification

Vérifiez :

Pour les clés privées chiffrées, saisissez la phrase secrète dans le champ mot de passe/phrase secrète.

Échec de l’importation de la clé privée

L’importation de la clé privée utilise le sélecteur de fichiers du système. Si l’importation échoue :

La saisie au clavier est retardée ou modifiée

Mobile SSH envoie les frappes directement au shell, avec l’autocorrection et les suggestions prédictives désactivées, de sorte que le clavier ne devrait pas réécrire le texte avant qu’il n’atteigne le côté distant. Si votre clavier modifie tout de même l’entrée, vérifiez qu’aucun outil système de remplacement ou de presse-papiers ne l’intercepte, et utilisez la rangée de touches supplémentaires pour les touches de terminal comme ESC, TAB, CTRL, les flèches, HOME, END, PGUP et PGDN.

Le défilement de tmux n’est pas celui attendu

Mobile SSH modifie le comportement du défilement selon l’état du terminal. Dans tmux ou d’autres programmes à écran alternatif, les gestes de défilement peuvent envoyer des commandes du mode copie de tmux au lieu de faire défiler l’historique local. Si le mode souris de tmux est activé, l’app envoie des séquences d’échappement de molette.

Si le défilement semble incorrect :

La session est tombée après le verrouillage de l’écran

Sur Android, Mobile SSH utilise des keepalives, un service de premier plan, un wake lock, un Wi-Fi lock et des tentatives de reconnexion pour réduire les déconnexions. Les politiques de batterie d’Android peuvent tout de même arrêter le travail en arrière-plan.

Vérifiez :

Sur iOS, le système suspend les apps en arrière-plan : une connexion SSH brute ne peut donc pas rester ouverte indéfiniment une fois que vous changez d’app ou verrouillez l’écran. Un court délai de grâce couvre les changements d’app rapides ; pour toute durée plus longue, activez Auto-attach tmux session sur le profil du serveur (ou utilisez le transport Eternal Terminal) afin que la reconnexion vous ramène dans le même shell, là où vous vous étiez arrêté.

Le transfert de fichiers ne parcourt pas les fichiers du téléphone

Mobile SSH ne demande aucune permission de stockage sur Android. À la place, le volet local affiche un seul dossier que vous accordez avec le sélecteur de dossiers du système — s’il est vide, utilisez Pick folder pour en choisir un. L’autorisation persiste : c’est donc une étape unique.

Si les fichiers distants se chargent mais pas les fichiers locaux, la connexion SSH est correcte et vous n’avez simplement encore accordé aucun dossier.

Sur iOS, le volet local affiche la zone de documents de l’app, et vous ajoutez des fichiers via les sélecteurs de documents et de photos du système. Les téléchargements y sont aussi visibles dans l’app Fichiers sous Sur mon iPhone.

Échec de l’envoi ou du téléchargement

Vérifiez :

Échec de la redirection de port

Vérifiez :

Journaux de débogage

Les deux plateformes n’enregistrent pas les mêmes choses : choisissez celle qui correspond à votre problème.

Android — terminal et rendu. Activez Settings → Debugging → Show Debug and Logs buttons, puis utilisez le bouton Debug qui apparaît sur l’écran d’accueil. Il enregistre les événements du terminal, les tailles de données SSH, la saisie tactile, le comportement de redimensionnement et le cycle de vie des tunnels. Démarrer un enregistrement vous avertit d’abord qu’il capture chaque touche que vous saisissez, mots de passe compris. L’arrêter écrit une archive dans votre dossier Téléchargements.

iOS — connexions et reconnexions. Activez Settings → Diagnostics → Record debug log. Il enregistre chaque adresse composée et la raison de son échec, les tentatives de reconnexion et leur backoff, les connexions perdues, « peer stopped answering keepalives », les changements de réseau et les commandes tmux avec leurs erreurs. Settings affiche un compteur de lignes en direct pour confirmer que l’enregistrement est en cours, et Export Debug Log le partage sous forme de fichier texte. Il est conservé en mémoire et ne couvre que la session applicative en cours.

Examinez tout journal ou archive de débogage avant de le partager. Ils sont destinés au dépannage et peuvent révéler des noms de serveurs, des adresses, des horodatages ou d’autres détails de l’environnement — et sur Android, tout ce que vous avez saisi.