Panel güncellemeleri

#Güncellemeler nereden yönetilir

Panel güncellemeleri Sunucu Yönetimi → Sistem → Güncellemeler ekranının bipanel sekmesindedir. Aynı ekrandaki İşletim sistemi sekmesi dağıtım paketlerini günceller; o konu otomatik güvenlik güncellemeleri sayfasında anlatılır.

Sekmenin üstünde kurulu sürüm, kanal, kurulu sürümün destek süresi, kurulum türü ve son denetim zamanı görünür. Panel yeni sürümleri 6 saatte bir kendiliğinden denetler; Şimdi denetle beklemeden sorar. Yeni bir sürüm varsa sürüm notlarıyla birlikte gösterilir; kurulu sürümle en yenisi arasındaki diğer sürümler Aradaki sürümler listesindedir ve en yeni sürüm hepsini içerir. Panelden kurulan her sürüm, başlatanı (Otomatik / Yönetici) ve sonucuyla Güncelleme geçmişi tablosuna yazılır. Tüm sürümlerin notları sürümler sayfasında da yayımlanır.

Sunucu kurulumunda aynı işlemler komut satırından da yapılabilir:

$ bipanel update status
$ bipanel update check
$ bipanel update apply

bipanel update apply yeni sürüm açılıp sonuç kaydedilene kadar (en fazla 30 dakika) bekler.

#Sürüm kanalları

Bir sunucu, seçtiği kanala ve ondan daha tutucu tüm kanallara yayınlanan sürümleri alır. Örneğin release kanalındaki bir sunucu stable ve lts sürümlerini de görür. Sürümler zamanla daha tutucu kanallara taşınır (release → stable → lts); ön sürümler (ör. 1.5.0-beta.1) yalnızca current ve edge kanallarına yayınlanır.

Destek süresi, sürümün o kanala girdiği tarihten sayılır; panel kurulu sürüm ve yeni sürüm için "En az … tarihine kadar desteklenir" bilgisini gösterir. Eski beta kanal adı current olarak kabul edilir.

#Kanalı değiştirmek

Kanalı Sürüm kanalı bölümünden seçip Kaydet deyin; panel yeni kanalı bir sonraki zamanlanmış denetimde, en geç 15 dakika içinde sorar. Kanal değiştirmek hiçbir zaman sürüm düşürmez: daha tutucu bir kanala geçtiğinizde kurulu sürüm yerinde kalır ve o kanal bu sürümün ötesine geçene kadar yeni güncelleme gösterilmez.

Kanal kurulum sırasında da seçilebilir. Kurulum komutuna BIPANEL_CHANNEL ortam değişkeni verilmezse stable kullanılır:

$ curl -fsSL https://bipanel.io/install.sh | sudo BIPANEL_CHANNEL=lts bash -s -- --hostname sunucu.ornek.com --email [email protected]

Konteyner kurulumunda aynı değişkeni konteynerin ortamına ekleyebilirsiniz. Kurulumda seçilen kanal, Güncellemeler ekranında bir kanal kaydedene kadar geçerlidir.

#Sürüm serisine sabitleme

Sürüm serisine sabitle anahtarını açıp Seri alanına 1.4 gibi bir değer girerseniz yalnızca o serideki (1.4.x) ve daha eski serilerdeki sürümler önerilir; 1.5.0 önerilmez. Yeni bir seriye geçmek için seriyi yükseltin ya da sabitlemeyi kaldırın. Kurulu sürümün serisinden eski bir seri seçilemez, çünkü sürüm düşürülmez.

Sabitleme, bir sürümün yalnızca belirli bir ara sürümden sonra kurulabildiği durumda da işe yarar. Bir sürüm için "en az şu sürümden yükseltilebilir" koşulu varsa ve kurulu sürümünüz daha eskiyse panel Önce … sürümüne geçilmeli uyarısı gösterir ve o sürümü kurmaz. Ara sürümün serisine sabitleyip onu kurun, ardından sabitlemeyi kaldırın.

#Otomatik güncelleme modları

