O Jellyfin apresenta dados desatualizados após uma alteração do caminho de armazenamento

Eva Wong é a Redatora Técnica e e entusiasta residente na ZimaSpace. Uma geek de longa data com paixão por homelabs e software de código aberto, ela é especialista em traduzir conceitos técnicos complexos em guias acessíveis e práticos . Eva acredita que o auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ela capacita a comunidade adesmistificar configurações de hardware , desde a construção do seu primeiro NAS até dominar os contêineres Docker., from building their first NAS to mastering Docker containers.

O Jellyfin costuma apresentar dados desatualizados após uma mudança de armazenamento porque o serviço vê o caminho antigo, não consegue ler o novo ponto de montagem ou ainda não concluiu uma análise válida da nova localização.

O painel apresenta itens antigos, itens em falta ou uma mistura de ambos? Não elimine a biblioteca nem esvazie o lixo primeiro. Registe os caminhos antigo e novo exatos, o estado da montagem, o proprietário do serviço e o resultado da análise, para que cada cenário possa ser testado sem destruir metadados.

Verifique que caminho o Jellyfin consegue realmente ver

Inspecione o caminho a partir do processo ou contentor do Jellyfin, não apenas da shell do anfitrião. Confirme que a montagem existe após o arranque, que a conta de serviço consegue listar e ler um ficheiro de exemplo e que o mapeamento do contentor corresponde ao caminho armazenado na configuração da biblioteca.

Se o caminho estiver vazio ou inacessível, corrija primeiro a montagem, o UID/GID ou o volume do contentor. Uma montagem de armazenamento que só aparece após o início de sessão manual pode deixar o Jellyfin a analisar um diretório vazio durante o arranque.

Compare o caminho antigo e o novo na configuração da biblioteca e num registo da base de dados. Se ambos permanecerem, o Jellyfin pode legitimamente apresentar um item válido e uma referência obsoleta.

Distinguir metadados obsoletos de uma análise falhada

Depois de o caminho estar acessível, execute uma análise controlada e acompanhe os registos em busca do nome da biblioteca, da contagem de itens, de erros de permissões e de ficheiros ignorados. Compare um item antigo conhecido com um ficheiro adicionado recentemente. Se a análise terminar, mas os caminhos antigos permanecerem, a base de dados ainda contém a localização anterior ou o novo caminho foi adicionado sem remover a referência antiga.

Não interprete um cartaz em cache como prova de que o ficheiro multimédia está disponível. As regras de caminhos de armazenamento tornam o sistema de ficheiros montado e o caminho da aplicação verificações distintas.

Execute uma única análise controlada depois de corrigir o mapeamento e, em seguida, compare a contagem de itens e um ficheiro conhecido. Análises repetidas antes de corrigir o caminho podem criar um estado ainda mais confuso.

Repare apenas depois de confirmar o cenário

Corrija o mapeamento do caminho ou as permissões, reinicie uma vez e execute uma nova análise. Se o caminho na base de dados estiver errado, atualize a localização da biblioteca com a alteração mínima possível e confirme a contagem de itens esperada antes de limpar entradas antigas. Preserve os dados da aplicação e uma cópia de segurança antes de qualquer operação de metadados em massa.

A recuperação está confirmada quando o serviço continua a ver o novo caminho após o reinício, um cliente representativo reproduz um item e uma segunda análise não recria o estado obsoleto. Proceda à escalada quando o sistema de ficheiros indicar corrupção, a base de dados contiver caminhos em conflito ou o problema regressar após uma montagem e um reinício limpos.

Após a reparação, reinicie com a montagem disponível durante o arranque e repita a análise. Os dados obsoletos só ficam resolvidos quando o mesmo caminho continua visível após o reinício.

-15% OFF

Proceda à escalada quando o caminho continua a reaparecer

Mantenha o mapeamento reparado quando um reinício limpo, uma análise e uma reprodução representativa utilizarem o novo caminho sem recriar a entrada antiga.

Pare a limpeza quando o caminho antigo regressar, a base de dados contiver identidades em conflito ou a montagem de armazenamento mudar entre análises. Preserve primeiro a base de dados e o mapa de caminhos atual.

Proceda à escalada para uma reposição a partir de uma cópia de segurança ou para uma reparação específica da base de dados quando o sistema de ficheiros estiver saudável, mas as referências obsoletas persistirem após um mapeamento e um reinício limpos.

Suporte e Dicas

Mais para Ler

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.