ZiraCP Dokümanlar

AlmaLinux 9 için modern, yapay zekâ destekli hosting kontrol paneli. Bu kılavuz kurulumdan günlük yönetime kadar her şeyi anlatır.

Giriş

ZiraCP; web sitesi, e-posta, DNS, veritabanı, SSL, yedek ve güvenliğin tamamını tek panelden yöneten, cPanel/WHM sınıfı bir hosting kontrol panelidir. İki düzlemden oluşur:

zCenter (yönetici, port 7443) — sunucunun tamamı: hesaplar, paketler, servisler, DNS, güvenlik.
zPanel (kullanıcı, port 7444) — web sitesi merkezli hesap yönetimi.

Güvenlik mimarisi: web süreçleri asla root çalışmaz; her ayrıcalıklı işlem, tipli bir RPC allowlist'i üzerinden root ajanına iletilir. Genel "komut çalıştır" uç noktası yoktur.

Kurulum

Temiz bir AlmaLinux 9 sunucusuna root olarak tek komutla kurulur:

curl -fsSL https://get.ziracp.com | bash

Kurucu; OS ve mimariyi doğrular, gerekli depoları ekler, servisleri kurar, firewalld portlarını açar ve systemd birimlerini başlatır. Bittiğinde panel adreslerini ve rastgele oluşturulmuş admin parolasını ekrana yazar.

Ortam değişkenleriyle sessiz kurulum

Değişken	Varsayılan	Açıklama
`ZIRACP_HUB_PORT`	7443	Yönetici paneli portu
`ZIRACP_PANEL_PORT`	7444	Kullanıcı paneli portu
`ZIRACP_HOSTNAME`	sistem	Panel host adı
`ADMIN_USER`	admin	İlk yönetici kullanıcı adı
`ADMIN_PASSWORD`	rastgele	İlk yönetici parolası
`INTERACTIVE`	yes	`no` ile tamamen otomatik kurulum

ADMIN_PASSWORD='Guclu-Parola-123' INTERACTIVE=no \
  bash -c "$(curl -fsSL https://get.ziracp.com)"

Kurulum idempotenttir: aynı komutu yeniden çalıştırmak mevcut kurulumu onarır veya günceller.

Kurulum bitince tarayıcıdan yönetici paneline gidin:

https://SUNUCU_IP:7443

Panel başta kendinden imzalı sertifika kullanır; tarayıcı uyarısını geçin. Host adınız bir domaine yönlendirildiğinde panel otomatik olarak Let's Encrypt sertifikası alır ve uyarı kalkar. Kurulumda gösterilen kullanıcı adı/parola ile giriş yapın ve ilk iş olarak iki adımlı doğrulamayı (2FA) açın.

Sistem gereksinimleri

OS: AlmaLinux 9 (veya RHEL 9 ailesi: Rocky, RHEL).
Mimari: x86_64 veya aarch64.
RAM: en az 2 GB (mail + AI için 4 GB+ önerilir).
Disk: en az 20 GB; /home için XFS önerilir (proje kotası).
Temiz sunucu — cPanel/Plesk/CyberPanel kurulu olmamalı.

Hesaplar & paketler

zCenter'da önce bir paket tanımlarsınız (disk, bant genişliği, site sayısı, PHP sürümleri, özellik listesi), sonra bu pakete bağlı hesaplar açarsınız. Her hesap; kendi Linux kullanıcısı, cgroup slice'ı, XFS kotası ve izole veritabanı/mail kimlikleriyle atomik olarak kurulur.

Paketi düzenlediğinizde değişiklik ona bağlı tüm hesaplara anında yansır. Hesap açıldığında birincil alan adı otomatik olarak ana web sitesi olarak provizyonlanır ve zPanel bilgileriyle giriş yapılabilen bir ana FTP hesabı oluşturulur.

Web siteleri & PHP

zPanel'de her web sitesi birincil nesnedir. Site oluşturduğunuzda nginx vhost'u ve hesabın slice'ında çalışan bir PHP-FPM havuzu kurulur. Site başına farklı PHP sürümü (8.1–8.5) seçebilir, php.ini değerlerini düzenleyebilir ve eklenti kurabilirsiniz.

SSL

Bir alan adı eklendiğinde ZiraSSL otomatik olarak Let's Encrypt üzerinden ücretsiz sertifika alır (HTTP-01, wildcard için DNS-01). Sertifikalar süresi dolmadan otomatik yenilenir. Tek birleşik SSL sayfasından tüm sertifikaların durumunu görebilirsiniz.

DNS

ZiraCP, PowerDNS ile kendi otoriter DNS sunucunuzu çalıştırır. Bölge editöründen A/AAAA/CNAME/MX/TXT/SRV/CAA kayıtlarını yönetebilir ve tek tıkla DNSSEC etkinleştirebilirsiniz. Hesap veya site açıldığında bölge otomatik oluşturulur, mail kayıtları (SPF/DKIM/DMARC) otomatik yayımlanır.

