VDS'e cPanel Nasıl Kurulur? Lisans, Gereksinimler ve Kurulum

Elinizde yeni bir VDS var ve amacınız birkaç siteyi ya da müşteri hesabını tek panelden yönetmek. cPanel kurulumu bu yolun ilk adımı, ama internetteki Türkçe rehberlerin çoğu tek bir curl komutu paylaşıp bitiyor. Gerçekte kurulumun başarısız olmasının nedenleri neredeyse hiç bu komutta değil: yanlış işletim sistemi seçilmiş oluyor, sunucuda daha önce Apache veya MySQL kurulmuş oluyor, hostname tam nitelikli bir alan adı değil, ya da lisansın sunucunun ana IP adresine bağlandığı bilinmediği için kurulum bitiyor ama panel "license file expired" diyor.

Bu yazıda cPanel/WHM kurulumunu, gerçekten çalışan bir sırayla anlatıyorum: hangi dağıtımların desteklendiği ve neden CentOS 7 rehberlerinin artık işe yaramadığı, kuruluma başlamadan önce sunucunun neden hiç dokunulmamış olması gerektiği, hostname'in nasıl ayarlanacağı, kurulum komutu ve süreci, lisansın nasıl çalıştığı ve IP değişirse ne olacağı, WHM açıldıktan sonra karşınıza çıkan ilk yapılandırma sihirbazında hangi ekranda ne seçeceğiniz ve kurulum hatalarının tek tek çözümü.

cPanel/WHM Nedir ve Ne Zaman Gerekmez#

cPanel iki parçadan oluşur: WHM sunucunun tamamını yöneten yönetici arayüzüdür (hesap açma, paket tanımlama, servis ayarları, güvenlik, yedek), cPanel ise her hesabın kendi kullanıcısına açılan arayüzdür (dosya yöneticisi, e-posta, veritabanı, SSL). Yani WHM sunucu sahibinin, cPanel son kullanıcının panelidir. İkisi arasındaki iş bölümünü daha ayrıntılı görmek için WHM nedir yazısına bakabilirsiniz.

Şunu peşinen söylemek isterim: tek bir siteniz varsa cPanel kurmanız çoğu zaman gereksizdir. Lisans bedeli bir yana, panel sunucuda kalıcı olarak bellek ve CPU tüketir. cPanel'in gerçekten anlamlı olduğu senaryolar şunlar:

• Bayilik yapıyor, müşterilere hosting hesabı satıyorsunuz.
• Onlarca farklı siteyi farklı kullanıcılar adına barındırıyorsunuz.
• Müşterileriniz panelden kendi e-postasını, yedeğini, veritabanını yönetsin istiyorsunuz.
• Ekibinizde komut satırıyla çalışmayan kişiler var.

Buna karşılık tek bir WordPress sitesi için sunucu kuracaksanız, panelsiz bir LAMP kurulumu hem daha az kaynak yer hem lisans gerektirmez.

Desteklenen İşletim Sistemleri: En Kritik Karar Kurulumdan Önce Verilir#

cPanel her Linux dağıtımına kurulmaz ve kurulmayanlarda betik daha ilk saniyede durur. Güncel olarak desteklenen aile şudur: AlmaLinux 8/9, Rocky Linux 8/9, CloudLinux 8/9 ve Ubuntu LTS sürümleri. CentOS 7 desteği sona erdi; internetteki Türkçe rehberlerin çoğu tam olarak o dönemde yazıldığı için oradaki yum komutları artık bir işe yaramıyor.

Sunucu sağlayıcınızın panelinden yeniden kurulum yaparken bu listeden birini seçin. Bayilik yapacaksanız CloudLinux ciddi bir fark yaratır: her hesabı kendi sanallaştırılmış dosya sistemine ve kaynak limitine hapsettiği için, tek bir müşterinin sitesi sunucunun tamamını yavaşlatamaz.

Kurulum Öncesi Sunucu Hazırlığı: "Temiz Sunucu" Şartı#

cPanel kurulumunun bir numaralı başarısızlık nedeni, sunucuda önceden kurulmuş bir web/veritabanı yığınının bulunmasıdır. Kurulum betiği kendi Apache (EA4), MySQL/MariaDB, Exim, Dovecot, BIND ve Pure-FTPd bileşenlerini kurar; sistemde başka bir Apache veya MySQL varsa betik açıkça durur ve şu türden bir mesaj verir:

