SSHFS (Español)

SSHFS es un cliente de sistema de archivos basado en FUSE para montar directorios remotos a través de una conexión Secure Shell.

Esta traducción de SSHFS fue revisada el 2020-12-06. Si existen cambios puede actualizarla o avisar al equipo de traducción.

Instalación

Instale el paquete sshfs.

Sugerencia:

• Si a menudo necesita montar sistemas de archivos sshfs, puede estar interesado en utilizar un ayudante sshfs, como qsshfs^AUR, sftpman, sshmnt^AUR o fmount.py.
• Es posible que desee utilizar Google Authenticator para proporcionar seguridad adicional como es la autenticación de dos pasos.
• SSH keys puede ser utilizado sobre la autenticación tradicional de contraseña.

Montaje

Para poder montar un directorio, el usuario de SSH necesita poder acceder a él. Invoque sshfs para montar un directorio remoto:

$ sshfs [usuario@]host:[dir] puntodemontaje [opciones]

Por ejemplo:

$ sshfs miusuario@micomputadora:/ruta/remota /ruta/local -C -p 9876

Aquí -p 9876 especifica el número de puerto y -C activa la compresión. Para más opciones véase la sección #Opciones.

Cuando no se especifica, la ruta remota se establece de manera predeterminada en el directorio de inicio del usuario remoto. Los nombres de usuario y las opciones predeterminadas se pueden predefinir para cada computadora en para simplificar el uso de sshfs. Para obtener más información, véase OpenSSH#Client usage.

SSH le pedirá la contraseña, si es necesario. Si no desea escribir la contraseña varias veces al día, véase SSH keys.

Desmontaje

Para desmontar el sistema remoto:

$ fusermount3 -u puntodemontaje

Por ejemplo:

$ fusermount3 -u /ruta/local

Opciones

sshfs' puede convertir automáticamente entre ID de usuarios locales y remotos. Utilice la opción para traducir el UID del usuario que se conecta al usuario remoto (GID permanece sin cambios):

$ sshfs miusuario@micomputadora:/ruta/remota /ruta/local -o idmap=user

Si necesita más control sobre la traducción de UID y GID, mire las opciones , uidfile y gidfile.

Se puede encontrar una lista completa de opciones en .

Haciendo Chroot

Es posible que desee restringir un usuario específico a un directorio específico en el sistema remoto. Esto se puede hacer editando :

Véase también SFTP chroot. Para más información revise la página del manual para , y .

Montaje automático

El montaje automático puede ocurrir en el arranque o bajo demanda (al acceder al directorio). Para ambos, la configuración ocurre en fstab.

Bajo demanda

Con systemd es posible el montaje bajo demanda utilizando entradas /etc/fstab.

Por ejemplo:

usuario@host:/carpeta/remota /punto/montaje  fuse.sshfs noauto,x-systemd.automount,_netdev,users,idmap=user,IdentityFile=/home/usuario/.ssh/id_rsa,allow_other,reconnect 0 0

Las opciones de montaje importantes aquí son noauto,x-systemd.automount,_netdev.

• noauto le dice que no se monte en el arranque
• x-systemd.automount hace la magia bajo demanda
• _netdev le dice que es un dispositivo de red, no un dispositivo de bloque (sin él pueden ocurrir errores del tipo "No existe dicho dispositivo")

Nota: Después de editar /etc/fstab, (re)inicie el servicio requerido: systemctl daemon-reload seguido por systemctl restart <objetivo> donde <objetivo> se puede encontrar ejecutando systemctl list-unit-files --type automount

En el arranque

Un ejemplo de cómo utilizar sshfs para montar un sistema de archivos remoto a través de /etc/fstab

USUARIO@NOMBREHOST_O_IP:/DIRECTORIO/REMOTO  /PUNTOMONTAJE/LOCAL  fuse.sshfs  defaults,_netdev  0  0

Tomemos, por ejemplo, la línea fstab

llib@192.168.1.200:/home/llib/FAH  /media/FAH2  fuse.sshfs  defaults,_netdev  0  0

Lo anterior funcionará automáticamente si está utilizando una clave SSH para el usuario. Véase Uso de claves SSH.

Si quiere utilizar sshfs con múltiples usuarios:

[e-mail]:/home/usuario  /media/usuario   fuse.sshfs    defaults,allow_other,_netdev    0  0

Una vez más, es importante configurar la opción de montaje _netdev para asegurarse de que la red esté disponible antes de intentar montar.

Acceso de usuario seguro

Al realizar el montaje automático a través de fstab, el sistema de archivos generalmente será montado por el superusuario. De forma predeterminada, esto produce resultados indeseables si desea acceder como un usuario normal y limitar el acceso a otros usuarios.

Un ejemplo de configuración del punto de montaje:

