W obecnym ZimaOS nie stosuj instrukcji Ubuntu instalujących NVIDIA Container Toolkit za pomocą apt na hoście. ZimaOS ma własną integrację sterownika/środowiska uruchomieniowego NVIDIA, a aktualna dokumentacja aplikacji Docker pokazuje używanie kontenerów GPU z runtime: nvidia oraz NVIDIA_VISIBLE_DEVICES.
Użytkownik źródłowy z 2025 roku miał ogólny serwer x86 z kartą GTX 1050 i słusznie zauważył, że ZimaOS nie ma standardowego menedżera pakietów Debiana. Uruchomienie toolkit w kontenerze Alpine również nie rozwiąże problemu środowiska uruchomieniowego hosta — środowisko NVIDIA musi istnieć na poziomie hosta Docker.
Najpierw sprawdź sterownik GPU hosta
nvidia-smi
lspci -nnk | grep -A3 -Ei 'vga|3d|display'Jeśli nvidia-smi nie może skomunikować się z GPU, konfiguracja Dockera nie jest pierwszym problemem.
Sprawdź, czy Docker ma już środowisko uruchomieniowe NVIDIA
docker info | grep -i nvidia
ps aux | grep '[d]ockerd'Obecne wersje ZimaOS często uruchamiają Dockera z dostępnym środowiskiem NVIDIA, nawet na systemach, na których nie jest ono aktywnie używane.
Użyj modelu środowiska uruchomieniowego ZimaOS
Aktualny przewodnik ZimaOS dotyczący środowiska uruchomieniowego NVIDIA dla Dockera pokazuje:
services:
my-gpu-app:
image: your/image
runtime: nvidia
ipc: host
environment:
NVIDIA_VISIBLE_DEVICES: allDlaczego instalacja toolkit w innym kontenerze nie działa
NVIDIA Container Toolkit integruje się z Dockerem/containerd na hoście. Własny przewodnik instalacji NVIDIA Container Toolkit firmy NVIDIA używa polecenia nvidia-ctk runtime configure do modyfikacji konfiguracji Dockera na hoście i ponownego uruchomienia Dockera.
Nie kopiuj instrukcji dotyczących apt do ZimaOS
Przewodnik instalacji NVIDIA zakłada obsługiwane dystrybucje w stylu Debiana/RPM z menedżerami pakietów na hoście. Obecne ZimaOS nie jest utrzymywane w ten sposób, dlatego instrukcje dotyczące pakietów na hoście mogą kolidować z obrazem urządzenia i modelem aktualizacji.
Przetestuj dostęp do GPU w kontenerze
Gdy sterownik hosta i środowisko uruchomieniowe działają prawidłowo, użyj znanego kontenera z obsługą GPU lub docelowej aplikacji, aby potwierdzić, że urządzenie jest faktycznie widoczne wewnątrz kontenera.
GTX 1050 ma ograniczenia dotyczące obciążenia
GTX 1050 może wystarczyć do niektórych zadań transkodowania NVENC/NVDEC, ale obciążenia związane ze sztuczną inteligencją, takie jak obecne uczenie maszynowe Immich, mogą mieć bardziej rygorystyczne wymagania dotyczące CUDA, pamięci VRAM, modeli i frameworków. „Docker widzi GPU” nie gwarantuje, że każda aplikacja będzie je obsługiwać.
Utwórz kopię konfiguracji aplikacji przed zmianą ustawień środowiska uruchomieniowego
Nie zastępuj ręcznie plików usług Dockera ani konfiguracji środowiska uruchomieniowego, chyba że możesz przywrócić poprzedni stan. Błędna konfiguracja środowiska uruchomieniowego hosta może zatrzymać wszystkie aplikacje Docker, a nie tylko kontener GPU.
Aktualny przewodnik dotyczący kontenerów GPU dokładniej wyjaśnia obecną i dawną granicę odpowiedzialności oprogramowania.
Sprawdź środowisko uruchomieniowe wewnątrz docelowej aplikacji
Hostowe nvidia-smi potwierdza tylko, że sterownik hosta ZimaOS widzi kartę. Otwórz powłokę w rzeczywistym kontenerze z obsługą GPU i sprawdź w nim urządzenie oraz środowisko uruchomieniowe; w przeciwnym razie aplikacja może po cichu przełączyć się na procesor, mimo że GPU hosta działa prawidłowo.
Oddziel transkodowanie od zgodności z AI
Obsługa NVENC/NVDEC, możliwości obliczeniowe CUDA, pamięć VRAM oraz frameworki zależne od aplikacji to różne ograniczenia. Karta obsługująca transkodowanie w Plex/Jellyfin może być nadal zbyt stara lub mieć zbyt mało pamięci dla obecnego modelu ML.
FAQ
Czy powinienem zainstalować nvidia-container-toolkit za pomocą apt w ZimaOS?
Nie. Użyj obecnej ścieżki środowiska uruchomieniowego NVIDIA w ZimaOS, zamiast traktować hosta jak Ubuntu.
Czy mogę zainstalować toolkit w Dockerze Alpine?
Nie. Integracja środowiska uruchomieniowego musi istnieć na hoście Dockera.
Skąd mam wiedzieć, czy Docker widzi NVIDIA?
Sprawdź docker info, polecenie demona Dockera i jego środowisko uruchomieniowe, a następnie zweryfikuj dostęp do GPU wewnątrz docelowego kontenera.
Czy hostowe nvidia-smi potwierdza, że Immich ML będzie działać?
Nie. Potwierdza widoczność sterownika hosta; kontener i aplikacja nadal wymagają zgodnej obsługi CUDA, odpowiedniej pamięci VRAM oraz środowiska uruchomieniowego.