The system detected an existing installation of MySQL. cPanel & WHM
cannot be installed on a server with existing web or database software.

Bu durumda paketleri "kaldırıp devam etmek" cazip gelir ama tavsiye etmem; artık kalan yapılandırma dosyaları ve kullanıcılar sonradan çok tuhaf hatalara yol açar. Doğru hamle sunucuyu sıfırdan kurmaktır — sağlayıcı panelinden birkaç dakika süren bir işlemdir ve nasıl yapıldığını sunucuya format atma yazısında anlattık.

Kuruluma başlamadan yapılacak kontroller:

# Dağıtım ve sürüm
cat /etc/os-release

# Bellek (en az 1 GB, gerçekçi taban 2 GB)
free -m

# Disk (kök bölümde en az 20 GB boş, gerçekçi taban 40 GB)
df -h /

# Halihazırda çalışan web/DB servisi var mı
ss -tulpn | grep -E ':(80|443|3306|2087|25)\b'

# Perl kurulu mu (kurulum betiği Perl ile çalışır)
perl -v | head -n 2

Hostname mutlaka FQDN olmalı. cPanel, tek kelimelik hostname'i kabul etmez ve kurulumun sonunda uyarı verir. Ayrıca hostname olarak sunucuda barındıracağınız bir siteyi kullanmayın; alanadiniz.com yerine sunucu.alanadiniz.com gibi bir alt alan adı kullanın. Aksi hâlde sitenin kendi kayıtlarıyla sunucunun servis kayıtları birbirine girer.

hostnamectl set-hostname sunucu.alanadiniz.com
hostname -f

Bu hostname'in DNS'te sunucunun IP'sine bakan bir A kaydı olması gerekir; lisans doğrulaması ve SSL için önemlidir.

Son olarak SELinux ve NetworkManager: kurulum betiği gerekli düzenlemeleri kendisi yapar, ama sunucuda özel bir güvenlik duvarı yapılandırması varsa kurulum sırasında kapatın; kurulum bittikten sonra cPanel'in kendi güvenlik duvarı yönetimini kullanırsınız.

cPanel Kurulum Komutu ve Kurulum Süreci#

Root olarak, kurulumu bir screen oturumu içinde başlatın — kurulum 30-60 dakika sürer ve SSH kopması kurulumu yarıda bırakır:

screen -S cpanel
cd /home
curl -o latest -L https://securedownloads.cpanel.net/latest
sh latest

Bağlantınız koparsa yeniden bağlanıp screen -r cpanel ile oturuma dönebilirsiniz.

Kurulum sırasında ekranda uzun bir paket akışı görürsünüz; müdahale gerektiren bir soru sorulmaz. Kurulum boyunca sunucuda şunlar olur:

1. Sistem paketleri güncellenir ve cPanel'in kendi depoları eklenir.
2. EasyApache 4 (Apache + PHP), MySQL/MariaDB, Exim, Dovecot, BIND, Pure-FTPd kurulur.
3. cPanel/WHM servisleri (cpsrvd) kurulur ve başlatılır.
4. Sunucunun ana IP'si için lisans sorgulanır.

Kurulum bittiğinde şuna benzer bir çıktı görürsünüz:

Congratulations! Your installation of cPanel & WHM is now complete.
The next step is to configure your server.
...
https://198.51.100.10:2087

Artık WHM'e girebilirsiniz:

Giriş bilgileri: kullanıcı adı root, şifre sunucunun root şifresi.

Lisans: Nasıl Çalışır ve IP Değişirse Ne Olur#

cPanel lisansı sunucunun ana IP adresine bağlanır. Bu, Türkçe rehberlerde neredeyse hiç anlatılmayan ama en çok baş ağrıtan konudur. Sonuçları şunlar:

• Sunucunun ana IP'si değişirse lisans geçersiz olur ve WHM'e giremezsiniz.
• Sunucuyu başka bir makineye taşırsanız lisansın yeni IP'ye aktarılması gerekir.
• Sağlayıcınızdan aldığınız lisanslar genelde o sağlayıcının IP bloğuna bağlıdır; sunucuyu başka bir yere taşırsanız lisans birlikte gelmez.

