İçeriğe geç
Lightning VM

Yazılar

Tek komutla kurulum ne yapar, sunucuya ne koyar

Kurulum komutunun indirdiği betik, betiğin sırayla yaptıkları, dokunmadıkları ve kurulumdan sonra sunucuda nelerin durduğu.

Yaklaşık 3 dakikalık okuma

Bir sunucuya curl … | sudo sh ile bir şey kurmadan önce o komutun ne yaptığını bilmek istersiniz. Bu yazı Lightning VM'in kurulum komutunu baştan sona anlatıyor.

Komut

curl -fsSL https://lightningvm.app/install.sh | sudo sh

Bu adresteki dosya, panelin deposundaki scripts/get.sh betiğinin kopyasıdır; yaklaşık 120 satırlık bir POSIX sh betiğidir ve çalıştırmadan önce okuyabilirsiniz:

curl -fsSL https://lightningvm.app/install.sh | less

Betik kısa bir iş yapar: root olarak çalıştığını denetler, git yoksa kurar, kaynağı /opt/lightning-vm dizinine indirir, en yeni kararlı sürüm etiketine geçer ve asıl kurulum betiğini (scripts/install.sh) çalıştırır. Yayımlanmış bir sürüm yoksa ana dalı kurar ve bunu uyarı olarak söyler.

Seçenekler boru işaretinden sonra verilir. İlk -- betiğin kendi seçeneklerini, ikinci -- kurulum betiğine gidecekleri başlatır:

curl -fsSL https://lightningvm.app/install.sh | sudo sh -s -- --version v1.2.0 -- --domain panel.example.com --lang tr
SeçenekNe yapar
--version v1.2.0Belirli bir sürümü kurar
--branch mainSürüm yerine bir dalı izler (test sunucuları)
--dir /srv/lightning-vmKaynağın duracağı dizin
--repo URLBaşka bir depo, örneğin kendi çatalınız
--token-file DOSYAÖzel bir depo için salt okunur erişim anahtarı

Depo herkese açıktır; erişim anahtarı yalnızca özel bir çataldan kuruyorsanız gerekir.

Kurulum betiği sırayla ne yapar

  1. İşletim sistemini ve kaynakları denetler. Ubuntu 22.04, 24.04 ya da 26.04 değilse, bellek 2 GB'ın ya da boş disk 10 GB'ın altındaysa durur. Ön kontrollerden biri başarısız olursa hiçbir dosya oluşturmadan çıkar.
  2. Docker yoksa Docker'ın resmî apt deposundan kurar.
  3. Sırları openssl rand ile üretir ve .env dosyasına 600 izinle yazar. Sırlar terminale yazdırılmaz.
  4. Servisleri kaynak koddan derler, başlatır ve hazır olmalarını bekler.
  5. Erişimi ayarlar. --domain verdiyseniz o ad, vermediyseniz ve sunucunun genel bir IPv4 adresi varsa <ip>.sslip.io kullanılır; iki durumda da Caddy bir Let's Encrypt sertifikası alır. Genel IP yoksa ya da --local verdiyseniz panel yalnızca 127.0.0.1:8080 adresinde açılır.
  6. Bellek 3,8 GB ya da üstündeyse izleme yığınını (Prometheus, Grafana, Loki) açar.
  7. İlk yöneticiyi rastgele bir parolayla oluşturur.
  8. Günlük yedek zamanlayıcısını kurar ve ilk yedeği alır.
  9. Panel adresini, yönetici e-postasını ve parolasını özetler.

İlk yönetici parolası bir kez gösterilir ve secrets/initial-admin.txt dosyasına da yazılır. İlk girişten sonra parolayı değiştirin ve dosyayı silin.

Sunucuda ne durur

  • /opt/lightning-vm: kaynak kodun git kopyası. Güncellemeler buradan yapılır.
  • .env: ayarlar ve sırlar.
  • secrets/: ana anahtar, yedek anahtarı (backup.key) ve ilk yönetici dosyası.
  • backups/: şifreli yedekler ve imza dosyaları.
  • data/: bakım istekleri, sonuçları ve kalıcı veriler.
  • Docker container'ları ve veri birimleri: web, API, worker, adaptör servisleri, konsol geçidi, PostgreSQL, Redis ve Caddy.
  • systemd birimleri: yedek ve otomatik güncelleme zamanlayıcısı ile panelin bakım isteklerini çalıştıran ajan.

Betiğin dokunmadıkları

Güvenlik duvarına, SSH ayarlarına, mevcut Nginx / Caddy / Traefik kurulumuna ve sistem paketlerine dokunmaz. Tek istisna Docker'dır.

Yarıda kalırsa

Aynı komutu yeniden çalıştırın. .env yalnızca bir kez oluşturulur; sonraki çalıştırmalar eksik anahtarları ekler, var olan sırları değiştirmez. Veritabanı ve yönetici hesabı korunur.

Aynı komutu kurulu bir sunucuda çalıştırırsanız yeniden kurulum yapmaz: kurulum tamamlanmışsa install.sh update çalışır, yani önce yedek alınır ve yeni sürüm hazır olmazsa öncekine dönülür.

Önce yalnızca denetlemek

Kaynağı elle indirdiyseniz hiçbir şeyi değiştirmeyen bir denetim vardır:

git clone https://github.com/syildirim689/lightning-vm.git
cd lightning-vm
sh scripts/install.sh check

Bilmeniz gerekenler

  • Kurulum paketi imzalı ve sürümlü imajlarla gelmez; kurulum ve güncelleme kaynak koddan derler. İlk kurulum bu yüzden sunucunun hızına bağlı olarak zaman alır.
  • Paneli HTTPS olmadan internete açmayın. Genel IP'si olmayan sunucuda SSH tüneli kullanın: ssh -L 8080:127.0.0.1:8080 KULLANICI@SUNUCU.
  • Let's Encrypt limitlerine takılmamak için önce --acme-staging ile test sertifikası deneyebilirsiniz.

Kaynak: docs/setup.md, docs/updates.md, scripts/get.sh.