Configurar NFS en Linux: guía completa para una unidad de red compartida

Tengo NFS funcionando en mi mini PC N100. Sirve el contenido multimedia de Jellyfin, gestiona las copias de seguridad de todas las máquinas de mi red y almacena documentos compartidos. Esta guía de configuración de NFS en Linux te lleva paso a paso por la puesta en marcha de un servidor NFS y el montaje de recursos compartidos en clientes Linux: desde una instalación básica funcional hasta el blindaje con NFSv4.2, el automontaje con systemd y la integración con contenedores.

NFSv4.2 es el valor predeterminado en los clientes Linux modernos (negocian primero la versión 4.2), así que esta guía lo fija desde el principio. NFS es gratuito, está integrado en el kernel y es la forma más eficiente de compartir archivos en una red doméstica solo con Linux. Si aún estás comparando hardware, echa un vistazo a los mejores mini PC para servidores domésticos.

¿Qué es NFS y por qué usarlo?

Ventajas clave de NFS

NFS frente a SMB: ¿qué protocolo para compartir archivos deberías usar?

Recomendación: usa NFS en redes domésticas solo con Linux. Es más rápido y sencillo que SMB. Para entornos mixtos Windows/Linux, usa SMB/CIFS. Consulta cómo configurar Samba para redes mixtas Windows/Linux. Para acceso a archivos por HTTP, revisa nuestra guía de WebDAV en Nginx.

Requisitos previos y planificación de la red

Antes de empezar, asegúrate de tener:

Resumen de la arquitectura de red

Diagrama de la arquitectura de red NFS con un servidor NFS Linux exportando recursos compartidos /srv/nfs a máquinas cliente Linux en una red local

Paso 1: Configura el servidor NFS en Linux

Instala el paquete del servidor NFS

sudo apt update && sudo apt install nfs-kernel-server -y

sudo dnf install nfs-utils -y

Crea los directorios compartidos

Define una estructura de directorios para tus recursos compartidos NFS. Yo los organizo por propósito:

# Create main NFS directory (FHS-compliant location)
sudo mkdir -p /srv/nfs

# Create specific share directories
sudo mkdir -p /srv/nfs/media
sudo mkdir -p /srv/nfs/backups
sudo mkdir -p /srv/nfs/documents

Configura los permisos y entiende el mapeo UID/GID

Establece la propiedad y los permisos:

# Set ownership to nobody:nogroup for security
sudo chown -R nobody:nogroup /srv/nfs

# Set permissions (755 for directories)
sudo chmod -R 755 /srv/nfs

# In /etc/exports, squash everyone to UID 1000, GID 1000
/srv/nfs/media  192.168.1.0/24(rw,sync,no_subtree_check,all_squash,anonuid=1000,anongid=1000)

Configura las exportaciones NFS en /etc/exports

El archivo /etc/exports define qué directorios se comparten y con qué permisos:

sudo nano /etc/exports

Añade tus configuraciones de exportación:

# Media share, read-write for the whole LAN (root_squash is the default)
/srv/nfs/media     192.168.1.0/24(rw,sync,no_subtree_check)

# Backup share, read-write for the whole LAN
/srv/nfs/backups   192.168.1.0/24(rw,sync,no_subtree_check)

# Documents, read-write for one machine, read-only for another
/srv/nfs/documents 192.168.1.101(rw,sync,no_subtree_check) 192.168.1.102(ro,sync,no_subtree_check)

# Container share, squash all users to UID/GID 1000
/srv/nfs/appdata   192.168.1.0/24(rw,sync,no_subtree_check,all_squash,anonuid=1000,anongid=1000)

# Optional: NFSv4 root export (lets clients mount server:/media instead of server:/srv/nfs/media)
/srv/nfs           192.168.1.0/24(rw,sync,no_subtree_check,fsid=0,crossmnt)

Opciones de exportación explicadas

Aplica las exportaciones e inicia el servicio

Tras configurar las exportaciones, aplica los cambios en caliente, sin reiniciar el servicio:

# Apply exports (re-exports all directories, re-reads /etc/exports)
sudo exportfs -arv

Salida esperada:

exporting 192.168.1.0/24:/srv/nfs/media
exporting 192.168.1.0/24:/srv/nfs/backups
exporting 192.168.1.101:/srv/nfs/documents
exporting 192.168.1.102:/srv/nfs/documents

Activa el servicio para que arranque con el sistema:

sudo systemctl enable --now nfs-kernel-server

