trkod.tr — Türkçe Kılavuzlar

TRKOD Sunucu Paneli Kurulum ve İşletim Kılavuzu

Bu sayfayı ekleyen: #Netler

Bu kılavuz, Ubuntu 22.04 LTS ve Pardus 25.2 sunucuya TRKOD Sunucu Paneli'ni kurmayı, site açmayı, mail sistemini yapılandırmayı ve olası sorunları çözmeyi anlatır.

Canlı sunucuya kurulum yapmadan önce dosyaları bir test sunucusunda deneyin. Kurulum betiği; sistem paketlerini kurar, systemd servisi oluşturur ve güvenlik duvarına (UFW) kural ekleyebilir. Bu nedenle yalnızca yetkili olduğunuz sunucularda çalıştırın.


TRKOD Sunucu Paneli Görüntüsü

Hızlı Başlangıç: Tek Komutla Kurulum (Önerilen)

İlk başta sunucumuzu güncelleyelim.

Bash
sudo apt update && sudo apt upgrade -y

Sunucumuz güncellendikten sonra reboot yazıp enter diyerek sunucumuzu yeniden başlatalım.

TRKOD Sunucu Paneli'ni sunucunuza doğrudan indirip kurmak için aşağıdaki komutu terminalde çalıştırmanız yeterlidir. Betik, arşivi /root dizinine indirip açar ve kurulumu başlatır:

