Como configurar ficheiros de metadados locais sem permitir reescritas indesejadas

Eva Wong é a redatora técnica e entusiasta residente na ZimaSpace. Uma geek desde sempre, apaixonada por homelabs e software de código aberto, dedica-se a traduzir conceitos técnicos complexos em guias práticos. A Eva acredita que a auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ajuda a comunidade a desmistificar configurações de hardware, desde montar o primeiro NAS até dominar os contentores Docker.

Os ficheiros NFO locais e as imagens tornam uma biblioteca multimédia portátil, mas o mesmo servidor que os lê também pode ter permissão para substituir títulos, imagens ou identificadores. Uma montagem de ficheiros multimédia só de leitura impede gravações acidentais, mas altera o local onde o servidor pode guardar ficheiros auxiliares transferidos.

Escolha uma única fonte de referência para cada campo de metadados antes de alterar as permissões. Os ficheiros auxiliares organizados devem ter controlo de versões ou cópias de segurança, o estado da base de dados do servidor deve permanecer gravável e um teste de atualização deve confirmar que o servidor lê os ficheiros sem reescrever os ficheiros de origem. Repita esse teste após atualizações e qualquer atualização de metadados em toda a biblioteca.

Decidir qual é a fonte de metadados de referência

Enumere os campos que organiza localmente: título, título de ordenação, edição, data, pessoas, IDs de fornecedores, cartaz e imagem de fundo. Se os ficheiros locais forem a fonte de autoridade, desative ou limite as atualizações dos fornecedores que possam substituir esses campos durante uma atualização.

Consulte o comportamento dos campos NFO do Jellyfin para a família de servidores instalada antes de adotar um esquema de nomes de ficheiros. O suporte varia consoante o tipo de biblioteca, e um nome de ficheiro aparentemente óbvio pode não corresponder ao ficheiro lido pelo analisador.

Mantenha um pequeno diretório de exemplo fora da biblioteca de produção. Deve conter um filme ou episódio, o respetivo ficheiro NFO e as imagens selecionadas, para que o comportamento da análise e da atualização possa ser testado sem pôr em risco milhares de ficheiros organizados.

Separar os ficheiros multimédia só de leitura do estado gravável do servidor

Monte a árvore de ficheiros multimédia como só de leitura dentro do contentor, mantendo graváveis os caminhos da configuração, da cache e da base de dados. Uma opção do contentor, como uma montagem bind só de leitura, é mais segura do que depender de uma caixa de verificação da aplicação, cujo significado pode mudar entre versões.

Se o servidor tiver de transferir novas imagens junto aos ficheiros multimédia, uma biblioteca totalmente só de leitura é incompatível com esse fluxo de trabalho. Guarde os metadados transferidos no estado da aplicação ou utilize uma tarefa de preparação controlada que grave ficheiros auxiliares fora do processo do servidor.

Considere o mapa de montagens parte do registo de implementação. A lista de verificação para a atualização do contentor Jellyfin ajuda a preservar a distinção entre multimédia, metadados e estado da aplicação durante a recriação.

Desativar os caminhos de gravação que entram em conflito com a curadoria

Desative as opções que guardam imagens ou metadados NFO nas pastas multimédia quando estas são selecionadas externamente. Verifique também as definições de gravação de metadados de cada biblioteca; a definição global pode não ser o único local que permite escritas.

Não torne todo o sistema de ficheiros do contentor só de leitura como substituto de montagens corretas, a menos que todos os caminhos que precisam de escrita sejam disponibilizados explicitamente. As bases de dados, os registos, os plugins e os ficheiros temporários continuam a precisar de localizações de escrita controladas.

Registe os hashes dos ficheiros ou as datas de modificação do ficheiro NFO e das imagens de exemplo, execute uma análise da biblioteca, edite um título na interface e atualize os metadados. Os ficheiros devem permanecer inalterados, enquanto a aplicação regista na base de dados o estado local permitido.

Verificar o comportamento de restauro e atualização

Exporte ou faça cópias de segurança dos ficheiros auxiliares selecionados separadamente da base de dados do servidor multimédia. Esses ficheiros restauram os metadados de apresentação; a base de dados pode ainda conter o estado de visualização, os utilizadores, as coleções e outras informações que os ficheiros locais não abrangem.

Recrie o contentor numa janela de testes e confirme que a opção de montagem só de leitura se mantém durante o processo de implementação. Em seguida, analise o diretório de exemplo e volte a comparar os hashes, porque uma atualização pode introduzir um novo gravador de metadados ou alterar um valor predefinido.

A regra final é simples: se uma atualização exigir acesso de escrita para preservar o resultado pretendido, a arquitetura da fonte de verdade ainda não está resolvida. Restaure o exemplo, mantenha a produção só de leitura e decida se é o servidor ou o curador externo que é responsável por esse campo.

Assistência 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.