Proxmox Modülü
WHMCS üzerinden Proxmox VE sanal makineleri ve konteynerleri için otomatik provizyon ve yaşam döngüsü yönetimi sağlar.
Ön koşullar
- WHMCS 8.x/9.x desteklenen sürüm
- PHP 8.1+, cURL, JSON, mbstring ve XML
- Proxmox HTTPS API erişimi; varsayılan port 8006
- API Token ve sınırlandırılmış Proxmox rolü
- Cloud-init uyumlu şablon
Kurulum adımları
-
1
Yedek ve ön kontrol
WHMCS dosyaları ile veritabanını yedekleyin; işlemi önce staging ortamında uygulayın.
-
2
Dosyaları yükleyin
Paket dizin yapısını bozmadan şu hedeflere yükleyin: modules/servers/proxmoxcloud/, modules/addons/proxmoxcloud_admin/
-
3
İzinleri doğrulayın
Klasörleri normalde 750/755, dosyaları 640/644 tutun; web sunucusu sahibini doğru ayarlayın ve 777 kullanmayın.
-
4
Bağımlılıkları kurun
Paket vendor klasörü içermiyorsa, composer.json bulunan modül klasöründe üretim bağımlılıklarını kurun.
Komutcomposer install --no-dev --optimize-autoloader -
5
Modülü etkinleştirin
WHMCS yönetiminde sunucu modülünü ve varsa yönetici eklentisini etkinleştirin.
-
6
İlk yapılandırmayı kaydedin
Aşağıdaki modüle özel alanları doldurun; test tamamlanmadan canlı ortam/kimlik bilgilerine geçmeyin.
Yapılandırma
Bağlantı profili
Proxmox adresi, port 8006, realm, kullanıcı ve API Token ID/Secret bilgilerini ekleyin.
Kaynak eşlemesi
Node/cluster, storage, bridge/VLAN, şablon, CPU, RAM, disk ve IP havuzunu ürüne bağlayın.
Cloud-init
Şablonda cloud-init diskini ve guest agent'ı doğrulayın; test kullanıcı/SSH anahtarıyla klonlayın.
Cron
Ana işlemler WHMCS cron ile yürür. Yönetici kuyruğu/ölçüm görevlerini yalnız paketinizdeki dosya ve ayarlara göre ekleyin.
*/5 * * * * php -q /WHMCS_PATH/crons/cron.php
Testler
- Test kaynak havuzunda bir VM oluşturun; VMID, node, ağ ve disk değerlerini karşılaştırın.
- Cloud-init hostname, kullanıcı ve ağ yapılandırmasını doğrulayın.
- Askıya alma, yeniden etkinleştirme ve sonlandırmayı kontrollü test hizmetinde deneyin.
Güvenlik
- root@pam parolası yerine ayrı kullanıcı ve API Token kullanın.
- curl -k veya SSL doğrulamasını kapatma yöntemini canlı çözüm olarak kullanmayın.
Sorun giderme
API bağlantısı kurulamıyor
Port 8006, TLS zinciri, realm, Token ID/Secret ve Proxmox ACL kapsamını kontrol edin.
Cloud-init çalışmıyor
Şablonun cloud-init diskini, guest agent'ı ve klon tipini Proxmox üzerinde elle test edin.