Corriger les liens symboliques sur un montage SFTP — NetDrive

Un répertoire de déploiement sur votre serveur SFTP conserve un lien symbolique current qui pointe vers le dossier de version actif — current → releases/20260821-1. C’est un schéma standard pour les déploiements sans interruption, et c’est exactement le genre de chose qui casse silencieusement la première fois que vous pointez NetDrive vers ce serveur. Le lien apparaît comme un fichier vide, un raccourci rompu, ou n’apparaît pas du tout, et un script qui s’attend à ce que S:\current\config.yaml fonctionne simplement cesse soudain de le faire.

Montez des serveurs SFTP avec un support fonctionnel des liens symboliques

Avec NetDrive, Google Drive, OneDrive, S3, SFTP, WebDAV et plus apparaissent comme des lecteurs natifs sur Windows et macOS — sans synchronisation ni téléchargement complet.

• Les liens symboliques se résolvent correctement sur les montages SFTP, à partir de la version 3.17.817
• Authentification par mot de passe ou clé SSH
• Disponible sur Windows, macOS et la version expérimentale pour Linux

WindowsmacOS

Télécharger NetDrive →

Essai gratuit. Licences à vie et abonnements disponibles.

Vérifiez d’abord la version

NetDrive a ajouté la prise en charge des liens symboliques pour les connexions SFTP dans la version 3.17.817 (2023-01-07). Sur toute version antérieure, un lien symbolique sur le serveur n’a aucun équivalent côté monté — il peut ne pas apparaître, ou apparaître comme un fichier de zéro octet au lieu de pointer vers sa cible. C’est la cause la plus fréquente des signalements « mes liens symboliques ne fonctionnent pas », et il vaut la peine de l’écarter avant de toucher quoi que ce soit sur le serveur.

Pour vérifier votre version installée, ouvrez le Drive Manager de NetDrive, cliquez sur l’icône NetDrive (barre d’état système sous Windows, barre de menus sous macOS), puis ouvrez About NetDrive. Si la chaîne de version indique une valeur antérieure à 3.17.817, mettez à jour avant de continuer — la version actuelle est 3.19.7, disponible sur netdrive.net/download.

Déjà en 3.17.817 ou plus récent ? Vérifiez le lien lui-même

Si la version n’est pas le problème, c’est généralement la configuration du lien symbolique lui-même. Passez en revue les points suivants depuis le serveur, via une session SSH classique :

• Cibles absolues ou relatives. Un lien symbolique relatif (current → releases/20260821-1) se résout par rapport à son propre répertoire et se comporte généralement bien à travers un montage. Un lien symbolique absolu (current → /var/www/app/releases/20260821-1) ne se résout correctement que si ce chemin absolu exact existe aussi et est accessible depuis la vue du système de fichiers propre au compte SFTP — ce qui n’est pas garanti si le compte est enfermé (chroot) dans un sous-répertoire.

  # Run this on the server to see how the link is defined
  ls -la /var/www/app/current

• Une cible en dehors de la racine du compte SFTP. Certains serveurs restreignent les utilisateurs SFTP à une prison chroot enracinée dans leur répertoire personnel ou un chemin spécifique. Un lien symbolique pointant en dehors de cette racine est invisible pour la session SFTP — et donc pour NetDrive — quelle que soit la version de NetDrive utilisée. Confirmez que le chemin cible se trouve bien dans la même racine à laquelle le compte SFTP est confiné.

• Une cible orpheline. Si le répertoire de version vers lequel pointe un lien symbolique a été supprimé ou renommé (un déploiement inachevé, un script de nettoyage exécuté trop tôt), le lien lui-même est correct mais n’a rien à résoudre. ls -la sur le serveur affichera le lien dans une couleur différente ou le signalera comme rompu, selon la configuration de votre shell.

• Les permissions sur la cible, pas seulement sur le lien. Le fichier du lien symbolique lui-même peut être lisible alors que son répertoire cible a des permissions qui bloquent le compte SFTP. Vérifiez les deux.

Confirmer la correction via le montage

Une fois que vous avez écarté le problème de version et confirmé que le lien est relatif, dans la racine, et pointe vers quelque chose qui existe, reconnectez le lecteur dans NetDrive (clic droit sur la connexion dans Drive Manager puis Reconnect, ou déconnectez et reconnectez-vous) et vérifiez directement le chemin monté :

# Windows PowerShell — replace S: with your assigned drive letter
dir S:\current

# macOS / Linux Terminal
ls -la /Volumes/sftp-mount/current

Si le contenu du dossier cible s’affiche désormais correctement, le lien symbolique se résout. S’il apparaît toujours vide ou manquant après avoir confirmé à la fois la version et la validité du lien lui-même, la variable restante est généralement la configuration du sous-système SFTP côté serveur — plus précisément le fait que le processus sftp-server du serveur ait ou non la traversée des liens symboliques désactivée, ce qui relève de l’administrateur du serveur plutôt que d’un réglage de NetDrive.

Pour conclure

La gestion des liens symboliques sur un montage SFTP dépend de deux facteurs indépendants : si votre version de NetDrive la prend en charge (3.17.817+), et si le lien lui-même est valide du point de vue du compte SFTP. Vérifiez d’abord la version — c’est le correctif le plus rapide — puis examinez la cible du lien avant de supposer que NetDrive est en cause. Pour des problèmes de connexion SFTP plus généraux, consultez Fix SFTP Authentication Failures in NetDrive, et pour la configuration initiale, Mount an SFTP Server on Windows.

— Morgan, NetDrive