Porque é que a análise da biblioteca multimédia não encontra filmes num compartilhamento montado?

Uma análise de multimédia não encontra filmes quando o servidor não consegue percorrer o caminho montado, vê um caminho diferente ou rejeita os ficheiros durante a identificação.

Num NAS doméstico, “a partilha está montada” pode significar apenas que a shell do anfitrião consegue ver um diretório. O processo do servidor multimédia pode estar dentro do Docker, utilizar outro caminho de ligação, ser executado com um UID diferente ou analisar um ponto de montagem local vazio deixado depois de a partilha remota se desligar. Diagnostique um filme em falta, desde o armazenamento até à aplicação, em vez de iniciar repetidamente análises completas que não conseguem corrigir falhas de caminho, permissões, nomenclatura ou análise.

Confirme que a Partilha Montada Contém o Filme Neste Momento

Verifique o caminho exato da origem da biblioteca a partir do anfitrião e liste um filme em falta pelo nome de ficheiro completo. Confirme o tipo de sistema de ficheiros, a origem da montagem, as opções de montagem, o espaço livre e o número de ficheiros conhecido, em vez de confiar apenas no facto de o diretório do ponto de montagem existir.

Uma partilha de rede desligada pode deixar um diretório local normal e vazio no mesmo ponto de montagem, permitindo que uma análise termine sem encontrar multimédia. Um relatório do Jellyfin descreve uma análise que pareceu bem-sucedida, embora o destino tenha resolvido para zero itens.

Leia uma pequena parte do ficheiro em falta e liste os diretórios-pai. Se a partilha estiver ausente, restaure a montagem antes de analisar e configure o serviço multimédia para iniciar apenas depois de o sistema de ficheiros remoto estar disponível. Não adicione o ponto de montagem local vazio como um segundo caminho da biblioteca.

Verifique o Caminho a Partir do Contentor do Servidor Multimédia

Entre no contentor em execução e inspecione o caminho exato configurado na biblioteca. O anfitrião pode utilizar /mnt/media/movies, enquanto o contentor o vê como /media/movies; apenas o caminho dentro do contentor deve ser utilizado na aplicação.

Os conteúdos multimédia novos podem continuar invisíveis mesmo quando os itens antigos continuam a ser reproduzidos, se o contentor em execução já não conseguir ver o caminho atual do anfitrião ou receber conteúdos de montagem obsoletos. Um caso do Jellyfin relatou que os conteúdos multimédia novos não apareceram depois de análises repetidas.

Compare a definição de montagem do contentor com a montagem efetiva apresentada pelo runtime. Confirme que a origem da ligação é a partilha realmente montada, e não um diretório-pai ou um caminho obsoleto. Recrie o contentor apenas depois de confirmar que as montagens da configuração persistente e da base de dados permanecem inalteradas.

Teste a Travessia dos Diretórios com o Utilizador Real do Serviço

Utilize o UID e o GID do servidor multimédia para listar todos os diretórios desde a raiz da biblioteca até ao ficheiro do filme. Ler o ficheiro não é suficiente; o processo também precisa de permissão de execução em cada diretório-pai para percorrer o caminho.

Um problema de visibilidade da biblioteca do Jellyfin identifica a falta de permissões de leitura e de execução dos diretórios como causa direta de os itens não aparecerem. O limite importante é a permissão de travessia do diretório, e não o facto de uma conta de administrador conseguir navegar na partilha.

Corrija a regra mais específica de proprietário, grupo ou ACL que conceda ao serviço acesso multimédia apenas de leitura. O guia da ZimaSpace sobre permissões depois de mover ficheiros apresenta o procedimento complementar quando a partilha funciona através de SMB, mas não dentro do contentor.

Featured

ZimaCube 2 NAS Pessoal Cloud para Casa

ZimaCube2

$799.00 - $2,499.00

Buy Now

Compare um Filme em Falta com um Filme Detetado

Escolha duas pastas na mesma partilha montada: um filme que a biblioteca deteta e outro que não deteta. Compare o nome do ficheiro, a extensão, a profundidade da pasta, as maiúsculas e minúsculas, os caracteres especiais, o tamanho do ficheiro, a utilização de ligações simbólicas, as permissões, as marcas temporais e se o ficheiro está completo.

Algumas falhas do analisador são específicas de determinados itens e não de toda a partilha. Um caso registado do Jellyfin descobriu filmes que só apareceram depois de serem movidos para outra pasta, demonstrando por que motivo uma comparação controlada entre um item detetado e um item em falta é mais útil do que outra análise global.

Mude o nome ou mova apenas um item de teste copiado para uma estrutura simples, como Movies/Movie Name (Year)/Movie Name (Year).mkv. Se a cópia aparecer, analise a nomenclatura, os marcadores ocultos, as permissões ou o comportamento do sistema de ficheiros da pasta original antes de alterar toda a biblioteca.

Leia o Registo do Analisador no Primeiro Caminho em Falta

Inicie uma análise direcionada e acompanhe o registo a partir do momento em que o analisador entra no diretório afetado. Procure mensagens de acesso negado, diretório não encontrado, erros de E/S, ficheiros não suportados, falhas de sondagem, restrições da base de dados, erros do fornecedor de metadados e cancelamentos da análise.

Uma análise completa pode parar ou ignorar operações depois de uma exceção ao nível do caminho, enquanto a interface do utilizador mostra apenas uma biblioteca incompleta. O Jellyfin documentou análises afetadas por uma exceção de diretório em falta, o que torna o primeiro erro mais importante do que o indicador de progresso final.

Corrija o primeiro erro reproduzível e execute novamente a análise mais pequena possível. Não elimine a base de dados da biblioteca, os metadados ou a cache antes de comprovar a visibilidade do caminho e as permissões; reinicializações destrutivas podem remover evidências de diagnóstico sem reparar a partilha montada.

Confirme a Correção com uma Importação Controlada e um Reinício

Adicione um filme de teste com um nome simples à mesma partilha, analise a biblioteca afetada e confirme que aparece uma vez, com o caminho e os metadados corretos. Em seguida, reinicie o contentor e reinicie o anfitrião.

Depois do reinício, confirme que a partilha remota é montada antes do serviço multimédia, que o contentor vê o caminho preenchido, que o utilizador do serviço consegue percorrê-lo e que o analisador deteta um ficheiro de teste recém-adicionado sem alterações manuais às permissões.

A reparação só está concluída quando os filmes realmente em falta aparecem a partir da localização montada pretendida, nenhum diretório local vazio é analisado e o resultado persiste após remontar a partilha, recriar o contentor e reiniciar o anfitrião. Remova a cópia de teste depois de confirmar que o caminho original da biblioteca está estável.