Bash
cd /root && (curl -fsSL -O https://trkod.tr/trkodpanel1.0.0.tar.gz || wget -q https://trkod.tr/trkodpanel1.0.0.tar.gz) && tar -xzf trkodpanel1.0.0.tar.gz -C /root/ && chmod +x /root/trkod-panel/install/install.sh && bash /root/trkod-panel/install/install.sh

1. Gereksinimler

Sunucu erişim bilgileri bu depoda tutulmuyorsa, size verilen ayrı erişim dosyasındaki adres ve kimlik bilgilerini kullanın. Parolaları komut geçmişine veya dosyalara düz metin olarak yazmayın.

2. Dosyaları Sunucuya Alma

Kurulum dosyalarını sunucuya iki farklı yöntemle temin edebilirsiniz:

Yöntem A — Doğrudan Arşiv İndirme (Hızlı)

Sunucu terminalinde:

Bash
cd /root
wget -q --show-progress https://trkod.tr/trkodpanel1.0.0.tar.gz
tar -xzf trkodpanel1.0.0.tar.gz -C /root/
cd /root/trkod-panel

Yöntem B — Yerel Makineden Gönderme (SCP / SFTP)

Yerel makinenizde proje kökünde:

Bash
scp -r panel install README.md KURULUM.md docs root@SUNUCU_IP:/root/trkod-panel/

Sunucuda:

Bash
ssh root@SUNUCU_IP
cd /root/trkod-panel
ls
# panel   install   README.md   KURULUM.md   docs

Not: install betikleri LF satır sonuyla saklanmalıdır. Windows üzerinde düzenleme yaptıysanız satır sonlarını dönüştürün:

Bash
> sudo apt-get install -y dos2unix
> dos2unix install/*.sh
>

3. Panel Kurulumu

Etkileşimli Kurulum

Bash
sudo bash install/install.sh

Betik sırasıyla şunları sorar:

  1. Yönetici kullanıcı adı (varsayılan: admin)
  2. Panel portu (varsayılan: 8090)
  3. Dinlenecek adres (varsayılan: 0.0.0.0)
  4. Yönetici e-posta adresi (opsiyonel)
  5. IP/CIDR kısıtlaması (boş = tüm IP'ler)
  6. Self-signed HTTPS isteği (varsayılan: hayır)
  7. Yönetici parolası (en az 8 karakter)

Etkileşimsiz Kurulum (Otomasyon)

Bash
sudo bash install/install.sh --yes \
  --user admin \
  --port 8090 \
  --bind 0.0.0.0 \
  --email [email protected] \
  --allow-ips "203.0.113.10,10.0.0.0/8"

Parola girilmezse güçlü bir parola otomatik üretilir ve yalnızca bir kez ekrana yazdırılır. Hemen güvenli bir parola yöneticisine kaydedin.

Kurulum Seçenekleri

SeçenekAçıklama
--user ADYönetici kullanıcı adı (3–32 karakter)
--password PAROLAYönetici parolası; verilmezse sorulur veya üretilir
--port PORTPanel portu (varsayılan: 8090)
--bind ADRESDinlenecek IP adresi (varsayılan: 0.0.0.0)
--allow-ips LISTEVirgül/boşlukla ayrılmış IP veya CIDR erişim listesi
--email ADRESYönetici e-posta adresi
--tls / --no-tlsSelf-signed HTTPS aç/kapat
--tls-cn ADSertifika CN değeri (varsayılan sunucu FQDN'i)
--yesSoru sormadan onaylayarak kur
--skip-aptapt-get güncelleme adımını atla
--forceUbuntu 22.04 dışında bir dağıtımda zorla devam et

Kurulum Neler Yapar?

  1. Ubuntu 22.04 ve Python sürümünü kontrol eder.
  2. Portun boşta ve kullanılabilir olduğunu doğrular.
  3. Gerekirse openssl ve curl paketlerini kurar.
  4. Paneli /opt/serverpanel altına kopyalar (services/*.json dahil).
  5. /etc/serverpanel, /var/lib/serverpanel, /var/log/serverpanel dizinlerini açar.
  6. Boş /etc/serverpanel/ports.json dosyasını ve /etc/logrotate.d/serverpanel kuralını yazar.
  7. Parolayı PBKDF2-SHA256 ile özetleyip panel.json dosyasına işler (chmod 0600).
  8. İstenirse self-signed TLS sertifikası üretir.
  9. serverpanel.service systemd servisini kaydeder, etkinleştirir ve başlatır.
  10. /api/health üzerinden sağlık kontrolü yapar.
  11. UFW güvenlik duvarı etkinse panel portuna izin kuralı ekler.

Kurulum tamamlandığında panel erişim adresi, kullanıcı adı ve parola ekranda listelenir.

Kurulumu Doğrulama

Bash
systemctl status serverpanel --no-pager
curl -s http://127.0.0.1:8090/api/health
journalctl -u serverpanel -n 50 --no-pager

Beklenen sağlık yanıtı:

JSON
{"ok": true, "name": "TRKOD Sunucu Paneli", "version": "1.0.0", "port": 8090}

Tarayıcınızdan http://SUNUCU_IP:8090/ adresine giderek giriş yapabilirsiniz.

4. Kurulum Sonrası İlk Adımlar

4.1 Güvenlik Duvarı

SSH erişim portunun açık olduğundan emin olduktan sonra web ve panel portlarını açın:

Bash
ufw allow 22/tcp
ufw allow 8090/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw enable
ufw status verbose

Mail sunucusu kullanılacaksa ilgili portlar da açılmalıdır:

Bash
ufw allow 25/tcp
ufw allow 465/tcp
ufw allow 587/tcp
ufw allow 110/tcp
ufw allow 143/tcp
ufw allow 993/tcp
ufw allow 995/tcp

ufw enable komutunu çalıştırmadan önce SSH portunun (22) açık olduğunu doğrulayın; aksi halde sunucu bağlantınız kopabilir.

Tek seferlik port açma işlemleri için Ağ & Portlar → Elle port kuralları menüsü kullanılabilir. Kayıtlar /etc/serverpanel/ports.json içerisine yazılır. UFW aktifse kurallar anında uygulanır; kapalıysa kural listeye alınır ve UFW açıldığında Senkronize et ile devreye girer.

4.2 Paneli HTTPS'e Taşıma (Önerilir)

Ayarlar → TLS sertifikası bölümünden:

Kaydedildiğinde TRKOD Sunucu Paneli yeniden başlar ve güvenli bağlantıya yönlendirilir.

4.3 Yönetici Parolasını Değiştirme

Ayarlar → Yönetici parolası sekmesinden mevcut parolanızı doğrulayarak yeni şifrenizi tanımlayın.

5. Uygulamaların Kurulumu

Uygulamalar sekmesinden sunucu ihtiyaçlarınıza göre paketleri kurabilirsiniz:

  1. Nginx
  2. MySQL
  3. PHP 8.1 FPM (veya projenizin ihtiyaç duyduğu sürüm)
  4. Opsiyonel: phpMyAdmin, Certbot (Let's Encrypt), UFW, Fail2ban, Redis, Composer
  5. Mail altyapısı için: Postfix, Dovecot, OpenDKIM

Kurulumlar arka plan kuyruğunda sıralı çalışır. Sekmeyi kapatsanız dahi işlemler sürer; İşlemler sekmesinden canlı logları izleyebilirsiniz.

PHP sürümleri sabit TCP portlarını kullanır:

SürümPaylaşımlı Havuz
PHP 8.19001
PHP 8.29002
PHP 8.39003
PHP 8.49004

Her site için bağımsız PHP-FPM havuzu tahsis edilir: 9100 + site no (Örnek: 1 numaralı site 127.0.0.1:9101). Bu havuz sitenin kendi sistem kullanıcısı ile çalışır ve open_basedir sınırı site kök diziniyle sınırlandırılır.

5.1 phpMyAdmin

Uygulamalar → phpMyAdmin → Kur tıklandığında:

6. Web Stack Seçimi

Web Stack sekmesinden ihtiyacınız olan mimariyi seçip Stack'i uygula butonuna tıklayın:

Senaryo A — Nginx (Önerilen)

PHP-FPM ile doğrudan konuşan en performanslı ve kaynak tasarruflu modeldir.

Senaryo B — Nginx + Apache

.htaccess gereksinimi olan CMS ve PHP uygulamaları için uygundur. Nginx ters vekil (reverse proxy) görevi üstlenir, gerçek IP X-Forwarded-For ile aktarılır.

Senaryo C — Nginx + OpenLiteSpeed

OpenLiteSpeed vhost'ları docRoot, vhDomain/vhAliases ve context / { location $DOC_ROOT/ } kurallarıyla yapılandırılır. Dosyalar 404 vermeden servis edilir.

Senaryo D — Varnish + Nginx

Trafik önce Varnish önbelleğinden geçer, dinamik istekler ve oturumlu çerezler Nginx'e yönlendirilir. Yoğun trafikli siteler için idealdir.

Stack uygulama sırasında yapılandırmalar test edilir; hata durumunda otomatik geri alma devreye girer. Kullanılmayan servisler durdurulur ve port çakışmaları engellenir.

7. Site Oluşturma

Siteler → Yeni site:

AlanAçıklama
Alan adıApex domain (ör. ornek.com); www otomatik tanımlanır
Ek alan adlarıVirgül veya boşlukla ayrılmış diğer alias domainler
Panel sahibiSiteyi yönetecek kiracı kullanıcı (kotalar bu hesaptan düşer)
PHP sürümüStatik HTML veya sistemde kurulu PHP sürümleri
SSLYok / Let's Encrypt / Self-signed
Yönetici e-postaLet's Encrypt yenileme bildirimleri için
MySQL veritabanıOtomatik rastgele veritabanı adı, kullanıcı ve güçlü parola
NotlarProje detayları / açıklamalar

Site açıldığında:

DNS Yapılandırması

Sitenin yayına girmesi için alan adınızın DNS kayıtlarını sunucuya yönlendirin:

ornek.com.     A   SUNUCU_IP
www.ornek.com. A   SUNUCU_IP

DNS oturmasının ardından Let's Encrypt üzerinden ücretsiz SSL sertifikasını aktif edebilirsiniz.

Dosya Yükleme

Dosyalarınızı SFTP/SSH ile sitenin public dizinine aktarın:

Bash
scp -r ./site-dosyalari/* root@SUNUCU_IP:/var/www/skart/public/
chown -R skart:skart /var/www/skart/public

Not: TRKOD Sunucu Paneli, güvenlik açıklarını en aza indirmek ve saldırı yüzeyini daraltmak adına dahili bir web dosya yöneticisi (File Manager) barındırmaz.

7.1 Kullanıcılar, Paketler ve Kotalar

Çok kiracılı (multi-tenant) kullanım için önce Paketler sayfasından bir şablon oluşturun:

LimitAçıklama
SiteAçılabilecek maksimum site adedi
VeritabanıMaksimum MySQL veritabanı adedi
Mail alanıİzin verilen mail alan adı sayısı
Posta kutusuToplam e-posta hesabı sınırı
Aylık trafik (GB)Aylık bant genişliği kotası
Disk alanı (MB)Site dizinlerinin toplam disk sınırı

-1 değeri sınırsız kullanımı temsil eder. Kullanıcılar → Yeni kullanıcı adımından müşteri profilleri tanımlanabilir. Kiracı kullanıcılar sisteme girdiklerinde yalnızca kendilerine ait siteleri ve veritabanlarını yönetebilir; sunucu ayarları, stack ve port alanlarına erişemezler (403).

7.2 Veritabanları

Veritabanları menüsünden bağımsız MySQL veritabanları yönetilebilir:

7.3 Sunucu ve Servis Yönetimi

Sunucu sayfasından:

8. Mail Sunucusu

8.1 Kurulum

Mail Sunucusu sekmesinde:

  1. Mail sunucu adını girin (Örnek: mail.ornek.com).
  2. DKIM kutusunu işaretleyin.
  3. Mail sunucusunu kur butonuna basın.

Postfix, Dovecot (IMAP/POP3/LMTP) ve OpenDKIM yapılandırılarak SASL kimlik doğrulama ve 587/465 portları devreye alınır.

8.2 Alan Adı ve Posta Kutusu

  1. Alan adı ekle ile ornek.com tanımlayın.
  2. Posta kutusu sekmesinden [email protected] hesabını açın.

8.3 Zorunlu DNS Kayıtları

TürAdDeğerAçıklama
Amail.ornek.comSUNUCU_IPMail sunucu IP yönlendirmesi
MXornek.com10 mail.ornek.comGelen e-posta rotası
TXTornek.comv=spf1 mx ~allSPF doğrulama kaydı
TXTmail._domainkey.ornek.comv=DKIM1; k=rsa; p=...DKIM açık anahtar
TXT_dmarc.ornek.comv=DMARC1; p=none; rua=mailto:[email protected]DMARC politikası
PTRSUNUCU_IPmail.ornek.comHosting sağlayıcı panelinden Ters DNS

8.4 İstemci Bağlantı Bilgileri

9. Yedekleme ve Geri Yükleme

Yedek Alma

Bash
sudo mkdir -p /root/yedek

# Sistem dosyaları ve veritabanı kütüphanesini arşivle

sudo tar -czf /root/yedek/trkodpanel-$(date +%F).tar.gz \
  /etc/serverpanel /opt/serverpanel/services /var/lib/serverpanel \
  /var/www /var/mail/vhosts /etc/letsencrypt

# MySQL veritabanlarını yedekle

sudo mysqldump --all-databases --single-transaction --routines \
  | gzip > /root/yedek/mysql-$(date +%F).sql.gz

Geri Yükleme

Bash
sudo systemctl stop serverpanel
sudo tar -xzf /root/yedek/trkodpanel-YYYY-MM-DD.tar.gz -C /
gunzip -c /root/yedek/mysql-YYYY-MM-DD.sql.gz | sudo mysql
sudo systemctl start serverpanel

10. Güncelleme

Yeni sürüm dosyalarını sunucuya aktardıktan sonra güncellemek için:

Bash
sudo systemctl stop serverpanel
sudo tar -C panel --exclude='__pycache__' --exclude='*.pyc' -cf - . \
  | sudo tar -C /opt/serverpanel -xf -
sudo chown -R root:root /opt/serverpanel
sudo systemctl start serverpanel
sudo systemctl status serverpanel --no-pager

/etc/serverpanel/panel.json ayar dosyası ve /var/lib/serverpanel/panel.db veritabanı güncelleme sırasında korunur.

11. Sorun Giderme

Bash
  sudo systemctl stop serverpanel
  NEW_HASH=$(sudo python3 - <<'PY'
  import getpass, sys
  sys.path.insert(0, "/opt/serverpanel")
  from sp.auth import hash_password
  print(hash_password(getpass.getpass("Yeni parola: ")))
  PY
  )
  sudo python3 - "$NEW_HASH" <<'PY'
  import json, sys
  path = "/etc/serverpanel/panel.json"
  data = json.load(open(path))
  data["password_hash"] = sys.argv[1]
  json.dump(data, open(path, "w"), indent=2)
  PY
  sudo systemctl start serverpanel

12. Kaldırma (Uninstall)

Bash
sudo bash install/uninstall.sh

Kaldırma işlemi sitelerinize (/var/www), e-postalarınıza (/var/mail/vhosts) ve SSL sertifikalarınıza (/etc/letsencrypt) dokunmaz.

Bu kodlarda sıkıntı yaşarsanız lütfen yorumlarla bize ulaşın bizde size yardım edelim. iyi günler.

Yorumlar (0)

Henüz yorum yok. İlk yorumu siz yapın!

Yorum Yap

Yorum yapmak için giriş yapın veya kayıt olun.