2026-10-04 21:35:47 +02:00
V10
2026-10-04 21:20:11 +02:00
2026-10-04 21:35:47 +02:00
2026-10-04 17:04:10 +02:00
V25
2026-10-04 21:16:19 +02:00

Proxmox und Guest Updater

Automatische Updates für Proxmox VE, LXC-Container und Debian-/Ubuntu-VMs.

Das Skript aktualisiert den Proxmox-Host sowie unterstützte Gäste zentral vom Proxmox-Host aus. Es erkennt, ob tatsächlich Paketänderungen vorhanden sind, behandelt notwendige Neustarts gesammelt und kann nach einem Update-Lauf eine Zusammenfassung über das Proxmox Notification System versenden.

Funktionen

  • Automatische Updates des Proxmox-Hosts
  • Automatische Updates von Debian-/Ubuntu-LXC-Containern
  • Automatische Updates von Debian-/Ubuntu-VMs über den QEMU Guest Agent
  • Erkennt, ob ein System bereits aktuell ist
  • Gestoppte Gäste können optional für das Update gestartet werden
  • Vom Updater gestartete Gäste werden anschließend wieder gestoppt
  • Ausschlussliste für einzelne CTs und VMs
  • Ein Fehler bei einem Gast stoppt nicht die Aktualisierung der übrigen Gäste
  • Sichere Behandlung von notwendigen Neustarts
  • Automatischer Host-Neustart optional
  • Proxmox-Benachrichtigungen optional
  • Wöchentlicher systemd-Timer
  • Check-Modus ohne Installation von Updates
  • Gezielte Aktualisierung einzelner CTs oder VMs
  • Protokollierung nach /var/log/pve-guest-update.log

Voraussetzungen

  • Proxmox VE
  • Debian-/Ubuntu-basierte LXC-Container für automatische LXC-Updates
  • Debian-/Ubuntu-VMs benötigen den QEMU Guest Agent
  • Internetzugriff auf die verwendeten Paketquellen

Windows-VMs und andere nicht unterstützte Betriebssysteme werden nicht aktualisiert.

Installation

Auf dem Proxmox-Host als root:

curl -fsSL https://gitea.vourx.com/sharky/Proxmox-und-GuestUpdater/raw/branch/main/install.sh | bash

Der Installer führt keine Updates aus. Er installiert bzw. aktualisiert lediglich das Skript, die Konfiguration und den systemd-Timer.

Bei einer vorhandenen Installation werden die bisherigen Einstellungen eingelesen und können übernommen bzw. angepasst werden.

Konfiguration

Die Konfiguration liegt unter:

/etc/pve-guest-update.conf

Konfigurierbar sind unter anderem:

  • Update des Proxmox-Hosts
  • automatische LXC-Updates
  • automatische VM-Updates
  • Start gestoppter Gäste
  • automatischer Host-Reboot
  • Ausschlussliste
  • Wochentag und Uhrzeit
  • Proxmox-Benachrichtigungen
  • Notification-Target

Gestoppte Gäste

Ist das automatische Starten gestoppter Gäste deaktiviert, werden diese übersprungen.

Ist es aktiviert, startet der Updater einen unterstützten gestoppten Gast, führt die Aktualisierung durch und fährt ihn anschließend wieder herunter. Ein Gast, der vor dem Lauf gestoppt war, bleibt also nicht dauerhaft eingeschaltet.

Gäste ausschließen

CT- und VM-IDs können in der Ausschlussliste eingetragen werden. Diese Gäste werden vollständig übersprungen.

Beispiel:

EXCLUDE_GUESTS="107 105 210"

QEMU Guest Agent für VMs

Automatische Updates innerhalb von Debian-/Ubuntu-VMs erfolgen über den QEMU Guest Agent.

In jeder VM, die automatisch aktualisiert werden soll:

apt update
apt install -y qemu-guest-agent
systemctl enable --now qemu-guest-agent

Zusätzlich in Proxmox bei der VM unter:

Optionen → QEMU Guest Agent

den QEMU Guest Agent aktivieren.

Die Verbindung kann auf dem Proxmox-Host geprüft werden:

qm agent <VM-ID> ping

Beispiel:

qm agent 100 ping

Ohne erreichbaren QEMU Guest Agent kann eine laufende Debian-/Ubuntu-VM nicht automatisch aktualisiert werden.

Update-Verhalten

Für Debian-/Ubuntu-Systeme verwendet der Updater grundsätzlich:

apt-get update

und bei tatsächlich vorhandenen Paketänderungen:

DEBIAN_FRONTEND=noninteractive apt-get -y \
  -o Dpkg::Options::="--force-confdef" \
  -o Dpkg::Options::="--force-confold" \
  full-upgrade

Vor dem eigentlichen Upgrade wird geprüft, ob Paketänderungen anstehen.

Dadurch unterscheidet die Ausgabe zwischen:

CT 101 (InfluxDB): bereits aktuell.

und:

CT 101 (InfluxDB): Update erfolgreich.

In der Zusammenfassung werden entsprechend aktualisiert, bereits aktuell, fehlgeschlagen und übersprungen getrennt gezählt.

Neustart-Logik

Notwendige Neustarts werden nicht sofort während der Aktualisierung durchgeführt.

