Jellyfin 12 upgrade and migration

Jellyfin 12 adalah rilis pertama dalam waktu yang lama yang akan menolak untuk dimuat di server yang pluginnya belum mengikuti perkembangan. Tim akhirnya membersihkan skema basis data, mengencangkan kontrak API plugin, dan menghentikan dukungan untuk beberapa alur auth kuno. Itu sehat untuk proyek. Itu juga kesempatan nyata untuk merusak server rumah Anda jika Anda upgrade di tempat tanpa rencana.

Kami melihat tujuh alat desktop yang membuat upgrade aman: cadangan yang benar-benar dipulihkan, audit plugin sebelum Anda menarik citra baru, jalur rollback jika migrasi gagal, dan lintasan sanity metadata setelah itu. Enam dari tujuh gratis dan open-source. Semuanya berjalan di Windows, macOS, dan Linux (atau dalam wadah yang melakukannya).

Yang harus diperhatikan

Perbandingan cepat

Aplikasi Terbaik untuk Platform Paket gratis Harga Lisensi
Jellyfin Server itu sendiri Windows, macOS, Linux, Docker Ya Gratis GPL
Jellyfin Backup Plugin Backup config + database dalam aplikasi Host Jellyfin apa pun Ya Gratis GPL
Kopia Backup server terenkripsi penuh Windows, macOS, Linux Ya Gratis Apache 2.0
Portainer Rollback kontainer dan image pinning Windows, macOS, Linux Ya Gratis (Community) zlib
Watchtower Update Docker yang terkontrol Linux, Docker Ya Gratis Apache 2.0
Diun Notifikasi sebelum menarik image baru Linux, Docker Ya Gratis MIT
TinyMediaManager Pembersihan metadata pra- atau pasca-upgrade Windows, macOS, Linux Ya Gratis / ~$50/tahun Apache 2.0

1. Jellyfin — Server itu sendiri, di-upgrade sesuai kondisi Anda

Jellyfin adalah server media. Untuk upgrade versi 12, saran jujur adalah: jangan ambil auto-update. Kunci tag 10.x di Docker, hentikan kontainer, jalankan langkah backup di bawah, dan tarik tag baru secara manual ketika Anda siap duduk di depan server selama satu jam.

Di mana ini kurang: Kebiasaan auto-update beberapa jalur installer (layanan Windows asli, beberapa paket distro) membuat pinning lebih sulit dari yang seharusnya.

Harga:

Platform: Windows, macOS, Linux, Docker, ARM.

Unduh: jellyfin.org.

Garis bawah: Kunci tag, ambil backup, upgrade dengan sengaja.

2. Jellyfin Backup Plugin — Backup config + database terbaik dalam aplikasi

Jellyfin Backup Plugin adalah plugin first-party resmi yang mengemas direktori config, database metadata, dan database pengguna ke dalam satu zip pada jadwal. Restore adalah sekali klik. Untuk lompatan versi 12, jalankan backup manual dengan server berhenti sehingga tidak ada yang menulis di tengah, kemudian pertahankan backup terjadwal berjalan di versi baru.

Di mana ini kurang: Tidak melakukan backup perpustakaan media itu sendiri, hanya metadata di sekitarnya. Penyimpanan bersifat lokal kecuali Anda menunjuknya ke bagian.

Harga:

Platform: Host apa pun yang menjalankan Jellyfin.

Unduh: Instal dari katalog plugin Jellyfin di dalam Dashboard.

Garis bawah: Hal pertama untuk diinstal. Yang membuat rollback menjadi sepele jika upgrade menjadi tidak benar.

3. Kopia — Backup server terenkripsi penuh terbaik

Kopia adalah alat backup yang menangani lapisan yang tidak dapat dijangkau plugin Jellyfin: folder config penuh, cache artwork, transcoding tmp, dan file compose. Ini menghilangkan duplikasi, mengenkripsi, dan mendorong ke S3, B2, NAS, atau disk lain. Snapshot bersifat inkremental dan dapat dipasang untuk dipulihkan.

Di mana ini kurang: Kurva pembelajaran untuk model repositori/kebijakan. GUI adalah tab browser, bukan aplikasi asli.

Harga:

Platform: Windows, macOS, Linux.

Unduh: kopia.io.

Garis bawah: Lapisan backup di bawah plugin. Atur sekali, lupakan sampai Anda membutuhkannya.

4. Portainer — Rollback kontainer dan image pinning terbaik

