SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor

Konfiguracja kontenerów systemowych Incus na VPS

Instrukcja wdrożenia Incus na serwerze VPS. Omówienie weryfikacji wirtualizacji, tworzenia pul pamięci, konfiguracji sieci oraz rozwiązywania typowych błędów instalacji.

Czym jest kontener systemowy Incus

Kontenery systemowe Incus na serwerze VPS zapewniają pełne środowisko maszyny z własnym systemem init oraz własnymi kontami użytkowników, a nie tylko pojedynczy proces z dołączonym systemem plików. Kontener uruchamia się, wykonuje proces init jako PID 1 i odpowiada przed własnym menedżerem usług. Jest to systemctl w obrazach opartych na systemd, takich jak Debian czy Ubuntu, oraz rc-service w przypadku Alpine, który korzysta z OpenRC. Kontener współdzieli jądro systemu z gospodarzem, więc nie jest maszyną wirtualną. Wszystkie warstwy powyżej jądra zachowują się jednak jak w pełnym systemie.

Incus to społecznościowy fork projektu LXD, rozwijany w ramach inicjatywy Linux Containers. Klientem wiersza poleceń jest incus. Incus pozwala również na uruchamianie pełnych maszyn wirtualnych za pośrednictwem QEMU po przekazaniu flagi --vm, jednak to kontenery systemowe są głównym powodem instalacji tego oprogramowania i to one stanowią przedmiot dalszej części tego przewodnika.

Dlaczego porównania z Docker wprowadzają w błąd

Docker pakuje jeden proces. Incus pakuje jeden system operacyjny. Dokumentacja Incus bezpośrednio wskazuje na ten podział: „Kontenery aplikacyjne (dostarczane na przykład przez Docker) pakują pojedynczy proces lub aplikację. Kontenery systemowe natomiast symulują pełny system operacyjny, podobny do tego, który uruchamiałbyś na hoście lub w maszynie wirtualnej”.

Ta różnica zmienia sposób codziennej pracy z danym rozwiązaniem.

  • Kontener Docker zazwyczaj uruchamia aplikację bezpośrednio, więc systemctl wewnątrz niego nie zadziała bez uruchomionego systemu init systemd. Kontener Incus uruchamia system init, dzięki czemu usługi i timery działają tak samo, jak na serwerze.
  • Kontener Docker ma być niszczony i budowany od nowa z pliku Dockerfile. Kontener Incus ma być utrzymywany, aktualizowany i objęty snapshotami.
  • Obraz Docker to artefakt budowania, który wypychasz do rejestru. Instancja Incus to stan na dysku w puli pamięci, który przenosisz za pomocą incus export.
  • Docker izoluje obciążenie. Incus izoluje maszynę, więc jeden kontener może obsługiwać kilka obciążeń i kilka kont użytkowników.

Możesz uruchomić Docker wewnątrz kontenera systemowego Incus. Incus dokumentuje również obrazy Docker firm trzecich, służące do uruchamiania Incus wewnątrz uprzywilejowanego kontenera Docker. Jeśli faktycznie potrzebujesz jednego procesu na kontener z etapem budowania obrazu, Podman i Docker na VPS to porównanie, które należy przeczytać w pierwszej kolejności. Jeśli zamiast współdzielonego jądra potrzebujesz osobnego jądra dla każdego obciążenia, Firecracker microVM na VPS prowadzi w przeciwnym kierunku.

Czy Incus zadziała na VPS?

Zależy to od typu wirtualizacji VPS oraz używanego jądra systemu, dlatego należy sprawdzić oba te parametry przed instalacją. Nie należy polegać wyłącznie na informacjach marketingowych dostawcy. Na serwerze należy wykonać poniższe cztery polecenia.

systemd-detect-virt
uname -r
stat -fc %T /sys/fs/cgroup
cat /sys/fs/cgroup/cgroup.controllers

systemd-detect-virt wyświetlające kvm lub qemu oznacza, że VPS jest maszyną wirtualną z własnym jądrem. Jest to sytuacja korzystna, ponieważ Incus zachowuje się wtedy tak samo, jak na fizycznym sprzęcie. Wyświetlenie lxc, lxc-libvirt lub openvz oznacza, że VPS sam w sobie jest kontenerem współdzielącym jądro dostawcy. Kontenery Incus uruchomione wewnątrz będą kontenerami zagnieżdżonymi, a zagnieżdżanie działa tylko wtedy, gdy dostawca włączył taką możliwość dla danego kontenera. Nie można włączyć tej opcji z wnętrza systemu, ponieważ ustawienie to znajduje się na hoście, do którego użytkownik nie ma dostępu.

