Linux VPS'e CloudPanel Kurulumu (Ubuntu/Debian)

CloudPanel; Nginx, PHP-FPM, veritabanları ve SSL sertifikalarını web arayüzünden yöneten ücretsiz ve hafif bir kontrol panelidir. Bir Infrawire Linux VPS üzerine kurulduğunda boş bir sunucuyu birkaç dakikada çok siteli bir barındırma platformuna dönüştürür. Bu rehber Ubuntu 24.04 ve Debian 12 için geçerlidir.

📋 Gereksinimler

Ubuntu 24.04 veya Debian 12 yüklü, başka hiçbir şey kurulu olmayan (Apache, Nginx, MySQL veya başka bir panel yok) yeni bir KVM VPS.
En az 2 GB RAM ve root SSH erişimi. VPS'in IP adresini ve root parolasını müşteri alanınızda bulabilirsiniz.
DNS A kaydı (IPv6 kullanıyorsanız AAAA kaydı da) VPS_IP adresine yönlenen bir alan adı.
İnternetten erişilebilen 22, 80, 443 ve 8443 portları.

🔄 1. Sistemi hazırlayın

root olarak bağlanın ve paketleri güncelleyin. CloudPanel için curl, wget ve sudo gerekir.

Bash
1ssh root@VPS_IP
2apt update && apt -y upgrade && apt -y install curl wget sudo

Çekirdek güncellendiyse devam etmeden önce reboot ile yeniden başlatın ve tekrar bağlanın.

⬇️ 2. Resmi kurulum betiğini çalıştırın

Kurulum betiği önce indirilir, çalıştırılmadan önce SHA-256 sağlama toplamı doğrulanır. Sağlama toplamı her betik sürümünde değişir: güncel değeri ve güncel veritabanı motoru listesini resmi sayfadan kopyalayın: https://www.cloudpanel.io/docs/v2/getting-started/other/ (aşağıdaki SHA256_FROM_DOCS ifadesini değiştirin).

Bash
1curl -sS https://installer.cloudpanel.io/ce/v2/install.sh -o install.sh
2echo "SHA256_FROM_DOCS install.sh" | sha256sum -c
3sudo CLOUD_PANEL_DB_ENGINE=MARIADB_11.4 bash install.sh

CLOUD_PANEL_DB_ENGINE değişkeni veritabanı sunucusunu seçer. Belgelenen değerler MYSQL_8.4, MYSQL_8.0, MARIADB_11.4 ve MARIADB_10.11 değerleridir. Belirtmezseniz kurulum betiği varsayılanını kullanır. sha256sum -c komutu install.sh: OK yazdırmalıdır; FAILED görürseniz durun ve dosyayı yeniden indirin. Kurulum birkaç dakika sürer.

🔑 3. İlk yönetici hesabını oluşturun

Tarayıcınızda https://VPS_IP:8443 adresini açın. Sertifika kendinden imzalıdır, bu yüzden tarayıcı uyarı gösterir: bu ilk giriş için kabul edin.

Yöneticiyi ilk ziyaretçi oluşturur, bu yüzden bunu hemen yapın. Kullanıcı adını, e-posta adresini ve uzun bir parolayı girip oturum açın. Hesabı oluşturmadan önce paneli saatlerce açık bırakmayın.

🌐 4. PHP sitesi ekleyin

Panelde Sites, ardından Add Site ve Create a PHP Site seçeneklerine tıklayın. Bir uygulama şablonu seçin (Generic, WordPress, Laravel vb.), alan adı olarak example.com girin, bir PHP sürümü seçin ve site kullanıcısı ile parolasını belirleyin. CloudPanel, Nginx vhost'unu, bir PHP-FPM havuzunu ve siteye özel bir sistem kullanıcısını oluşturur.

Dosyalarınızı root ile değil, site kullanıcısıyla SFTP üzerinden /home/USER/htdocs/example.com dizinine yükleyin. Databases bölümünden site için bir veritabanı da oluşturabilirsiniz.

🔒 5. Let's Encrypt sertifikası alın

example.com alan adının zaten VPS_IP adresine yönlendiğini kontrol edin:

Bash
1dig +short example.com

Ardından siteyi açın, SSL/TLS sekmesine gidin, Actions düğmesine tıklayın ve New Let's Encrypt Certificate seçeneğini seçin. Dahil edilecek alan adlarını işaretleyip onaylayın. Yenileme CloudPanel tarafından otomatik yapılır.

🛡️ 6. Paneli güvenceye alın

Admin Area > Security > Firewall bölümünde 8443 portunu yalnızca kendi IP adresinize izin verecek şekilde sınırlayın ve her yerden erişime izin veren kuralı silin. 22, 80 ve 443 portlarını ihtiyacınıza göre açık tutun.
Admin Area > Security bölümünde ikinci bir engel olarak panel için Basic Auth'u etkinleştirin.
Kullanıcı profilinizde iki adımlı doğrulamayı etkinleştirin.
Uzun ve benzersiz bir parola kullanın, sistemi güncel tutun:

Bash
1apt update && apt -y upgrade

✅ 7. Kurulumu doğrulayın

Bash
1ss -tlnp | grep -E ':(80|443|8443)\b'
2systemctl is-active nginx clp-agent
3curl -I https://example.com

80, 443 ve 8443 portları dinlemede olmalı, iki servis de active yanıtı vermeli ve son komut geçerli sertifikayla HTTP 200 veya bir yönlendirme döndürmelidir.

🧰 Sorun giderme

Kurulum betiği başlamıyor veya yarıda kesiliyor: CloudPanel temiz bir sisteme kurulmalıdır. Sunucuda önceden başka bir web sunucusu ya da veritabanı varsa müşteri alanınızdan işletim sistemini yeniden kurun ve baştan başlayın.
8443 portu yanıt vermiyor: Güvenlik duvarının (panel kuralları ve diğer güvenlik duvarları) portu açtığını ve IP adresinizin izinli listeden çıkarılmadığını kontrol edin. Sunucuda ss -tlnp | grep 8443 çalıştırın.
Let's Encrypt başarısız oluyor: Alan adı henüz VPS'e yönlenmiyor ya da bir proxy gerçek IP'yi gizliyor. DNS kaydını düzeltin, yayılmasını bekleyin ve yeniden deneyin. 80 portu açık olmalıdır.
Yönetici parolası kayboldu: Kabuktan clpctl user:reset:password --userName='admin' --password='NEW_PASSWORD' ile sıfırlayın.

🎉 CloudPanel çalışıyor: sitelerinizi ekleyin, 8443 portunu koruyun ve VPS'inizde temiz bir barındırma ortamının keyfini çıkarın.