Accueil
» LINUX
»
Comment configurer le transfert X11 sous Linux via SSH
Comment configurer le transfert X11 sous Linux via SSH
Le transfert X11 vous permet d'exécuter une application Linux graphique sur un ordinateur distant et d'afficher sa fenêtre sur votre bureau local via SSH. Pour le configurer, activez le transfert sur le serveur SSH distant, vérifiez que ce dernier dispose des droits nécessaires xauth, assurez-vous que votre bureau local dispose d'un affichage X, puis connectez-vous ssh -X. Cette méthode transfère les fenêtres d'applications individuelles ; elle ne crée pas une session de bureau à distance complète.
Ce dont vous avez besoin avant de l'installer
L'ordinateur sur lequel vous saisissez la commande SSH est le client . Il nécessite le client OpenSSH et une session graphique active avec un affichage X. De nombreux environnements de bureau Linux fournissent ces informations directement ou via XWayland lorsque la session utilise Wayland. Si echo "$DISPLAY"rien ne s'affiche sur le bureau local, aucun affichage n'est disponible pour SSH dans cette invite de commandes.
L'ordinateur distant fait office de serveur . Il nécessite le serveur OpenSSH et l' xauthutilitaire `openssh` pour que SSH puisse créer le cookie d'autorisation temporaire utilisé pour l'affichage différé. Sous Debian ou Ubuntu, installez-les sur le système distant avec `openssh` sudo apt updateet `openssh` sudo apt install openssh-server xauth. Sous une autre distribution, utilisez son gestionnaire de paquets pour installer le serveur OpenSSH et le paquet `openssh` xauth. Assurez-vous qu'une connexion SSH classique fonctionne avant de modifier la configuration.
Vérifiez que le terminal local peut exécuter le client OpenSSH ; le serveur distant a également besoin de xauth.
Configurer le transfert X11 via SSH
1. Activez le transfert dans la configuration du serveur
Sur l'ordinateur distant, modifiez le fichier de configuration du serveur/etc/ssh/sshd_config , généralement , à l'aide d'un éditeur disposant des privilèges d'administrateur :
sudoedit /etc/ssh/sshd_config
Trouvez un X11Forwardingparamètre actif existant et modifiez-le comme suit :
X11Forwarding yes
Si le paramètre est absent, ajoutez-le dans la section globale avant chaque Matchbloc. Certaines distributions chargent également des fichiers depuis un répertoire/etc/ssh/sshd_config.d/ ; vérifiez les fichiers inclus pour détecter d'éventuels conflits de paramètres. Une Matchrègle DisableForwarding yespeut empêcher le transfert pour un compte particulier. Laissez X11UseLocalhostla configuration par défaut, sauf en cas de problème de compatibilité spécifique : OpenSSH associe généralement le proxy de transfert à l'adresse de bouclage. Le manuel officiel de sshd_config décrit ces options côté serveur.
Le paramètre du serveur doit être défini dans sshd_config, et non dans le fichier client SSH ssh_config.
2. Validez la configuration et rechargez SSH.
Avant de recharger le démon, vérifiez le fichier pour détecter les erreurs de syntaxe et confirmez la valeur de redirection effective :
La première commande doit s'exécuter sans erreur ; la seconde doit afficher un message d'erreur x11forwarding yes. Si vous utilisez Matchdes règles, testez la configuration effective pour l'utilisateur et la connexion concernés, comme décrit dans le manuel OpenSSH. Corrigez toute erreur avant de recharger afin de ne pas interrompre l'accès SSH.
Rechargez le service sous le nom utilisé par votre distribution. Debian et Ubuntu utilisent généralement :
sudo systemctl reload ssh
Les systèmes Fedora et de la famille RHEL utilisent généralement :
sudo systemctl reload sshd
Si le rechargement n'est pas pris en charge, utilisez la commande appropriée restartpour le même service. Laissez la session ouverte et testez une nouvelle connexion avant de la fermer. La documentation du serveur OpenSSH d'Ubuntu décrit le fichier serveur et les extraits de configuration utilisés sous Ubuntu.
3. Connectez-vous depuis le bureau Linux local.
Sur le client, demandez le transfert X11 non approuvé avec -X:
ssh -X user@server.example.com
Remplacez le nom d'utilisateur et l'hôte d'exemple par les vôtres. Si le serveur SSH écoute sur un port non standard, ajoutez son numéro de port avec -p:
ssh -X -p 2222 user@server.example.com
Après vous être connecté, lancez un programme graphique installé sur l'hôte distant. Pour une vérification rapide, exécutez xclockl'application de test si elle est disponible, ou lancez un autre programme graphique installé. SSH configure DISPLAYautomatiquement la valeur de la session distante et redirige la connexion X11 ; ne copiez pas la valeur de votre affichage local sur le serveur et ne la configurez pas manuellement.
Cette -Xoption active le transfert X11 au démarrage de la session SSH.Une application GUI transférée apparaît sous forme de fenêtre sur le bureau local tandis que la session SSH reste ouverte.
Sécurité et dépannage
Activé -Xpar défaut. Cette -Yoption active le transfert de données de confiance, ce qui supprime les restrictions de sécurité X11 et accorde à l'application distante un accès plus étendu à votre affichage local. Utilisez-la uniquement avec un serveur et une application de confiance. OpenSSH avertit que le transfert X11 peut exposer l'affichage du client à des attaques ; consultez la documentation ssh et le manuel ssh_config pour comprendre la différence entre le transfert de données de confiance et le transfert de données non fiable.
« Échec de la requête de transfert X11 » : Vérifiez la valeur effective du serveur X11Forwarding, confirmez xauthqu'il est installé sur l'hôte distant et recherchez un Matchblocage ou un DisableForwardingparamètre restrictif.
DISPLAYSi la session distante est vide : déconnectez-vous et reconnectez-vous ssh -X. Vérifiez que l’interface graphique de votre terminal local est active et que la connexion atteint bien le serveur que vous venez de configurer.
La fenêtre indique qu'elle ne peut pas ouvrir d'affichage : vérifiez que votre session de bureau locale est toujours active. Une invite de commandes sans accès à l'affichage du bureau ne peut pas afficher les fenêtres transférées.
xclockLe programme de test est introuvable . Essayez une application graphique déjà installée sur la machine distante ; ce message à lui seul ne prouve pas que le transfert SSH est défaillant.
Le transfert X11 est pratique pour une utilisation ponctuelle d'outils distants, mais les applications graphiques nécessitant des mises à jour fréquentes peuvent s'avérer lentes avec une connexion à latence élevée. Pour un bureau complet ou des tâches gourmandes en ressources graphiques, privilégiez une solution de bureau à distance dédiée.