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
Bu yazıda
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 shBu 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 | lessBetik 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çenek | Ne yapar |
|---|---|
--version v1.2.0 | Belirli bir sürümü kurar |
--branch main | Sürüm yerine bir dalı izler (test sunucuları) |
--dir /srv/lightning-vm | Kaynağın duracağı dizin |
--repo URL | Baş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
- İş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.
- Docker yoksa Docker'ın resmî apt deposundan kurar.
- Sırları
openssl randile üretir ve.envdosyasına 600 izinle yazar. Sırlar terminale yazdırılmaz. - Servisleri kaynak koddan derler, başlatır ve hazır olmalarını bekler.
- Erişimi ayarlar.
--domainverdiyseniz o ad, vermediyseniz ve sunucunun genel bir IPv4 adresi varsa<ip>.sslip.iokullanılır; iki durumda da Caddy bir Let's Encrypt sertifikası alır. Genel IP yoksa ya da--localverdiyseniz panel yalnızca127.0.0.1:8080adresinde açılır. - Bellek 3,8 GB ya da üstündeyse izleme yığınını (Prometheus, Grafana, Loki) açar.
- İlk yöneticiyi rastgele bir parolayla oluşturur.
- Günlük yedek zamanlayıcısını kurar ve ilk yedeği alır.
- 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 checkBilmeniz 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-stagingile test sertifikası deneyebilirsiniz.
Kaynak: docs/setup.md, docs/updates.md, scripts/get.sh.