As atualizações de aplicações autoalojadas têm menos probabilidades de criar ficheiros pertencentes ao root quando a implementação fixa um contrato de utilizador numérico e valida a propriedade dos volumes antes de substituir o contentor.
A medida preventiva consiste em deixar de tratar o nome de utilizador interno da imagem como uma identidade de armazenamento estável. Registe o UID e o GID efetivos que escrevem os dados persistentes, associe-os a diretórios do anfitrião ou a volumes nomeados, preserve quaisquer definições de PUID/PGID ou de espaço de nomes de utilizadores e teste a nova imagem num pequeno caminho com permissões de escrita antes de a implementar por completo. Assim, uma atualização da imagem não poderá alterar silenciosamente a propriedade numérica da configuração, dos carregamentos, das bases de dados ou dos metadados multimédia.
Registe o UID e o GID numéricos antes de atualizar
Registe o utilizador do processo em execução, o grupo principal, os grupos suplementares e a propriedade numérica de ficheiros representativos em cada volume com permissões de escrita. Guarde o resumo criptográfico ou a versão da imagem junto desse registo de referência da propriedade.
As orientações da Docker para a criação de imagens indicam que os IDs explícitos evitam variações entre reconstruções, porque os utilizadores atribuídos automaticamente às imagens podem receber IDs numéricos diferentes em cada reconstrução.
Registe os números, não apenas nomes como app ou media. Uma nova imagem pode reutilizar o mesmo nome de utilizador e alterar o respetivo UID, e os ficheiros no anfitrião guardam a propriedade numérica.
Fixe o utilizador de execução no contrato de implementação
Quando a imagem suportar a execução direta com uma conta sem privilégios de root, especifique explicitamente o utilizador e o grupo pretendidos no Compose ou na configuração de execução. Se a imagem exigir uma fase de inicialização com privilégios de root, documente qual é o processo subsequente que escreve efetivamente os dados persistentes.
A especificação de imagens Open Container define User como o valor predefinido em tempo de execução, o que significa que uma alteração à imagem pode alterar a identidade em tempo de execução, a menos que a implementação a substitua ou valide deliberadamente.
Não force um UID arbitrário sem privilégios de root em imagens que exijam um modelo de inicialização suportado. O contrato deve respeitar a conceção documentada da aplicação, mantendo previsível a propriedade dos ficheiros persistentes.
Mantenha o PUID e o PGID alinhados com a propriedade no anfitrião
Nas imagens que disponibilizam as variáveis PUID e PGID, fixe esses valores numa configuração Compose ou de ambiente com controlo de versões e certifique-se de que os diretórios dos volumes no anfitrião pertencem à conta de serviço correspondente.
O LinuxServer explica que o PUID mapeia as gravações do contentor, para que os ficheiros criados nos volumes mapeados continuem a ser geríveis fora do contentor.
Antes de atualizar, compare os IDs configurados com o resultado de id no anfitrião e com a propriedade dos ficheiros existentes. Não copie cegamente um valor de exemplo como 1000 para um servidor onde esse ID pertence a outra pessoa ou serviço.
Tenha em conta os espaços de nomes de utilizadores e o mapeamento sem privilégios
O Docker ou Podman sem privilégios pode fazer com que um processo pareça ser root dentro do contentor, embora seja mapeado para um UID não root no anfitrião. Registe o modo do espaço de nomes e a configuração dos UID/GID subordinados antes de interpretar as alterações de propriedade.
As opções de execução do Podman mostram que o keep-id preserva o mapeamento do utilizador quando um contentor precisa de acesso previsível a ficheiros montados a partir do anfitrião.
Não «corrija» um proprietário que pareça ser root dentro do contentor antes de verificar o ID numérico no anfitrião. Root com espaço de nomes e root no anfitrião nem sempre são a mesma identidade.
Teste previamente a nova imagem num volume de teste
Antes de substituir o contentor de produção, execute a nova imagem com o UID/GID pretendido e um diretório temporário com permissões semelhantes às de produção. Deixe a inicialização criar um ficheiro e um diretório e, em seguida, verifique a propriedade dos mesmos no anfitrião.
O guia de depuração de volumes sem privilégios da Red Hat demonstra que a propriedade no anfitrião segue o mapeamento de UID, pelo que o nome de utilizador apresentado no contentor não é, por si só, uma prova suficiente.
Se o canário criar ficheiros inesperadamente pertencentes a root ou com IDs remapeados, interrompa a implementação e compare o utilizador da imagem, o ponto de entrada, o espaço de nomes e as definições das montagens. É muito mais seguro do que descobrir a alteração depois de uma migração recursiva no arranque afetar uma árvore inteira de fotografias ou bases de dados.
Verifique os grupos suplementares e os caminhos com permissão de escrita
Algumas aplicações precisam de um UID de serviço principal e de acesso através de um grupo partilhado de multimédia, transferências ou dispositivos. Registe esses IDs de grupo e teste todos os caminhos com permissão de escrita, não apenas o diretório de configuração.
O Kubernetes usa controlos explícitos runAsUser e runAsGroup, ilustrando o mesmo princípio de propriedade do Linux, mesmo fora de uma implementação simples do Docker Compose.
A política de atualização está completa quando a nova imagem cria ficheiros com a propriedade esperada no anfitrião em todos os caminhos persistentes e mantém essa propriedade após a recriação de um contentor. O artigo relacionado do ZimaSpace sobre ficheiros pertencentes a root após atualizações da imagem explica como recuperar se uma implementação já tiver criado dados pertencentes a root.
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...