Verifica las exportaciones activas:

sudo exportfs -v

Deberías ver cada recurso compartido con sus opciones (rw, sync, no_subtree_check, root_squash).

Configura el firewall

NFSv4 solo necesita el puerto TCP 2049. Los antiguos puertos 111 (rpcbind), mountd, statd y lockd son de la era NFSv2/v3: no los necesitas si solo usas NFSv4.

sudo ufw allow from 192.168.1.0/24 to any port 2049 proto tcp
sudo ufw reload

sudo firewall-cmd --permanent --add-service=nfs
sudo firewall-cmd --reload

Verifica que el puerto está a la escucha:

sudo ss -tuln | grep :2049

Restringe a NFSv4 y ajusta el servidor

Edita /etc/nfs.conf para desactivar las versiones antiguas de NFS y ajustar el servidor:

sudo nano /etc/nfs.conf

Añade o actualiza la sección [nfsd]:

[nfsd]
# Disable NFSv2 and NFSv3, NFSv4 only
vers3=n
# Optional: disable NFSv4.0 and 4.1 if you only need 4.2
vers4.0=n
vers4.1=n
# Increase worker threads (default is 8; raise for multiple clients)
threads=16
# Bind to LAN IP only (replace with your server's IP)
host=192.168.1.100

Reinicia el servidor NFS para aplicar los cambios:

sudo systemctl restart nfs-kernel-server

Verifica las versiones habilitadas:

cat /proc/fs/nfsd/versions

Salida esperada:

-2 -3 +4 +4.1 +4.2

Consulta la configuración efectiva:

sudo nfsconf --dump

En un servidor solo con v4 puedes enmascarar rpcbind, porque NFSv4 no lo usa:

sudo systemctl mask rpcbind.service rpcbind.socket

Nota: enmascarar rpcbind rompe showmount -e en el servidor. Desenmascáralo si lo necesitas.

Paso 2: Monta los recursos compartidos NFS en los clientes Linux

Instala el paquete del cliente NFS

En las máquinas cliente:

sudo apt update && sudo apt install nfs-common -y

Para clientes RHEL/Fedora:

sudo dnf install nfs-utils -y

Verifica las exportaciones del servidor

Antes de montar, verifica que el servidor es accesible y que las exportaciones son visibles:

# List exports from the server
showmount -e 192.168.1.100

Salida esperada:

Export list for 192.168.1.100:
/srv/nfs        192.168.1.0/24
/srv/nfs/media  192.168.1.0/24
/srv/nfs/backups 192.168.1.0/24

Nota: si enmascaraste rpcbind en el servidor, showmount puede fallar; no pasa nada. El montaje usa directamente el puerto 2049.

Crea los puntos de montaje y prueba un montaje NFS manual

# Create mount points
sudo mkdir -p /mnt/server-media
sudo mkdir -p /mnt/server-backups
sudo mkdir -p /mnt/server-docs

Prueba un montaje manual:

sudo mount -t nfs 192.168.1.100:/srv/nfs/media /mnt/server-media

Verifica el montaje:

df -h | grep nfs
ls -la /mnt/server-media

grep server-media /proc/mounts

Montajes NFS persistentes con /etc/fstab

Edita /etc/fstab para el montaje automático al arrancar:

sudo nano /etc/fstab

# NFS mounts, always-on
192.168.1.100:/srv/nfs/media     /mnt/server-media    nfs  _netdev,nfsvers=4.2,hard,timeo=600,retrans=2  0 0
192.168.1.100:/srv/nfs/backups   /mnt/server-backups  nfs  _netdev,nfsvers=4.2,hard,timeo=600,retrans=2  0 0
192.168.1.100:/srv/nfs/documents /mnt/server-docs     nfs  _netdev,nfsvers=4.2,hard,timeo=600,retrans=2,ro  0 0

# NFS mounts, on-demand automount via systemd
192.168.1.100:/srv/nfs/media     /mnt/server-media    nfs  _netdev,noauto,x-systemd.automount,x-systemd.mount-timeout=30,x-systemd.idle-timeout=10min,nfsvers=4.2,hard,timeo=600,retrans=2  0 0
192.168.1.100:/srv/nfs/backups   /mnt/server-backups  nfs  _netdev,noauto,x-systemd.automount,x-systemd.mount-timeout=30,x-systemd.idle-timeout=10min,nfsvers=4.2,hard,timeo=600,retrans=2  0 0
192.168.1.100:/srv/nfs/documents /mnt/server-docs     nfs  _netdev,noauto,x-systemd.automount,x-systemd.mount-timeout=30,x-systemd.idle-timeout=10min,nfsvers=4.2,hard,timeo=600,retrans=2,ro  0 0

