Usuários, teams e permissões no Portainer
Os usuários e os teams são os cadastros que o Portainer usa para organizar o acesso ao painel. As permissões definem os ambientes e recursos que você pode consultar ou alterar, sem conceder um login no Linux da VPS.
Ficha e sumário da página
- Referência técnica
- Portainer 2.45.3
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Usuários que existem só no Portainer
Um usuário do Portainer não entra no Linux nem no grupo do Docker. Quando a autenticação é a interna, a senha dele fica criptografada no banco do Server. O primeiro usuário, criado na configuração inicial, é o administrador. Os demais são criados na tela de usuários, com nome, senha e duas escolhas: se o novo usuário é administrador e em quais teams ele entra.
A autenticação interna tem duas configurações globais. O tempo de sessão, de 8 horas por padrão, define quando o usuário precisa entrar de novo. O tamanho mínimo da senha é de 12 caracteres por padrão. Um usuário com senha abaixo do mínimo precisa trocá-la no próximo login. Para empresas que já mantêm os usuários num diretório, a documentação descreve a autenticação por LDAP, por Active Directory ou por OAuth.
O Portainer separa essas permissões em camadas, do Server inteiro até um recurso dentro de um ambiente. Na Business Edition, uma camada a mais atribui papéis por ambiente, que definem quais ações cada usuário executa:
Portainer ServerO banco com usuários, teams e configurações.AdministradorControle de todas as configurações e de todos os ambientes.TeamUm grupo de usuários que recebe acesso em conjunto.UsuárioEntra num ou em vários teams, ou recebe acesso direto.Ambiente ou grupoO acesso liberado para usuários e teams escolhidos.Papel no ambienteAs ações permitidas naquele ambiente, na Business Edition.RecursoAdministradores, todos os usuários ou acesso restrito.
Teams
Um team junta usuários que recebem o mesmo acesso. Em vez de liberar um ambiente para cada usuário, você libera para o team. Cada novo integrante herda esse acesso ao entrar nele. A documentação usa os teams para controlar o acesso aos ambientes, aos containers, aos serviços e aos volumes.
Na criação do team, você pode escolher líderes. Um líder adiciona e remove usuários existentes no próprio team e promove outros integrantes a colíderes, sem precisar de um administrador para isso. O papel de líder vale só com a autenticação interna. Quando os teams vêm sincronizados de um provedor externo, como um LDAP, o papel de líder fica desligado.
O controle de acesso de cada recurso
Todo recurso Docker criado pelo Portainer, com exceção das imagens, tem um controle de acesso definido na criação ou depois dela. O acesso pode ficar exclusivo dos administradores, aberto aos usuários com acesso ao ambiente ou restrito aos teams e usuários selecionados. Você combina essa configuração com as permissões do ambiente, porque liberar um recurso não concede acesso a um servidor que o usuário não pode administrar.
Os recursos criados por uma stack ou por um serviço herdam o acesso do pai. Uma stack restrita ao team do comercial cria containers, volumes e redes com a mesma restrição, sem configuração em cada recurso. Essa herança mantém coerente o acesso a todas as peças de um app, desde o container do n8n até o volume com os workflows.
Os recursos criados fora do Portainer, pelo terminal, ficam marcados como externos e visíveis só para administradores. Três labels do Docker liberam o acesso a esses recursos já na criação, no próprio arquivo do Compose:
io.portainer.accesscontrol.publicLibera o recurso para todos os usuários e prevalece sobre as outras duas.io.portainer.accesscontrol.teamsRestringe o recurso aos teams listados, separados por vírgula.io.portainer.accesscontrol.usersRestringe o recurso aos usuários listados, junto ou não com teams.
Papéis na Business Edition
Na Community Edition, a divisão principal fica entre administradores e usuários padrão, combinada com o controle de acesso de cada recurso. A Business Edition acrescenta o controle de acesso por papéis, chamado de RBAC (Role-Based Access Control). Um papel é um conjunto fixo de privilégios. Você combina um usuário ou um team com um papel e associa essa combinação a um ambiente ou a um grupo de ambientes. O mesmo usuário pode ter papéis diferentes em ambientes diferentes.
Os papéis prontos cobrem os casos mais comuns. O administrador de ambiente tem acesso total dentro de um ambiente, sem mexer na infraestrutura dele nem nas configurações do Portainer. O operador enxerga todos os recursos. No Docker, ele lê logs e abre o console dos containers, sem criar, editar, iniciar ou parar recursos. O helpdesk tem acesso de leitura, sem console. O papel de usuário padrão dá controle sobre os recursos criados pelo próprio usuário ou pelo team dele. O papel só de leitura mostra os recursos do team e os públicos, sem alteração. A tela de papéis tem um visualizador de acesso efetivo, que mostra os papéis de um usuário em cada ambiente.
Administrador só para a configuração do painel
A documentação desaconselha dar acesso de administrador a todos os usuários. Um administrador modifica ou apaga qualquer coisa, inclusive as stacks, os registries e os apps em produção. O acesso administrativo fica para a manutenção do próprio Portainer, enquanto os demais usuários implantam e administram os próprios apps com acessos limitados.
Numa VPS administrada só por você, pode haver apenas o cadastro administrativo. Quando um cliente ou colaborador precisa acessar um app específico, um team restrito à stack separa esse app das outras stacks do ambiente. Essa restrição define os recursos visíveis, mas não cria um acesso exclusivamente de leitura na Community Edition. Para permitir apenas a consulta aos logs, a Business Edition oferece papéis como Helpdesk e Read-Only User.
A divisão entre os recursos da Community Edition e os que exigem uma chave da Business Edition continua na página Community e Business Edition.