Lisans durumunu sunucudan kontrol etmek ve yenilemek için:

/usr/local/cpanel/cpkeyclt

Bu komut lisans sunucusuna gidip anahtarı yeniden alır. Tipik çıktı:

Updating cPanel license...Done. Update succeeded.
Building global cache for cpanel...Done

Sık görülen lisans hataları ve anlamları:

Kurulum sırasında henüz lisansınız yoksa panel kurulur ama giriş yapamazsınız; önce lisansı IP'ye tanımlatıp sonra cpkeyclt çalıştırmanız gerekir.

WHM İlk Yapılandırma Sihirbazı: Ekran Ekran Ne Seçilir#

İlk girişte karşınıza Initial Setup Assistant çıkar. Bu ekranları hızlıca geçmek cazip gelir ama sonradan düzeltmesi en zor ayarlar burada belirlenir.

1. Contact Information (İletişim). Sunucu uyarılarının gideceği e-posta adresini yazın. Buraya bu sunucuda barındırdığınız bir adresi yazmayın — sunucu düştüğünde uyarı e-postası da gitmez. Farklı bir sağlayıcıdaki bir adres kullanın.

2. Hostname & Resolvers (Ana makine adı ve DNS çözümleyiciler). Hostname'i kurulumdan önce ayarladıysanız burada doğrulayın. Resolver alanına genel ve güvenilir DNS çözümleyicileri girin; sağlayıcınızın verdiği çözümleyiciler varsa onlar da uygundur. Yanlış resolver, e-posta gönderiminde ve paket güncellemelerinde gizemli yavaşlıklara yol açar.

3. IP Addresses (IP adresleri). Sunucuda ek IP'ler varsa burada tanımlanır. Tek IP'li standart bir VDS'te değişiklik yapmadan geçebilirsiniz.

4. Nameservers (İsim sunucuları). Burası kritik. İki seçenek var:

• Kendi nameserver'larınızı kullanacaksanız: ns1.alanadiniz.com ve ns2.alanadiniz.com girin. Sonrasında alan adı sağlayıcınızda bu isimler için glue record oluşturmanız şart; aksi hâlde nameserver'lar hiçbir yerden çözülmez. Süreci özel nameserver ve reseller yazısında adım adım anlattık.
• DNS'i başka yerde tutacaksanız: Bu ekranı boş bırakıp DNS rolünü sunucuya yüklemeyebilirsiniz. Tek sunucuda iki nameserver çalıştırmak, sunucu düştüğünde DNS'inizin de düşmesi demektir.

5. Services (Servisler). FTP sunucusu olarak Pure-FTPd varsayılan gelir ve iyi bir tercihtir. Cphulkd (brute force koruması) kutusunu işaretli bırakın — kapatılırsa 2087 portu sürekli deneme altındadır.

6. Quotas (Kotalar). Dosya sistemi kotalarını etkinleştirin. Etkin değilse hesap bazlı disk limitleri uygulanmaz ve tek bir hesap sunucunun diskini doldurabilir.

Sihirbaz bitince WHM ana ekranına düşersiniz. Bundan sonra ilk yapacağınız iş, Account Functions → Create a New Account ile ilk hesabı açmaktır: alan adı, kullanıcı adı, paket ve nameserver seçimini burada yaparsınız.

Kurulum Sonrası Zorunlu Adımlar#

Kurulum bitti diye sunucu üretime hazır değil. Şu altı iş yapılmadan müşteri hesabı açmayın:

1. Root SSH'ı sertleştirin. Parola girişini kapatın, anahtar tabanlı doğrulamaya geçin, SSH portunu değiştirmeyi değerlendirin.
2. Hostname için SSL alın. WHM → Manage AutoSSL ekranından bir sağlayıcı seçip etkinleştirin; hem hostname hem de yeni açılan hesaplar otomatik sertifika alır.
3. Yedeklemeyi yapılandırın. WHM → Backup Configuration. Yedeğin aynı sunucuda durması yedek değildir; Additional Destinations bölümünden uzak bir SFTP/S3 hedefi tanımlayın.
4. Güvenlik duvarını kurun. cPanel'in çalışması için açık kalması gereken portlar:

