Ö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ı.
Bu sayfada
Gereksinimler
| En az | Önerilen | |
|---|---|---|
| İşletim sistemi | Ubuntu 22.04 / 24.04 / 26.04 (amd64 ya da arm64) | Ubuntu 24.04 LTS |
| Bellek / disk | 2 GB RAM, 10 GB boş disk | 4 GB RAM, 40 GB disk (izleme açıkken) |
| Ağ | 80 ve 443 portları dışarıya açık | A 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 shKomut 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.comBetik 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 updateHer 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 backupYedek 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ılan | Anlamı |
|---|---|---|
BACKUP_KEEP | 7 | Yerelde tutulan en yeni yedek sayısı |
BACKUP_COPY_TO | boş | rsync hedefi; yedekle birlikte imza dosyası da kopyalanır |
BACKUP_SCHEDULE | daily | Zamanlayı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-dataOnay 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-holdNeden 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 onBu 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 shUbuntu 22.04 / 24.04 / 26.04. Gereksinimler ve seçenekler