Tras editar fstab, recarga systemd y prueba:

sudo systemctl daemon-reload
sudo mount -a
mount | grep nfs

Opciones de montaje explicadas

Nota sobre rsize/wsize: los kernels modernos negocian automáticamente el tamaño de búfer máximo soportado (1 MiB). No fuerces rsize=8192 ni rsize=32768: en realidad reduce el rendimiento. Déjalos sin definir y verifica con grep server-media /proc/mounts.

Automontaje de NFS con systemd

La opción x-systemd.automount mostrada arriba es la forma moderna de gestionar los montajes NFS en clientes de una sola máquina. Es más simple que AutoFS y evita bloqueos en el arranque cuando el servidor NFS está apagado.

Verifica que la unidad de automontaje está activa:

systemctl status mnt-server\\x2dmedia.automount

La salida esperada debería mostrar Active: active (waiting).

Cómo funciona: systemd crea un disparador de automontaje en el punto de montaje. La primera vez que accedes a /mnt/server-media, systemd monta el recurso NFS. Tras el x-systemd.idle-timeout de inactividad, lo desmonta automáticamente. Si el servidor NFS está apagado al arrancar, el sistema arranca con normalidad, sin bloqueos.

No añadas x-systemd.requires=network-online.target: provoca ciclos de ordenación en systemd (según systemd.automount(5)). Mantén los números de paso de fstab en 0 0; ejecutar fsck sobre NFS al arrancar puede colgar el sistema.

Paso 3: Configuración avanzada de NFS

AutoFS para el montaje bajo demanda

AutoFS sigue siendo válido para configuraciones complejas con varios mapas de montaje. Instálalo:

sudo apt install autofs -y

Configura el mapa maestro:

sudo nano /etc/auto.master

Añade esta línea:

/mnt/auto /etc/auto.nfs --timeout=60 --ghost

Crea el archivo de mapa de AutoFS:

sudo nano /etc/auto.nfs

Configura tus montajes automáticos:

media     -fstype=nfs,nfsvers=4.2,rw,hard,timeo=600   192.168.1.100:/srv/nfs/media
backups   -fstype=nfs,nfsvers=4.2,rw,hard,timeo=600   192.168.1.100:/srv/nfs/backups
documents -fstype=nfs,nfsvers=4.2,ro,hard,timeo=600   192.168.1.100:/srv/nfs/documents

Arranca y habilita AutoFS:

sudo systemctl restart autofs
sudo systemctl enable autofs

Nota: usa -fstype=nfs,nfsvers=4.2; la antigua sintaxis -fstype=nfs4 está obsoleta según la página de manual nfs(5).

Funciones de NFSv4.2 y la exportación raíz

NFSv4.2 añade varias funciones sobre la 4.1:

• Operaciones con archivos dispersos (SEEK/HOLE): gestión eficiente de archivos con huecos
• Copia/clonación del lado del servidor: copy_file_range() funciona en el servidor; genial para rsync y cp dentro del mismo recurso
• Reserva de espacio: soporte de fallocate()
• NFS etiquetado: etiquetas de seguridad para el control de acceso obligatorio

La exportación raíz fsid=0 mostrada antes permite a los clientes montar rutas más cortas. Con esta exportación:

# Instead of:
sudo mount -t nfs 192.168.1.100:/srv/nfs/media /mnt/server-media

# You can mount:
sudo mount -t nfs 192.168.1.100:/media /mnt/server-media

La opción crossmnt sigue los puntos de montaje dentro de la exportación. Sin ella, los subdirectorios que sean sistemas de archivos independientes (como los volúmenes LVM) no serán visibles.

Ajuste del rendimiento

TCP multiconexión (nconnect): para un mayor rendimiento de un solo cliente en NIC modernas, añade nconnect=4 (hasta 16) a tus opciones de montaje:

192.168.1.100:/srv/nfs/media /mnt/server-media nfs _netdev,nfsvers=4.2,hard,timeo=600,retrans=2,nconnect=4  0 0

Nota: nconnect se fija en el primer montaje y no se puede cambiar sin remontar.

Hilos del servidor: el valor predeterminado son 8 hilos de trabajo de nfsd. Para varios clientes, súbelo a 16 o más en /etc/nfs.conf:

[nfsd]
threads=16

