2025년 12월, IceWhale 커뮤니티 튜토리얼에서 특정 ZimaOS 커널용 RTX 50XX GPU의 독립형 NVIDIA 오픈 커널 확장 프로그램을 공개했습니다. 이후 한 사용자는 RTX 5060 Ti 16GB에서 컨테이너에 GPU 제어 기능이 노출되는 것을 확인했습니다. 다른 사용자들은 동일한 절차가 ZimaOS 1.6.1에서는 실패했거나 RTX 5090을 사용할 수 있게 만들지 못했다고 보고했습니다.
따라서 이 게시물은 버전에 종속된 과거의 절차이며, 언제나 적용되는 “최신 NVIDIA 드라이버” 명령이 아닙니다.
과거의 정확한 절차
원문 게시물에서는 사용자에게 SSH로 접속해 root로 전환한 다음 다음 명령을 실행하도록 안내했습니다.
cd /var/lib/extensions/
wget https://github.com/jerrykuku/staff/releases/download/v0.1.3/nvidia-open-kernel-580.105.08-linux-6.12.25.raw -O nvidia-open-kernel-580.105.08-linux-6.12.25.raw
systemd-sysext refresh
install-nvidia-kernel-open
GPU가 RTX 50XX 모델이라는 이유만으로 이 블록을 실행하지 마세요. 파일 이름은 Linux 커널 6.12.25를 명시적으로 대상으로 하며, 설치된 ZimaOS 빌드에 도우미 명령이 존재해야 합니다. 커널 확장을 변경하기 전에 앱 데이터를 백업하고 로컬 콘솔을 통한 복구 경로를 확인하세요.
설치 전에 ZimaOS 빌드 일치 여부 확인
- 정확한 ZimaOS 버전과 커널을 기록합니다.
lspci에 GPU가 표시되는지 확인합니다.install-nvidia-kernel-open이 존재하는지 확인합니다.- 확장 프로그램의 커널 번호가 현재 실행 중인 커널과 일치하는지 확인합니다.
- 소스 스레드의 최신 답글에서 회귀 문제를 확인합니다.
ZimaOS 1.6.1 사용자는 시스템 확장 프로그램에 대해 Package not installed가 표시되고, install-nvidia-kernel-open: command not found 오류가 발생했다고 보고했습니다. 이는 중단 신호이지, 다른 root 수준 설치 프로그램을 임의로 시도할 이유가 아닙니다.
PCIe 장치가 없으면 드라이버로 해결할 수 없습니다
lspci에 NVIDIA 엔드포인트가 표시되지 않는다면 먼저 Oculink, 어댑터 무결성, 도크 전원, 케이블 연결 상태, PCIe 링크 트레이닝을 점검하세요. 관련 Oculink 감지 스레드는 팬과 LED가 작동한다고 해서 장치가 인식되었다는 의미는 아님을 보여 줍니다.
RTX 5060 Ti 성공 사례에서 확인된 내용
이 성공 사례는 특정 모델과 소프트웨어 조합이 작동했다는 사실을 입증했습니다. Stable Diffusion 설정, 모든 RTX 50XX 카드, 모든 도크 또는 이후 출시된 모든 ZimaOS 버전에서 작동한다는 의미는 아닙니다.
재부팅 후 세 계층을 모두 확인
-
호스트:
lspci에서 GPU가 확인되고nvidia-smi가 GPU 정보를 표시해야 합니다. - 컨테이너: ZimaOS 앱 설정에서 NVIDIA GPU 액세스를 허용해야 합니다.
-
애플리케이션: 작업이 CUDA, NVENC 또는 관련 GPU 백엔드를 선택하고
nvidia-smi에 프로세스가 표시되어야 합니다.
구형 NVIDIA 카드에는 RTX 50XX 확장 프로그램을 사용하지 마세요
별도의 GTX 1050 Ti 사용자가 이 확장 프로그램을 설치한 후 NVML 액세스를 잃었고, IceWhale 팀 구성원은 uninstall-nvidia-kernel-open을 실행한 뒤 재부팅하라고 안내했습니다. 확장 프로그램은 지원하도록 빌드된 하드웨어와 시스템 버전에서만 사용하세요.
업데이트 기준은 소스 스레드로 삼으세요
IceWhale이 현재 일반 설치 가이드에서 버전에 관계없이 사용할 수 있는 RTX 50XX 명령을 게시하지 않았으므로, 시도할 때마다 원본 RTX 50XX 튜토리얼로 돌아가 확인하세요. 지원 요청에는 ZimaOS 버전, 커널, GPU 모델, 연결 방식, lspci, nvidia-smi, 전체 오류 메시지를 포함하세요.
ZimaOS의 RTX 50XX FAQ
6.12.25 확장 프로그램은 모든 ZimaOS 릴리스에서 유효한가요?
아니요. 파일 이름과 이후의 실패 보고를 보면 버전에 종속되어 있습니다.
“NVIDIA Corporation Device”가 표시되면 드라이버가 작동한다고 봐도 되나요?
아니요. 호스트에서 장치 인식은 성공했지만, nvidia-smi가 드라이버와 통신하는지도 확인해야 합니다.
GPU가 lspci에 표시되기 전에 드라이버를 설치해야 하나요?
아니요. 먼저 하드웨어 인식 문제를 해결하세요.
