📌 Como acessar o Portainer

O Portainer é uma interface gráfica para gerenciar containers Docker. Com ele, você pode criar, parar e monitorar serviços de forma simples, direto pelo navegador.

Este guia vai te mostrar como acessar e configurar o Portainer em um servidor Ubuntu 22, mesmo que você nunca tenha feito isso antes.

🔑 1. Criando a senha de acesso

Na primeira vez que acessar o Portainer, ele vai pedir para você criar uma senha de administrador.

👉 Basta abrir o endereço de acesso e cadastrar a senha desejada. Essa senha será usada todas as vezes que você entrar no painel.

⏱️ 2. Mensagem de timeout

Se aparecer a mensagem:

Your Portainer instance timed out for security purposes. 
To re-enable your Portainer instance, you will need to restart Portainer.

Isso significa que o Portainer entrou em modo de segurança por inatividade. Para resolver, reinicie o container:

docker container restart portainer

🌐 3. Acesso direto pelo navegador

O Portainer roda, por padrão, na porta 9000.

Então, basta acessar no navegador:

http://IP_DO_VPS:9000

🔒 4. Configurando acesso com domínio e SSL

Por padrão, o acesso é feito via IP, mas o ideal é acessar pelo seu domínio com HTTPS (SSL).

Existem dois cenários possíveis de instalação no Ubuntu 22:

  • Caddy (proxy reverso automático com SSL)

  • Nginx (proxy reverso manual + Certbot)

Você precisa primeiro identificar qual deles está ativo no seu servidor.

🔍 4.1 Como identificar se usa Caddy ou Nginx

No terminal, execute:

systemctl status caddy

  • Se aparecer como active (running) → sua VPS usa Caddy.

  • Se aparecer erro, teste:

systemctl status nginx

  • Se aparecer como active (running) → sua VPS usa Nginx.

🚀 5. Caso 1 — Configurando no Caddy

O Caddy é o servidor web mais simples de configurar, pois ele gera automaticamente o certificado SSL (HTTPS).

📂 Arquivo de configuração do Caddy

No Ubuntu 22, o arquivo principal fica em:

/etc/caddy/Caddyfile

🛠️ Passos para configurar:

  1. Abra o arquivo para edição:

nano /etc/caddy/Caddyfile

  1. Adicione no final do arquivo o bloco para o Portainer:

portainer.seudominio.com {
    reverse_proxy 127.0.0.1:9000
}

  1. Salve e feche (CTRL + O, ENTER, CTRL + X).

  2. Reinicie o Caddy para aplicar:

systemctl restart caddy

🚀 6. Caso 2 — Configurando no Nginx

O Nginx também pode ser usado como proxy reverso, mas nele você precisa criar a configuração manualmente e gerar o SSL com o Certbot.

📂 Estrutura de arquivos do Nginx

  • Configurações disponíveis: /etc/nginx/sites-available/

  • Configurações ativas: /etc/nginx/sites-enabled/

🛠️ Passos para configurar:

  1. Crie o arquivo de configuração do Portainer:

nano /etc/nginx/sites-available/portainer.conf

  1. Adicione o conteúdo abaixo:

server {
    server_name portainer.seudominio.com;

    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

  1. Ative a configuração criando o link simbólico:

ln -s /etc/nginx/sites-available/portainer.conf /etc/nginx/sites-enabled/

  1. Teste se não há erro de sintaxe:

nginx -t

  1. Recarregue o Nginx:

systemctl reload nginx

  1. Instale o Certbot (se ainda não tiver):

apt update && apt install certbot python3-certbot-nginx -y

  1. Gere o certificado SSL:

certbot --nginx -d portainer.seudominio.com
AnteriorSenha Universal: Acesso Simplificado para Contas Cadastradas na PlataformaPróximoUsuários

Atualizado