stat -fc %T /sys/fs/cgroup powinno zwrócić cgroup2fs. Każdy inny wynik oznacza, że serwer korzysta z układu cgroup (control group) w wersji 1 lub hybrydowej, co nie jest wspierane przez obecne wersje Incus.

cat /sys/fs/cgroup/cgroup.controllers wyświetla kontrolery grup kontrolnych dostępne dla danego cgroup. Incus w dokumentacji wymaga blkio, cpuset, devices, freezer, memory oraz pids. Nazwy te nie stanowią listy kontrolnej dla pliku cgroup v2: operacje wejścia/wyjścia blokowego wykorzystują io, filtrowanie urządzeń opiera się na BPF, a zamrażanie procesów na cgroup.freeze. Na zagnieżdżonym VPS lista ta jest często krótsza niż w przypadku KVM, ponieważ dostawca decyduje, które zasoby udostępnić. Kontroler zasobów nieobecny w tym pliku nie może zostać włączony dla podrzędnych grup cgroup, co oznacza, że limit instancji zależny od tego kontrolera będzie niedostępny.

Wersja jądra ma obecnie większe znaczenie niż dawniej. Według stanu na październik 2026 r. twórcy utrzymują dwie serie LTS (long term support), 6.0 oraz 7.0, obok bieżących wydań rozwojowych, a każda z nich ma inne wymagania minimalne. Dokumentacja LTS 6.0 podaje: „Minimalna wspierana wersja jądra to 5.4”. Bieżąca dokumentacja wskazuje: „Minimalna wspierana wersja jądra to 6.12”, a komunikat z maja 2026 r. dotyczący LTS 7.0 wymienia Linux 6.12 jako jedno z wymagań minimalnych. Ten sam komunikat przeniósł LTS 6.0 do fazy wsparcia wyłącznie w zakresie bezpieczeństwa. Ubuntu 24.04 dostarcza serię LTS 6.0 w swoim repozytorium i paruje ją z jądrem 6.8, co jest wspieraną kombinacją. Instalacja stabilnego wydania lub LTS 7.0 z zewnętrznego repozytorium Zabbly na tym samym jądrze 6.8 oznacza zejście poniżej udokumentowanego minimum, dlatego przed wyborem repozytorium należy przeczytać uname -r.

Jeśli celem jest uruchamianie pełnych maszyn wirtualnych, a nie kontenerów, ograniczenia są inne i trudniejsze do obejścia. Zobacz zagnieżdżona wirtualizacja na VPS, aby sprawdzić, czy dany VPS może udostępnić /dev/kvm, oraz Proxmox na wynajętym VPS, jeśli użytkownik posiada własny sprzęt.

Instalacja Incus na systemach Ubuntu lub Debian

Dystrybucje Debian 13 oraz Ubuntu 24.04 i nowsze dostarczają Incus we własnych repozytoriach.

sudo apt update
sudo apt install -y incus

W systemie Debian polecenie incus-base instaluje obsługę kontenerów bez komponentów maszyn wirtualnych. W systemie Ubuntu należy dodać qemu-system, jeśli wymagane są również instancje --vm.

W celu uzyskania nowszego wydania niż oferowane przez dystrybucję, można skorzystać z pakietów zewnętrznych dostarczanych przez Zabbly pod adresem pkgs.zabbly.com. Projekt Incus udostępnia oficjalnie jedynie archiwa tar, a nie gotowe pakiety. Wspomniane repozytorium oferuje kanały lts-6.0, lts-7.0 oraz stable, a poniższe polecenia, zaczerpnięte z pliku README repozytorium Zabbly, wykorzystują stable. Należy zamienić nazwę kanału w nazwie pliku oraz w linii URIs:, jeśli jądro systemu wymaga serii LTS.

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 incus

Następnie należy nadać użytkownikowi uprawnienia dostępu do gniazda demona.

sudo usermod -aG incus-admin "$USER"
newgrp incus-admin
incus info

