Transkodowanie sprzętowe zwykle przestaje działać po aktualizacji, ponieważ odtworzony kontener nie ma już dostępu do tego samego urządzenia, grupy uprawnień, możliwości środowiska uruchomieniowego ani zgodnego stosu przestrzeni użytkownika.
GPU hosta może nadal działać, mimo że Plex, Jellyfin, Emby lub aplikacja do kamer po podmianie obrazu po cichu przechodzi na procesor. Najpierw trzeba potwierdzić, czy urządzenie jest dostępne wewnątrz nowego kontenera i czy użytkownik usługi może je otworzyć, a następnie oddzielić problemy z mapowaniem w środowisku uruchomieniowym i uprawnieniami od regresji kodeka lub sterownika specyficznej dla obrazu.
Potwierdź, że zadanie rzeczywiście przeszło na transkodowanie programowe
Wymuś transkodowanie pliku, który tego wymaga, i zanotuj stan w panelu serwera multimediów, log FFmpeg lub transkodera, użycie procesora hosta oraz aktywność silnika GPU. Odtwarzanie bezpośrednie nie testuje ścieżki sprzętowej.
Przypadek ze społeczności LinuxServer zaleca sprawdzenie jawnego wskaźnika sprzętowego i telemetrii GPU, ponieważ sama aktywność procesora może być myląca. Przydatnym kryterium rozróżniającym jest aktywne użycie silnika GPU podczas kontrolowanego transkodowania.
Jeśli logi wskazują, że sprzętowy koder otwiera się prawidłowo, sprawdź nieobsługiwane filtry, napisy, mapowanie tonów lub częściową akcelerację. Jeśli nie można otworzyć urządzenia, kontynuuj diagnostykę wykrywania na hoście i dostępu z kontenera.
Porównaj urządzenia GPU na hoście i wewnątrz kontenera
Wyświetl oczekiwane węzły urządzeń na hoście i wewnątrz zaktualizowanego kontenera. W przypadku VA-API firmy Intel lub AMD porównaj /dev/dri/card* i /dev/dri/renderD*; w przypadku NVIDIA porównaj widoczność w środowisku uruchomieniowym oraz urządzenia zgłaszane przez jej narzędzie do zarządzania.
Przypadek Quick Sync w Unraid pokazuje, że przed pojawieniem się /dev/dri na hoście może być wymagany właściwy moduł jądra, a urządzenie nadal trzeba przekazać do kontenera. Brakującym elementem jest często mapowanie urządzenia /dev/dri, a nie biblioteka multimediów czy baza danych aplikacji.
Jeśli urządzenia nie ma na hoście, najpierw napraw sterownik hosta, BIOS, jądro lub stan sprzętu. Jeśli urządzenie jest dostępne na hoście, ale nie wewnątrz kontenera, porównaj poprzednią i nową konfigurację urządzeń w Compose lub wygenerowaną przez interfejs użytkownika.
Sprawdź dostęp do grup renderowania i wideo
Zapisz numeryczne identyfikatory właściciela i grupy węzłów urządzeń GPU na hoście, a następnie sprawdź grupy przypisane użytkownikowi usługi wewnątrz kontenera. Nazwy takie jak render mogą odpowiadać różnym identyfikatorom numerycznym w różnych obrazach.
Przypadek z poradnika rozwiązywania problemów z Jellyfin w Dockerze pokazuje działającą konfigurację, która jawnie dopasowuje identyfikator grupy renderującej hosta i sprawdza uprawnienia renderD128. To mapowanie numerycznego identyfikatora grupy renderującej może się zmienić, gdy zmieni się obraz, a wraz z nim wewnętrzni użytkownicy lub grupy.
Dodaj wymaganą grupę uzupełniającą w definicji kontenera zamiast udostępniać urządzenie wszystkim użytkownikom z prawem zapisu. Utwórz kontener ponownie i przetestuj dostęp jako rzeczywisty użytkownik usługi multimediów.
Sprawdź flagi środowiska uruchomieniowego i możliwości zależne od obrazu
Porównaj poprzednią i bieżącą definicję obrazu pod kątem devices, group_add, ustawień środowiska uruchomieniowego GPU, zmiennych możliwości, trybu uprzywilejowanego i ewentualnych zmian w szablonie menedżera kontenerów.
Zgłoszenie dotyczące Emby opisuje przypadek, w którym akceleracja sprzętowa przestała działać w Dockerze, choć aplikacja nadal była dostępna, ilustrując ciche przejście na oprogramowanie po utracie dostępu do GPU, przez które łatwo przeoczyć ten problem.
Nie rozwiązuj wąskiego problemu z dostępem do urządzenia, przyznając szerokie uprawnienia uprzywilejowane. Przywróć tylko minimalne uprawnienia do urządzenia i grup wymagane przez ścieżkę kodera.
Odróżnij regresję obrazu kontenera od awarii hosta
Uruchom prosty test GPU lub FFmpeg w zaktualizowanym kontenerze, a następnie porównaj wyniki z poprzednim przypiętym obrazem przy użyciu tych samych podmontowań, mapowań urządzeń, pliku multimedialnego i konfiguracji aplikacji.
Jeśli stary obraz działa od razu, a nowy nie działa przy identycznym stanie środowiska uruchomieniowego, zachowaj logi i potraktuj aktualizację jako regresję w przestrzeni użytkownika, kodeku, FFmpeg lub aplikacji. Nie zmieniaj wielokrotnie uprawnień, skoro kontrolowane porównanie obrazów pozwala już wskazać wersję jako przyczynę.
Czyść tylko udokumentowane, odtwarzalne pamięci podręczne kodeków, gdy wskazują na nie logi, i nie naruszaj bazy danych aplikacji ani metadanych multimediów. Przypnij sprawdzony obraz, dopóki przyczyna regresji nie zostanie zrozumiana lub usunięta.
Sprawdź cały potok po naprawie
Przetestuj dekodowanie i kodowanie sprzętowe, mapowanie tonów, wypalanie napisów w obrazie oraz co najmniej jednego klienta wymuszającego transkodowanie. Potwierdź, że w logach pojawia się oczekiwane urządzenie GPU, a host wykazuje długotrwałą aktywność silnika.
Procedura ZimaSpace dotycząca weryfikacji rzeczywistego transkodowania sprzętowego zapewnia bardziej miarodajny test zakończenia niż przełącznik na stronie ustawień.
Problem zostaje rozwiązany dopiero wtedy, gdy zaktualizowany lub przypięty kontener zachowuje dostęp do urządzenia po ponownym utworzeniu i restarcie, używa GPU w docelowej ścieżce kodeka i nie przełącza się po cichu na tryb zastępczy. Zachowaj poprzedni digest obrazu i definicję środowiska uruchomieniowego jako punkt odniesienia do przywrócenia przy następnej aktualizacji.
Wsparcie i porady
Więcej do przeczytania

Jak ukryć filmy dla dorosłych na serwerze NAS przed członkami rodziny
Przechowuj filmy dla dorosłych prywatnie na rodzinnym serwerze NAS. Sprawdź uprawnienia folderów, dostęp do bibliotek Plex i Jellyfin, miniatury, historię oglądania, wspólne loginy do...

Co sprawdzić przed załadowaniem modelu społecznościowego w Transformers
Użyj aktualizacji piaskownicy Jinja dla Transformers, aby sprawdzić pochodzenie modelu, szablony czatu, zdalny kod, serializowane wagi i pierwsze uruchomienia w izolowanym środowisku.

Uruchom Mirage lokalnie: OCR i wykrywanie obiektów na podstawie jednego obrazu
Przetestuj niewielki lokalny model wizyjny Cactus Compute, zweryfikuj OCR i ekstrakcję obiektów na rzeczywistych danych wejściowych oraz poznaj ograniczenia związane z pamięcią, językiem i...



