Evite a perda da configuração do Jellyfin durante as atualizações, tratando o estado da aplicação e o runtime substituível como dois objetos de recuperação distintos.
Uma atualização pode ser bem-sucedida ao nível do pacote, enquanto uma montagem alterada, um ID de utilizador, um mapeamento de dispositivos ou uma migração fazem com que o Jellyfin pareça novo. O passo de prevenção não é simplesmente “fazer uma cópia de segurança”; é saber exatamente onde o estado reside, capturá-lo de forma consistente, registar a definição em execução e comprovar que consegue restaurá-lo.
Mapeie os Caminhos Persistentes Reais Antes da Atualização
Não assuma que o caminho apresentado dentro de um contentor é o caminho do anfitrião incluído na cópia de segurança. Verifique a montagem bind ou o volume nomeado que contém efetivamente a base de dados, a configuração, os metadados e o estado dos plugins.
O armazenamento dos contentores mantém-se portátil quando as definições de volumes e os limites dos serviços são explícitos na configuração da implementação.
Registe o caminho do anfitrião, o caminho do contentor, o proprietário e o sistema de ficheiros de cada montagem persistente. Se não for possível identificar o local do estado com confiança, adie a atualização.
Crie uma Cópia Consistente Antes da Alteração
O ponto de recuperação mais útil é criado antes de a nova versão poder modificar a base de dados. Uma cópia de ficheiros feita durante gravações ativas pode ser menos fiável do que uma cópia de segurança com o serviço parado ou um instantâneo coerente.
Uma cópia de segurança separada da configuração do Jellyfin preserva o estado difícil de recriar, mantendo os conteúdos multimédia em massa no seu próprio percurso de proteção.
Crie a cópia de segurança, guarde-a fora do dispositivo de configuração ativo e registe o respetivo carimbo temporal e a versão. Um layout persistente dos dados da aplicação deve permitir fazer uma cópia de segurança do estado sem copiar a própria imagem.
Registe a Definição do Runtime com o Mesmo Cuidado que os Dados
Uma cópia de segurança perfeita da base de dados não restaurará a aceleração de hardware, as portas, o DNS, os dispositivos ou as permissões se a definição recriada do contentor não incluir essas configurações. Trate a configuração do Compose ou da plataforma como parte do conjunto de recuperação.
A execução de contentores com uma identidade de serviço estável depende de um mapeamento previsível de UID e GID entre atualizações e sistemas de ficheiros do anfitrião.
Exporte ou confirme no repositório a definição efetiva da implementação, sem segredos. Registe o digest da imagem e os mapeamentos de dispositivos para que a reversão não dependa da memória.
Teste o Percurso de Recuperação Antes de Remover a Versão Antiga
A limpeza deve ser feita depois de a nova versão sobreviver a um reinício e de a cópia de segurança poder ser localizada e aberta. Se a reversão nunca foi ensaiada, eliminar imagens e instantâneos antigos remove as opções de recuperação mais económicas.
Um percurso de restauro testado transforma uma cópia de segurança de uma opção de recuperação presumida numa opção que efetivamente reconstruiu um estado utilizável da aplicação.
Valide os utilizadores, as bibliotecas, os metadados, uma reprodução e um reinício. Mantenha o conjunto de recuperação anterior à atualização até a nova versão concluir as migrações esperadas e o trabalho normal em segundo plano.
Suporte e Dicas
Mais para Ler

Deve fazer uma cópia de segurança do Jellyfin em funcionamento ou parar primeiro o serviço?
Prefira cópias de segurança com o serviço parado, pela sua simplicidade; utilize instantâneos em funcionamento apenas quando o estado da aplicação for capturado de...

Porque é que o Jellyfin funciona a altas temperaturas ou faz ruído quando ninguém está a transmitir?
O calor em inatividade normalmente indica atividade em segundo plano ou uma carga de trabalho de um anfitrião partilhado; por isso, identifique o processo...

Quando deve reconstruir em vez de reparar o Jellyfin?
Escolha recriar em vez de reparar quando o problema for a divergência do ambiente de execução e o estado persistente estiver salvaguardado; não «recrie»...