5. Sunucu paketi (package) tanımlayın. Her hesabı elle limitlemek yerine WHM → Packages ile disk, bant genişliği, e-posta ve veritabanı limitlerini içeren paketler oluşturun.
6. Güncelleme politikasını belirleyin. WHM → Update Preferences ekranından cPanel'in otomatik güncellenmesini açık bırakın; kapatılan sunucular birkaç ay içinde güvenlik yamalarının gerisine düşüyor.

Kurulum Hataları ve Çözümleri#

"cPanel & WHM cannot be installed on a server with existing web or database software." Sunucuda Apache/Nginx/MySQL var. En temiz çözüm işletim sistemini yeniden kurmak.

"The system could not detect a supported operating system." Desteklenmeyen ya da desteği bitmiş bir dağıtımdasınız. cat /etc/os-release ile doğrulayın, desteklenen bir sürümle yeniden kurun.

"Your hostname is not a fully qualified domain name." Hostname tek kelime. hostnamectl set-hostname sunucu.alanadiniz.com ile düzeltin, ardından /etc/hosts dosyasında da satırın güncel olduğunu doğrulayın.

Kurulum yarıda kesildi, tekrar başlatılabilir mi. Evet, sh latest komutunu tekrar çalıştırabilirsiniz; betik kaldığı yerden devam etmeye çalışır. Kurulum günlüğü:

tail -n 100 /var/log/cpanel-install.log

Kurulum bitti ama 2087 açılmıyor. Önce servisi kontrol edin:

systemctl status cpanel
/scripts/restartsrv_cpsrvd

Sunucu içinden curl -k -I https://127.0.0.1:2087 cevap veriyorsa engel güvenlik duvarındadır.

"License file expired" ekranı. /usr/local/cpanel/cpkeyclt çalıştırın. Komut lisans sunucusuna ulaşamıyorsa sunucunun giden bağlantılarında bir filtre vardır.

Kurulum çok yavaş ya da bellek hatası veriyor. 1 GB RAM'li sunucularda EasyApache derleme aşaması sıkışabilir. Swap alanı açmak çoğu zaman kurulumu kurtarır:

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab

Sıkça Sorulan Sorular#

cPanel hangi işletim sistemlerine kurulur#

cPanel güncel olarak AlmaLinux 8/9, Rocky Linux 8/9, CloudLinux 8/9 ve Ubuntu LTS sürümlerine kurulur. CentOS 7 desteği sona erdiği için yeni kurulumlarda kullanılmamalıdır; internetteki eski Türkçe rehberlerin komutlarının çalışmamasının sebebi de budur. Debian ve Windows Server desteklenmez. Bayilik yapacaksanız CloudLinux, hesapları birbirinden yalıtması nedeniyle diğerlerine göre belirgin avantaj sağlar.

cPanel kurulumu ne kadar sürer#

Kurulum tipik bir VDS'te 30 ila 60 dakika sürer. Süreyi belirleyen ana etkenler sunucunun CPU gücü, disk hızı ve EasyApache derleme aşamasıdır. Kurulum boyunca müdahale gerektiren bir soru sorulmaz, ama SSH bağlantısının kopması kurulumu yarıda bırakabilir. Bu yüzden kurulumu screen ya da tmux oturumu içinde başlatmanız, bağlantı koptuğunda işlemin devam etmesini sağlar.

cPanel lisansı olmadan kurulum yapılabilir mi#

Kurulum betiği lisanssız da çalışır ve paketleri kurar, ancak lisans olmadan WHM'e giriş yapamazsınız. Lisans sunucunun ana IP adresine tanımlanır; IP değişirse lisans geçersiz olur ve panel açılmaz. Lisansı tanımlattıktan sonra sunucuda /usr/local/cpanel/cpkeyclt komutunu çalıştırarak anahtarı hemen yenileyebilirsiniz. Deneme lisansı kullanıyorsanız süre dolduğunda aynı ekranla karşılaşırsınız.

cPanel kurulu sunucuda Nginx kullanılabilir mi#