USUARIO@NOMBREHOST_O_IP:/DIRECTORIO/REMOTO  /PUNTOMONTAJE/LOCAL  fuse.sshfs noauto,x-systemd.automount,_netdev,user,idmap=user,follow_symlinks,identityfile=/home/USUARIO/.ssh/id_rsa,allow_other,default_permissions,uid=N_ID_USUARIO,gid=N_GID_USUARIO 0 0

Resumen de las opciones relevantes:

• allow_other - Permite que otros usuarios que no sean el montador (es decir, el superusuario) accedan al recurso compartido.
• default_permissions - Permite que el kernel verifique los permisos, es decir, utilice los permisos reales en el sistema de archivos remoto. Esto permite prohibir el acceso a todas las personas que de otra forma concede allow_other.
• uid, gid - establece la propiedad de archivos reportada a unos valores determinados; uid es el ID numérico de su usuario, gid es el ID numérico del grupo de su usuario.

Solución de problemas

Lista de comprobación

Lea primero OpenSSH (Español)#Lista de comprobación. Otros temas para verificar son:

1. ¿Su inicio de sesión SSH está enviando información adicional desde, por ejemplo, el archivo del servidor? Esto podría confundir SSHFS. Debería desactivar temporalmente el archivo del servidor:

$ mv /etc/issue /etc/issue.orig

2. Tenga en cuenta que la mayoría de los artículos de solución de problemas relacionados con SSH que encontrará en la web no están relacionados con Systemd. A menudo las definiciones en /etc/fstab comienzan erroneamente con en lugar de utilizar la sintaxis .

3. Compruebe que el propietario de la carpeta de origen y el contenido del servidor es propiedad del usuario del servidor.

$ chown -R USER_S: /mnt/servidores/carpeta

4. El ID de usuario del servidor puede ser diferente del cliente. Obviamente ambos nombres de usuario tienen que ser los mismos. Solo tiene que cuidar los ID de usuario del cliente. SSHFS traducirá el UID con las siguientes opciones de montaje:

uid=ID_USUARIO_C,gid=ID_GRUPO_C

5. Compruebe que el punto de montaje de destino del cliente (carpeta) es propiedad del usuario cliente. Esta carpeta debe tener el mismo ID de usuario definido en las opciones de montaje de SSHFS.

$ chown -R USUARIO_C: /mnt/cliente/carpeta

6. Compruebe que el punto de montaje (carpeta) del cliente esté vacío. De forma predeterminada no puede montar carpetas SSHFS en carpetas no vacías.

Connection reset by peer

• Si está intentando acceder al sistema remoto con un nombre de host, intente utilizar su dirección IP, ya que puede ser un problema de resolución de nombres de dominio. Asegúrese de editar con los detalles del servidor.
• Si está utilizando nombres de clave no predeterminados y los está pasando como , no funcionará. Tiene que utilizar , con la ruta completa a la clave.
• Si su es un enlace simbólico, recibirá este error también. Véase este tema en serverfault
• Añadiendo la opción '' (como en '') puede ayudar a resolver el problema.
• Si eso no revela nada útil, también puede intentar añadir la opción 'debug'
• Si está intentando hacer sshfs a través de un enrutador que utiliza DD-WRT o similar, hay una solución aquí. (tenga en cuenta que la opción -osftp_server=/opt/libexec/sftp-server se puede utilizar para la orden sshfs en lugar de parchear dropbear)
• Si ve esto solo durante el arranque, puede ser que systemd esté intentando montar antes de que haya una conexión de red disponible. Habilite el servicio de 'espera-en-línea' apropiado para su conexión de red (por ejemplo, systemd-networkd-wait-online.service) para solucionar esto.
• Hilo antiguo del foro: sshfs: Connection reset by peer
• Asegúrese de que su usuario pueda iniciar sesión en el servidor (especialmente al utilizar AllowUsers)
• Asegúrese de que Subsystem sftp /usr/lib/ssh/sftp-server está activado en .

Nota: Cuando se proporciona más de una opción para sshfs, deben estar separadas por comas. Al igual que: 'sshfs -o sshfs_debug,IdentityFile=</ruta/a/la/clave> usuario@servidor ...')

El host remoto se ha desconectado

Si recibe este mensaje directamente después de intentar utilizar sshfs:

• Primero asegúrese de que la máquina remota tiene instalado sftp. No funcionará si no lo tiene.
• Después, comprueba que la ruta de Subsystem sftp en en la máquina remota es válida.

Problemas de montaje fstab

Para obtener una salida de depuración detallada, añada lo siguiente a las opciones de montaje:

ssh_command=ssh\040-vv,sshfs_debug,debug

Para poder ejecutar y ver la salida de depuración, elimine lo siguiente:

 noauto,x-systemd.automount

Véase también

• Cómo montar el sistema de archivos SSH en chroot, Con especial cuidado con las preguntas de propietarios y permisos.