İçeriğe geç
Lightning VM

Özellikler

Kurulum, güncelleme ve yedek

Tek komutla kurulum, otomatik HTTPS, panelden güncelleme, şifreli ve imzalı yedek, geri yüklemeden sonra bekleme ve isteğe bağlı izleme yığını.

Gereksinimler

En azÖnerilen
İşletim sistemiUbuntu 22.04 / 24.04 / 26.04 (amd64 ya da arm64)Ubuntu 24.04 LTS
Bellek / disk2 GB RAM, 10 GB boş disk4 GB RAM, 40 GB disk (izleme açıkken)
Ağ80 ve 443 portları dışarıya açıkA kaydı sunucuyu gösteren bir alan adı

Paneli sanallaştırma hostunun kendisine değil, ayrı bir Linux sunucuya kurun; bu sunucu sanal da olabilir.

Kurulum

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

Komut kaynağı /opt/lightning-vm dizinine git ile indirir, en yeni kararlı sürümü seçer ve kurulum betiğini çalıştırır. Kendi alan adınızla:

curl -fsSL https://lightningvm.app/install.sh | sudo sh -s -- -- --domain panel.example.com

Betik sistemi denetler, Docker yoksa resmî deposundan kurar, sırları üretir, servisleri derleyip başlatır, HTTPS sertifikasını alır, izlemeyi ve günlük yedeği ayarlar. Sonunda panel adresini ve ilk yönetici bilgilerini yazar. Alan adı vermezseniz ve sunucunun genel bir IPv4 adresi varsa panel <ip>.sslip.io adıyla açılır. Adım adım anlatımı: Tek komutla kurulum ne yapar.

Kurulum yarıda kalırsa aynı komutu yeniden çalıştırın; mevcut sırlar, veriler ve hesaplar korunur. Betik güvenlik duvarına, SSH ayarlarına ve mevcut Nginx / Caddy / Traefik kurulumuna dokunmaz.

Güncelleme

Panelden: Yönetim → Sistem → Güncellemeler. Komut satırından:

sudo sh scripts/install.sh update

Her güncelleme önce şifreli bir yedek alır; yedek alınamazsa hiçbir şey değişmez. Yeni sürüm hazır olmazsa container'lar önceki sürüme geri alınır. Veritabanı otomatik geri alınmaz; yedek oradadır. Sürüm vermeden çalışan güncelleme yalnızca daha yeni bir sürüme geçer. Açıkça bir sürüm verdiğinizde (update --to v1.2.0) eski bir sürüme dönüşü yalnızca migration denetimi durdurur.

Otomatik güncelleme açılıp kapatılabilir; kanal (stable, beta, edge) ve bakım penceresi seçilir. Yükseltmeden önce depodaki upgrade-notes.md sayfasını okuyun.

Yedek

sudo sh scripts/install.sh backup

Yedek PostgreSQL'in tamamını, .env dosyasını, ana anahtarı, sertifikaları ve Alertmanager ayarını içerir. secrets/backup.key ile şifrelenir (AES-256-CBC) ve aynı anahtarla imzalanır (HMAC-SHA256): her yedek AD.tar.enc ile yanındaki AD.tar.enc.hmac dosyasından oluşur. Yedek yazıldıktan sonra geri okunarak doğrulanır.

Ayar (.env)VarsayılanAnlamı
BACKUP_KEEP7Yerelde tutulan en yeni yedek sayısı
BACKUP_COPY_TOboşrsync hedefi; yedekle birlikte imza dosyası da kopyalanır
BACKUP_SCHEDULEdailyZamanlayıcı açıkken günlük yedek

Bu yedek müşteri VM'lerini içermez.

Geri yükleme ve bekleme

sudo sh scripts/install.sh restore backups/DOSYA.tar.enc --yes-replace-data

Onay seçeneği olmadan komut yalnızca denetler ve neyin değişeceğini söyler. Geri yükleme imza dosyasını yedeğin yanında, yedeği özgün adıyla ve aynı backup.key ile ister. Eski sürümlerin imzasız yedekleri yalnızca --allow-unsigned ile geri yüklenir.

Geri yüklemeden sonra herkesin oturumu kapanır ve panel beklemede açılır: serbest bırakılana kadar işlem başlatılmaz, zamanlamalar ve zamanlanmış silmeler çalışmaz, tahsilat çalışmaz. Bekleme Yönetim → Sistem'deki şeritten ya da şu komutla kaldırılır:

docker compose exec api node dist/cli.js release-restore-hold

Neden böyle olduğunu Güncelleme, yedek ve geri yükleme yazısında anlattık.

İzleme

İsteğe bağlı olarak Prometheus, Grafana, Loki ve Alertmanager kurulur. Kurulumda açılır (betik, RAM 3,8 GB ve üstündeyse kendisi açar); sonradan yalnızca komut satırından açılıp kapatılır:

sudo sh scripts/install.sh monitoring on

Bu bileşenlerin hiçbiri internete açılmaz; uzaktan erişim için SSH tüneli kullanılır.

Diğer komutlar

  • sh scripts/install.sh check: hiçbir şeyi değiştirmeden ön kontrolleri çalıştırır.
  • sudo sh scripts/install.sh reset-password eposta@ornek.com: parolasını unutan yönetici için.
  • sudo sh scripts/install.sh domain panel.example.com: alan adını sonradan ekler ya da değiştirir.
  • sudo sh scripts/install.sh behind-proxy --public-url https://panel.example.com: mevcut bir proxy arkasında çalıştırır.
  • sudo sh scripts/install.sh uninstall: servisleri kaldırır; .env, secrets/, backups/ ve veriler kalır.

Sınırlar

  • Sürümlü, imzalı kurulum paketi henüz yoktur; kurulum ve güncelleme kaynak koddan derler.
  • Birden çok sunucuda (küme) çalışma bir tasarımdır, yazılmadı.
  • İzleme kurulumdan sonra panelden açılıp kapatılamaz.
  • Kurulum betiğinin yedek, güncelleme, alan adı ve kaldırma yolları güvenlik incelemesinde satır satır yeniden okunmadı; betiğin yolları yalnızca sahte dosyalarla denendi.

Kaynak: docs/setup.md, docs/operations.md, docs/updates.md, docs/domain-https.md.

Kurulum komutu

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

Ubuntu 22.04 / 24.04 / 26.04. Gereksinimler ve seçenekler