Doğrudan Apache yerine Nginx kurmak desteklenmez, çünkü cPanel kendi EasyApache 4 yığınını yönetir ve elle yapılan değişiklikleri güncellemelerde geri alır. Bunun yerine, Apache'nin önüne ters vekil olarak çalışan resmî eklentiler kullanılır; bu yapıda statik içerikler Nginx tarafından karşılanır, dinamik istekler Apache'ye iletilir. Apache'yi tamamen kaldırmaya çalışmak panelin site yapılandırma dosyalarını üretmesini bozar. Kısacası Nginx'i cPanel'de "yerine" değil, "önüne" koyarsınız.

Kurulumdan sonra hostname değiştirilebilir mi#

Değiştirilebilir ancak dikkat gerektirir, çünkü hostname lisans doğrulaması, sunucu SSL sertifikaları, e-posta sunucusunun kendini tanıtması ve DNS bölgeleriyle ilişkilidir. Değişikliği WHM'in Change Hostname ekranından yapın, sunucu üzerinde elle hostnamectl ile değiştirip bırakmayın. İşlem sonrasında yeni hostname için A kaydını oluşturmayı ve AutoSSL ile yeni sertifika alınmasını beklemeyi unutmayın. Mümkünse hostname'i kurulumdan önce doğru belirleyip sonradan hiç dokunmamak en sorunsuz yoldur.

Tek bir site için cPanel kurmak mantıklı mı#

Genellikle değildir. cPanel arka planda Apache, MySQL, Exim, Dovecot, BIND ve panel servislerini sürekli çalıştırır; bu, tek siteli bir sunucuda kaynakların önemli kısmının panel için harcanması demektir. Üstelik lisans kalıcı bir gider oluşturur. Tek bir WordPress ya da kurumsal siteniz varsa, panelsiz bir web sunucusu kurulumu veya doğrudan paylaşımlı hosting hem daha ucuz hem daha az bakım gerektirir. cPanel'in maliyetini karşıladığı yer, çok sayıda hesabın ayrı ayrı yönetildiği senaryolardır.

cPanel kurulumu sırasında sunucuda veri varsa ne olur#

Kurulum betiği mevcut web ve veritabanı yazılımını tespit ederse kurulumu başlatmadan durur; yani var olan veriyi silmez ama kurulum da tamamlanmaz. Yine de kuruluma girişmeden önce sunucudaki tüm site dosyalarının ve veritabanlarının yedeğini sunucu dışına almanızı öneririm. Doğru yaklaşım, cPanel'i her zaman sıfırdan kurulmuş temiz bir sisteme kurmak ve verileri kurulum tamamlandıktan sonra hesaplara taşımaktır. Var olan bir kurulumun üzerine zorlama, sonradan teşhisi zor hatalar üretir.

Kapanış#

cPanel kurulumu tek bir komuttan ibaret görünse de başarısı, komuttan önce verilen kararlara bağlıdır: desteklenen ve güncel bir dağıtım seçmek, sunucuyu hiç dokunulmamış hâlde bırakmak, hostname'i FQDN olarak baştan ayarlamak, lisansın sunucunun ana IP'sine bağlandığını bilmek ve ilk yapılandırma sihirbazındaki nameserver, kota, uyarı e-postası ayarlarını bilinçli seçmek. Kurulumdan sonra da iş bitmiş olmuyor: AutoSSL'i açmak, sunucu dışına giden bir yedekleme hedefi tanımlamak, güvenlik duvarında yalnızca gerekli portları bırakmak ve otomatik güncellemeleri açık tutmak, paneli üretim ortamı hâline getiren asıl adımlar.

Bu kurulumu üzerinde yapacağınız donanımı seçerken, cPanel'in kendi servislerinin de bellek tükettiğini hesaba katarak VDS paketleri sayfasındaki yapılandırmalara bakabilirsiniz. Kurulum, sertleştirme, güncelleme ve yedek takibiyle uğraşmak istemiyorsanız bu işleri devralan sunucu yönetimi hizmeti daha rahat bir yol; müşterilerinize hosting satmak istiyor ama sunucu işletmek istemiyorsanız hazır kurulu bayi hosting paketleri aynı sonucu kurulum derdi olmadan verir. Yedeklerin sunucu dışında tutulması için de yedekleme çözümünü kurulumun ilk gününde devreye alın.