Ubuntu veya Debian'a NVIDIA sürücülerini ve CUDA'yı kurun
GPU sunucuya NVIDIA veri merkezi sürücüsünü ubuntu-drivers veya NVIDIA deposuyla kurun, CUDA araç setini ekleyin ve nvidia-smi ile nvcc ile doğrulayın.
- Orta
- 30 dk okuma
- Güncellendi
Bu sayfada
GPU sunucunuzdaki NVIDIA GPU'yu herhangi bir yazılımın kullanabilmesi için önce NVIDIA sürücüsü gerekir. Çoğu yapay zeka aracı ve konteyner başka bir şeye ihtiyaç duymaz; CUDA araç seti CUDA kodunu kendiniz derlemek içindir. Bu rehber ikisini de Canonical, Debian ve NVIDIA'nın belgelediği şekilde kurar.
Başlamadan önce
- Özel NVIDIA GPU'lu bir GPU VPS, GPU VDS veya GPU'lu dedicated sunucu. Paylaşımlı vGPU için GPU sunucular: başlangıç rehberindeki nota bakın.
- Tamamen güncellenmiş ve yeniden başlatılmış Ubuntu 24.04 LTS veya 26.04 LTS ya da Debian 12 veya 13:
sudo apt update && sudo apt full-upgrade
sudo reboot- GPU'nun göründüğünü kontrol edin:
lspci | grep -i nvidia. - Secure Boot'u kontrol edin:
mokutil --sb-state(gerekirsemokutilkurun).
1. adım: Sürücüyü kurun
Ubuntu
Canonical'ın aracı doğru veri merkezi sürücüsünü seçer ve önceden derlenmiş, imzalı modüller kurar. Adayları listeleyin, ardından bir dal kurun; örneğin Canonical'ın belgelerinde kullandığı 535 dalı. Kendi listenizden bir dal seçin:
sudo ubuntu-drivers list --gpgpu
sudo ubuntu-drivers install --gpgpu nvidia:535-serverAd vermeden sudo ubuntu-drivers install --gpgpu çalıştırmak bunun yerine önerilen dalı kurar. Ardından nvidia-smi içeren araçları kurun; numaraları sürücü dalıyla aynı olmalıdır:
sudo apt install nvidia-utils-535-server
sudo rebootDebian 13
APT kaynaklarınızda trixie ve trixie-security için contrib, non-free ve non-free-firmware bileşenlerini açın, ardından:
sudo apt update
sudo apt install linux-headers-amd64
sudo apt install nvidia-kernel-dkms nvidia-driver
sudo rebootDebian wiki'si her sürücü serisinin hangi GPU kuşaklarını desteklediğini ve açık modül türünün (nvidia-open-kernel-dkms) durumunu listeler; GPU'nuz için kontrol edin. En yeni GPU kuşakları için bunun yerine NVIDIA deposunu kullanın (sonraki sekme).
NVIDIA deposu
NVIDIA'nın kendi deposu Ubuntu ve Debian için en yeni sürücüleri içerir. Dağıtım adı olarak ubuntu2404, ubuntu2604, debian12 veya debian13 kullanın:
sudo apt install linux-headers-$(uname -r)
wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2404/x86_64/cuda-keyring_1.1-1_all.deb
sudo dpkg -i cuda-keyring_1.1-1_all.deb
sudo apt update
sudo apt install nvidia-open
sudo rebootEkransız bir hesaplama sunucusu için NVIDIA daha küçük bir seti de belgeler: sudo apt -V install libnvidia-compute nvidia-dkms-open. Debian'da önce contrib bileşenini açın.
Sürücüyü yalnızca tek bir kaynaktan kurun. Ubuntu'nun sürücü paketlerini NVIDIA deposuyla karıştırmak sürüm çakışmalarına yol açar.
Doğrulama:
nvidia-smiTablo GPU'nuzu, sürücü sürümünü ve sürücünün desteklediği en yüksek CUDA sürümünü gösterir.
2. adım: CUDA araç setini kurun (yalnızca CUDA kodu derlemek için)
Araç seti NVIDIA deposundan gelir. Anahtarlığı 1. adımda eklemediyseniz şimdi ekleyin (aynı wget ve dpkg -i satırları), ardından:
sudo apt update
sudo apt install cuda-toolkitAraç seti sürücü kurmaz. Derleyicisini yolunuza ekleyin; klasör adı sürümü taşır, bu yüzden önce kontrol edin:
ls -d /usr/local/cuda*
echo 'export PATH=/usr/local/cuda/bin:$PATH' >> ~/.bashrc
source ~/.bashrc/usr/local/cuda yoksa bunun yerine ls komutunun yazdığı sürümlü klasörü kullanın.
Doğrulama: nvcc --version CUDA derleyici sürümünü yazar.
3. adım: Sürücüyü güncel tutun
- Ubuntu sürücü paketleri
sudo apt update && sudo apt upgradeile güncellenir. Sürücü güncellemesinden sonra yeniden başlatın. - NVIDIA deposunda tek bir dalda kalmanız gerekiyorsa NVIDIA sürüm sabitleme paketlerini (
nvidia-driver-pinning-…) belgeler.
Sorun giderme
Failed to initialize NVML: Driver/library version mismatch. Sürücü güncellendi ama eski çekirdek modülü hâlâ yüklü. Yeniden başlatın.
NVIDIA-SMI has failed because it couldn't communicate with the NVIDIA driver. Modül yüklenmedi. DKMS sürücülü Secure Boot sistemlerinde MOK anahtarını kaydedin veya Ubuntu'nun imzalı sürücülerini kullanın; ayrıca dkms status ve dmesg | grep -i nvidia çıktılarına bakın. Daha fazlası GPU sorunlarını giderme rehberinde.
apt NVIDIA paketleri arasında çakışma bildiriyor. İki kaynaktan sürücüler karışmış. Onları dpkg -l | grep -i nvidia ile listeleyin, bir kaynağın paketlerini adlarıyla sudo apt purge kullanarak kaldırın, yeniden başlatın ve tek kaynakta kalın.
nvcc: command not found. Araç seti kurulu ama PATH üzerinde değil; bkz. 2. adım.
Sonraki adımlar
- GPU'lu konteynerler: Docker konteynerlerinde GPU.
- Bir model sunun: vLLM kurulumu veya Ollama kurulumu.
Sık sorulan sorular
Yapay zeka uygulamalarını çalıştırmak için CUDA araç seti gerekir mi?
Genellikle hayır. Çoğu uygulama ve konteyner imajı kendi CUDA kitaplıklarını getirir ve yalnızca sürücüye ihtiyaç duyar. Araç setini CUDA kodunu kendiniz derlediğinizde kurun.
Hangi sürücü sürümünü kurmalıyım?
ubuntu-drivers'ın hesaplama için önerdiğini veya NVIDIA deposundaki güncel dalı. Yazılımınızın gereksinimlerine bakın: yeni CUDA sürümleri daha yeni sürücüler ister.
Bu, paylaşımlı vGPU için de geçerli mi?
Hayır. Paylaşımlı vGPU, sunucudaki (host) vGPU yazılımıyla uyumlu vGPU konuk sürücüsünü kullanır; imajlarımız bu sürücüyle gelir. Bu rehberdeki sürücüyü onun üzerine kurmayın. Yeniden kurmak için hizmet bilgilerinizde listelenen veya HyperDC desteğinin verdiği sürümü kullanın.
Secure Boot önemli mi?
Secure Boot açık sistemlerde çekirdek modüllerinin imzalı olması gerekir. Ubuntu'nun ubuntu-drivers aracı önceden derlenmiş imzalı sürücüler kurar; DKMS ile derlenen sürücüler kayıtlı bir makine sahibi anahtarı (MOK) ister.