incus info wyświetlające konfigurację serwera oznacza, że gniazdo działa poprawnie. Błąd uprawnień oznacza, że zmiana grupy nie została jeszcze uwzględniona w bieżącej powłoce, co naprawia newgrp incus-admin dla aktualnej sesji, natomiast ponowne logowanie rozwiązuje problem trwale. Członkostwo w grupie incus-admin należy traktować na równi z uprawnieniami root na hoście, ponieważ dostęp do tego gniazda zapewnia pełną kontrolę nad demonem działającym z uprawnieniami root. Niektóre dystrybucje tworzą również grupę incus dla użytkowników z ograniczonym dostępem.

Teraz należy zainicjować demona.

sudo incus admin init

Należy odpowiedzieć na pytania zamiast używać incus admin init --minimal. Minimalna ścieżka konfiguracji wybiera sterownik pamięci dir, chyba że bazowy system plików to Btrfs i sterownik ten jest dostępny; kolejna sekcja wyjaśnia konsekwencje tego wyboru.

Uruchom dowolny obiekt i sprawdź, czy działa.

incus launch images:debian/13 web
incus list
incus exec web -- bash

incus list powinno wyświetlić web jako RUNNING z adresem IPv4 w podsieci incusbr0. Brak adresu oznacza, że protokół DHCP (dynamic host configuration protocol) nie zakończył działania, co opisano w sekcji dotyczącej sieci. Kontener, który nie uruchamia się, wyświetla przyczynę w incus info web --show-log, a błędy na poziomie demona trafiają do sudo journalctl -u incus -n 50. Na serwerze VPS, gdzie systemd-detect-virt zwróciło lxc lub openvz, to uruchomienie jest wiarygodnym testem dostępności zagnieżdżania (nesting).

Dlaczego wybór domyślnego backendu pamięci masowej ma znaczenie

Backend pamięci masowej decyduje o tym, czy migawka jest tworzona natychmiastowo, czy stanowi pełną kopię dysku kontenera. Jest to jedyny wybór dokonywany podczas instalacji, którego nie można później tanio zmienić.

Incus obsługuje dir, btrfs, lvm, zfs, Ceph oraz kilka sterowników zdalnych. Na VPS z pojedynczym dyskiem rzeczywisty wybór ogranicza się do dir oraz btrfs.

Sterownik dir przechowuje każdy kontener jako zwykłe pliki i katalogi w /var/lib/incus. Dokumentacja Incus określa go jako „znacznie wolniejszy od wszystkich pozostałych sterowników”, ponieważ wymaga rozpakowania każdego obrazu i wykonania rzeczywistych kopii zamiast odwoływania się do współdzielonych bloków. Jest to jedyny sterownik w zestawieniu funkcji Incus bez zoptymalizowanego tworzenia migawek, więc w puli dir migawka 4 GiB kontenera jest pełną kopią: zapisuje 4 GiB i trwa tyle, ile kopiowanie takiej ilości danych. W przypadku btrfs, lvm lub zfs ta sama migawka jest zoptymalizowana i nie kopiuje całego dysku. Limity dyskowe działają tylko na ext4 lub XFS z włączonymi limitami projektowymi (project quotas) na poziomie systemu plików, co nie jest domyślnie aktywne w większości obrazów VPS, więc limit dysku w puli dir często nie przynosi efektu.

btrfs oraz zfs wykorzystują mechanizm copy-on-write, dzięki czemu migawka rejestruje tylko bloki, które zmieniły się po jej utworzeniu. Incus wskazuje te dwa rozwiązania jako zalecane backendy. Migawki stają się niemal natychmiastowe. Limity dyskowe działają poprzez natywne wsparcie dla kwot w systemie plików.

Większość planów VPS oferuje jeden dysk bez wolnej partycji, dlatego pulę należy umieścić w pliku typu loop. Incus wykonuje to automatycznie, jeśli nie zostanie podany parametr source=.

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 fast

Bez size=, pula oparta na pliku loop zajmuje 20% wolnego miejsca na dysku, z dolnym limitem 5 GiB i górnym 30 GiB. Wartość tę należy ustawić świadomie. Pula zatrzymuje się po osiągnięciu własnego rozmiaru, więc może zostać zapełniona, mimo że host wciąż posiada wolne miejsce – jest to typowy sposób wyczerpania zasobów w pulach typu loop. Sam plik loop jest jednak zwykłym plikiem w systemie plików hosta, dlatego rozmiar puli należy planować z uwzględnieniem potrzeb samego hosta, zamiast przydzielać jej każdy dostępny gigabajt.

