Incus-Systemcontainer auf einem VPS einrichten
Erfahren Sie, wie Sie Incus-Systemcontainer auf einem VPS einrichten: Virtualisierung prüfen, Speicherpools und Netzwerk konfigurieren sowie typische Fehler vermeiden.
Was ein Incus-Systemcontainer ist
Incus-Systemcontainer auf einem VPS stellen Ihnen ein vollständiges System mit eigenem Init-System und eigenen Benutzerkonten bereit. Sie führen nicht nur einen einzelnen Prozess mit einem angehängten Dateisystem aus. Der Container startet, führt ein Init-System als PID 1 aus und wird von seinem Dienstmanager verwaltet. Das ist systemctl bei systemd-Images wie Debian und Ubuntu sowie rc-service bei Alpine, das OpenRC verwendet. Der Container nutzt den Kernel des Hosts gemeinsam. Er ist daher keine virtuelle Maschine. Alles oberhalb des Kernels verhält sich wie ein eigenständiges System.
Incus ist ein Community-Fork von LXD und wird im Rahmen des Linux-Containers-Projekts gepflegt. Der Client-Befehl lautet incus. Mit --vm führt Incus über QEMU auch echte virtuelle Maschinen aus. Der Systemcontainer ist jedoch der Hauptgrund, aus dem die meisten Benutzer Incus installieren. Um ihn geht es im weiteren Verlauf dieses Leitfadens.
Warum Docker-Vergleiche in die Irre führen
Docker bündelt einen Prozess. Incus bündelt ein Betriebssystem. Die Incus-Dokumentation beschreibt die Abgrenzung direkt: „Anwendungscontainer (wie sie beispielsweise von Docker bereitgestellt werden) bündeln einen einzelnen Prozess oder eine einzelne Anwendung. Systemcontainer simulieren dagegen ein vollständiges Betriebssystem, ähnlich dem System, das auf einem Host oder in einer virtuellen Maschine ausgeführt wird.“
Dieser Unterschied verändert, wie Sie das jeweilige System im Alltag verwenden.
- Ein Docker-Container führt normalerweise die Anwendung direkt aus. Daher schlägt
systemctldarin ohne einen laufenden systemd-init-Prozess fehl. Ein Incus-Container führt ein Init-System aus. Daher funktionieren Dienste und Timer wie auf einem Server. - Ein Docker-Container ist dafür vorgesehen, aus einer Dockerfile gelöscht und neu erstellt zu werden. Ein Incus-Container ist dafür vorgesehen, erhalten, aktualisiert und als Snapshot gespeichert zu werden.
- Ein Docker-Image ist ein Build-Artefakt, das Sie in eine Registry übertragen. Eine Incus-Instanz ist ein Zustand auf dem Datenträger in einem Storage-Pool. Sie verschieben sie mit
incus export. - Docker isoliert eine Workload. Incus isoliert eine Maschine. Daher kann ein Container mehrere Workloads und mehrere Benutzerkonten enthalten.
Sie können Docker in einem Incus-Systemcontainer ausführen. Incus dokumentiert außerdem Docker-Images von Drittanbietern, mit denen Sie Incus in einem privilegierten Docker-Container ausführen können. Wenn Sie tatsächlich einen Prozess pro Container mit einem Image-Build-Schritt benötigen, ist Podman und Docker auf einem VPS der erste Vergleich, den Sie lesen sollten. Wenn Sie statt eines gemeinsam genutzten Kernels einen separaten Kernel pro Workload benötigen, geht Firecracker-MicroVMs auf einem VPS in die andere Richtung.
Wird Incus innerhalb eines VPS ausgeführt?
Das hängt vom Virtualisierungstyp und vom Kernel Ihres VPS ab. Prüfen Sie beides, bevor Sie etwas installieren. Verlassen Sie sich dabei nicht auf die Marketingseite des Anbieters. Führen Sie diese vier Befehle auf dem System aus.
systemd-detect-virt
uname -r
stat -fc %T /sys/fs/cgroup
cat /sys/fs/cgroup/cgroup.controllerssystemd-detect-virt mit kvm oder qemu bedeutet, dass Ihr VPS eine virtuelle Maschine mit eigenem Kernel ist. Das ist der einfache Fall, weil sich Incus dann wie auf echter Hardware verhält. lxc, lxc-libvirt oder openvz bedeutet, dass Ihr VPS selbst ein Container ist, der den Kernel des Anbieters nutzt. Incus-Container darin sind verschachtelte Container. Verschachtelung funktioniert nur, wenn der Anbieter sie für Ihren Container aktiviert hat. Sie können sie nicht innerhalb des Containers aktivieren, weil diese Einstellung auf dem Host liegt, auf den Sie keinen Zugriff haben.
stat -fc %T /sys/fs/cgroup sollte cgroup2fs ausgeben. Jede andere Ausgabe bedeutet, dass das System ein cgroup- (control group-)v1- oder ein hybrides Layout verwendet. Aktuelle Incus-Versionen zielen nicht darauf ab.
cat /sys/fs/cgroup/cgroup.controllers listet die für diese cgroup verfügbaren Control-Group-Controller auf, die aktiviert werden können. Incus dokumentiert blkio, cpuset, devices, freezer, memory und pids als erforderlich. Diese Namen sind keine Checkliste für die cgroup-v2-Datei: Block-I/O verwendet io, die Gerätefilterung verwendet BPF und das Einfrieren verwendet cgroup.freeze. Bei einem verschachtelten VPS ist diese Liste häufig kürzer als bei einem KVM-VPS, weil der Anbieter festlegt, welche Controller weitergereicht werden. Ein Resource-Controller, der in dieser Datei fehlt, kann für untergeordnete cgroups nicht aktiviert werden. Das davon abhängige Instanzlimit steht Ihnen daher nicht zur Verfügung.
Die Kernel-Version ist wichtiger als früher. Im Oktober 2026 pflegt das Upstream-Projekt neben den aktuellen Feature-Releases zwei LTS-Serien (Long Term Support), 6.0 und 7.0. Diese Serien haben nicht dieselbe Mindestversion. In der Dokumentation zu 6.0 LTS steht: „The minimum supported kernel version is 5.4.“ In der aktuellen Dokumentation steht: „The minimum supported kernel version is 6.12.“ Die Ankündigung von 7.0 LTS vom Mai 2026 nennt Linux 6.12 als eine der Mindestanforderungen. Dieselbe Ankündigung verschob 6.0 LTS in die Phase mit ausschließlich Security-Updates. Ubuntu 24.04 stellt die 6.0-LTS-Serie im eigenen Repository bereit und kombiniert sie mit einem 6.8-Kernel. Diese Kombination wird unterstützt. Wenn Sie den Stable- oder 7.0-LTS-Build aus dem Drittanbieter-Repository von Zabbly auf demselben 6.8-Kernel installieren, unterschreiten Sie die dokumentierte Mindestversion. Lesen Sie daher uname -r, bevor Sie ein Repository auswählen.
Wenn Sie vollständige virtuelle Maschinen statt Container ausführen möchten, ist die Einschränkung eine andere und schwerwiegender. Unter verschachtelte Virtualisierung auf einem VPS erfahren Sie, ob Ihr VPS /dev/kvm überhaupt bereitstellen kann. Für den Fall, dass Ihnen die Hardware gehört, siehe Proxmox auf einem gemieteten VPS.
Incus unter Ubuntu oder Debian installieren
Debian 13 sowie Ubuntu 24.04 und neuer liefern Incus in ihren eigenen Paketquellen aus.
sudo apt update
sudo apt install -y incusUnter Debian installiert incus-base die Container-Unterstützung ohne die Komponenten für virtuelle Maschinen. Unter Ubuntu fügen Sie qemu-system hinzu, wenn Sie auch --vm-Instanzen verwenden möchten.
Für eine neuere Version als diejenige, die Ihre Distribution bereitstellt, bietet Zabbly Drittanbieterpakete unter pkgs.zabbly.com an. Incus upstream veröffentlicht Tarballs, aber keine offiziellen Pakete. Dieses Repository bietet die Kanäle lts-6.0, lts-7.0 und stable. Die folgenden Befehle stammen aus der README des Zabbly-Repositorys und verwenden stable. Ersetzen Sie den Kanalnamen im Dateinamen und in der URIs:-Zeile, wenn Ihr Kernel eine LTS-Serie benötigt.
sudo apt update && sudo apt install -y curl
sudo mkdir -p /etc/apt/keyrings/
sudo curl -fsSL https://pkgs.zabbly.com/key.asc -o /etc/apt/keyrings/zabbly.asc
sudo sh -c 'cat <<EOF > /etc/apt/sources.list.d/zabbly-incus-stable.sources
Enabled: yes
Types: deb
URIs: https://pkgs.zabbly.com/incus/stable
Suites: $(. /etc/os-release && echo ${VERSION_CODENAME})
Components: main
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/zabbly.asc
EOF'
sudo apt-get update
sudo apt-get install -y incusGeben Sie Ihrem Benutzer anschließend Zugriff auf den Daemon-Socket.
sudo usermod -aG incus-admin "$USER"
newgrp incus-admin
incus infoWenn incus info die Serverkonfiguration ausgibt, funktioniert der Socket. Ein Berechtigungsfehler bedeutet, dass die Gruppenänderung Ihre Shell noch nicht erreicht hat. newgrp incus-admin übernimmt die Änderung für die aktuelle Shell. Eine neue Anmeldung setzt sie dauerhaft korrekt um. Behandeln Sie die Mitgliedschaft in incus-admin auf dem Host gleichwertig zu root, weil der Zugriff auf diesen Socket die vollständige Kontrolle über einen als root laufenden Daemon ermöglicht. Einige Distributionen erstellen außerdem eine einfache incus-Gruppe für eingeschränkten Benutzerzugriff.
Initialisieren Sie nun den Daemon.
sudo incus admin initBeantworten Sie die Fragen, statt auf incus admin init --minimal zurückzugreifen. Der minimale Ablauf wählt den Speichertreiber dir, außer das zugrunde liegende Dateisystem ist Btrfs und dieser Treiber ist verfügbar. Im nächsten Abschnitt wird erläutert, warum diese Auswahl Sie dauerhaft begleitet.
Starten Sie etwas und prüfen Sie, ob es funktioniert.
incus launch images:debian/13 web
incus list
incus exec web -- bashincus list sollte web als RUNNING mit einer IPv4-Adresse im Subnetz incusbr0 anzeigen. Wenn keine Adresse vorhanden ist, wurde DHCP (Dynamic Host Configuration Protocol) nicht abgeschlossen. Der Abschnitt zur Netzwerkkonfiguration behandelt dieses Problem. Ein Container, der nicht startet, gibt den Grund in incus info web --show-log aus. Fehler auf Daemon-Ebene stehen in sudo journalctl -u incus -n 50. Wenn systemd-detect-virt auf einem VPS lxc oder openvz zurückgegeben hat, ist dieser Start der zuverlässige Test dafür, ob Ihnen verschachtelte Virtualisierung zur Verfügung steht.
Warum das standardmäßige Storage-Backend wichtig ist
Das Storage-Backend bestimmt, ob ein Snapshot sofort erstellt wird oder ob der gesamte Datenträger des Containers kopiert werden muss. Diese Entscheidung lässt sich nach der Installation nur mit erheblichem Aufwand ändern.
Incus unterstützt dir, btrfs, lvm, zfs, Ceph und mehrere Remote-Treiber. Bei einem VPS mit nur einem Datenträger fällt die praktische Wahl zwischen dir und btrfs.
Der Treiber dir speichert jeden Container als gewöhnliche Dateien und Verzeichnisse unter /var/lib/incus. Incus bezeichnet ihn als „viel langsamer als alle anderen Treiber“, weil jedes Image entpackt und vollständig kopiert werden muss, anstatt auf gemeinsam genutzte Blöcke zu verweisen. In der Incus-Funktionsübersicht ist dies der einzige Treiber ohne optimierte Snapshot-Erstellung. Auf einem dir-Pool ist ein Snapshot eines Containers mit 4 GiB daher eine vollständige Kopie: Es werden 4 GiB geschrieben, und die Erstellung dauert so lange wie das Kopieren dieser Datenmenge. Auf btrfs, lvm oder zfs ist derselbe Snapshot optimiert und kopiert nicht den gesamten Datenträger. Datenträgerkontingente funktionieren nur auf ext4 oder XFS, wenn Project Quotas auf Dateisystemebene aktiviert sind. Das ist bei den meisten VPS-Images standardmäßig nicht der Fall. Eine Speicherbegrenzung auf einem dir-Pool hat daher häufig keine Wirkung.
btrfs und zfs verwenden Copy-on-Write. Ein Snapshot enthält daher nur die Blöcke, die sich danach ändern. Incus nennt diese beiden Backends als empfohlene Optionen. Snapshots werden nahezu sofort erstellt. Datenträgerkontingente verwenden die integrierte Quota-Unterstützung des Dateisystems.
Die meisten VPS-Tarife stellen einen Datenträger ohne freie Partition bereit. Legen Sie den Pool daher in einer Loop-Datei an. Incus erledigt das für Sie, wenn Sie kein source= angeben.
sudo apt install -y btrfs-progs
incus storage create fast btrfs size=30GiB
incus profile device set default root pool=fast
incus launch images:debian/13 web2 -s fastOhne size= verwendet ein Pool auf einer Loop-Datei 20% des freien Speicherplatzes, mindestens 5 GiB und höchstens 30 GiB. Legen Sie diesen Wert bewusst fest. Der Pool endet an seiner eigenen Größenbegrenzung. Er kann daher voll laufen, während auf dem Host noch freier Speicherplatz vorhanden ist. Das ist die häufigste Ursache dafür, dass einem Pool auf einer Loop-Datei der Speicherplatz ausgeht. Die Loop-Datei selbst liegt jedoch im Dateisystem des Hosts. Bemessen Sie den Pool daher anhand des Speicherbedarfs des Hosts, anstatt ihm jeden freien Gigabyte zuzuweisen.
ZFS verwendet unter Debian ein DKMS-Modul. Dieses wird bei jedem Kernel-Upgrade neu erstellt und kann danach möglicherweise nicht mehr gebaut werden. Ubuntu enthält ZFS in den standardmäßigen Linux-Kernelpaketen. Unter Debian vermeidet btrfs diesen Wartungsaufwand für DKMS.
Die drei Netzwerkmodi und was die einzelnen Modi verfügbar machen
Wenn Sie die empfohlene Antwort übernehmen, erstellt incus admin init eine verwaltete Bridge namens incusbr0 und hängt sie an das Profil default. Dadurch wird jede neue Instanz, die dieses Profil verwendet, mit dieser Bridge verbunden. Sie können stattdessen auch eine vorhandene Bridge oder ein vorhandenes Interface angeben. Die verwaltete Bridge ist eine von drei Möglichkeiten, einen Container anzubinden. Die beiden anderen gibt es, weil die erste Möglichkeit Ihre Container hinter NAT (Network Address Translation) verbirgt.
Verwaltete Bridge. incusbr0 erhält ein privates Subnetz. Der Host verwendet die erste Adresse dieses Subnetzes und fungiert als Gateway. Incus stellt darauf DHCP und DNS (Domain Name System) bereit. Ausgehender Netzwerkverkehr verlässt den Host über dessen öffentliche Adresse, wobei Source NAT angewendet wird. Von außerhalb erreicht den Container nichts, bis Sie dies ausdrücklich konfigurieren. Leiten Sie einen Port mit einem Proxy-Device weiter.
incus config device add web http proxy listen=tcp:203.0.113.10:8080 connect=tcp:0.0.0.0:80 nat=trueErsetzen Sie 203.0.113.10 durch die öffentliche IPv4-Adresse des Hosts. Die Wildcard-Connect-Adresse wählt die IPv4-Adresse der Instanz aus. Konfigurieren Sie unter 6.0 LTS eine statische Adresse auf dem Incus-NIC der Instanz, bevor Sie den NAT-Proxy hinzufügen.
nat=true leitet den Datenverkehr mit netfilter-Regeln weiter, statt ihn über eine separate Userspace-Verbindung zu proxien. Dadurch bleibt die tatsächliche Adresse des Clients in den Logs des Containers erhalten. Incus unterstützt diesen Modus nur, wenn der Host das Gateway der Instanz ist. Genau das ist beim Fall incusbr0 gegeben.
macvlan. Der Container erhält eine eigene MAC-Adresse (Media Access Control) im physischen Netzwerk des Hosts. Auf den meisten VPS-Plattformen funktioniert dies nicht, weil der virtuelle Switch-Port an die MAC-Adresse Ihrer VM gebunden ist und Frames von anderen MAC-Adressen verwirft. Es gibt eine zweite Einschränkung, die auch dann relevant ist, wenn macvlan grundsätzlich funktioniert. Incus dokumentiert: „macvlan-Devices können untereinander und mit dem Netzwerk außerhalb kommunizieren, jedoch nicht mit ihrem übergeordneten Device. Das bedeutet, dass Sie macvlan nicht verwenden können, wenn Ihre Instanzen irgendwann mit dem Host selbst kommunizieren müssen.“
Routed. Dies ist der Modus, der auf einem VPS mit zusätzlichen Adressen normalerweise funktioniert. Incus beschreibt das Device als eines, das „ein virtuelles Device-Paar erstellt, um den Host mit der Instanz zu verbinden, und statische Routen sowie Proxy-ARP/NDP-Einträge einrichtet, damit die Instanz dem Netzwerk eines angegebenen übergeordneten Interfaces beitreten kann“. ARP ist das Address Resolution Protocol. Der Container behält eine öffentliche Adresse. Der Host beantwortet ARP-Anfragen für diese Adresse. Der Provider sieht daher weiterhin nur die MAC-Adresse des Hosts.
incus config device add web eth0 nic nictype=routed parent=enp1s0 ipv4.address=203.0.113.20Übernehmen Sie den Namen des übergeordneten Interfaces aus ip route show default auf dem Host. Dieser Name stammt aus dem Kernel und dem Image Ihres VPS. Er kann ein vorhersehbarer Name wie enp1s0 oder ens3 statt eth0 sein. Lesen Sie den Namen daher aus, anstatt ihn zu erraten. Im Container ist der Name anders. Die Incus-Dokumentation sagt, dass das Netzwerk-Interface im Profil default „in der Instanz zu eth0 wird“. Wenn Sie das Device eth0 nennen, überschreiben Sie den Namen, den das Profil default vorgibt. Der Container verwendet dadurch die geroutete Schnittstelle statt der Bridge. Prüfen Sie das Ergebnis im Container mit ip a und ip route.
Warum ein Container einen Dienst auf dem Host erreicht
Ein Container auf incusbr0 verfügt über einen eigenen Netzwerk-Namespace. Dieser ist keine Firewall-Grenze zum Host. Die Firewall-Regeln, die eine verwaltete Incus-Bridge hinzufügt, sollen laut Dokumentation „die vollständige Funktionalität sicherstellen“ und den Host nicht abschotten. Der Host ist unter der Gateway-Adresse an diese Bridge angebunden. Aus dem Container ist der Host daher ein direkt erreichbarer Nachbar. Jeder Host-Dienst, der an 0.0.0.0 gebunden ist, antwortet dort, sofern eine Host-Firewall die Pakete nicht verwirft.
Prüfen Sie das selbst. Listen Sie auf dem Host die Ports auf, an denen Dienste Verbindungen annehmen.
sudo ss -tlnpRichten Sie sich anschließend aus einem Container an das Gateway, das ip route meldet.
ip route show default
nc -zv 10.0.0.1 6379Wenn eine Datenbank, ein Metrik-Endpunkt oder ein Administrationspanel auf dem Host an 0.0.0.0 gebunden ist und keine Host-Firewallregel die Bridge blockiert, ist diese Prüfung erfolgreich. Die Netzwerk-Firewall Ihres Providers hat das Paket nie gesehen, weil es die Maschine nie verlassen hat. Das ist der Grund für die meisten Fragen nach dem Muster „Wie konnte es diesen Dienst erreichen?“: NAT isoliert den Container vom Internet. Vom Host ist er jedoch nur durch die Regeln isoliert, die Ihre Host-Firewall erzwingt.
Binden Sie Host-Dienste nach Möglichkeit an 127.0.0.1. Filtern Sie anschließend die Bridge auf dem Host. Auf einem System mit ufw blockiert die standardmäßige Deny-Richtlinie bereits den Datenverkehr vom Container zum Host. Dadurch funktionieren DNS und DHCP von Incus nicht. Die Incus-Dokumentation nennt sudo ufw allow in on incusbr0 als Korrektur. Dieser einzelne Befehl öffnet jeden Host-Port für jeden Container erneut. Erlauben Sie stattdessen nur, was die Container tatsächlich benötigen.
sudo ufw allow in on incusbr0 to any port 53 proto udp
sudo ufw allow in on incusbr0 to any port 53 proto tcp
sudo ufw allow in on incusbr0 to any port 67 proto udp
sudo ufw route allow in on incusbr0
sudo ufw route allow out on incusbr0Die beiden ufw route-Regeln ermöglichen es, dass der Datenverkehr der Instanzen über den Host ins Internet weitergeleitet wird. Ohne diese Regeln verwirft die geroutete Richtlinie von ufw weitergeleitete Pakete. Die Container erhalten dann zwar eine Adresse, erreichen aber nichts.
Snapshots und Profile
Ein Snapshot ist eine zeitpunktbezogene Kopie der Instanz innerhalb ihres Storage-Pools.
incus snapshot create web pre-upgrade
incus info web
incus snapshot restore web pre-upgrade
incus snapshot delete web pre-upgradeincus info web listet die Snapshots auf, die die Instanz enthält. Planen Sie Snapshots pro Instanz.
incus config set web snapshots.schedule=@daily
incus config set web snapshots.expiry=4wEin Snapshot liegt im selben Pool, auf derselben Festplatte und auf demselben Server. Er schützt Sie vor einem fehlerhaften Upgrade. Er schützt Sie nicht vor einem ausgefallenen Datenträger oder einer gelöschten Instanz. Das Backup ist incus export, und die Datei muss den Server verlassen.
incus export web /root/web-backup.tar.gz
incus import /root/web-backup.tar.gzEin Profil ist eine benannte Gruppe von Konfigurationsschlüsseln und Geräten, die auf Instanzen angewendet wird. Jede Instanz erhält das Profil default, sofern Sie nichts anderes angeben. Dieses Profil stellt die Root-Disk und die Netzwerkschnittstelle der Instanz bereit. Wenn Sie default bearbeiten, ändern Sie jede Instanz, die dieses Profil verwendet. Das ist nützlich, ermöglicht aber auch, das Netzwerk gleichzeitig von zwanzig Containern zu trennen.
incus profile create small
incus profile set small limits.memory=512MiB
incus profile set small limits.cpu=1
incus launch images:debian/13 api -p default -p smallProfile werden in der angegebenen Reihenfolge angewendet. Daher hat ein Schlüssel aus dem zuletzt aufgeführten Profil Vorrang. Mit incus config show api --expanded sehen Sie, welche Konfiguration eine Instanz tatsächlich erhalten hat.
Docker innerhalb eines Incus-Containers ausführen
Docker innerhalb eines Incus-Systemcontainers benötigt aktiviertes Nesting, weil Docker eigene Namespaces und Mounts erstellt, die ein Container standardmäßig nicht erstellen darf.
incus config set web security.nesting=true
incus restart webIncus dokumentiert security.nesting als „Ob Nesting innerhalb der Instanz erlaubt werden soll“. Für Container ist der Standardwert false. Zwei weitere Punkte stammen direkt aus der Incus-FAQ. Ein Container kann keine Kernelmodule laden. Ein von Docker benötigtes Modul muss daher auf dem Host geladen und mit incus config set web linux.kernel_modules overlay,br_netfilter angegeben werden. Wenn Sie innerhalb des Containers eine Datei /.dockerenv erstellen, überspringt Docker einige Prüfungen, die in einer verschachtelten Umgebung fehlschlagen.
Auf Ubuntu-24.04-Hosts können die Einschränkungen von AppArmor für nicht privilegierte User-Namespaces den von runc ausgeführten pivot_root blockieren. Docker innerhalb des Containers gibt Folgendes aus:
failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: error during container init: error jailing process inside rootfs: pivot_root .: permission deniedDie dmesg-Ausgabe auf dem Host enthält dann eine Zeile mit apparmor="DENIED" operation="pivotroot" class="mount". Die naheliegende Einstellung ist kernel.apparmor_restrict_unprivileged_userns. Das Deaktivieren dieser Einstellung ist jedoch keine zuverlässige Lösung. Der Upstream-Incus-Fehlerbericht zu genau dieser Ablehnung dokumentiert, dass die Einstellung auf 0 das Problem nicht behoben hat. Lesen Sie zuerst dmesg, um die Ablehnung zu prüfen. So stellen Sie fest, ob AppArmor tatsächlich die Ursache ist, bevor Sie einen Sicherheitsstandard ändern.
Wenn Sie Container lieber direkt auf dem VPS ausführen und eine Ebene überspringen möchten, beschreibt Docker auf einem VPS ausführen diese Konfiguration separat.
Fehlerfälle und die angezeigten Meldungen
Instanzen verlieren nach der Installation von Docker auf dem Host das gesamte Netzwerk. Die Incus-Dokumentation nennt die Ursache: „Docker setzt die globale FORWARD-Richtlinie auf drop. Dadurch kann Incus keinen Traffic weiterleiten, und die Instanzen verlieren ihre Netzwerkverbindung.“ Die Instanzen behalten ihre Adressen, erreichen aber kein Ziel. Setzen Sie ip-forward-no-drop in /etc/docker/daemon.json auf true. Machen Sie die Weiterleitung anschließend dauerhaft und lassen Sie die Bridge durch die Docker-eigene Chain zu.
echo "net.ipv4.conf.all.forwarding=1" | sudo tee /etc/sysctl.d/99-forwarding.conf
sudo systemctl restart systemd-sysctl
sudo iptables -I DOCKER-USER -i incusbr0 -j ACCEPT
sudo iptables -I DOCKER-USER -o incusbr0 -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPTDiese iptables-Regeln bleiben nach einem Reboot nicht automatisch erhalten. Machen Sie sie persistent.
Container starten wegen eines cgroup-Fehlers nicht mehr. Die Incus-FAQ beschreibt diesen Fall. Wenn Container plötzlich mit Failed to mount "/sys/fs/cgroup" fehlschlagen, kann laut FAQ ein VPN-Client auf dem Host die Ursache sein. Dieser bindet den net_cls-cgroup-v1-Controller über die von Incus verwendete cgroup-v2-Hierarchie ein. Das ist eine mögliche Ursache, die Sie prüfen sollten, aber nicht die einzige. Falls dies zutrifft, besteht die einfachste Lösung laut FAQ darin, den VPN-Client zu stoppen und sudo umount /sys/fs/cgroup/net_cls auszuführen. Wenn der VPN-Client weiterlaufen muss, empfiehlt die FAQ, net_cls an einer anderen Stelle einzubinden und den Client entsprechend neu zu konfigurieren.
Die Instanz erhält keine IPv4-Adresse. incus list zeigt, dass sie läuft, die Adressspalte aber leer ist. DHCP-Antworten vom Host werden verworfen, meistens durch eine Host-Firewall, die die Bridge nicht kennt. Unter ufw stellt sudo ufw allow in on incusbr0 to any port 67 proto udp die Verbindung wieder her. Mit sudo tcpdump -ni incusbr0 port 67 können Sie beobachten, wie die Anfragen eintreffen.
Die Instanz startet auf einem verschachtelten VPS nicht. Lesen Sie zuerst incus info <name> --show-log und anschließend sudo journalctl -u incus -n 50. Wenn systemd-detect-virt lxc oder openvz ausgegeben hat, liegt die fehlende Voraussetzung auf der Seite des Providers. Keine Einstellung innerhalb Ihres VPS kann dies ändern.
Snapshots sind langsam, und der Datenträger füllt sich weiter. Sie verwenden einen dir-Pool. incus storage list gibt den Treiber für jeden Pool aus. Der Wechsel zu einem Copy-on-Write-Pool erfordert, dass Sie den neuen Pool erstellen, die Instanzen mit incus copy web web-new -s fast dorthin kopieren und die ursprünglichen Instanzen erst löschen, nachdem Sie geprüft haben, dass die Kopien starten.
FAQ
Ist ein Incus-Container dasselbe wie ein Docker-Container?
Nein. Docker paketiert einen einzelnen Prozess oder eine Anwendung. Ein Incus-Systemcontainer bildet ein vollständiges Betriebssystem nach, mit einer eigenen init, eigenen Benutzern, eigenen Diensten und einem eigenen Paketmanager. Einen Incus-Container pflegen und aktualisieren Sie wie einen Server. Einen Docker-Container löschen Sie und erstellen ihn aus einem Image neu. Sie können Docker in einem Incus-Container ausführen, indem Sie security.nesting=true für den Container setzen. Incus dokumentiert außerdem Images von Drittanbietern, um Incus in einem privilegierten Docker-Container auszuführen.
Kann ich Incus auf einem VPS ausführen?
Auf einem KVM-VPS: ja. Wenn systemd-detect-virt kvm oder qemu ausgibt, haben Sie einen eigenen Kernel, und Incus verhält sich wie auf echter Hardware. Gibt der Befehl lxc, lxc-libvirt oder openvz aus, ist Ihr VPS selbst ein Container. Die darin ausgeführten Incus-Container sind daher verschachtelt und funktionieren nur, wenn der Anbieter das Verschachteln für Ihren Container aktiviert hat. Prüfen Sie außerdem uname -r, denn seit Oktober 2026 benötigen die aktuellen Incus-Releases und die 7.0-LTS-Serie einen Kernel ab Version 6.12, während für die 6.0-LTS-Serie Version 5.4 dokumentiert ist.
Welches Storage-Backend sollte ich für Incus auf einem VPS auswählen?
btrfs auf einer Loop-Datei, sofern Sie kein freies Blockgerät dafür haben. Der dir-Treiber ist als deutlich langsamer als die anderen dokumentiert, weil er Dateien kopiert, statt Copy-on-Write zu verwenden. Daher schreibt jeder Snapshot den gesamten Container erneut. incus admin init --minimal wählt dir, sofern das zugrunde liegende Dateisystem Btrfs ist und dieser Treiber verfügbar ist. Deshalb lohnt es sich, die interaktiven Fragen für die zwei Minuten zu beantworten. Erstellen Sie den Pool mit incus storage create fast btrfs size=30GiB.
Warum kann mein Incus-Container einen auf dem Host laufenden Dienst erreichen?
Weil die standardmäßige incusbr0-Bridge den Host an derselben Subnetzadresse wie den Container, an der Gateway-Adresse, platziert. Die Firewall-Regeln, die Incus für diese Bridge anlegt, dienen dazu, die Netzwerkverbindung zu ermöglichen, nicht dazu, den Host zu blockieren. Jeder Hostdienst, der an 0.0.0.0 gebunden ist, antwortet dort, sofern keine Host-Firewall-Regel die Pakete verwirft. Die Firewall Ihres Anbieters sieht diese Pakete nie, weil sie die Maschine nicht verlassen. Binden Sie Hostdienste an 127.0.0.1. Lassen Sie auf einem Host mit ufw über incusbr0 nur DNS und DHCP zu, statt pauschal sudo ufw allow in on incusbr0 zu erlauben.
Wie sichere ich einen Incus-Container?
incus export web /root/web-backup.tar.gz schreibt die Instanz und ihre Snapshots in eine Datei. incus import stellt sie auf demselben oder einem anderen Server wieder her. Snapshots, die mit incus snapshot create erstellt wurden, sind keine Backups. Sie befinden sich im selben Storage-Pool auf derselben Festplatte. Daher überstehen sie ein fehlerhaftes Upgrade, nicht aber einen ausgefallenen Server. Planen Sie sie mit incus config set web snapshots.schedule=@daily und kopieren Sie die Exporte vom Server weg.