Otomatik güncelleme bölümünde genel modu seçersiniz; varsayılan Yalnızca bildir'dir.

Ön sürümler yalnızca Tüm sürümleri kur modunda kendiliğinden kurulur. Diğer ayarlar:

• Kanala göre kural: Yeni sürüm hangi kanala yayınlandıysa o kanal için ayrı bir kural seçebilirsiniz (ör. stable sürümlerinde yama kur, current sürümlerinde yalnızca bildir). Kural seçilmeyen kanalda genel mod geçerlidir. Önerilen kuralları uygula yukarıdaki tablodaki önerileri doldurur.
• Bakım penceresi (sunucu saati): Otomatik kurulum yalnızca bu saatlerde yapılır; varsayılan 03:00–05:00. Başlangıç ve bitiş aynıysa günün her saati geçerlidir.
• Güncellemeden önce panel veritabanını yedekle: Varsayılan olarak açıktır. Geri alma sırasında bu yedek geri yüklenir; son 5 yedek saklanır.
• Otomatik kurulumu başarısız olan sürüm bir daha kendiliğinden denenmez; ekrandan elle kurabilirsiniz.

Otomatik kurulum sunucu kurulumunda ve RAILWAY_API_TOKEN tanımlı Railway kurulumlarında çalışır. Docker Compose kurulumunda güncellemeyi siz yaparsınız (bkz. konteyner imajı).

#Kritik güncellemeler

Güvenlik ya da kararlılık düzeltmesi içeren sürümler kritik olarak işaretlenebilir. Kritik bir sürüm çıktığında:

• Sunucu Yönetimi'nin her sayfasının üstünde kırmızı Kritik güncelleme: bipanel … uyarısı görünür; sürüm Kritik etiketiyle gösterilir ve güncelleme düğmesi kırmızıdır.
• Mod Kapalı olsa bile panel bildirim gönderir.
• Kurulum yine seçtiğiniz moda ve bakım penceresine göre yapılır; kritik işaret otomatik kurulumu zorlamaz. Yalnızca bildir modundaysanız kritik sürümü en kısa sürede elle kurun.

#Güncelleme nasıl uygulanır ve doğrulanır

#İmza doğrulaması

• bipanel Merkez her sürüm bildirimini (sürüm, kanal, paket özeti, indirme adresi) Ed25519 ile imzalar. bipanel Merkez'in açık anahtarını içinde taşır ve yalnızca bu anahtarla doğrulanan bildirimleri kabul eder; imzası tutmayan bildirim yok sayılır.
• İndirilen paketin boyutu, SHA-256 özeti ve bu özet üzerindeki Ed25519 imzası ayrı ayrı denetlenir. Biri tutmazsa güncelleme durur ve kurulu sürüm değişmez.
• Merkez adresi panelden değiştirilemez; yalnızca kurulumdaki BIPANEL_HUB_URL değişkeniyle belirlenir. Adres değişse bile imzasız ya da başka bir anahtarla imzalanmış paket kurulmaz.
• Pro kurulumları paketi lisanslarıyla, kısa ömürlü bir bağlantıdan ve lisansa özel işaretlenmiş olarak indirir. Çalışan Pro paketi elle değiştirilirse panel Panel paketi değişti bildirimi gösterir ve Pro güncellemeleri duraklatılır.

#Sunucu kurulumunda adımlar

… sürümüne güncelle düğmesi ya da otomatik kurulum şu adımları izler; ekranda her adımın durumu ve iş günlüğü görünür:

1. Paket indirilir ve doğrulanır.
2. Ayar açıksa panel veritabanı yedeklenir (/var/lib/bipanel/backups/panel-db/).
3. Kurulum betiği, panel servisinden bağımsız bir systemd birimi olarak başlar: paketi açar (Paket açılıyor), bağımlılıkları kurar (Bağımlılıklar kuruluyor), eski kurulumu /opt/bipanel.prev olarak saklayıp yenisini yerine koyar (Yeni sürüme geçiliyor) ve servisi yeniden başlatır (Panel yeniden başlatılıyor).
4. Sağlık denetimi: Panel 90 saniye içinde yeni sürüm numarasıyla yanıt vermelidir.