Der Updater sammelt zunächst alle Neustart-Anforderungen und entscheidet erst am Ende des vollständigen Laufs.

Fehlerfreier Lauf mit notwendigem Host-Reboot

Wenn der Proxmox-Host einen Neustart benötigt und der gesamte Update-Lauf fehlerfrei war:

  • keine einzelnen CT-/VM-Neustarts
  • der Host übernimmt die Neustarts der Gäste
  • automatischer Host-Reboot nur, wenn er in der Konfiguration aktiviert ist

Kein Host-Reboot erforderlich

Benötigt der Host keinen Neustart, werden nur die Gäste neu gestartet, bei denen ein Neustart erforderlich ist.

Fehler während des Laufs

Sobald mindestens ein Fehler im Update-Lauf auftritt:

  • kein automatischer Host-Neustart
  • keine automatischen Gast-Neustarts

Damit wird bei einem nicht vollständig erfolgreichen Lauf kein automatischer Neustart ausgelöst.

--no-reboot

Mit --no-reboot wird der automatische Host-Neustart unterdrückt. Notwendige Gast-Neustarts können weiterhin durchgeführt werden, sofern der Update-Lauf fehlerfrei war.

Benachrichtigungen

Der Updater kann das vorhandene Proxmox Notification System verwenden. SMTP-Zugangsdaten werden nicht im Updater gespeichert.

Der Installer erkennt vorhandene Notification-Targets. Ist genau ein benutzerdefiniertes Target vorhanden, wird dieses automatisch ausgewählt. Das eingebaute Target mail-to-root wird dabei nicht gegenüber einem vorhandenen benutzerdefinierten Target bevorzugt.

Sind keine geeigneten Benachrichtigungen eingerichtet, kann der Updater vollständig ohne Mailversand verwendet werden.

Bei aktiviertem Versand enthält die Nachricht unter anderem:

  • Status des Proxmox-Hosts
  • Host-Reboot erforderlich: ja/nein
  • Anzahl aktualisierter LXCs
  • Anzahl bereits aktueller LXCs
  • fehlgeschlagene und übersprungene LXCs
  • Anzahl aktualisierter VMs
  • Anzahl bereits aktueller VMs
  • fehlgeschlagene und übersprungene VMs
  • Gesamtzahl der Fehler
  • Neustartentscheidung

Beispiel-Betreff:

Proxmox Updater - Erfolgreich

Bei einem fehlerhaften Lauf:

Proxmox Updater - FEHLER

Der --check-Modus verschickt keine Update-Benachrichtigung.

Verwendung

Vollständigen Update-Lauf starten

pve-guest-update

Nur prüfen

pve-guest-update --check

Der Check-Modus prüft Host und Gäste, installiert aber keine Updates.

Einzelnen LXC-Container aktualisieren

pve-guest-update --ct <ID>

Beispiel:

pve-guest-update --ct 101

Einzelne VM aktualisieren

pve-guest-update --vm <ID>

Beispiel:

pve-guest-update --vm 100

Host-Reboot unterdrücken

pve-guest-update --no-reboot

Automatischer Zeitplan

Der Installer richtet einen systemd-Timer ein.

Beispiel:

Sonntag 03:00 Uhr

Status des Timers anzeigen:

systemctl status pve-guest-update.timer

Nächsten geplanten Lauf anzeigen:

systemctl list-timers pve-guest-update.timer

Logdatei

Alle Läufe werden protokolliert:

/var/log/pve-guest-update.log

Beispiel:

tail -n 100 /var/log/pve-guest-update.log

Live mitlesen:

tail -f /var/log/pve-guest-update.log

Beispiel einer Zusammenfassung

============================================================
                     Ergebnis
============================================================
LXC aktualisiert:      0
LXC bereits aktuell:   7
LXC fehlgeschlagen:    0
LXC übersprungen:      1

VM aktualisiert:       0
VM bereits aktuell:    2
VM fehlgeschlagen:     0
VM übersprungen:       2

Fehler gesamt:         0
Host Update:           yes
Host Reboot nötig:     no
============================================================

Dateien

/usr/local/sbin/pve-guest-update
/etc/pve-guest-update.conf
/etc/systemd/system/pve-guest-update.service
/etc/systemd/system/pve-guest-update.timer
/var/log/pve-guest-update.log

Aktualisierung des Updaters

Zum Aktualisieren einfach den Installer erneut ausführen:

curl -fsSL https://gitea.vourx.com/sharky/Proxmox-und-GuestUpdater/raw/branch/main/install.sh | bash

Eine vorhandene Installation wird erkannt. Die aktuelle Konfiguration wird eingelesen und kann übernommen werden.

Hinweise

Das Skript ist für die zentrale Pflege von Proxmox-Systemen mit Debian-/Ubuntu-Gästen gedacht.

Vor dem produktiven Einsatz sollte die Konfiguration insbesondere hinsichtlich Ausschlussliste, gestoppter Gäste, automatischer Neustarts und Benachrichtigungen geprüft werden.

Lizenz

Für dieses Repository ist derzeit keine Lizenz angegeben.

S
Description
Automatische Updates für Proxmox VE, VM und LXC-Container
Readme
459 KiB
0 Stars 1 Watchers 0 Forks
Languages
Shell 100%