Jellyfin 12 é a primeira versão em muito tempo que se recusa a carregar em um servidor cujos plugins não foram atualizados. A equipe finalmente está limpando o esquema do banco de dados, endurecendo os contratos de API do plugin e descontinuando o suporte para alguns fluxos de autenticação antigos. Isso é saudável para o projeto. É também uma oportunidade real de quebrar seu servidor doméstico se você atualizar sem um plano.
Examinamos sete ferramentas de desktop que tornam a atualização segura: um backup que realmente é restaurado, uma auditoria de plugin antes de obter a nova imagem, um caminho de retorno se a migração falhar e uma verificação de sanidade de metadados depois. Seis dos sete são gratuitos e de código aberto. Todos rodam no Windows, macOS e Linux (ou em um contêiner que faz).
O que procurar
- Um backup do diretório de configuração e do banco de dados, feito com o servidor desligado.
- Uma auditoria de compatibilidade de plugins antes de atualizar — alguns plugins não fornecerão uma construção compatível com 12 no primeiro dia.
- Uma imagem de contêiner marcada, para que você possa fixar a versão 10.x exata que estava executando e reverter sem mergulhar no git.
- Um servidor de staging em uma Pi sobressalente ou VM, para que a primeira tentativa de atualização não seja na real.
- Ferramentas de metadados para corrigir as inconsistências que o scanner mais rigoroso do Jellyfin 12 exposirá.
Comparação rápida
| Aplicativo | Melhor para | Plataformas | Plano gratuito | Preço | Licença |
|---|---|---|---|---|---|
| Jellyfin | O servidor em si | Windows, macOS, Linux, Docker | Sim | Gratuito | GPL |
| Jellyfin Backup Plugin | Backup de configuração e banco de dados no aplicativo | Qualquer host Jellyfin | Sim | Gratuito | GPL |
| Kopia | Backups de servidor totalmente criptografados | Windows, macOS, Linux | Sim | Gratuito | Apache 2.0 |
| Portainer | Reversão de contêiner e fixação de imagem | Windows, macOS, Linux | Sim | Gratuito (Community) | zlib |
| Watchtower | Atualizações Docker controladas | Linux, Docker | Sim | Gratuito | Apache 2.0 |
| Diun | Notificação antes de obter novas imagens | Linux, Docker | Sim | Gratuito | MIT |
| TinyMediaManager | Limpeza de metadados antes ou depois da atualização | Windows, macOS, Linux | Sim | Gratuito / ~$50/ano | Apache 2.0 |
1. Jellyfin — O servidor em si, atualizado ao seu ritmo
Jellyfin é o servidor de mídia. Para uma atualização de versão 12, o conselho honesto é: não acesse a atualização automática. Fixe a tag 10.x no Docker, interrompa o contêiner, execute as etapas de backup abaixo e obtenha a nova tag manualmente quando estiver pronto para sentar na frente do servidor por uma hora.
Onde fica aquém: Os hábitos de atualização automática de alguns caminhos do instalador (serviço Windows nativo, alguns pacotes distro) tornam a fixação mais difícil do que deveria ser.
Preço:
- Gratuito: Tudo.
- Pago: Nada.
Plataformas: Windows, macOS, Linux, Docker, ARM.
Download: jellyfin.org.
Conclusão: Fixe a tag, faça o backup, atualize deliberadamente.
2. Jellyfin Backup Plugin — Melhor backup de configuração e banco de dados no aplicativo
Jellyfin Backup Plugin é o plugin oficial de primeira parte que compacta o diretório de configuração, o banco de dados de metadados e o banco de dados de usuários em um único zip em um cronograma. Restaurar é um clique. Para o salto de versão 12, execute um backup manual com o servidor desligado para que nada esteja sendo escrito, depois mantenha um backup agendado rodando na nova versão.
Onde fica aquém: Não faz backup da própria biblioteca de mídia, apenas dos metadados ao seu redor. O armazenamento é local a menos que você o aponte para um compartilhamento.
Preço:
- Gratuito: Tudo.
- Pago: Nada.
Plataformas: Qualquer host executando Jellyfin.
Download: Instale no catálogo de plugins Jellyfin dentro do Dashboard.
Conclusão: A primeira coisa a instalar. Aquela que torna o retorno trivial se a atualização der errado.
3. Kopia — Melhor backup de servidor totalmente criptografado
Kopia é a ferramenta de backup que lida com a camada que o plugin Jellyfin não pode alcançar: a pasta de configuração completa, o cache de arte, o tmp de transcodificação e os arquivos de composição. Ele desduplica, criptografa e envia para S3, B2, NAS ou outro disco. Os snapshots são incrementais e montáveis para restauração.
Onde fica aquém: Curva de aprendizado para o modelo repositório/política. A GUI é uma guia do navegador, não um aplicativo nativo.
Preço:
- Gratuito: Todos os recursos.
- Pago: Nada.
Plataformas: Windows, macOS, Linux.
Download: kopia.io.
Conclusão: A camada de backup sob o plugin. Configure uma vez, esqueça até precisar.
4. Portainer — Melhor reversão de contêiner e fixação de imagem
Portainer é a interface de Docker que torna fixar uma tag de imagem específica do Jellyfin alguns cliques em vez de uma edição de arquivo de composição. Duplique a pilha, mantenha a antiga em pausa com a tag antiga, execute a nova lado a lado. Se 12 se comportar mal, interrompa a nova pilha, retome a antiga — você voltou ao 10.x em menos de um minuto.
Onde fica aquém: O nível gratuito é generoso, mas bloqueia alguns recursos atrás de Business. Mensagens de login e licença a cada instalação nova levam um minuto para desativar.
Preço:
- Gratuito: Portainer Community Edition.
- Pago: Portainer Business, para níveis de recurso que a maioria dos usuários domésticos não precisa.
Plataformas: Windows, macOS, Linux (Docker).
Download: portainer.io.
Conclusão: A rede de segurança. Retroceda para 10.x de uma guia do navegador sem tocar a CLI.
5. Watchtower — Melhor atualização Docker controlada
Watchtower atualiza automaticamente os contêineres Docker quando novas imagens chegam. Para um servidor doméstico normal, é configurar e esquecer. Para a janela Jellyfin 12, faça o oposto: exclua Jellyfin da lista de vigilância do Watchtower para que uma atualização agendada não o arraste para a migração às 3 da manhã.
Onde fica aquém: Sem GUI. A configuração são variáveis de ambiente no contêiner.
Preço:
- Gratuito: Todos os recursos.
- Pago: Nada.
Plataformas: Linux (Docker).
Download: containrrr.dev/watchtower.
Conclusão: A ferramenta para reconfigurar antes de atualizar, para que você decida quando Jellyfin se move.
6. Diun — Melhor alternativa “notificar antes de obter” ao Watchtower
Diun monitora registros de imagem e envia um ping para você (via Discord, Telegram, ntfy ou email) quando uma nova tag é publicada. Ao contrário do Watchtower, nunca puxa ou reinicia — apenas diz que o mundo se moveu. Perfeito para a janela Jellyfin 12: você recebe o ping, decide quando realmente atualizar.
Onde fica aquém: Não é um atualizador. Se você quer zero intervenção, Watchtower é a ferramenta.
Preço:
- Gratuito: Todos os recursos.
- Pago: Nada.
Plataformas: Linux (Docker).
Download: github.com/crazy-max/diun.
Conclusão: A ferramenta certa para quem quer um empurrão sem obtenção automática.
7. TinyMediaManager — Melhor limpeza de metadados pré- ou pós-atualização
TinyMediaManager verifica sua biblioteca e reescreve metadados desordenados em uma estrutura limpa de nfo + arte que Jellyfin adora. Execute antes da atualização para corrigir episódios rotulados incorretamente e arte ausente; execute novamente depois para capturar qualquer coisa que o novo scanner exponha. O nível gratuito cobre os casos comuns; a v5 paga desbloqueia ações em massa.
Onde fica aquém: A versão gratuita limita algumas ações em massa e recursos de episódio de TV ao v5 pago.
Preço:
- Gratuito: v4 totalmente funcional para filmes; v5 adiciona ferramentas de episódio em massa.
- Pago: Cerca de $50/ano pela licença v5.
Plataformas: Windows, macOS, Linux.
Download: tinymediamanager.org.
Conclusão: Execute isso uma vez por ano, mesmo sem atualização. Em torno de um salto Jellyfin 12, execute antes e depois.
Como escolher o certo
- Se você instalar uma coisa hoje: Jellyfin Backup Plugin. Faça um backup manual com o servidor desligado, depois atualize.
- Se você executar Docker (a maioria): Portainer, para que você possa reverter com um clique.
- Se você tiver atualizações automáticas ativadas: desative-as para Jellyfin com exclusões de Watchtower ou mude para notificações de Diun.
- Se você quiser o backup completo: Kopia, junto com o plugin.
- Se sua biblioteca tiver episódios rotulados incorretamente e arte ausente: TinyMediaManager, antes e depois do salto.
Perguntas frequentes
Devo pular Jellyfin 12 e esperar? Não. Esperar não reduz o risco, apenas o move. Faça backup, fixe a tag atual, atualize uma instância de staging primeiro, depois atualize a real.
Quais plugins vão quebrar em Jellyfin 12? A equipe está publicando uma lista de compatibilidade no blog Jellyfin e nas notas de versão. Verifique todos os plugins de terceiros (auto-organizar, transcodificadores personalizados, auth personalizado) antes de atualizar.
Posso executar Jellyfin 10.x e 12 lado a lado? Com Docker, sim. Aponte cada contêiner para uma pasta de configuração separada (Jellyfin 12 migrará o banco de dados no local, então não compartilhe a pasta de configuração entre versões).
Quanto tempo leva a migração do banco de dados? Para uma biblioteca com 5.000 itens, espere alguns minutos em SSD, dezenas de minutos em disco giratório. Não interrompa o contêiner enquanto ele é executado.
Preciso de uma instalação limpa ou a atualização no local funciona? A atualização no local é suportada e esperada para a maioria dos usuários. Uma instalação limpa é o caminho seguro se seu servidor tem anos de peculiaridades acumuladas de configuração ou plugins de uma era mais antiga.
