A abordagem segura consiste em tratar a verificação do mapeamento de identidades numéricas, desde a exportação do NAS, passando pela montagem no anfitrião, até ao processo do contentor em execução, como uma sequência de etapas verificáveis, e não como um único comando.
Num anfitrião Linux de contentores que use partilhas NAS através de SMB ou NFS, o risco prático é um contentor conseguir ver um caminho montado a partir do NAS, mas as leituras ou escritas falharem com erros de permissões. Registe a identidade atual e o ponto de recuperação, comece pelo método de diagnóstico menos invasivo, interprete os resultados positivos e negativos antes de alterar outra variável e pare se o armazenamento se tornar instável ou se a única cópia recuperável ficar exposta. O procedimento abaixo só termina quando a carga de trabalho original funcionar ou quando as evidências atingirem um limite que exija escalada.
Identifique a identidade efetiva do processo do contentor
Inspecione a documentação da imagem, a definição user do Compose, as variáveis de ambiente, o comportamento do entrypoint e os UID, GID e grupos suplementares do processo da aplicação em execução. As variáveis denominadas PUID e PGID são convenções das imagens, não funcionalidades universais do Docker; por isso, confirme se esta imagem as suporta.
Um caso da comunidade LinuxServer sobre um problema de permissões com PUID e PGID no contentor demonstra que valores de PUID e PGID aparentemente corretos podem, ainda assim, deixar uma montagem bind inacessível. Use o caso como um lembrete para inspecionar o processo em execução e a montagem, não como prova de que todas as imagens implementam a mesma lógica de inicialização.
Registe os valores numéricos com id dentro do contentor e no anfitrião. Pare se a aplicação estiver a ser executada como root apenas porque as permissões falharam anteriormente; o acesso como root oculta o defeito de mapeamento e aumenta o impacto de um serviço comprometido.
Rastreie a propriedade desde o NAS até à montagem no anfitrião
No NAS, inspecione o proprietário numérico, o grupo, o modo, a ACL e a ACL predefinida do diretório de destino. No anfitrião do contentor, inspecione os mesmos objetos montados e compare os valores numéricos. Se os nomes forem diferentes, mas os números coincidirem, as etiquetas são meramente cosméticas; se os números forem diferentes, o percurso de autorização é efetivamente diferente.
Para NFS, inclua as opções de exportação, a versão de NFS, o mapeamento de IDs, o root squashing e a identidade usada pelo cliente para montar. Para SMB, inclua as credenciais de montagem, a identidade mapeada no servidor, as opções de apresentação de uid ou gid e se estão a ser usadas extensões Unix ou tradução de ACLs.
Não altere as ACL do servidor e as opções de montagem do cliente ao mesmo tempo. A etapa é concluída quando um ficheiro de teste tem um proprietário numérico conhecido e o anfitrião apresenta um mapeamento estável após desmontar, voltar a montar e reiniciar.
Teste a montagem bind e os grupos suplementares
Confirme que o caminho de origem do contentor corresponde à montagem esperada no anfitrião, e não a um diretório local vazio criado antes da montagem da partilha de rede. Inspecione a montagem em execução e, em seguida, teste a listagem, a leitura, a criação, a mudança de nome e a eliminação como utilizador da aplicação, num subdiretório descartável.
Um caso no Server Fault documenta uma incompatibilidade de permissões de ACL no NFS, mesmo quando as entradas do proprietário e da ACL parecem alinhadas, mostrando por que motivo é necessário inspecionar a máscara da ACL, o mapeamento do servidor e a identidade efetiva. Capture getfacl no diretório e no ficheiro criado.
Se o acesso ao grupo for intencional, adicione o grupo numérico suplementar suportado e recrie o contentor, pois os grupos do processo são definidos no arranque. Consulte o guia da ZimaSpace sobre diagnóstico de caminhos vazios no contentor quando a aplicação é iniciada com um caminho vazio; trata-se de um problema na ordem de montagem, não de um problema de ACL.
Aplique a correção de identidade mais restrita e volte a testar
Dê preferência a alinhar o UID, o GID ou o grupo suplementar suportado pela aplicação com a política do NAS. Use um grupo partilhado e uma ACL herdada quando vários serviços colaborarem. Evite permissões de escrita para todos, alterações recursivas de propriedade em conjuntos de dados não relacionados e contentores privilegiados como atalhos.
Recrie o contentor, volte a montar a partilha se as opções de mapeamento tiverem sido alteradas e repita as mesmas operações. Reinicie o anfitrião uma vez para verificar se a ordem de montagem e a identidade numérica se mantêm após o arranque. Confirme que os ficheiros criados continuam a permitir escrita aos clientes humanos previstos, sem conceder direitos desnecessários ao contentor.
Feche a lista de verificação quando a aplicação concluir a carga de trabalho original, as operações não autorizadas continuarem a ser recusadas e a propriedade se mantiver estável após o reinício. Escale o problema se os namespaces de utilizador, os mapeamentos sem privilégios de root ou os serviços de identidade do NAS reescreverem IDs de uma forma incompatível com a imagem escolhida.
Assistência e dicas
Mais para ler

Como manter vídeos para adultos no seu NAS ocultos dos membros da família
Mantenha os vídeos para adultos privados num NAS familiar. Verifique as permissões das pastas, o acesso às bibliotecas do Plex e do Jellyfin, as...

O que verificar antes de carregar um modelo da comunidade em Transformers
Utilize a atualização da sandbox Jinja do Transformers para rever a proveniência dos modelos, os modelos de chat, o código remoto, os pesos serializados...

Execute o Mirage localmente: OCR e deteção de objetos a partir de uma imagem
Experimente o pequeno modelo de visão local da Cactus Compute, valide o OCR e a extração de objetos com dados reais e compreenda os...



