Proxmox VE (PVE) ortamında sanal makinelerinizle (VM) çalışırken, ana makineye takılı fiziksel bir USB cihazını (örneğin bir harici disk, KVM aygıtı veya dongle) web arayüzü (GUI) üzerinden bir VM’e bağlamak istediğinizde şu hata ile karşılaşabilirsiniz:
“only root can modify ‘usb0’ config for real devices (500)”
Bu rehberde, bu hatanın neden kaynaklandığını ve sorunu PVE Web GUI‘ye bağımlı kalmadan, SSH terminali üzerinden root yetkisiyle saniyeler içinde nasıl çözeceğinizi adım adım anlatıyoruz.
Hatasının Nedeni Nedir?
Proxmox’un varsayılan güvenlik politikaları gereği, küme (cluster) veya sunucu üzerinde Administrator rolüne sahip olsalar bile root@pam dışındaki kullanıcıların ana makinenin fiziksel donanımlarına (USB, PCIe pass-through vb.) doğrudan müdahale etmesine izin verilmez.
Eğer web arayüzünde root dışındaki bir admin veya API kullanıcısıyla oturum açtıysanız, Proxmox bu işlemi güvenlik bariyerine takar ve 500 iç sunucu hatası döndürür.
Çözüm: SSH Üzerinden Root Yetkisiyle USB Bağlama
Makinemize root kullanıcısı ile SSH erişimimiz olduğuna göre, bu kısıtlamayı CLI (Command Line Interface) üzerinden kolayca aşabiliriz.
Adım 1: USB Cihazının Kimliğini (ID) Bulun
İlk olarak Proxmox hostunuza SSH ile bağlanın ve aşağıdaki komutu çalıştırarak sisteme takılı USB cihazlarını listeleyin:
lsusbÖrnek Çıktı:
Bus 002 Device 002: ID 2109:0715 VIA Labs, Inc. VL817 SATA Adaptor
Bus 001 Device 002: ID 12d1:0003 Huawei Technologies Co., Ltd. Keyboard/Mouse KVM 1.1.0Burada hedefleyeceğimiz yapı VendorID:ProductID çiftidir. Örneğin, yukarıdaki çıktıda yer alan Hikvision harici disk/adaptör için bu kimlik 2109:0715‘tir.
Adım 2: Diskin Durumunu Doğrulayın (Opsiyonel)
Bağlayacağınız cihaz bir depolama birimi ise, sistem tarafından tanındığından emin olmak için fdisk -l ile kontrol edebilirsiniz:
fdisk -lÇıktıda diskinizin yolunu (örn: /dev/sdc) ve boyutunu doğrulayarak doğru cihaz üzerinde işlem yaptığınızdan emin olun.
Adım 3: USB’yi Sanal Makineye (VM) Entegre Edin
Proxmox’un güçlü qm (Qemu Manager) aracını kullanarak, web arayüzündeki yetki kısıtlamasına takılmadan cihazı doğrudan ilgili VM’e atayabiliriz.
Aşağıdaki komutta <VM_ID> yerine hedef sanal makinenizin numarasını (örn: 101) ve host kısmına da ilk adımda bulduğunuz USB ID’sini yazarak çalıştırın:
qm set <VM_ID> -usb0 host=XXXX:YYYY,usb3=1Gerçek Bir Senaryo Örneği:
Eğer VM ID’niz 101 ve USB ID’niz 2109:0715 ise komut şu şekilde olmalıdır:
qm set 101 -usb0 host=2109:0715,usb3=1💡 İpucu: Eğer bağladığınız cihaz yüksek hızlı bir harici SSD veya USB 3.0 destekli bir disk ise, komutun sonuna mutlaka
,usb3=1parametresini ekleyin. Aksi takdirde Proxmox cihazı varsayılan olarak USB 2.0 hızında eşleştirecektir.
Değişikliklerin Aktif Edilmesi
Komutu çalıştırdıktan sonra Proxmox Web GUI’ye dönüp ilgili sanal makinenin Hardware (Donanım) sekmesine giderseniz, USB aygıtının listenize başarıyla eklendiğini göreceksiniz.
- Eğer VM kapalıysa: Doğrudan başlatabilirsiniz.
- Eğer VM açık (Running) durumdaysa: Donanımın sanal makine işletim sistemi (Guest OS) tarafından tam anlamıyla algılanabilmesi için VM’i içeriden kapatıp (Shutdown) web arayüzünden yeniden başlatmanız (Start) önerilir. Sıcak reset (Reboot) işlemleri bazen yeni donanım katmanını tetiklemeyebilir.