ZFS w systemie Debian korzysta z modułu DKMS, więc jest przebudowywany przy każdej aktualizacji jądra i może nie zostać poprawnie skompilowany po takiej operacji. Ubuntu zawiera ZFS w swoich domyślnych pakietach jądra Linux. W systemie Debian, btrfs pozwala uniknąć konieczności utrzymywania DKMS.

Trzy tryby sieciowe i zakres ich ekspozycji

Po zaakceptowaniu zalecanej odpowiedzi, incus admin init tworzy zarządzany most o nazwie incusbr0 i przypisuje go do profilu default, dzięki czemu każda nowa instancja korzystająca z tego profilu zostaje do niego podłączona. Można również wskazać istniejący most lub interfejs. Zarządzany most jest jednym z trzech sposobów podłączenia kontenera; pozostałe dwa istnieją, ponieważ pierwszy ukrywa kontenery za NAT (network address translation).

Zarządzany most (Managed bridge). incusbr0 otrzymuje prywatną podsieć. Host posiada w niej pierwszy adres i pełni rolę bramy, Incus uruchamia na nim DHCP oraz DNS (domain name system), a ruch wychodzący opuszcza sieć przez publiczny adres hosta z zastosowaniem source NAT. Nic z zewnątrz nie dociera do kontenera, dopóki nie zostanie to jawnie skonfigurowane. Przekierowanie portu realizuje się za pomocą urządzenia typu proxy.

incus config device add web http proxy listen=tcp:203.0.113.10:8080 connect=tcp:0.0.0.0:80 nat=true

Zastąp 203.0.113.10 publicznym adresem IPv4 hosta. Adres typu wildcard w konfiguracji połączenia wybiera adres IPv4 instancji. W wersji 6.0 LTS należy skonfigurować statyczny adres na karcie sieciowej Incus instancji przed dodaniem proxy NAT.

nat=true realizuje przekierowania za pomocą reguł netfilter zamiast pośredniczenia przez osobne połączenie w przestrzeni użytkownika, dzięki czemu rzeczywisty adres klienta jest widoczny w logach kontenera. Incus wspiera ten tryb tylko wtedy, gdy host jest bramą dla instancji, co ma miejsce dokładnie w przypadku incusbr0.

macvlan. Kontener otrzymuje własny adres MAC (media access control) w fizycznej sieci hosta. Na większości platform VPS to rozwiązanie nie działa, ponieważ port wirtualnego przełącznika jest powiązany z adresem MAC maszyny wirtualnej i odrzuca ramki z innych adresów. Istnieje drugie ograniczenie, które dotyczy użytkowników nawet tam, gdzie rozwiązanie to działa. Dokumentacja Incus wskazuje, że "urządzenia macvlan, mimo że mogą komunikować się między sobą oraz z siecią zewnętrzną, nie mogą komunikować się z urządzeniem nadrzędnym. Oznacza to, że nie można użyć macvlan, jeśli instancje muszą komunikować się z samym hostem".

Routed. Jest to tryb, który zazwyczaj działa na VPS z dodatkowymi adresami. Dokumentacja Incus opisuje to urządzenie jako takie, które "tworzy parę urządzeń wirtualnych w celu połączenia hosta z instancją oraz konfiguruje trasy statyczne i wpisy proxy ARP/NDP, aby umożliwić instancji dołączenie do sieci wyznaczonego interfejsu nadrzędnego". ARP to protokół rozstrzygania adresów (address resolution protocol). Kontener zachowuje publiczny adres. Host odpowiada na zapytania ARP w jego imieniu, więc dostawca nadal widzi tylko adres MAC hosta.

incus config device add web eth0 nic nictype=routed parent=enp1s0 ipv4.address=203.0.113.20

Nazwę interfejsu nadrzędnego należy pobrać z ip route show default na hoście. Nazwa ta pochodzi z jądra systemu i obrazu VPS; może to być przewidywalna nazwa, taka jak enp1s0 lub ens3, zamiast eth0, dlatego należy ją odczytać, zamiast zgadywać. Wewnątrz kontenera sytuacja wygląda inaczej: dokumentacja Incus podaje, że interfejs sieciowy w profilu default "staje się eth0 wewnątrz instancji". Nazwanie urządzenia eth0 nadpisuje ustawienie dostarczane przez profil default, dzięki czemu kontener zostaje podłączony do interfejsu routowanego zamiast do mostu. Wynik należy sprawdzić od wewnątrz za pomocą ip a oraz ip route.

