ProxMenux/web/messages/es/docs/storage-share/host-nfs.json

{
  "meta": {
    "title": "Host: montar recurso NFS en el host | Documentación de ProxMenux",
    "description": "Monta un export NFS externo en el host Proxmox — bien como almacenamiento de Proxmox (pvesm add nfs), bien como un montaje fstab del host normal (NO visible en Datacenter > Storage), o ambos. El método fstab es ideal para hacer bind mount del share en contenedores LXC sin exponerlo como almacenamiento de Proxmox.",
    "ogTitle": "Host: montar recurso NFS en el host | Documentación de ProxMenux",
    "ogDescription": "Monta un export NFS externo en el host Proxmox vía pvesm, fstab o ambos. La ruta fstab es ideal para bind mounts LXC."
  },
  "header": {
    "title": "Host: montar share NFS en el host",
    "description": "Monta un export NFS externo (de un NAS, otro servidor, un share de homelab…) en el host Proxmox. Elige uno o ambos métodos: regístralo como almacenamiento de Proxmox (visible en Datacenter > Storage) y/o añade un montaje /etc/fstab normal en una ruta que tú elijas (útil para hacer bind mount del share en contenedores LXC sin exponerlo como almacenamiento de Proxmox).",
    "section": "Almacenamiento y compartición · Host"
  },
  "intro": {
    "title": "Qué hace",
    "body": "ProxMenux ofrece dos métodos de montaje para cualquier export NFS: <strong>(1) Almacenamiento de Proxmox</strong> vía <code>pvesm add nfs</code> — el share aparece en Datacenter > Storage y Proxmox gestiona el montaje en <code>/mnt/pve/&lt;id&gt;</code>; <strong>(2) Montaje fstab del host</strong> en una ruta que tú elijas — persistente vía <code>/etc/fstab</code>, NO visible como almacenamiento de Proxmox, ideal para hacer bind mount en contenedores LXC (la UI de Proxmox queda limpia). Puedes ejecutar un método, el otro o ambos."
  },
  "opening": {
    "heading": "Abrir la herramienta",
    "body": "Desde el menú principal de ProxMenux, abre <strong>Storage &amp; Share Manager → Mount NFS Share on Host</strong>. Verás este submenú con cuatro opciones:",
    "imageAlt": "Menú NFS del host — Montar / Ver / Eliminar / Probar conectividad"
  },
  "howRuns": {
    "heading": "Cómo se ejecuta el script",
    "body": "El flujo tiene dos fases con una separación clara entre \"descubrir, validar y elegir\" y \"montar / escribir config realmente\". Tras seleccionar un export, eliges el método o métodos de montaje vía una lista de verificación; el resto de diálogos solo piden parámetros para los métodos que seleccionaste. Hasta la confirmación final, ni <code>/etc/pve/storage.cfg</code> ni <code>/etc/fstab</code> se tocan."
  },
  "modes": {
    "heading": "Selector de método de montaje (dos opciones, marca una o ambas)",
    "intro": "Tras seleccionar y validar el export, ProxMenux muestra una lista de verificación con los dos métodos de montaje. Puedes marcar uno o ambos. Si pulsas OK sin marcar nada, el diálogo reaparece hasta que elijas al menos una opción o pulses Cancel para salir del flujo.",
    "imageAlt": "Lista de verificación de método de montaje con opciones pvesm y fstab",
    "headerMethod": "Método",
    "headerMount": "Ruta de montaje",
    "headerUi": "Visible en Datacenter > Storage",
    "headerUseCase": "Caso de uso típico",
    "rows": [
      {
        "method": "<strong>Como almacenamiento de Proxmox (pvesm)</strong>",
        "mountRich": "<code>/mnt/pve/&lt;storage-id&gt;</code> (gestionado por Proxmox)",
        "ui": "Sí",
        "useCase": "Imágenes de disco de VM, backups, ISOs, templates LXC — cualquier cosa que necesite aparecer en la UI de Proxmox."
      },
      {
        "method": "<strong>Solo fstab del host</strong>",
        "mountRich": "<code>/mnt/&lt;path&gt;</code> (tú eliges la ruta)",
        "ui": "No",
        "useCaseRich": "Hacer bind mount del share en uno o más LXCs <em>sin</em> exponerlo como almacenamiento de Proxmox. Mantiene la UI de Datacenter limpia."
      },
      {
        "method": "<strong>Ambos</strong>",
        "mount": "Ambas rutas anteriores (dos puntos de montaje del mismo export NFS)",
        "ui": "Sí",
        "useCase": "Integración con la interfaz y una ruta estable separada en el host con permisos abiertos para bind mounts LXC."
      }
    ],
    "bothTitle": "\"Ambos\" crea dos montajes NFS independientes",
    "bothBody": "Los dos métodos se ejecutan por separado: pvesm monta en <code>/mnt/pve/&lt;id&gt;</code> y fstab en <code>/mnt/&lt;path&gt;</code>. Así tienes un montaje gestionado por Proxmox con opciones predeterminadas y otro en el host para bind mounts LXC. Dos puntos de montaje no garantizan dos conexiones TCP: el cliente NFS puede reutilizarlas."
  },
  "pvesmBranch": {
    "heading": "Método A — Como almacenamiento de Proxmox (pvesm)",
    "intro": "Si <em>Como almacenamiento de Proxmox</em> está marcado, ProxMenux ejecuta el flujo pvesm original:",
    "items": [
      "<strong>Storage ID</strong> — cómo llamará Proxmox a este almacenamiento. Por defecto es <code>nfs-&lt;server-ip-with-dashes&gt;</code>. Solo se aceptan letras, dígitos, <code>-</code> y <code>_</code>.",
      "<strong>Content types</strong> — Proxmox vincula categorías de contenido a volúmenes de almacenamiento; elige qué se le permite a este NFS contener:"
    ],
    "headerType": "Tipo de contenido",
    "headerAllows": "Qué permite",
    "rows": [
      {
        "type": "import",
        "allowsRich": "Importaciones de imágenes de disco (seleccionado por defecto). Necesario para <em>Import Disk Image to VM</em>."
      },
      {
        "type": "backup",
        "allowsRich": "Archivos de backup de VM y CT (<code>vzdump</code>)."
      },
      {
        "type": "iso",
        "allows": "Imágenes ISO de instalación."
      },
      {
        "type": "vztmpl",
        "allows": "Templates LXC."
      },
      {
        "type": "images",
        "allows": "Imágenes de disco de VM en vivo (esto convierte el NFS en un almacén de discos de VM)."
      },
      {
        "type": "rootdir",
        "allows": "Sistemas de archivos raíz de LXC (raro para NFS — lee la nota de abajo)."
      },
      {
        "type": "snippets",
        "allows": "Scripts de hook y snippets cloud-init."
      }
    ],
    "warnTitle": "images y rootdir en NFS",
    "warnBody": "Seleccionar <code>images</code> permite guardar discos de VM en NFS. El rendimiento depende de la red, el servidor y la carga; una caída puede bloquear la E/S que dependa del montaje. Seleccionar <code>rootdir</code> guarda sistemas de archivos raíz LXC en NFS, donde los contenedores sin privilegios pueden encontrar limitaciones de mapeo de UID, overlay y propiedad. Evalúa estos requisitos antes de colocar <code>images</code> / <code>rootdir</code> ahí; NFS también sirve para <code>backup</code> / <code>iso</code> / <code>vztmpl</code>.",
    "result": "El resultado es <code>pvesm add nfs &lt;id&gt; --server &lt;srv&gt; --export &lt;path&gt; --content &lt;csv&gt;</code> y Proxmox automonta en <code>/mnt/pve/&lt;id&gt;</code>."
  },
  "fstabBranch": {
    "heading": "Método B — Solo montaje fstab del host",
    "intro": "Si <em>Solo como montaje fstab del host</em> está marcado, ProxMenux pide una ruta de montaje del host y opciones persistentes, luego monta y escribe la entrada en <code>/etc/fstab</code>:",
    "items": [
      "<strong>Ruta de montaje del host</strong> — por defecto <code>/mnt/&lt;export-basename&gt;</code>. Debe ser una ruta absoluta. Si algo ya está montado ahí, o existe una entrada fstab para la misma ruta, ProxMenux te avisa y ofrece reemplazarla.",
      "<strong>Opciones de montaje</strong> — <em>Lectura/escritura</em> (predeterminado: <code>rw,hard,nofail,_netdev,rsize=131072,wsize=131072,timeo=600,retrans=2</code>), <em>Solo lectura</em>, <em>Personalizado</em> (escribe tus propias opciones)."
    ],
    "appliesIntro": "Una vez confirmes, el script:",
    "applies": [
      "<code>mkdir -p</code> de la ruta de montaje.",
      "<code>mount -t nfs -o &lt;opts&gt; &lt;srv&gt;:&lt;export&gt; &lt;path&gt;</code>.",
      "Escribe una entrada de una línea en <code>/etc/fstab</code>: <code>&lt;srv&gt;:&lt;export&gt; &lt;path&gt; nfs &lt;opts&gt; 0 0</code>.",
      "Ejecuta <code>systemctl daemon-reload</code> para que systemd recoja la nueva entrada fstab.",
      "Intenta <code>chmod 1777</code> + <code>setfacl o::rwx</code> en el punto de montaje (best-effort silencioso — solo tiene éxito si el servidor NFS lo permite; muchos exports NAS ya sirven rutas world-writable)."
    ],
    "lxcTitle": "Usar el montaje fstab desde un LXC",
    "lxcBody": "El script muestra un comando <code>pct set</code> para un bind mount, p. ej. <code>pct set &lt;ctid&gt; -mp0 /mnt/&lt;path&gt;,mp=/mnt/&lt;ct-path&gt;,shared=1,backup=0</code>. También puedes usar <mountLink>LXC Mount Manager</mountLink>, que detecta los montajes fstab. <strong>No se cambia nada dentro del contenedor</strong>. El acceso desde un CT sin privilegios depende de los permisos del servidor para sus UID/GID mapeados. El script solo intenta ajustar permisos desde el host; no garantiza exports escribibles ni ajustes predeterminados de fabricantes. Si falla, consulta Solución de problemas.",
    "noUiTitle": "El montaje fstab NO es un almacenamiento de Proxmox",
    "noUiBody": "El montaje fstab del host es invisible para la UI web de Proxmox — por diseño. No aparece en <em>Datacenter > Storage</em>, no puedes seleccionarlo en el creador de VM / CT, y los trabajos de backup de Proxmox no pueden apuntarlo. Es puramente una ruta del sistema de archivos del host. Si quieres también integración con la UI, marca <em>ambos</em> métodos en el selector."
  },
  "manual": {
    "heading": "Equivalente manual",
    "pvesmIntro": "El Método A (pvesm) se traduce a:",
    "fstabIntro": "El Método B (fstab) se traduce a:"
  },
  "view": {
    "heading": "Ver almacenamientos NFS configurados",
    "body": "Lista cada entrada NFS en Proxmox (<code>pvesm status | awk ''$2 == \"nfs\"''</code>) con servidor, export, content types, ruta de montaje y estado en vivo. <strong>Nota:</strong> esta vista solo muestra almacenamientos registrados con pvesm — los montajes solo en fstab no se listan aquí. Compruébalos con <code>findmnt -t nfs</code> o <code>grep nfs /etc/fstab</code>."
  },
  "remove": {
    "heading": "Eliminar almacenamiento NFS",
    "body": "Ejecuta <code>pvesm remove &lt;storage-id&gt;</code> tras una confirmación que muestra servidor / export / contenido. Solo se elimina el registro del lado de Proxmox — <strong>el propio servidor NFS remoto nunca se toca</strong>, no se borran archivos. Para eliminar un montaje solo en fstab, edita <code>/etc/fstab</code> a mano y ejecuta <code>umount &lt;path&gt;</code>.",
    "warnTitle": "Haz backup de las dependencias primero",
    "warnBody": "Si VMs, CTs o trabajos de backup todavía referencian este almacenamiento (por ID), eliminarlo los deja apuntando a un almacén desaparecido. Proxmox marcará el error pero no limpiará. Mueve o elimina esas referencias primero, después elimina el almacenamiento."
  },
  "test": {
    "heading": "Probar conectividad NFS",
    "body": "Ejecuta una pasada de diagnóstico sobre cada almacenamiento NFS registrado en Proxmox: comprueba que <code>showmount</code> está disponible, que <code>rpcbind</code> está corriendo, hace ping a cada servidor, prueba el puerto 2049, llama a <code>showmount -e</code> y finalmente informa de la vista del propio Proxmox (<code>pvesm status</code>). Buena primera parada cuando un almacenamiento aparece como <em>inactive</em> en la UI de Proxmox."
  },
  "troubleshoot": {
    "heading": "Solución de problemas",
    "noServersTitle": "\"No se encontraron servidores NFS en la red\"",
    "noServersBody": "El auto-descubrimiento usa <code>nmap -p 2049 --open &lt;subnet&gt;/24</code>. El servidor puede no responder si: está en una VLAN / subnet diferente, su firewall bloquea las sondas nmap (muchos lo hacen) o el puerto 2049 está intencionalmente cerrado en esa interfaz. Usa la opción <em>Manual</em> con la IP o hostname del servidor en su lugar.",
    "portTitle": "«No se puede acceder al puerto NFS (2049)»",
    "portBody": "El ping tuvo éxito pero <code>nc -z -w 3 &lt;server&gt; 2049</code> falló. Comprueba que el servicio NFS está corriendo en el servidor (<code>systemctl status nfs-server</code> en Linux, Panel de Control → File Services en Synology, plugin NFS en OMV / TrueNAS) y que el firewall permite el 2049 desde el host Proxmox.",
    "showmountTitle": "\"Failed to connect\" desde showmount",
    "showmountBody": "El servidor rechazó la consulta de la lista de exports. Causas comunes: el servidor aplica ACLs de cliente estrictas (tu IP de Proxmox no está en la lista permitida), <code>rpcbind</code> no está corriendo en el servidor o el servidor expone solo NFSv4 con <code>showmount</code> deshabilitado. La ruta del export se puede añadir manualmente igualmente si la conoces.",
    "inactiveTitle": "El almacenamiento aparece como inactive en la UI de Proxmox",
    "inactiveBody": "Ejecuta primero <em>Probar la conectividad NFS</em>: comprueba que el servidor responde al ping, que el puerto 2049 está abierto y que la lista de exports (<code>showmount -e</code>) está disponible. Si la conectividad funciona pero sigue inactivo, consulta <code>journalctl -u pvestatd</code> y la configuración del servidor/export. Corrige primero la conectividad o los permisos. <code>pvesm set &lt;id&gt; --disable 0</code> habilita un almacenamiento deshabilitado; no repara fallos NFS en general.",
    "lxcNoWriteTitle": "El montaje fstab funciona pero un LXC unprivileged no puede escribir por un bind mount",
    "lxcNoWriteBody": "El acceso NFS depende de propiedad, ACL y squash en el servidor. Las opciones CIFS como <code>uid=</code> y <code>file_mode=</code> <strong>no</strong> se aplican a NFS. Con el mapeo LXC predeterminado, root del CT se convierte en UID 100000 del host, no en UID remoto 0. Da acceso al UID/GID mapeado real o a la identidad anónima del servidor. <code>no_root_squash</code> solo afecta al UID remoto 0, por lo que no resuelve todos los casos de UID 100000. El script intenta <code>chmod 1777</code>, pero no anula permisos del servidor.",
    "fstabBootTitle": "El montaje fstab no se levanta tras el reinicio",
    "fstabBootBody": "El script añade <code>nofail,_netdev</code> para que un share que falte al arranque no bloquee el inicio. Si el montaje nunca se levanta: confirma que la red es alcanzable (<code>ping &lt;server&gt;</code>), comprueba <code>journalctl -u remote-fs.target</code> y verifica que la entrada es válida con <code>mount -fav | grep nfs</code>. <code>mount -a</code> después del arranque monta todo lo que falte actualmente."
  },
  "related": {
    "heading": "Relacionado",
    "items": [
      {
        "href": "/docs/storage-share/host-samba",
        "label": "Samba / CIFS como almacenamiento de Proxmox",
        "tail": " — mismo patrón de flujo (Método A pvesm + Método B fstab) para shares SMB/CIFS."
      },
      {
        "href": "/docs/storage-share/lxc-mount-points",
        "label": "Gestor de montajes LXC",
        "tailRich": " — hacer bind mount de la ruta solo en fstab <code>/mnt/&lt;path&gt;</code> en uno o más contenedores."
      },
      {
        "href": "/docs/storage-share/lxc-nfs-client",
        "label": "Cliente NFS en LXC",
        "tail": " — alternativa: monta NFS directamente desde dentro de un contenedor privileged (se salta el host)."
      }
    ]
  }
}