Lista de verificação do mapeamento de utilizadores e grupos de contentores para partilhas NAS

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.

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

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.