Dlaczego kontener uzyskał dostęp do usługi na hoście

Kontener w incusbr0 posiada własną przestrzeń nazw sieciowych. Nie stanowi ona bariery firewall odgradzającej go od hosta. Reguły firewalla dodawane przez mostek Incus służą, zgodnie z dokumentacją, „zapewnieniu pełnej funkcjonalności”, a nie odizolowaniu hosta. Host znajduje się w tym mostku pod adresem bramy, więc z wnętrza kontenera host jest bezpośrednio osiągalnym sąsiadem. Każda usługa hosta powiązana z 0.0.0.0 odpowie na zapytania, chyba że reguła firewalla hosta odrzuci pakiety.

Można to zweryfikować samodzielnie. Na hoście należy wyświetlić listę nasłuchujących usług.

sudo ss -tlnp

Następnie, z wnętrza kontenera, należy skierować zapytanie do bramy wskazywanej przez ip route.

ip route show default
nc -zv 10.0.0.1 6379

Jeśli baza danych, punkt końcowy metryk lub panel administracyjny na hoście są powiązane z 0.0.0.0, a żadna reguła firewalla hosta nie blokuje mostka, test zakończy się powodzeniem. Sieciowy firewall dostawcy nigdy nie zobaczył tego pakietu, ponieważ pakiet nigdy nie opuścił maszyny. To jest przyczyna większości pytań o to, „jak to uzyskało dostęp”: kontener jest odizolowany od Internetu przez NAT, natomiast od hosta izolują go wyłącznie reguły wymuszone przez firewall hosta.

Usługi hosta należy wiązać z 127.0.0.1, gdzie tylko jest to możliwe. Następnie należy przefiltrować mostek na hoście. W systemach z ufw domyślna polityka deny blokuje ruch między kontenerem a hostem, co uniemożliwia działanie DNS i DHCP w Incus. Rozwiązanie podane w dokumentacji Incus to sudo ufw allow in on incusbr0. To pojedyncze polecenie otwiera wszystkie porty hosta dla każdego kontenera. Zamiast tego należy zezwolić tylko na to, czego kontenery faktycznie potrzebują.

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 incusbr0

Dwie reguły ufw route pozwalają na przesyłanie ruchu z instancji przez hosta do Internetu. Bez nich polityka routingu ufw odrzuca przekazywane pakiety, przez co kontenery otrzymują adres, ale nie mają łączności z siecią zewnętrzną.

Migawki i profile

Migawka to kopia instancji wewnątrz puli pamięci masowej wykonana w określonym punkcie czasowym.

incus snapshot create web pre-upgrade
incus info web
incus snapshot restore web pre-upgrade
incus snapshot delete web pre-upgrade

incus info web wyświetla listę migawek posiadanych przez instancję. Harmonogramy migawek definiuje się dla każdej instancji z osobna.

incus config set web snapshots.schedule=@daily
incus config set web snapshots.expiry=4w

Migawka znajduje się w tej samej puli, na tym samym dysku i na tym samym serwerze. Chroni ona przed skutkami nieudanej aktualizacji. Nie zapewnia ochrony w przypadku awarii dysku lub usunięcia instancji. Kopia zapasowa to incus export, a plik musi zostać przeniesiony poza serwer.

incus export web /root/web-backup.tar.gz
incus import /root/web-backup.tar.gz

Profil to nazwany zestaw kluczy konfiguracyjnych i urządzeń stosowany do instancji. Każda instancja otrzymuje profil default, chyba że określono inaczej; to właśnie ten profil dostarcza dysk główny oraz interfejs sieciowy. Edycja default zmienia każdą instancję, która z niego korzysta, co jest przydatne i pozwala na przykład na jednoczesne odłączenie sieci od dwudziestu kontenerów.

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 small

Profile są stosowane w określonej kolejności, więc klucz ustawiony w ostatnim wymienionym profilu ma pierwszeństwo. Aby sprawdzić, jakie ustawienia ostatecznie otrzymała instancja, należy użyć incus config show api --expanded.

Uruchamianie Docker wewnątrz kontenera Incus