Siteler, e-posta ve veritabanları bu sırada kesintisiz çalışır; yalnızca panel 1–2 dakika yeniden başlar; ardından sayfayı yenileyin. Bağımlılıklar sunucuda npm ile kurulduğu için sunucunun npm paket deposuna erişebilmesi gerekir.

#Geri alma

Yeni sürüm sağlık denetimini geçemezse önceki kurulum geri konur, panel veritabanı güncelleme öncesi yedeğinden geri yüklenir ve eski sürüm yeniden başlatılır. Hatalı kurulum inceleme için /opt/bipanel.failed olarak saklanır; geçmişte Geri alındı görünür ve yöneticiye bildirim gider. 30 dakikada sonuçlanmayan bir güncelleme başarısız sayılır ve kurulu sürüm değişmez.

#update.sh ile komut satırından güncelleme

/opt/bipanel/deploy/native/update.sh, panel açılmadığında ya da panelden güncelleme yapılamadığında sunucu kurulumunu elle güncellemek içindir. Root olarak çalışır; panel veritabanını (/var/lib/bipanel) ve /etc/bipanel/bipanel.env dosyasını korur, yalnızca panel servisini yeniden başlatır ve panelin 60 saniye içinde yanıt vermesini bekler.

Kurulum betiğiyle kurulan sunucularda /opt/bipanel bir git deposu değildir; sürüm paketini açıp --source ile verin. Paketi indirme sayfasından alıp SHA-256 değerini aynı sayfadakiyle karşılaştırın:

$ sha256sum bipanel-X.Y.Z.tar.gz
$ mkdir -p /root/bipanel-yeni && tar -xzf bipanel-X.Y.Z.tar.gz -C /root/bipanel-yeni
$ sudo bash /opt/bipanel/deploy/native/update.sh --source /root/bipanel-yeni/bipanel

Panelden güncellemenin aksine update.sh imza doğrulaması ve otomatik geri alma yapmaz. Ayrıca kurulum, verdiğiniz paketin türüne geçer: indirme sayfasındaki paket Topluluk paketidir, bu yüzden Pro kurulumlarını panelden güncelleyin.

#Konteyner imajı güncellemeleri

Docker ve Railway kurulumlarında dosya sistemi imajdan gelir; panel paket indirmez, yeni sürüm yeni imajla gelir. Güncellemeler ekranı yine imzalı sürüm bildirimini denetler ve yeni sürümü gösterir. Veriler /data biriminde kalır.

• Railway, RAILWAY_API_TOKEN tanımlı: Güncelle düğmesi servisin imajını yeni sürümün imajına çevirip yeniden dağıtımı başlatır; sürüm için imaj yayımlanmamışsa bağlı deponun son commit'i dağıtılır. Otomatik güncelleme modları burada da çalışır. Dağıtım sırasında panel ve siteler kısa süre yeniden başlar.
• Railway, token yok: Railway panelinde servisi seçip Redeploy deyin ya da servisin imajını yeni sürümün imajına çevirin.
• Docker Compose, hazır imajla: docker-compose.yml içindeki imaj etiketini yeni sürüme çevirin, ardından yeni imajı çekip konteyneri yeniden oluşturun:

$ docker compose pull
$ docker compose up -d

• Docker Compose, sürüm paketinden derlenmiş kurulum (indirme sayfasındaki yol): yeni sürüm paketini ilk kurulumda paketi açtığınız dizinde açın (mevcut bipanel klasörünün üzerine yazılır) ve imajı yeniden derleyin. .env dosyanız ve /data birimi korunur:

$ curl -fsSL https://bipanel.io/api/v1/releases/X.Y.Z/download | tar xz
$ cd bipanel && docker compose up -d --build

Konteynerde işletim sistemi paketleri de imajla birlikte güncellenir. Kurulum ayrıntıları Docker ve Railway sayfasındadır; güncellemelerin güvenlik yönü güvenli güncelleme ve yapılandırma sayfasında anlatılır.