Portainer adalah UI Docker yang membuat kunci tag image Jellyfin tertentu beberapa klik alih-alih edit file compose. Duplikasi stack, pertahankan yang lama dijeda dengan tag lama, jalankan yang baru berdampingan. Jika 12 berperilaku tidak benar, hentikan stack baru, lanjutkan yang lama — Anda kembali di 10.x dalam waktu kurang dari satu menit.

Di mana ini kurang: Tingkat gratis murah hati tetapi mengunci beberapa fitur di balik Business. Login dan prompt lisensi pada setiap instalasi baru membutuhkan waktu semenit untuk dinonaktifkan.

Harga:

Platform: Windows, macOS, Linux (Docker).

Unduh: portainer.io.

Garis bawah: Jaring pengaman. Mundur ke 10.x dari tab browser tanpa menyentuh CLI.

5. Watchtower — Update Docker terkontrol terbaik

Watchtower auto-update kontainer Docker ketika image baru tiba. Untuk server rumah normal, itu set-and-forget. Untuk jendela Jellyfin 12, lakukan kebalikannya: kecualikan Jellyfin dari watchlist Watchtower sehingga update terjadwal tidak menyeret Anda ke migrasi pada pukul 3 pagi.

Di mana ini kurang: Tidak ada GUI. Konfigurasi adalah variabel lingkungan pada kontainer.

Harga:

Platform: Linux (Docker).

Unduh: containrrr.dev/watchtower.

Garis bawah: Alat untuk dikonfigurasi ulang sebelum Anda upgrade, jadi Anda memutuskan kapan Jellyfin berpindah.

6. Diun — “Notifikasi sebelum tarik” alternatif terbaik untuk Watchtower

Diun menonton registri image dan ping Anda (melalui Discord, Telegram, ntfy, atau email) ketika tag baru dipublikasikan. Tidak seperti Watchtower, ini tidak pernah menarik atau memulai ulang — itu hanya memberi tahu Anda dunia telah bergerak. Sempurna untuk jendela Jellyfin 12: Anda mendapat ping, Anda memutuskan kapan akan benar-benar upgrade.

Di mana ini kurang: Bukan updater. Jika Anda menginginkan nol intervensi, Watchtower adalah alatnya.

Harga:

Platform: Linux (Docker).

Unduh: github.com/crazy-max/diun.

Garis bawah: Alat yang tepat untuk siapa pun yang menginginkan dorongan tanpa auto-pull.

7. TinyMediaManager — Pembersihan metadata pra- atau pasca-upgrade terbaik

TinyMediaManager memindai perpustakaan Anda dan menulis ulang metadata berantakan ke dalam struktur nfo + artwork yang bersih yang disukai Jellyfin. Jalankan sebelum upgrade untuk memperbaiki episode yang salah label dan artwork yang hilang; jalankan lagi sesudahnya untuk menangkap apa pun yang dibuat scanner baru permukaan. Tingkat gratis mencakup kasus umum; v5 berbayar membuka tindakan massal.

Di mana ini kurang: Versi gratis membatasi beberapa tindakan massal dan fitur episode TV ke v5 berbayar.

Harga:

Platform: Windows, macOS, Linux.

Unduh: tinymediamanager.org.

Garis bawah: Jalankan ini sekali setahun bahkan tanpa upgrade. Di sekitar lompatan Jellyfin 12, jalankan sebelum dan sesudah.

Cara memilih yang tepat

Tanya Jawab

Haruskah saya melewatkan Jellyfin 12 dan menunggu? Tidak. Menunggu tidak mengurangi risiko, hanya memindahkannya. Backup, kunci tag saat ini, upgrade instance staging terlebih dahulu, kemudian upgrade yang asli.

Plugin apa yang akan rusak di Jellyfin 12? Tim menerbitkan daftar kompatibilitas di blog Jellyfin dan di catatan rilis. Periksa setiap plugin pihak ketiga (auto-organise, transcode khusus, auth khusus) sebelum upgrade.

Dapatkah saya menjalankan Jellyfin 10.x dan 12 berdampingan? Dengan Docker, ya. Tunjukkan setiap kontainer ke folder config terpisah (Jellyfin 12 akan bermigrasi database di tempat, jadi jangan bagikan folder config antar versi).

Berapa lama migrasi database memakan waktu? Untuk perpustakaan dengan 5.000 item, harapkan beberapa menit di SSD, puluhan menit di disk berputar. Jangan hentikan kontainer saat berjalan.

Apakah saya memerlukan instalasi segar, atau apakah upgrade di tempat berfungsi? Upgrade di tempat didukung dan diharapkan untuk sebagian besar pengguna. Instalasi segar adalah jalan aman jika server Anda memiliki bertahun-tahun quirks config terakumulasi atau plugin dari era yang lebih tua.