Uruchomienie Docker wewnątrz kontenera systemowego Incus wymaga włączenia funkcji nesting, ponieważ Docker tworzy własne przestrzenie nazw (namespaces) oraz punkty montowania, których kontener domyślnie nie może tworzyć.

incus config set web security.nesting=true
incus restart web

Dokumentacja Incus określa security.nesting jako „czy zezwolić na zagnieżdżanie wewnątrz instancji”, a domyślną wartością dla kontenerów jest false. Dwie dodatkowe kwestie wynikają bezpośrednio z FAQ Incus. Kontener nie może ładować modułów jądra, więc moduł wymagany przez Docker musi zostać załadowany na hoście i wymieniony w incus config set web linux.kernel_modules overlay,br_netfilter. Ponadto utworzenie pliku /.dockerenv wewnątrz kontenera sprawia, że Docker pomija niektóre testy, które kończą się niepowodzeniem w środowisku zagnieżdżonym.

Na hostach z systemem Ubuntu 24.04 ograniczenia AppArmor dotyczące nieuprzywilejowanych przestrzeni nazw użytkownika mogą blokować operację pivot_root, którą wykonuje runc. Docker wewnątrz kontenera wyświetla komunikat:

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 denied

a plik dmesg na hoście zawiera linię z apparmor="DENIED" operation="pivotroot" class="mount". Ustawieniem, po które sięgają użytkownicy, jest kernel.apparmor_restrict_unprivileged_userns. Wyłączenie go nie jest niezawodnym rozwiązaniem: oficjalny raport o błędzie Incus dotyczący tej konkretnej odmowy wskazuje, że ustawienie wartości 0 nie rozwiązało problemu. Najpierw należy zapoznać się z dmesg dotyczącym odmowy, aby upewnić się, czy AppArmor rzeczywiście stanowi przyczynę problemu, zanim nastąpi zmiana domyślnych ustawień bezpieczeństwa.

Jeśli preferowane jest uruchamianie kontenerów bezpośrednio na VPS z pominięciem dodatkowej warstwy, sekcja uruchamianie Docker na VPS opisuje taką konfigurację.

Tryby awarii i towarzyszące im komunikaty

Instancje tracą łączność sieciową po zainstalowaniu Docker na hoście. Dokumentacja Incus wskazuje przyczynę: „Docker ustawia globalną politykę FORWARD na drop, co uniemożliwia Incus przekazywanie ruchu i powoduje utratę łączności sieciowej przez instancje”. Instancje zachowują swoje adresy, ale nie mogą nawiązać połączeń. Należy ustawić ip-forward-no-drop na true w pliku /etc/docker/daemon.json, a następnie zapewnić trwałość przekazywania ruchu i zezwolić na ruch przez łańcuch Dockera.

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 ACCEPT

Reguły iptables nie są zachowywane po restarcie systemu. Należy zapewnić ich trwałość.

Kontenery przestają się uruchamiać z błędem cgroup. Ten problem opisano w FAQ Incus. Jeśli kontenery nagle zgłaszają błąd Failed to mount "/sys/fs/cgroup", zgodnie z FAQ może to wynikać z uruchomienia klienta VPN na hoście, który montuje kontroler cgroup v1 net_cls w hierarchii cgroup v2 używanej przez Incus. Jest to jedna z możliwych przyczyn. Jeśli dotyczy ona danego przypadku, najprostszym rozwiązaniem wskazanym w FAQ jest zatrzymanie klienta VPN i wykonanie polecenia sudo umount /sys/fs/cgroup/net_cls. Jeśli klient VPN musi pozostać uruchomiony, FAQ sugeruje zamontowanie net_cls w innej lokalizacji i odpowiednią rekonfigurację klienta.

Instancja nie otrzymuje adresu IPv4. Polecenie incus list pokazuje instancję działającą z pustą kolumną adresu. Odpowiedzi DHCP z hosta są odrzucane, najczęściej przez zaporę sieciową hosta, która nie rozpoznaje mostka. W przypadku ufw, polecenie sudo ufw allow in on incusbr0 to any port 67 proto udp przywraca łączność. Należy monitorować napływające żądania za pomocą sudo tcpdump -ni incusbr0 port 67.

