"title":"Host: monta condivisione NFS sull’host | Documentazione ProxMenux",
"description":"Monta un’esportazione NFS esterna sull’host Proxmox come storage Proxmox tramite pvesm add nfs, come semplice montaggio fstab sull’host non visibile in Datacenter > Storage oppure in entrambi i modi. Il metodo fstab è adatto a condividere il percorso con i container LXC tramite bind mount senza registrarlo come storage Proxmox.",
"ogTitle":"Host: monta condivisione NFS sull’host | Documentazione ProxMenux",
"ogDescription":"Monta un’esportazione NFS esterna sull’host Proxmox tramite pvesm, fstab o entrambi. La modalità fstab è adatta ai bind mount LXC."
},
"header":{
"title":"Host: monta condivisione NFS sull’host",
"description":"Monta sull’host Proxmox un’esportazione NFS proveniente da un NAS, un altro server o una condivisione del tuo homelab. Puoi registrarla come storage Proxmox visibile in Datacenter > Storage, aggiungere un montaggio tramite /etc/fstab in un percorso a scelta oppure usare entrambi i metodi. Il percorso separato è utile per i bind mount nei container LXC senza registrare uno storage Proxmox.",
"section":"Archiviazione e condivisione · Host"
},
"intro":{
"title":"Cosa succede?",
"body":"ProxMenux offre due metodi per montare un’esportazione NFS: <strong>(1) Storage Proxmox</strong> tramite <code>pvesm add nfs</code>. La condivisione compare in Datacenter > Storage e Proxmox gestisce il montaggio in <code>/mnt/pve/<id></code>. <strong>(2) Montaggio fstab sull’host</strong> in un percorso a scelta, reso permanente tramite <code>/etc/fstab</code>. Non compare come storage Proxmox ed è adatto ai bind mount nei container LXC, senza aggiungere voci nell’interfaccia Proxmox. Puoi usare uno dei due metodi oppure entrambi."
},
"opening":{
"heading":"Apertura dello strumento",
"body":"Dal menu principale di ProxMenux, apri <strong>Storage & Share Manager → Mount NFS Share on Host</strong>. Il sottomenu presenta quattro opzioni:",
"body":"Il flusso ha due fasi con chiara separazione tra \"scoprire, validare e scegliere\" e \"montare effettivamente e scrivere la configurazione\". Dopo aver selezionato un'esportazione, scegli il metodo di montaggio (s) tramite una lista di controllo; il resto delle finestre di dialogo chiede solo params per i metodi selezionati. Fino alla conferma finale, non si toccano né <code>/etc/pve/storage.cfg</code> né <code>/etc/fstab</code>."
},
"modes":{
"heading":"Selezione del metodo di montaggio (una o entrambe le opzioni)",
"intro":"Dopo aver selezionato e convalidato l'esportazione, ProxMenux mostra una lista di controllo con i due metodi di montaggio. Puoi selezionare uno o entrambi. Se si preme OK senza marcare nulla, la finestra di dialogo riappare fino a quando si sceglie almeno una opzione o premere Annulla per uscire dal flusso.",
"imageAlt":"Elenco di controllo del metodo di montaggio con opzioni pvesm e fstab",
"mountRich":"<code>/mnt/pve/<storage-id></code> (gestito da Proxmox)",
"ui":"Sì",
"useCase":"VM immagini disco, backup, ISO, modelli LXC — tutto ciò che deve apparire nell'interfaccia utente Proxmox."
},
{
"method":"<strong>Solo fstab dell'host</strong>",
"mountRich":"<code>/mnt/<path></code> (si sceglie il percorso)",
"ui":"No",
"useCaseRich":"Collega la condivisione a uno o più LXC tramite bind mount <em>senza</em> registrarla come storage Proxmox. Mantiene ordinata l’interfaccia Datacenter."
},
{
"method":"<strong>Entrambi</strong>",
"mount":"Entrambi i percorsi sopra (due punti di montaggio della stessa esportazione NFS)",
"ui":"Sì",
"useCase":"Integrazione nell’interfaccia e percorso stabile separato sull’host con permessi aperti per bind mount LXC."
}
],
"bothTitle":"“Entrambi” crea due montaggi NFS indipendenti",
"bothBody":"I due metodi vengono eseguiti separatamente: pvesm monta in <code>/mnt/pve/<id></code> e fstab in <code>/mnt/<path></code>. Si ottiene un montaggio gestito da Proxmox con opzioni predefinite e un montaggio host separato per bind mount LXC. Due punti di montaggio non garantiscono due connessioni TCP: il client NFS può riutilizzare le connessioni di trasporto."
},
"pvesmBranch":{
"heading":"Metodo A — Come stoccaggio Proxmox (pvesm)",
"intro":"Se è selezionato <em>Come storage Proxmox</em>, ProxMenux esegue la procedura pvesm originale:",
"items":[
"<strong>Storage ID</strong> — ciò che Proxmox chiamerà questo storage. Predefinito è <code>nfs-<server-ip-with-dashes></code>. Sono accettate solo lettere, cifre, <code>-</code> e <code>_</code>.",
"<strong>Content type</strong> — Proxmox lega le categorie di contenuti ai volumi di archiviazione; selezionare ciò che questo NFS è permesso di tenere:"
],
"headerType":"Tipo di contenuto",
"headerAllows":"Cosa permette",
"rows":[
{
"type":"import",
"allowsRich":"Importazioni dell'immagine del disco (selezionate per impostazione predefinita). Necessità di <em>Import Disk Image a VM</em>."
},
{
"type":"backup",
"allowsRich":"File di backup VM e CT (<code>vzdump</code>)."
},
{
"type":"iso",
"allows":"Installazione immagini ISO."
},
{
"type":"vztmpl",
"allows":"Modelli LXC."
},
{
"type":"images",
"allows":"Immagini disco delle VM in uso: rende NFS uno storage per dischi VM."
},
{
"type":"rootdir",
"allows":"File system radice LXC (rari su NFS — leggi la nota sotto)."
},
{
"type":"snippets",
"allows":"Script hook e frammenti cloud-init."
}
],
"warnTitle":"images e rootdir su NFS",
"warnBody":"Selezionando <code>images</code> puoi archiviare dischi VM su NFS. Le prestazioni dipendono da rete, server e carico; un’interruzione può bloccare l’I/O che dipende dal montaggio. <code>rootdir</code> archivia file system radice LXC su NFS, dove i container non privilegiati possono incontrare limiti di mappatura UID, overlay e proprietà. Valuta questi requisiti prima di collocarvi <code>images</code> / <code>rootdir</code>; NFS è utile anche per <code>backup</code> / <code>iso</code> / <code>vztmpl</code>.",
"result":"Il risultato è <code>pvesm add nfs <id> --server <srv> --export <path> --content <csv></code> e Proxmox auto-mount a <code>/mnt/pve/<id></code>."
},
"fstabBranch":{
"heading":"Metodo B — solo montaggio tramite fstab sull’host",
"intro":"Se <em>Solo montaggio fstab sull’host</em> è contrassegnato, ProxMenux chiede un percorso di montaggio host e opzioni persistenti, quindi monta e scrive l'ingresso a <code>/etc/fstab</code>:",
"items":[
"<strong>Percorso di montaggio sull’host</strong> — default <code>/mnt/<export-basename></code>. Dev'essere un percorso assoluto. Se qualcosa è già montato là, o una voce fstab esiste per lo stesso percorso, ProxMenux vi avverte e le offerte per sostituirlo.",
"<strong>Opzioni di montaggio</strong> — <em>Lettura/scrittura</em> (predefinito: <code>rw,hard,nofail,_netdev,rsize=131072,wsize=131072,timeo=600,retrans=2</code>), <em>Sola lettura</em>, <em>Personalizzato</em> (inserisci le tue opzioni)."
],
"appliesIntro":"Dopo la conferma, lo script:",
"applies":[
"<code>mkdir -p</code> il percorso di montaggio.",
"Scrive una voce di una linea a <code>/etc/fstab</code>: <code><srv>:<export> <path> nfs <opts> 0 0</code>.",
"Esegue <code>systemctl daemon-reload</code> così systemd raccoglie la nuova voce fstab.",
"Tenta <code>chmod 1777</code> e <code>setfacl o::rwx</code> sul punto di montaggio, ignorando gli eventuali errori. Riesce solo se il server NFS lo permette; molte esportazioni NAS consentono già la scrittura a tutti gli utenti."
],
"lxcTitle":"Usare da un LXC il filesystem montato tramite fstab",
"lxcBody":"Lo script mostra un comando <code>pct set</code> per un bind mount, ad esempio <code>pct set <ctid> -mp0 /mnt/<path>,mp=/mnt/<ct-path>,shared=1,backup=0</code>. In alternativa, <mountLink>LXC Mount Manager</mountLink> rileva i montaggi fstab. <strong>Non viene modificato nulla nel container</strong>. L’accesso di un CT non privilegiato dipende dai permessi sul server per i suoi UID/GID mappati. Lo script tenta solo modifiche ai permessi dall’host e non garantisce esportazioni scrivibili o impostazioni predefinite dei produttori. Se l’accesso fallisce, consulta Risoluzione dei problemi.",
"noUiTitle":"Il montaggio tramite fstab NON è uno storage Proxmox",
"noUiBody":"Il montaggio tramite fstab sull’host rimane intenzionalmente invisibile nell’interfaccia web Proxmox. Non compare in <em>Datacenter > Storage</em>, non è selezionabile durante la creazione di VM o CT e non può essere scelto come destinazione dei processi di backup Proxmox. È soltanto un percorso nel filesystem dell’host. Per avere anche l’integrazione nell’interfaccia, seleziona <em>entrambi</em> i metodi."
},
"manual":{
"heading":"Equivalente manuale",
"pvesmIntro":"Il metodo A (pvesm) corrisponde a:",
"fstabIntro":"Il metodo B (fstab) corrisponde a:"
},
"view":{
"heading":"Visualizzare gli archivi NFS configurati",
"body":"Elenca tutte le voci NFS registrate in Proxmox (<code>pvesm status | awk ''$2 == \"nfs\"''</code>) con server, esportazione, tipi di contenuto, percorso e stato attuale del montaggio. <strong>Nota:</strong> questa vista mostra solo gli storage registrati tramite pvesm. I montaggi configurati soltanto in fstab non compaiono; controllali con <code>findmnt -t nfs</code> o <code>grep nfs /etc/fstab</code>."
},
"remove":{
"heading":"Rimuovere lo storage NFS",
"body":"Esegue <code>pvesm remove <storage-id></code> dopo una conferma che mostra il server / esportazione / contenuto. Solo la registrazione sul lato Proxmox viene rimossa — <strong> il server NFS remoto non viene mai toccato</strong>, nessun file viene eliminato. Per rimuovere un montaggio solo fstab, modificare <code>/etc/fstab</code> a mano ed eseguire <code>umount <path></code>.",
"warnTitle":"Prima esegui il backup delle dipendenze",
"warnBody":"Se VM, CT o lavori di backup fanno ancora riferimento a questo storage (da ID), rimuoverlo li lascia puntare in uno storage non più disponibile. Proxmox segnalerà l’errore ma non ripulirà. Spostare o rilasciare i riferimenti prima, quindi rimuovere lo storage."
},
"test":{
"heading":"Test di connettività NFS",
"body":"Esegue un passaggio diagnostico su ogni storage NFS registrato in Proxmox: controlla che <code>showmount</code> è disponibile, che <code>rpcbind</code> è in esecuzione, pings ogni server, sonde porta 2049, chiama <code>showmount -e</code>, e infine segnala la propria vista di Proxmox (<code>pvesm status</code>). Buona prima fermata quando uno storage mostra come <em>inactive</em> nell'interfaccia Proxmox."
},
"troubleshoot":{
"heading":"Risoluzione dei problemi",
"noServersTitle":"\"Nessun server NFS trovato sulla rete\"",
"noServersBody":"Auto-scoprimento utilizza <code>nmap -p 2049 --open <subnet>/24</code>. Il server non può rispondere se: è su una diversa VLAN / subnet, il suo firewall blocca nmap sonde (molti fanno) o la porta 2049 è volutamente chiusa su quell'interfaccia. Utilizzare l'opzione <em>Manual</em> con IP o hostname del server.",
"portTitle":"«La porta NFS (2049) non è accessibile»",
"portBody":"Ping riuscì ma <code>nc -z -w 3 <server> 2049</code> fallì. Controllare il servizio NFS è in esecuzione sul server (<code>systemctl status nfs-server</code> su Linux, Pannello di controllo → File Services on Synology, NFS plugin su OMV / TrueNAS), e che il firewall consente 2049 dall'host Proxmox.",
"showmountTitle":"\"Failed to connect\" da showmount",
"showmountBody":"Il server ha rifiutato la query della lista delle esportazioni. Cause comuni: il server applica il client rigoroso ACLs (il vostro IP Proxmox non è nell'elenco consentito), <code>rpcbind</code> non è in esecuzione sul server, o il server espone solo NFSv4 con <code>showmount</code> disabilitato. Il percorso di esportazione può ancora essere aggiunto manualmente se lo conosci.",
"inactiveTitle":"Lo stoccaggio mostra come inattivo nell'UI Proxmox",
"inactiveBody":"Esegui prima <em>Testa connettività NFS</em>: verifica che il server risponda al ping, che la porta 2049 sia aperta e che l’elenco delle esportazioni (<code>showmount -e</code>) sia disponibile. Se la connessione funziona ma lo storage rimane inattivo, controlla <code>journalctl -u pvestatd</code> e la configurazione server/esportazione. Ripristina prima connessione o permessi. <code>pvesm set <id> --disable 0</code> abilita uno storage disabilitato; non è una riparazione generica di NFS.",
"lxcNoWriteTitle":"Il montaggio fstab funziona ma il LXC non privilegiato non può scrivere tramite bind mount",
"lxcNoWriteBody":"L’accesso NFS dipende da proprietari, ACL e squash sul server. Le opzioni CIFS <code>uid=</code> e <code>file_mode=</code> <strong>non</strong> si applicano a NFS. Con la mappatura LXC predefinita, root nel CT diventa UID 100000 sull’host, non UID remoto 0. Configura l’accesso per l’UID/GID mappato effettivo o l’identità anonima del server. <code>no_root_squash</code> riguarda solo l’UID remoto 0 e non risolve ogni caso di UID 100000. Lo script tenta <code>chmod 1777</code> ma non aggira i permessi del server.",
"fstabBootTitle":"fstab mount non arriva dopo il riavvio",
"fstabBootBody":"Lo script aggiunge <code>nofail,_netdev</code> quindi una parte mancante all'avvio non blocca l'avvio. Se il montaggio non arriva mai: confermare la rete è raggiungibile (<code>ping <server></code>), controllare <code>journalctl -u remote-fs.target</code>, e verificare che l'ingresso sia valido con <code>mount -fav | grep nfs</code>. <code>mount -a</code> dopo il boot monta tutto ciò che attualmente manca."
},
"related":{
"heading":"Correlati",
"items":[
{
"href":"/docs/storage-share/host-samba",
"label":"Samba / CIFS come storage Proxmox",
"tail":"— stesso modello di flusso (Method A pvesm + Metodo B fstab) per le condivisioni SMB/CIFS."
},
{
"href":"/docs/storage-share/lxc-mount-points",
"label":"Gestore montaggi LXC",
"tailRich":"— eseguire il bind mount del percorso <code>/mnt/<path></code> in uno o più contenitori."
},
{
"href":"/docs/storage-share/lxc-nfs-client",
"label":"client NFS in LXC",
"tail":"— alternativa: montare NFS direttamente dall'interno di un contenitore privilegiato (senza passare dall’host)."
