LinuxParty

Si alguna vez has intentado acceder a un directorio montado con sshfs, rclone, o cualquier sistema basado en FUSE, y te ha recibido el temido mensaje:

Transport endpoint is not connected

…tranquilo, no estás solo. Es uno de esos clásicos de Linux que aparecen sin previo aviso, a menudo justo cuando más prisa tienes. En este artículo te explicamos qué significa realmente ese error, cómo solucionarlo en segundos, y cómo evitar que vuelva a ocurrir.

⚙️ El síntoma

De repente, un directorio montado (por ejemplo, /root/media/1media) deja de responder.
Intentas hacer ls, cd, o abrir un archivo y obtienes:

ls: cannot access '1media': Transport endpoint is not connected

Aparentemente todo está roto, pero el resto del sistema funciona bien.
Incluso puede que df -h siga mostrando el punto de montaje como activo.

🔍 Qué está pasando realmente

Este error no tiene nada que ver con permisos ni con discos dañados.
En realidad, lo que ha ocurrido es que el proceso FUSE (por ejemplo sshfs) que gestionaba la conexión con el sistema remoto se ha colgado o ha perdido la conexión.

Linux, sin embargo, sigue creyendo que el montaje existe, y al intentar acceder a él, el kernel responde con ese mensaje críptico:

“Transport endpoint is not connected”
…que en lenguaje humano significa: “El túnel está roto, pero la puerta sigue abierta.”

 

🧯 La solución rápida

Lo bueno de todo esto es que la solución es simple y no requiere reiniciar nada.

Solo hay que desmontar forzadamente el punto de montaje.
Usa este comando mágico:

fusermount -uz /root/media/1media

O, en sistemas más recientes:

fusermount3 -uz /root/media/1media

Si aun así no responde, la alternativa universal:

umount -l /root/media/1media

(-l significa lazy unmount, desmonta aunque el proceso esté bloqueado).

Después de eso, prueba:

ls /root/media

y verás que el sistema vuelve a estar perfectamente accesible.
El punto 1media estará limpio y libre del montaje roto.

🧠 Por qué ocurre (y cómo prevenirlo)

El error suele aparecer cuando:

• Se corta la conexión de red (por ejemplo, una sesión SSH inactiva demasiado tiempo).

• El servidor remoto se reinicia o cambia de IP.

• El proceso sshfs muere inesperadamente.

La buena noticia: puedes minimizar su aparición usando opciones más tolerantes al fallo.
Por ejemplo, al montar con sshfs, añade:

sshfs -o reconnect,ServerAliveInterval=15,ServerAliveCountMax=3 root@mi-servidor:/var/SITIOS /root/media/1media

Estas opciones le dicen al cliente que intente reconectarse automáticamente y mantenga viva la sesión aunque haya pequeños cortes.

🧩 Un truco adicional

Si administras muchos montajes FUSE, puedes detectar rápidamente cuáles están colgados con:

mount | grep fuse

o incluso automatizar una comprobación que desmonte los puntos problemáticos si detecta el error.
Esto es especialmente útil en servidores que mantienen montajes remotos activos durante días o semanas.

🚀 En resumen

El mensaje “Transport endpoint is not connected” no significa que hayas roto nada.
Solo indica que el sistema remoto ya no responde y el punto de montaje quedó en un estado zombi.

Solución inmediata:

fusermount -uz /ruta/del/montaje

Prevención a futuro: usa opciones reconnect y ServerAliveInterval en tus montajes.

Así de sencillo. Sin reinicios, sin drama… y sin volver a perder tiempo con un error que parece grave, pero no lo es.

✍️ Artículo redactado por Javier Orovengua Miguel — Linux sysadmin y colaborador de LinuxParty.es