DOKÜMANTASYON

Kurulum ve kullanım rehberi

Proxmox VE hazırlığı

Proxmox paketi, Proxmox VE REST API’sini kullanır. Panel sunucusundan Proxmox’a HTTPS 8006 erişimi gerekir.

API kullanıcısı

Datacenter → Permissions bölümünde bir kullanıcı (ör. hostvm@pve) veya API Token oluşturun. Token kullanıyorsanız Privilege Separation kapalı önerilir.

Rol

Aşağıdaki yetkilerle bir rol oluşturup kullanıcıyı / yoluna atayın:

VM.Allocate VM.Clone VM.Config.CPU VM.Config.Memory VM.Config.Disk
VM.Config.Network VM.Config.Options VM.Config.CDROM VM.Config.Cloudinit
VM.PowerMgmt VM.Console VM.Audit VM.Snapshot VM.Snapshot.Rollback
VM.Backup VM.Monitor Datastore.Allocate Datastore.AllocateSpace
Datastore.AllocateTemplate Datastore.Audit Sys.Audit SDN.Use Pool.Audit

Proxmox VE 9’da ek olarak VM.GuestAgent.Audit ve VM.GuestAgent.Unrestricted gerekir; 8.x’te VM.Monitor yeterlidir.

Şablon VM’ler

  • qemu-guest-agent kurulu ve VM Options → QEMU Guest Agent etkin olmalı. Panel IP, parola ve hostname ayarlarını guest agent üzerinden uygular.
  • Şablonu Convert to template ile şablona çevirin.
  • Yedekleme için en az bir depoda “VZDump backup file” içeriği açık olmalı.

Panele ekleme

Proxmox Yönetimi → Proxmox Ekle: adres (pve.firma.com, farklı port için pve.firma.com:8007), kullanıcı (hostvm@pve veya token için hostvm@pve!panel) ve parola/token. Kayıt öncesi bağlantı otomatik test edilir. Ardından Senkronize et ile node, depo ve VM listesini alın.

Bilinen sınırlar

  • Node bakım modu Proxmox REST API’sinde yoktur.
  • Disk küçültme desteklenmez.
  • Çalışan VM’de CPU/RAM değişikliği, hotplug açık değilse yeniden başlatma sonrası uygulanır.