Jellyfin 12.0 sürüm numaralandırmasını sıfırlıyor, .NET 10'a geçiyor ve tek yönlü bir zorunlu geçiş getiriyor

Sıfırlanan sürüm numarasının altında gerçek değişimler var

Jellyfin 12.0, 8 Eylül 2026'da yayınlandı ve açık kaynak medya sunucusunun 10.x sürüm numaralandırmasından nihayet koptuğu sürüm bu. dev.to'da yayımlanan bir rehbere göre sürüm, proje ne kadar şeyin değiştiğini göstermek için ana sürüm numarasını sıfırlamadan önce 10.12.0 olarak planlanmıştı; sunucular artık 12.0.0 olarak raporlanıyor ve 10.11.x hattı eski düzeni taşıyan son dal olarak kalıyor.

Yeniden adlandırma gerçek bir iç dönüşü yansıtıyor. Yükseltme gereksinimlerini resmi Jellyfin 12.0 duyurusuna karşı doğruladığını ve GitHub sürüm notlarıyla çapraz kontrol ettiğini söyleyen dev.to yazarı, runtime'ın .NET 9'dan .NET 10'a geçtiğini, paketle gelen FFmpeg'in ise 7.1.4'ten 8.1'e sıçradığını bildiriyor. Bu ikili, yükseltmenin neden rutin bir yerinde değişim olmadığının merkezinde yer alıyor.

Geçiş yalnızca ileri doğru çalışıyor

12.0'ın belirleyici kısıtı tek yönlü bir veritabanı geçişi. Veritabanı bir kez dönüştürüldü mü geri dönüştürülemez; çalışan önceki bir duruma giden tek yol, yükseltmeden önce alınmış bir yedekten yapılandırma dizinini geri yüklemek. dev.to rehberi tüm prosedürünü bu gerçeğin etrafında kurguluyor: servisi durdurun, hem veri hem yapılandırma dizinlerinin tam bir manuel yedeğini alın ve ancak sonra yeni sürümü kurun.

Başlangıç noktası da önemli. Yalnızca 10.10.7 veya herhangi bir 10.11.x sürümü doğrudan geçiş yapabilir. Daha eski her şey önce desteklenen bir 10.x yapıma adım adım çıkarılmalı; bu da bazı yöneticilerin iki aşamalı bir yükseltmeyle karşı karşıya kalacağı anlamına geliyor.

Yeni imajı çekmeden önce halletmeniz gerekenler

dev.to kontrol listesi bilinçli bir sırayla ilerliyor. Kullanıcı adları 12.0'da büyük/küçük harfe duyarsız hale geliyor, bu nedenden yalnızca büyük harf kullanımıyla ayrışan iki hesap, biri yeniden adlandırılana kadar geçişi bloke ediyor. Üçüncü taraf eklentiler güncellemeden önce kaldırılmalı, çünkü yeni sürüm için derlenmiş yapılara ihtiyaç duyuyorlar ve güncellemenin kendisini de aksatabiliyorlar. Yöneticiler ayrıca yükseltmeden sonraki ilk tam kütüphane taraması için plan yapmalı; rehbere göre bu tarama, otomatik çözülen alternatif sürümler taşınma sırasında temizlendiğinden normalden belirgin biçimde uzun sürüyor — bazı filmler hatta yeni eklenmiş olarak işaretlenebiliyor bile.

Docker Compose kurulumlarında sıra şöyle: durdurun, yapılandırma dizinini bir tarball olarak yedekleyin, imaj etiketini 12.0'a yöneltin, geçişi isteğe bağlı olarak --mode MigrateSystem bayrağıyla izole biçimde çalıştırın, sonra container'ı başlatın ve yönetim panelinden tam bir kütüphane taraması tetikleyin. Debian, Ubuntu, Snap ve Windows üzerindeki yerel kurulumlar da servisi durdurma, yapılandırmayı yedekleme, kurma ve yeniden tarama aynı mantığını izliyor. Bir dağıtım uyarısı: Debian Bullseye ve Ubuntu Focal için artık paket derlenmiyor, bu sistemlerdeki kullanıcıların 12.0'ı hiç kurabilmesi için önce desteklenen bir sürüme geçmeleri gerekiyor.

Gelenler ve kaybolanlar

Özellik tarafında kitap ve çizgi roman desteği artık eklenti gerektirmeden sunucuya gömülü geliyor. Oynatma listeleri ilişkisel hale geliyor ve her girdi düz bir liste yerine kendi veritabanı satırı olarak saklanıyor. Modern UI varsayılan arayüz olarak yükseltilirken eski düzen Legacy etiketi altında yaşamaya devam ediyor. ListenBrainz müzik benzerliği ve öneriler için paketle geliyor, eklentiler yeni arama sağlayıcıları üzerinden arama sonuçlarını genişletme yeteneği kazanıyor, altyazı ayarları global yapılandırmadan kütüphane başına yapılandırmaya geçiyor ve alternatif sürümler artık yalnızca filmler için değil bölümler için de destekleniyor.

Kaldırılanlar en az bunlar kadar önemli. Eski /emby/ ve /mediabrowser/ rotaları gitti, bu nedenden hâlâ bu yollara bağlanan her istemci çalışmayı bırakıyor. Eski yetkilendirme varsayılan olarak devre dışı, eklentiler .NET 10 için yeniden derlenmek zorunda, görsel uç noktaları artık kaynak dosyanın çözünürlüğünün ötesinde upsample yapmıyor ve .ogg dosyaları yalnızca ses olarak ele alınıyor.

Geri dönmek, sürüm düşürmek değil geri yüklemek demek

Geçiş geri alınamaz olduğu için rehberdeki geri dönüş prosedürü bir sürüm değişimi değil geri yükleme: yığını indirin, başarısız yapılandırma dizinini kenara taşıyin, yedek tarball'ı açın, imaj etiketini tekrar bir 10.11.x yapıma yöneltin (rehberin örneğinde 10.11.11) ve yeniden başlatın. O yedek olmadında, başarısız bir geçiş yöneticiyi geri yüklemek yerine yeniden inşa etmekle baş başa bırakıyor. Rehber ayrıca tam bu nedenle elinin altında çalışan bir geri dönüş imaj etiketi bulunduran Jacar.es'den bir Docker anlatımına işaret ediyor.

Neden önemli

Jellyfin, Plex'in kapalı modelinden uzaklaşan geniş bir topluluğun medya merkezi haline geldi ve dev.to rehberinin tahminine göre bu, o topluluğun şimdiye kadar karşılaştığı en kesintili bakım penceresi. Yükseltmenin en güçlü gerekçesi manşet özellikler değil güvenlik: .NET 10 ve FFmpeg 8.1 runtime'ları güvenlik yamaları getiriyor ve rehber bunu projenin bu adımı önermesinin gerçek nedeni olarak gösteriyor. Risk neredeyse tamamen tek yönlü geçişte ve tek bir disipline indirgeniyor — sunucuyu durdur, yapılandırmayı yedekle, sonra yükselt. Daha eski istemciler veya daha eski dağıtımlar çalıştıran yöneticilerin işe başlamadan önce ek ödevleri var, ama güncel bir 10.11.x tabandaki herkes için doğru sırayla yapılan iş kısa sürüyor.