Thomas.will: Neuer Artikel: virtiofs in Proxmox

2026-10-23T13:49:31Z

Neuer Artikel: virtiofs in Proxmox

Neue Seite

=Beschreibung=
*Mit virtiofs reicht Proxmox ein Verzeichnis des Hosts direkt an eine VM durch.
*Die VM bindet es wie ein normales Dateisystem ein. Es braucht dafür weder Netzwerk noch einen NFS-Server auf dem Host.
*Das ist schnell, weil Dateizugriffe ohne Umweg über das Netzwerk laufen.
*Die VM sieht nur dieses eine Verzeichnis und nicht den Rest des Hosts.

=Voraussetzungen=
*Proxmox VE ab 8.4 (die Weboberfläche zeigt dann den Eintrag ''Directory Mappings'').
*Auf dem Host das Paket virtiofsd:
<pre>
# dpkg -l | grep virtiofsd || apt install virtiofsd
</pre>
*In der VM ein Linux-Kernel mit virtiofs (jeder aktuelle Debian-, Ubuntu- oder Rocky-Kernel).

=Auf dem Proxmox-Host=
==Verzeichnis zuordnen==
*Datacenter
**Directory Mappings
***Add
*Eintragen:
{| class="wikitable"
! Feld
! Bedeutung
|-
| ID
| Name der Freigabe, z. B. ''austausch''. Das ist später der Tag in der VM.
|-
| Node
| Der Proxmox-Host, auf dem das Verzeichnis liegt
|-
| Path
| Verzeichnis auf dem Host, z. B. ''/tank/austausch''
|}
*Auf der Kommandozeile geht dasselbe:
<pre>
# pvesh create /cluster/mapping/dir --id austausch --map node=<hostname>,path=/tank/austausch
</pre>
*Der Eintrag steht nicht bei ''Resource Mappings → PCI/USB'', sondern im eigenen Punkt ''Directory Mappings''.

==Freigabe der VM geben==
*VM
**Hardware
***Add
****Virtiofs
*Das eben angelegte Mapping wählen.
*Die VM danach über Proxmox '''stoppen und neu starten'''. Ein Reboot aus der VM heraus reicht nicht, weil QEMU neu gestartet werden muss.
*Was einer VM zugewiesen ist:
<pre>
# qm config <vmid> | grep virtiofs
</pre>

=In der VM=
==Angebotene Freigaben anzeigen==
<pre>
# cat /sys/fs/virtiofs/*/tag
austausch
</pre>
*Pro Freigabe steht eine Zeile da. Der Tag ist der Name aus dem Mapping.

==Einbinden==
<pre>
# mkdir -p /mnt/austausch
# mount -t virtiofs austausch /mnt/austausch
# findmnt -t virtiofs
</pre>
*Dauerhaft in der ''/etc/fstab'':
<pre>
austausch /mnt/austausch virtiofs defaults,nofail,noexec,nosuid,nodev 0 0
</pre>
*''nofail'' verhindert, dass die VM beim Start hängt, wenn die Freigabe fehlt.
*''noexec,nosuid,nodev'' sind sinnvoll, wenn dort nur Daten liegen sollen. Programme in diesem Verzeichnis lassen sich dann nicht starten.

=Rechte=
*virtiofs reicht Besitzer und Gruppe (UID und GID) unverändert durch. Die Zahlen auf dem Host müssen zu denen in der VM passen.
*Läuft in der VM ein Dienst mit der UID 5001, gehört das Verzeichnis auf dem Host dazu:
<pre>
# chown -R 5001:5001 /tank/austausch
</pre>
*Der Dienst in der VM sieht nur das, was seine UID dort darf. Der Host-Benutzer ''root'' hat auf der Host-Seite weiter vollen Zugriff.

=Grenzen=
*Live-Migration einer VM mit virtiofs ist nicht möglich.
*Der Inhalt des Verzeichnisses ist '''nicht''' Teil des VM-Backups. Das Verzeichnis muss separat gesichert werden.

=Stolperfallen=
{| class="wikitable"
! Problem
! Lösung
|-
| Kein Eintrag ''Directory Mappings''
| Proxmox ist älter als 8.4. Erst aktualisieren. Danach Browser-Cache leeren (Strg+Shift+R) oder ''systemctl restart pveproxy''.
|-
| ''cat /sys/fs/virtiofs/*/tag'' zeigt nichts
| Die VM wurde noch nicht über Proxmox gestoppt und neu gestartet.
|-
| ''mount'' meldet ''unknown filesystem type''
| Der Kernel hat kein virtiofs, oder das Modul fehlt (''modprobe virtiofs'').
|-
| ''Permission denied'' beim Schreiben
| UID und GID auf dem Host stimmen nicht mit dem Benutzer in der VM überein.
|}

=Quelle=
*https://pve.proxmox.com/wiki/Virtiofs

[[Kategorie:Proxmox]]

Proxmox virtiofs - Versionsgeschichte

Thomas.will: Neuer Artikel: virtiofs in Proxmox