Configure os IDs de utilizador dos contentores em várias partilhas NAS, fazendo corresponder a identidade numérica efetiva de cada processo de contentor ao proprietário, grupo, ACL e modo de montagem de cada partilha de que necessita.
Não force um único UID a ser proprietário de todos os conjuntos de dados e não use chmod 777 como estratégia de integração. Um servidor multimédia pode precisar de acesso só de leitura às fotografias, um descarregador pode precisar de acesso de leitura e escrita a uma partilha de entrada e um contentor de cópias de segurança pode precisar de um destino protegido diferente. Use a propriedade para definir a responsabilidade principal e grupos ou ACL para o acesso partilhado.
Registe as três identidades antes de alterar as permissões
Para cada serviço, registe o UID/GID do proprietário no NAS, o utilizador e os grupos numéricos do processo dentro do contentor e qualquer convenção de identidade específica da imagem, como PUID/PGID. Estes três valores são muitas vezes confundidos porque os nomes de utilizador podem parecer iguais, apesar de os IDs numéricos serem diferentes.
Uma explicação atualizada de que PUID e PGID não são definições do Docker torna explícita a distinção: PUID e PGID são variáveis interpretadas por determinadas imagens de contentores, não definições universais do Docker.
Verifique o processo em execução com id dentro do contentor e inspecione os ficheiros no anfitrião, incluindo a propriedade numérica. Não parta do princípio de que os valores escritos no Compose controlam efetivamente o processo, a menos que a imagem suporte esse método.
Use um proprietário principal e grupos partilhados para dados entre serviços
Uma partilha utilizada por uma aplicação pode ter um proprietário dedicado. Uma partilha onde vários serviços escrevem é geralmente mais fácil de gerir com um grupo partilhado ou uma ACL configurados deliberadamente, que concedam apenas as operações necessárias a esses serviços.
Uma explicação prática da propriedade numérica de UID e GID mostra por que motivo os ficheiros montados por associação seguem a propriedade numérica do anfitrião e por que motivo a correspondência ou o mapeamento deliberado desses IDs evita ficheiros criados como propriedade de root e falhas de permissões.
Por exemplo, num fluxo de trabalho multimédia, o descarregador pode ser responsável pelos seus ficheiros temporários, enquanto o descarregador e o organizador pertencem ambos a um grupo media. Configure a herança de diretórios, ACL predefinidas ou um comportamento adequado de umask para que os novos ficheiros mantenham automaticamente o acesso partilhado.
Conceda a cada partilha apenas os direitos de montagem de que o contentor necessita
A identidade é apenas uma camada. Um UID corretamente mapeado continua sem poder escrever através de uma montagem bind só de leitura, e um contentor com permissões amplas no sistema de ficheiros pode, ainda assim, ser restringido em segurança montando uma biblioteca como só de leitura.
Um artigo de 2026 sobre substituições do utilizador em tempo de execução explica como as montagens bind usam a propriedade do anfitrião e como as definições de tempo de execução user: podem alinhar os IDs dos processos, alertando também que forçar um utilizador pode quebrar imagens cuja lógica de arranque espera privilégios diferentes.
Documente cada caminho no anfitrião, caminho no contentor, modo de montagem, operações necessárias e serviço responsável. Use montagens só de leitura para bibliotecas que um serviço apenas consulta e reserve o acesso de escrita para o caminho mais restrito que realmente dele necessita.
Faça uma gestão deliberada dos vários modelos de ACL do NAS
As ACL SMB/NFSv4, as ACL POSIX, o mapeamento de identidades NFS e os bits de modo Unix simples podem apresentar diferentes perspetivas sobre o acesso. Uma partilha que funciona através de SMB com um utilizador do NAS pode ainda assim rejeitar um processo do contentor que utilize uma identidade numérica diferente no anfitrião.
O artigo relacionado da ZimaSpace sobre alterações de permissões do NAS explica por que razão a herança de ACL do destino, a identidade SMB, o UID/GID do contentor e a umask devem ser diagnosticados como camadas separadas.
Quando vários protocolos acedem ao mesmo conjunto de dados, escolha um modelo de permissões e documente-o. Alterar repetidamente as ACL através da interface gráfica do NAS e depois executar comandos de shell chmod e chown pode fazer com que o ficheiro seguinte se comporte de forma diferente do anterior.
Teste a criação de ficheiros a partir de todos os processos de escrita antes de aplicar as alterações recursivamente
Crie um diretório de teste descartável com a propriedade e a ACL pretendidas. A partir de cada contentor, teste a listagem, leitura, criação, mudança de nome e eliminação, apenas das operações necessárias para esse serviço. Em seguida, inspecione no NAS o proprietário numérico, o grupo, o modo e a ACL herdada do novo ficheiro.
Se os ficheiros antigos funcionam, mas os ficheiros criados recentemente não funcionam noutro serviço, corrija o processo de criação: pertença a grupos, ACL predefinida, umask ou modo de ficheiro específico da aplicação. Uma correção recursiva dos dados antigos não impede que a mesma incompatibilidade volte a surgir amanhã.
Implemente em produção apenas depois de todos os processos que escrevem criarem ficheiros utilizáveis pelo serviço seguinte, sem permissões elevadas. Um esquema de UID/GID bem definido é recuperável porque o mapeamento está documentado e é reproduzível, não porque todos os contentores acabam por ser executados com o mesmo utilizador.
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...



