Ir para o conteúdo
Promovaweb

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
  1. Usuários que existem só no Portainer
  2. Teams
  3. O controle de acesso de cada recurso
  4. Papéis na Business Edition
  5. Administrador só para a configuração do painel

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.
As camadas de acesso do Portainer 2.45 LTS, do Server ao recurso. O papel por ambiente, marcado como Business Edition, é o controle de acesso por papéis (RBAC).

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.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.