Kendi ad sunucularınızı kullanmak için alan adı kaydında ns1/ns2 glue kayıtlarını sunucunuzun IP'sine yönlendirin.

Veritabanları

Hesap-izole MySQL/MariaDB veritabanları ve kullanıcıları oluşturun; her kullanıcı yalnızca kendi veritabanlarına yetkilidir. phpMyAdmin tek oturumla (SSO) açılır — zCenter'da tüm veritabanları, zPanel'de yalnızca hesabın kendi veritabanları.

E-posta

Postfix + Dovecot + Rspamd tam mail yığını. Alan adı için mail'i etkinleştirdiğinizde SPF, DKIM ve DMARC kayıtları otomatik kurulur. E-posta hesapları, yönlendiriciler, otomatik yanıtlar ve Sieve filtreleri panelden yönetilir. Teslimat sayfası SPF/DKIM/DMARC/PTR durumunu canlı doğrular ve tek tıkla onarır.

Yedekler

Zamanlanmış (günlük/haftalık) tam veya artımlı yedekler; yerel, SFTP ve S3 hedefleri. Kullanıcılar zPanel'den dosya, veritabanı veya mail'i granüler geri yükleyebilir; yöneticiler zCenter'dan tek tıkla tüm hesabı geri yükleyebilir.

Güvenlik

Firewall: firewalld (nftables) UI, port ve ülke kuralları.
fail2ban + kaba-kuvvet servisi: panel, SSH, FTP, Dovecot, Postfix olaylarını izler, kademeli ban uygular; whitelist ve çözülebilir ban listesi.
2FA: iki panelde TOTP; kurtarma kodları; 2FA değişimi yeniden kimlik doğrulaması ister.
WAF: site başına ModSecurity v3 + OWASP CRS.
Denetim: HMAC-SHA256 hash-zincirli, değiştirilemez audit log.

Yapay zekâ

Panelin AI asistanı, her eylemi UI tıklamasıyla aynı yetki/denetim yolundan geçirir. Üç statik güvenlik katmanı vardır: salt-okunur işlemler otomatik; değiştiren işlemler önizleme + tek tık onay; yıkıcı işlemler yazılı onay + otomatik ön-yedek. Okuyucu/yapıcı ayrımıyla prompt injection'a karşı korunur. Anthropic Claude, OpenAI uyumlu sağlayıcılar ve yerel Ollama (yalnızca danışma) desteklenir; API anahtarını yöneticiler panelden girer.

Güncelleme

Panelden Güncelle düğmesi bağımsız bir güncelleyici başlatır: otomatik anlık yedek (binary + veritabanı + config) → indir + SHA256 doğrula → atomik değişim (hatada otomatik geri dönüş) → servis yeniden başlat → sağlık kontrolü. Kararlı/beta kanalları ve istenen sürüme dönüş desteklenir.

Lisans

Kurulumda 15 günlük, kartsız deneme otomatik başlar. Lisans anahtarı, panelin çevrimdışı doğruladığı Ed25519 imzalı bir token'dır — lisans sunucusu erişilemez olsa bile paneliniz ve siteleriniz çalışmaya devam eder. Süresi dolarsa panel yalnızca salt-okunur moda geçer; barındırılan siteler asla durmaz. Ayrıntı ve doğrulama için license.ziracp.com.

zira CLI

Her panel eylemi aynı zamanda zira komut satırı aracından da yapılabilir — otomasyon ve acil durum erişimi için birinci sınıf bir araç.

zira user-info          # panel adresleri ve yönetici bilgisi
zira site add example.com --account musteri1
zira service status

Kaldırma

Kurulumda bir kaldırıcı da oluşturulur:

ziracp-uninstall.sh           # paneli kaldırır, veriyi korur
ziracp-uninstall.sh --purge   # her şeyi siler

Sık sorulan sorular

Mevcut sunucuma kurabilir miyim?

ZiraCP temiz bir AlmaLinux 9 sunucusu bekler. Başka bir panel kuruluysa (cPanel/Plesk) önce onu kaldırmanız gerekir.

Lisansım biterse siteler kapanır mı?

Hayır. Yalnızca panel salt-okunur moda geçer; barındırılan tüm siteler, e-posta ve DNS çalışmaya devam eder.

cPanel'den taşıma var mı?

cPanel yedeği (cpmove) içe aktarma, parola hash'leri korunarak sonraki fazda gelmektedir.

Terminale gerçekten hiç gerek yok mu?

Günlük yönetimin tamamı panelden yapılır. zira CLI isteğe bağlı bir otomasyon/acil durum aracıdır.

Daha fazla yardım mı gerekli? ziracp.com · API referansı