Instancja odmawia uruchomienia na zagnieżdżonym VPS. Należy najpierw przeczytać incus info <name> --show-log, a następnie sudo journalctl -u incus -n 50. Jeśli systemd-detect-virt zwróciło lxc lub openvz, brakujący element znajduje się po stronie dostawcy i żadne ustawienie wewnątrz VPS tego nie zmieni.

Migawki działają wolno, a dysk zapełnia się. Używana jest pula dir. Polecenie incus storage list wyświetla sterownik dla każdej puli. Przejście na pulę typu copy-on-write wymaga utworzenia nowej puli, skopiowania instancji za pomocą incus copy web web-new -s fast, a następnie usunięcia oryginałów po zweryfikowaniu, że kopie uruchamiają się poprawnie.

FAQ

Czy kontener Incus jest tym samym co kontener Docker?

Nie. Docker pakuje pojedynczy proces lub aplikację. Kontener systemowy Incus symuluje pełny system operacyjny, posiadający własny proces init, własnych użytkowników, własne usługi oraz własny menedżer pakietów. Kontener Incus utrzymuje się i aktualizuje jak serwer. Kontener Docker usuwa się i buduje ponownie z obrazu. Można uruchomić Docker wewnątrz kontenera Incus, ustawiając security.nesting=true dla danego kontenera. Incus dokumentuje również obrazy firm trzecich, umożliwiające uruchomienie Incus wewnątrz uprzywilejowanego kontenera Docker.

Czy mogę uruchomić Incus na VPS?

Na VPS typu KVM – tak. Polecenie systemd-detect-virt zwraca kvm lub qemu, co oznacza posiadanie własnego jądra, a Incus zachowuje się tak samo jak na sprzęcie fizycznym. Jeśli polecenie zwraca lxc, lxc-libvirt lub openvz, VPS sam w sobie jest kontenerem, więc kontenery Incus wewnątrz niego są zagnieżdżone i działają tylko wtedy, gdy dostawca włączył obsługę zagnieżdżania dla Twojego kontenera. Sprawdź również uname -r, ponieważ od października 2026 roku bieżące wydania Incus oraz seria 7.0 LTS wymagają jądra w wersji 6.12 lub nowszej, podczas gdy seria 6.0 LTS dokumentuje wersję 5.4.

Który backend pamięci masowej wybrać dla Incus na VPS?

btrfs na pliku pętli (loop file), chyba że dysponujesz wolnym urządzeniem blokowym. Sterownik dir jest dokumentowany jako znacznie wolniejszy od pozostałych, ponieważ kopiuje pliki zamiast korzystać z mechanizmu copy-on-write, co powoduje, że każdy snapshot zapisuje cały kontener ponownie. incus admin init --minimal wybiera dir, chyba że bazowym systemem plików jest Btrfs i ten sterownik jest dostępny, dlatego warto poświęcić dwie minuty na odpowiedzenie na pytania w trybie interaktywnym. Pula tworzona jest za pomocą incus storage create fast btrfs size=30GiB.

Dlaczego mój kontener Incus może połączyć się z usługą działającą na hoście?

Ponieważ domyślny most incusbr0 umieszcza hosta w tej samej podsieci co kontener, pod adresem bramy, a reguły zapory sieciowej dodawane przez Incus do tego mostu mają zapewnić działanie sieci, a nie blokować hosta. Każda usługa hosta powiązana z 0.0.0.0 odpowiada na żądania, chyba że reguła zapory sieciowej hosta odrzuci pakiety, a zapora dostawcy nigdy ich nie widzi, ponieważ nie opuszczają one maszyny. Powiąż usługi hosta z 127.0.0.1, a na hoście z ufw zezwól tylko na ruch DNS i DHCP na incusbr0, zamiast stosować ogólne sudo ufw allow in on incusbr0.

Jak wykonać kopię zapasową kontenera Incus?

incus export web /root/web-backup.tar.gz zapisuje instancję oraz jej snapshoty do jednego pliku, a incus import przywraca ją na tym samym lub innym serwerze. Snapshoty wykonane za pomocą incus snapshot create nie są kopiami zapasowymi: znajdują się w tej samej puli pamięci na tym samym dysku, więc chronią przed nieudaną aktualizacją, ale nie przed awarią serwera. Zaplanuj je za pomocą incus config set web snapshots.schedule=@daily i kopiuj wyeksportowane pliki poza serwer.

Czy ten artykuł był przydatny?

#incus#lxd#system-containers#virtualization#vps