Proxmox: Cloud-Init Images selbst erstellen und bereitstellen

Was ist Cloud-Init überhaupt?

Hallo und willkommen zu einem neuen Tutorial auf Server-Verstehen.de! Wenn du schon einmal einen Server (eine VM oder KVM) aufgesetzt hast, kennst du den Prozess: ISO-Datei herunterladen, einbinden, durch den Installations-Wizard klicken, Benutzer anlegen, Netzwerk konfigurieren… das kostet Zeit.

Was wäre, wenn du diesen ganzen Prozess auf wenige Sekunden reduzieren könntest? Genau hier kommt Cloud-Init ins Spiel.

Einfach gesagt, ist Cloud-Init der De-facto-Industriestandard, um Betriebssystem-Images (wie Debian, Ubuntu oder CentOS) beim ersten Start automatisch zu konfigurieren. Stell es dir wie ein „Erstes-Setup-Skript“ vor, das direkt in das Image eingebaut ist. Viele Hoster nutzen genau diese Technologie, um dir in Minuten einen einsatzbereiten vServer bereitzustellen.

In diesem Tutorial zeige ich dir, wie du Cloud-Init in Proxmox nutzt, um deine eigene perfekte VM-Vorlage (Template) zu erstellen. Nie wieder manuelle Installationen!

---

Die Vorteile: Warum solltet ihr Cloud-Init nutzen?

Bevor wir in die Kommandozeile springen, lass uns kurz klären, warum das so nützlich ist. Ein Cloud-Init-fähiges Image automatisiert beim ersten Start einer neuen VM die wichtigsten, aber oft mühsamen Aufgaben.

• Benutzer-Setup: Es legt automatisch deinen gewünschten Benutzer an (z. B. root oder einen anderen User) oder importiert ihn.
• Sicherheit: Dein öffentlicher SSH-Key kann direkt hinterlegt werden. Du musst dich nie wieder mit einem Passwort anmelden, was die Sicherheit massiv erhöht.
• Netzwerk: Es konfiguriert automatisch die Netzwerkeinstellungen, egal ob du eine statische IP oder DHCP (wie in unserem Beispiel) verwendest.
• Paket-Management: Es kann beim ersten Start automatisch alle Pakete aktualisieren (apt update && apt upgrade).
• Hostname: Es setzt den Hostnamen für deine neue VM.

Der größte Vorteil: Du erstellst einmal ein sauberes Template und kannst daraus in Sekunden Dutzende identische, vorkonfigurierte VMs klonen.

---

Schritt-für-Schritt: Dein eigenes Cloud-Init Template erstellen

Okay, genug der Theorie! Wir erstellen jetzt gemeinsam ein Template für Debian 13 „Trixie“ direkt auf deinem Proxmox-Host. Du benötigst dafür lediglich einen SSH-Zugang zu deinem Proxmox-Server (dem Host-System, nicht einer VM).

Schritt 1: Das Cloud-Init Image herunterladen

Zuerst laden wir das offizielle, fertige Cloud-Init-Image von Debian herunter. Diese Images sind im qcow2-Format, einem gängigen Format für virtuelle Festplatten.

Wir wechseln ins Root-Verzeichnis (oder einen anderen Ort deiner Wahl) und laden das Image mit wget.

# Wir wechseln ins root-Verzeichnis
cd /root

# Offizielles Debian 13 (Trixie) Cloud-Image herunterladen
# (Hinweis: Prüfe auf der Debian-Website ggf. auf eine neuere Version)
wget https://cdimage.debian.org/images/cloud/trixie/20251006-2257/debian-13-generic-amd64-20251006-2257.qcow2

Schritt 2: Die VM-Vorlage in Proxmox erstellen

Jetzt erstellen wir eine „leere“ VM in Proxmox, die als Basis für unser Template dient. Wir geben ihr die ID 1000 (du kannst auch eine andere freie ID wählen).

# Erstelle eine VM mit der ID 1000, 1GB RAM, 2 Cores und dem Bridge-Netzwerk 'vmbr0'
qm create 1000 --name "debian-13-trixie" --memory 1024 --cores 2 --net0 virtio,bridge=vmbr0

Schritt 3: Image importieren und Festplatte einrichten

Dieser Schritt ist entscheidend. Wir importieren das heruntergeladene qcow2-Image in die VM 1000 und binden es als performante virtio-Festplatte ein.

