Para mover o Jellyfin sem perder utilizadores ou histórico, pare a instância de origem antes de copiar os respetivos dados persistentes e mantenha a instância original intacta até a nova passar pela verificação.
Uma migração de um servidor doméstico pode falhar mesmo quando todos os ficheiros multimédia estão presentes, porque o estado do Jellyfin reside nos caminhos de dados, configuração, metadados e base de dados. Faça o inventário desses pontos de montagem, copie-os enquanto as escritas estiverem bloqueadas, recrie os mesmos caminhos e proprietários e, em seguida, teste o início de sessão, o histórico, o acesso às bibliotecas e a reprodução antes de desativar a origem.
Congele a Origem e Faça o Inventário dos Caminhos Persistentes
A instância de origem continua a servir utilizadores. Comece pela verificação menos invasiva: registe os caminhos de dados/configuração/cache do Jellyfin, os pontos de montagem do contentor, o UID/GID, a versão e as localizações dos conteúdos multimédia; pare o contentor antes de copiar o estado.
A observação útil é específica: todos os caminhos de estado estão montados, o caminho da base de dados está oculto num volume ou apenas os conteúdos multimédia estão mapeados. Registe o resultado antes de alterar outra variável. faça uma cópia de segurança antes da migração
Interprete o cenário em vez de adivinhar. Se todos os caminhos persistentes forem conhecidos, prossiga; se um caminho estiver oculto, resolva-o primeiro; se apenas os conteúdos multimédia estiverem mapeados, crie uma cópia de segurança do estado antes de copiar.
Copie os Dados, a Configuração e a Base de Dados Mantendo os Proprietários
A origem está parada e os caminhos foram inventariados. Comece pela verificação menos invasiva: copie primeiro os diretórios de estado, compare o número e o tamanho dos ficheiros, aplique depois o UID/GID de destino e confirme que o Jellyfin consegue ler e escrever na base de dados.
A observação útil é específica: a base de dados abre corretamente, aparece um erro de permissão ou os caminhos existem, mas as bibliotecas estão vazias. Registe o resultado antes de alterar outra variável. caminho da base de dados local
Interprete o cenário em vez de adivinhar. Se a base de dados abrir e os caminhos coincidirem, prossiga; se as permissões falharem, corrija os proprietários sem eliminar ficheiros; se as bibliotecas estiverem vazias, corrija os caminhos dos pontos de montagem antes de voltar a analisar.
Recrie o Ambiente de Execução Antes de Testar o Resultado
Os dados persistentes foram copiados e os proprietários foram corrigidos. Comece pela verificação menos invasiva: recrie o contentor com os pontos de montagem de destino, registe a versão da imagem e abra o painel de administração antes de alterar bibliotecas ou utilizadores.
A observação útil é específica: os utilizadores e as bibliotecas aparecem, é executada uma migração no arranque ou é apresentado o assistente de configuração inicial. Registe o resultado antes de alterar outra variável.
Interprete o cenário em vez de adivinhar. Se o estado aparecer, não volte a analisar ainda; se a migração for executada, deixe-a terminar e mantenha a origem; se o assistente de configuração aparecer, pare, porque o ponto de montagem dos dados está incorreto.
Verifique Utilizadores, Histórico, Bibliotecas e Reprodução Antes da Limpeza
A nova instância inicia-se com o estado copiado. Comece pela verificação menos invasiva: inicie sessão com um utilizador existente, verifique o histórico de visualização e as permissões das bibliotecas, reproduza um conteúdo em Reprodução direta e outro com transcodificação e, em seguida, reinicie uma vez e repita os testes.
A observação útil é específica: todo o estado e a reprodução funcionam, uma biblioteca está vazia ou faltam utilizadores ou histórico. Registe o resultado antes de alterar outra variável. processo de verificação da migração
Interprete o cenário em vez de adivinhar. Se todas as verificações passarem duas vezes, guarde uma cópia de segurança final e desative a origem mais tarde; se uma verificação do estado falhar, encaminhe os clientes novamente para a origem; se a reprodução falhar, corrija o caminho ou o acelerador antes da limpeza.
Suporte e Dicas
Mais para Ler

O Jellyfin pode partilhar em segurança uma GPU ou acelerador com outro contentor?
A partilha da GPU é condicional: verifique a visibilidade do dispositivo e o suporte dos controladores; em seguida, execute ambas as cargas de trabalho...

Como saber se um erro do Jellyfin vem do cliente ou do servidor
Um erro do Jellyfin pertence ao cliente quando afeta apenas um dispositivo; pertence ao servidor quando vários clientes falham no mesmo percurso e os...

Como configurar a cache e o armazenamento temporário do Jellyfin
Separe o estado persistente, a cache reconstruível e o armazenamento temporário para transcodificação; em seguida, verifique a capacidade e as permissões com um teste...