Exportaciones asíncronas: usar async en lugar de sync en /etc/exports puede mejorar el rendimiento en discos mecánicos, pero con riesgo de pérdida de datos si el servidor falla. Úsalo solo para datos no críticos, como cachés multimedia.

Protege NFS con Kerberos, TLS y VPN

Kerberos: para autenticación y cifrado reales, NFS soporta sec=krb5, sec=krb5i (integridad) y sec=krb5p (privacidad). Requiere un KDC de Kerberos, un principal nfs/<server-fqdn>, la extracción del keytab y la configuración de gssproxy/rpc-gssd tanto en el servidor como en los clientes. Es la opción correcta para entornos de producción, pero compleja para redes domésticas. Consulta la guía oficial de NFS con Kerberos de Ubuntu para el procedimiento completo.

NFS sobre TLS: disponible desde el kernel 6.4 de Linux (RFC 9289, RPC-with-TLS). Requiere ktls-utils/tlshd y certificados. RHEL 9.6+ lo soporta oficialmente. Todavía está madurando para uso general.

VPN WireGuard (recomendada para redes domésticas): la forma más sencilla de proteger NFS a través de redes no fiables. Ejecuta NFS dentro de un túnel WireGuard: todo el tráfico va cifrado y solo los pares de la VPN pueden alcanzar el puerto 2049. Si necesitas un VPS barato como relevo de WireGuard o nodo de copias externas, Hetzner Cloud VPS parte de unos pocos euros al mes en centros de datos de la UE.

Los precios de los VPS subieron en general en 2026; si estás reconsiderando una máquina alquilada, mira qué cambió y cuándo gana un mini PC.

Mapeo UID/GID en contenedores

Cuando ejecutas contenedores Docker que acceden a recursos NFS, tienes que hacer coincidir el UID del contenedor con la propiedad de la exportación.

Uso de all_squash con PUID/PGID:

Exporta con UID/GID explícitos:

/srv/nfs/appdata  192.168.1.0/24(rw,sync,no_subtree_check,all_squash,anonuid=1000,anongid=1000)

Para las imágenes de linuxserver.io (Jellyfin, Plex, etc.), define PUID=1000 y PGID=1000 para que coincidan.

Volumen NFS con nombre en Docker Compose:

services:
  jellyfin:
    image: jellyfin/jellyfin
    volumes:
      - media:/media:ro
      - ./config:/config

volumes:
  media:
    driver: local
    driver_opts:
      type: nfs
      o: addr=192.168.1.100,rw,nfsvers=4.2,hard,timeo=600,retrans=2
      device: ":/srv/nfs/media"

Esto es mejor que un bind-mount del host porque el volumen con nombre sobrevive a configuraciones multi-host y las opciones de NFS se declaran en el propio archivo compose.

Paso 4: Monitoriza y mantén NFS

Comprueba el estado de NFS y las exportaciones

# Check NFS server status
sudo systemctl status nfs-kernel-server

# View active exports with options
sudo exportfs -v

# Check active connections on port 2049
sudo ss -tuln | grep :2049

Estadísticas y registros de NFS

# Server statistics
nfsstat -s

# Client statistics
nfsstat -c

# Real-time I/O statistics (install nfs-common if not present)
nfsiostat 1

# NFS-related kernel messages
dmesg | grep -i nfs

# Server logs
sudo journalctl -u nfs-kernel-server

# Verify effective server configuration
sudo nfsconf --dump

Mantente parcheado: CVE recientes de NFS

Solución de problemas comunes de NFS

Connection refused

Lista de verificación:

mount.nfs: access denied by server

Síntoma: mount.nfs: access denied by server al intentar montar.

Causa: un error de sintaxis en la exportación, una IP/subred que no coincide, o la IP del cliente no está en la lista de exportación.

Solución:

# On the server, check what's actually exported
sudo exportfs -v

# Verify /etc/exports syntax (no missing parentheses, correct IPs)
cat /etc/exports

# Re-apply after fixing
sudo exportfs -arv

Permission denied (mapeo UID/GID)

Síntoma: puedes montar el recurso compartido, pero recibes «Permission denied» al escribir.

Causa: el clásico desajuste de UID/GID. Con propiedad nobody:nogroup y chmod 755, un usuario normal (UID 1000) en el cliente pasa a ser «otros», con solo lectura y ejecución.

Solución:

# Check your UID on the client
id

# Option 1: Match UIDs, create the same user on the server
sudo useradd -u 1000 myuser