# Heruntergeladenes Image in den 'local' Storage importieren
# (Ersetze 'local' mit deinem gewünschten Storage, z.B. 'local-lvm')
qm importdisk 1000 /root/debian-13-generic-amd64-20251006-2257.qcow2 local

# Festplatte als performantes 'virtio-scsi' Laufwerk einbinden
# Wichtig: 'ssd=1' und 'discard=on' für SSD-Optimierung
qm set 1000 --scsihw virtio-scsi-single --scsi0 local:vm-1000-disk-0,cache=writeback,discard=on,ssd=1

# Bootreihenfolge auf diese neue Festplatte setzen
qm set 1000 --boot c --bootdisk scsi0

# Festplatte auf 10GB vergrößern (oder einen Wert eurer Wahl)
qm resize 1000 scsi0 +10240M

Schritt 4: Cloud-Init Laufwerk und QEMU Agent konfigurieren

Jetzt kommt der „magische“ Teil. Wir fügen ein spezielles Cloud-Init-Laufwerk hinzu. Proxmox wird auf dieses Laufwerk alle Konfigurationen (wie SSH-Keys, IP-Adressen etc.) schreiben, die das Image beim Starten ausliest.

Wir aktivieren auch den QEMU Guest Agent, damit Proxmox besser mit der VM kommunizieren kann (z.B. für saubere Reboots oder das Auslesen von IP-Adressen).

# Das Cloud-Init Laufwerk als CD-ROM (scsi2) hinzufügen
qm set 1000 --scsi2 local:cloudinit

# QEMU Guest Agent aktivieren
qm set 1000 --agent enabled=1

Schritt 5: Serielle Konsole und CPU-Typ einstellen

Damit du die Konsole der VM direkt im Proxmox-Webinterface (via xterm.js) sehen kannst, müssen wir die serielle Konsole aktivieren. Außerdem setzen wir den CPU-Typ auf host, um die bestmögliche Performance zu erreichen (die VM „sieht“ dann die echte CPU des Hosts).

# Serielle Konsole für die Proxmox Web-Konsole aktivieren
qm set 1000 --serial0 socket
qm set 1000 --vga serial0

# CPU-Typ auf 'host' setzen (beste Performance)
qm set 1000 --cpu cputype=host

Schritt 6: Cloud-Init Standardwerte definieren

Jetzt legen wir noch ein paar Standardeinstellungen für Cloud-Init fest. Diese können später beim Klonen der VM jederzeit überschrieben werden.

# Automatische Paket-Updates beim ersten Start der VM
qm set 1000 --ciupgrade 1

# Standardbenutzer auf 'root' setzen (kann beim Klonen geändert werden)
qm set 1000 --ciuser root

# Netzwerk standardmäßig via DHCP konfigurieren
qm set 1000 --ipconfig0 ip=dhcp

# Standard DNS-Server (z.B. Google)
qm set 1000 --nameserver 8.8.8.8

# Standard Such-Domain
qm set 1000 --searchdomain init.internal

Schritt 7: Als Template konvertieren

Fast geschafft! Die VM 1000 ist nun perfekt konfiguriert. Der letzte Befehl wandelt diese VM in ein Template um. Das bedeutet, sie kann nicht mehr gestartet, sondern nur noch geklont werden.

# VM 1000 in ein Proxmox VM-Template konvertieren
qm template 1000

Herzlichen Glückwunsch! Du siehst nun im Proxmox-Interface dein neues „debian-13-trixie“-Template. Wenn du jetzt mit der rechten Maustaste darauf klickst und „Klonen“ wählst, kannst du im „Cloud-Init“-Tab des Klon-Dialogs deinen SSH-Key und die Netzwerkeinstellungen festlegen. Die neue VM ist in wenigen Sekunden startklar!

---

Fazit: Nie wieder manuell installieren!

Du hast es geschafft! Ist die Vorarbeit einmal erledigt, sparst du dir in Zukunft unglaublich viel Zeit. Das Aufsetzen einer neuen, sauberen Debian-VM ist jetzt kein 15-Minuten-Prozess mehr, sondern eine Sache von 15 Sekunden.

Keine mühsamen ISO-Installationen, keine manuellen Netzwerkkonfigurationen, keine Sorge um SSH-Keys. Das ist der moderne Weg, VMs zu deployen.

Ich hoffe, dir hat dieser Beitrag gefallen und weitergeholfen. Viel Spaß beim Automatisieren!