Corregir enlaces simbólicos que no funcionan en SFTP — NetDrive

Un directorio de deploy en tu servidor SFTP mantiene un enlace simbólico current que apunta a la carpeta de release que esté activa — current → releases/20260821-1. Es un patrón estándar para deploys sin downtime, y es exactamente el tipo de cosa que se rompe silenciosamente la primera vez que apuntas NetDrive a ese servidor. El enlace aparece como un archivo vacío, un acceso directo roto, o directamente no aparece, y un script que espera que S:\current\config.yaml simplemente funcione de pronto deja de hacerlo.

Monta servidores SFTP con soporte de symlinks funcional

NetDrive hace que Google Drive, OneDrive, S3, SFTP, WebDAV y más aparezcan como unidades nativas en Windows y macOS — sin sincronizar, sin descargas completas.

• Los symlinks se resuelven correctamente en montajes SFTP, versión 3.17.817 en adelante
• Autenticación por contraseña o clave SSH
• Disponible en Windows, macOS y la build experimental de Linux

WindowsmacOS

Descargar NetDrive →

Prueba gratuita. Planes de por vida y de suscripción disponibles.

Verifica primero la versión

NetDrive añadió soporte de symlinks para conexiones SFTP en la versión 3.17.817 (2023-01-07). En cualquier build anterior, un symlink en el servidor no tiene equivalente en el lado montado — puede no aparecer, o puede mostrarse como un archivo de cero bytes en lugar de apuntar a su destino. Esta es la causa más común de los reportes de “mis symlinks no funcionan”, y vale la pena descartarla antes de tocar nada en el servidor.

Para verificar tu versión instalada, abre el Drive Manager de NetDrive, haz clic en el ícono de NetDrive (bandeja del sistema en Windows, barra de menú en macOS), y abre About NetDrive. Si la cadena de versión muestra algo anterior a 3.17.817, actualiza antes de continuar — la versión actual es 3.19.7, disponible en netdrive.net/download.

¿Ya tienes 3.17.817 o posterior? Revisa el enlace en sí

Si la versión no es el problema, la configuración del propio symlink suele serlo. Repasa lo siguiente desde el lado del servidor, en una sesión SSH normal:

• Destinos absolutos vs. relativos. Un symlink relativo (current → releases/20260821-1) se resuelve respecto a su propio directorio y generalmente viaja bien a través de un montaje. Un symlink absoluto (current → /var/www/app/releases/20260821-1) solo se resuelve correctamente si esa ruta absoluta exacta también existe y es alcanzable desde la vista del propio sistema de archivos de la cuenta SFTP — lo cual no está garantizado si la cuenta está en un chroot a un subdirectorio.

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

• Un destino fuera de la raíz de la cuenta SFTP. Algunos servidores restringen a los usuarios SFTP a un chroot jail anclado en su directorio home o en una ruta específica. Un symlink que apunte fuera de esa raíz es invisible para la sesión SFTP — y por lo tanto para NetDrive — sin importar qué versión de NetDrive estés usando. Confirma que la ruta de destino cae dentro de la misma raíz a la que está limitada la cuenta SFTP.

• Un destino colgante (dangling). Si el directorio de release al que apunta un symlink fue eliminado o renombrado (un deploy a medio terminar, un script de limpieza que corrió antes de tiempo), el enlace en sí está bien pero no tiene nada a qué resolver. ls -la en el servidor mostrará el enlace en un color distinto o lo marcará como roto, según la configuración de tu shell.

• Permisos en el destino, no solo en el enlace. El archivo symlink en sí podría ser legible mientras que su directorio de destino tiene permisos que bloquean a la cuenta SFTP. Revisa ambos.

Confirmar la corrección a través del montaje

Una vez que hayas descartado la versión y confirmado que el enlace es relativo, está dentro de la raíz, y apunta a algo que existe, vuelve a conectar la unidad en NetDrive (clic derecho en la conexión dentro de Drive Manager y elige Reconnect, o desconecta y conecta de nuevo) y revisa la ruta montada directamente:

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

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

Si el contenido de la carpeta de destino ahora se lista correctamente, el symlink se está resolviendo. Si sigue apareciendo vacío o ausente después de confirmar tanto la versión como la validez del propio enlace, la variable restante suele ser la configuración del subsistema SFTP del lado del servidor — específicamente si el proceso sftp-server del servidor tiene deshabilitado el seguimiento de symlinks, lo cual es una pregunta para el administrador del servidor y no un ajuste de NetDrive.

Resumen

El manejo de symlinks en un montaje SFTP se reduce a dos cosas independientes: si tu build de NetDrive lo soporta en absoluto (3.17.817+) y si el enlace en sí es válido desde el punto de vista de la cuenta SFTP. Verifica primero la versión — es la corrección más rápida — luego revisa el destino del enlace antes de asumir que la falla es de NetDrive. Para problemas más amplios de conexión SFTP, consulta Fix SFTP Authentication Failures in NetDrive, y para la configuración inicial, Mount an SFTP Server on Windows.

— Morgan, NetDrive