# Option 2: Use all_squash in /etc/exports
/srv/nfs/media  192.168.1.0/24(rw,sync,no_subtree_check,all_squash,anonuid=1000,anongid=1000)
sudo exportfs -arv

Stale file handle

Síntoma: error Stale file handle al acceder a los archivos.

Causa: el sistema de archivos del servidor fue reemplazado (restauración de un snapshot de LVM, rollback de btrfs) o la exportación se eliminó y se recreó mientras los clientes la tenían montada.

Solución:

# On the client, lazy unmount and remount
sudo umount -l /mnt/server-media
sudo mount -a

Protocol not supported

Síntoma: mount.nfs: Protocol not supported

Causa: desajuste de versiones de NFS: el cliente pide una versión que el servidor no soporta (o al revés).

Solución:

# Check supported versions on the server
cat /proc/fs/nfsd/versions

# Explicitly set the version in fstab
nfsvers=4.2

Rendimiento lento o bloqueos al arrancar

Bloqueos al arrancar: el servidor NFS no es accesible durante el arranque y el montaje bloquea el proceso. Solución: usa x-systemd.automount o añade nofail a las opciones de fstab.

Rendimiento lento:

# Check negotiated buffer sizes and version
grep server-media /proc/mounts

# Try adding nconnect for parallel TCP connections
# In /etc/fstab: add nconnect=4

# Real-time I/O stats
nfsiostat 1

NFS en un servidor doméstico

Estructura de directorios para un servidor multimedia

/srv/nfs/media/
├── movies/
├── tv-shows/
├── music/
└── photos/

Esta estructura funciona bien con Jellyfin, Plex o Emby. El mini PC N100 sirve estos archivos por la red: cualquier máquina con un montaje NFS puede acceder a toda la biblioteca multimedia. Si buscas un mini PC compacto para tu servidor doméstico, hay muchas opciones de bajo consumo que manejan NFS y Docker sin despeinarse.

Estrategia de copias de seguridad con NFS

Combinado con añadir un disco nuevo a Ubuntu LVM para ampliar el almacenamiento:

# Backup scripts can target NFS shares
rsync -av /home/user/documents/ /mnt/server-backups/user-docs/

# Exclude unnecessary files, see [excluding files and directories with rsync](https://www.bitdoze.com/exclude-directories-files-copy-remote-machine/)
rsync -av --exclude='.cache' --exclude='node_modules' /home/user/ /mnt/server-backups/user-home/

Integración con contenedores Docker

Para ejecutar contenedores Docker en un servidor doméstico que necesitan multimedia compartida:

services:
  jellyfin:
    image: jellyfin/jellyfin
    environment:
      - PUID=1000
      - PGID=1000
    volumes:
      - media:/media:ro
      - ./config:/config
    ports:
      - 8096:8096

volumes:
  media:
    driver: local
    driver_opts:
      type: nfs
      o: addr=192.168.1.100,rw,nfsvers=4.2,hard,timeo=600,retrans=2
      device: ":/srv/nfs/media"

Si usas all_squash, haz coincidir los valores PUID/PGID con anonuid/anongid de tus exportaciones.

Buenas prácticas y consideraciones de seguridad

Buenas prácticas de seguridad

Copias de seguridad y redundancia

Consideraciones de red

• Usa conexiones por cable cuando sea posible; NFS sobre WiFi funciona, pero es menos fiable
• Configura la monitorización de la red; consulta la guía completa de monitorización de servidores
• Considera la segmentación de red por seguridad; aísla el tráfico NFS en una VLAN si tu switch lo permite
• Sin cifrado por defecto: el tráfico NFS va en texto plano. Usa WireGuard si cruza redes no fiables

Conclusión

NFS en Linux te da un uso compartido de archivos rápido y a nivel de kernel en toda tu red. Llevo tiempo ejecutándolo en mi mini PC N100 junto a Jellyfin, y gestiona el streaming multimedia, las copias de seguridad y el intercambio de documentos sin problemas.

Empieza por lo básico: instala nfs-kernel-server, configura /etc/exports con root_squash y monta desde tus clientes. Cuando funcione, añade el automontaje de systemd para evitar bloqueos en el arranque y restríngelo a NFSv4-only para una mayor seguridad. Todo el montaje lleva menos de 30 minutos.

Para seguir montando tu servidor doméstico, consulta los mejores mini PC para servidores domésticos, los contenedores Docker para un servidor doméstico y por qué necesitas un servidor doméstico en 2026.