Tutoriais de VPS
Authentik na VPS: OIDC, MFA, Caddy HTTPS e recuperação testada
Implante Authentik com Docker Compose e PostgreSQL, proteja portas privadas com Caddy HTTPS, integre OIDC e Forward Auth, configure MFA e preserve segredos e dados para atualizações e recuperação testada.

Quando uma VPS passa a hospedar vários aplicativos, administrar contas pode ficar difícil antes de faltar CPU ou disco. Grafana, Gitea e Nextcloud mantêm senhas separadas; desligar alguém exige retirar acessos em vários lugares; aplicativos antigos talvez não tenham OIDC. O Authentik centraliza a identidade com OIDC, SAML ou LDAP e protege sites sem login único por meio de um Proxy Provider.
Este guia usa Ubuntu 24.04, Docker Compose, PostgreSQL 16 e Caddy. O exemplo de 15 de setembro de 2026 usava Authentik 2026.8.2. A versão oficial consultada em 16 de novembro é 2026.8.5, cujo Compose continua com PostgreSQL 16 e serviços server/worker. Confira as notas antes de instalar: o endereço de download acompanha a versão atual e não reproduz automaticamente uma instalação antiga.
Ele atende pessoas e equipes pequenas com vários aplicativos que precisam de login comum, MFA e políticas de acesso:
- Suporta OpenID Connect/OAuth 2.0, SAML, LDAP, SCIM e outros protocolos; confira a edição necessária para cada recurso.
- Flows visuais definem login, cadastro, recuperação de senha e MFA.
- Em aplicativos com OIDC nativo, atua como provedor de identidade.
- Proxy Providers e Outposts protegem aplicativos sem integração nativa.
- Usuários, grupos, atributos e políticas controlam acesso por aplicativo.
- Desativar a conta impede novos logins autorizados pelo provedor conectado.
Isso não invalida necessariamente uma sessão já aberta no aplicativo nem um token emitido. No desligamento de usuários, teste logout, validade de tokens e revogação de sessões em cada integração.
O Authentik não é um cofre para as senhas pessoais de outros sites. Para um cofre de equipe separado, veja como hospedar o Vaultwarden.
| Opção | Vantagem | Manutenção | Indicação |
|---|---|---|---|
| Authentik | Administração acessível, protocolos e Flows flexíveis | Entender server, worker, PostgreSQL e Outposts | Mistura de OIDC e sites antigos |
| Keycloak | Ecossistema OIDC/SAML consolidado, realms, funções e diretórios empresariais | Mais configuração e planejamento de recursos | Identidade organizacional e funções complexas |
| Authelia | Relativamente leve para sites atrás de proxy | Escopo menor de plataforma e catálogo de aplicativos | Poucos sites internos, principalmente Forward Auth |
| Basic Auth | Configuração rápida | Sem ciclo de contas comum, MFA ou auditoria granular | Páginas temporárias com poucos usuários e exposição limitada |
Para diretórios empresariais ou muitos realms e funções, leia o guia do Keycloak. O Authentik costuma facilitar o início quando vários aplicativos Docker precisam de uma entrada comum.
O caminho de um nó é navegador ou cliente OIDC → Caddy HTTPS → Authentik server/worker → PostgreSQL pela rede privada Docker:
浏览器 / OIDC 应用
|
| HTTPS :443
v
Caddy
|
| HTTP 127.0.0.1:9000
v
Authentik server + worker
|
| Docker 内部网络 :5432
v
PostgreSQL 16
O método oficial Compose destina-se a testes e produção pequena, com mínimo de 2 núcleos e 2GB de RAM. Esse mínimo oferece pouca folga quando banco, Caddy, workers e backups compartilham a máquina.
| Carga | VPS sugerida | Limitação prática |
|---|---|---|
| Testes, menos de 10 usuários | 2 vCPU, 2GB RAM, SSD de 25GB | Validar recursos, não sustentar um login crítico |
| Equipe pequena, dezenas a centenas de usuários | 2–4 vCPU, 4GB RAM, NVMe de 40GB | Reservar espaço para dados e atualizações |
| Picos de login ou muitos aplicativos | 4 vCPU, pelo menos 8GB RAM | Medir antes de separar o banco ou adicionar nós |
São estimativas de planejamento, sem garantia de capacidade medida. Uma VPS continua sendo um ponto único de falha. Prepare backups externos, acessos emergenciais próprios dos aplicativos quando disponíveis, um administrador de emergência e recuperação ensaiada.
Use um hostname dedicado, como sso.example.com. Aponte o registro A para a IPv4 pública e crie AAAA somente se IPv6 estiver configurado e funcionando.
Libere SSH, HTTP e HTTPS:
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status verbose
Não abra 9000, 9443 nem 5432 no grupo de segurança ou UFW. As portas web ficam em 127.0.0.1, e o PostgreSQL não publica porta no host. Confira também a exposição das portas Docker; regras UFW sozinhas não comprovam isolamento. Se perder SSH, use o console do provedor e a recuperação de bloqueio pelo UFW.
Instale primeiro Docker Engine e o plugin Compose v2 seguindo as instruções oficiais para Ubuntu. Instalar Caddy e consultar a versão do Docker não instala o Docker. Avalie atualizações de pacotes e reinicializações antes de tornar a VPS o login da equipe.
sudo apt update
sudo apt full-upgrade -y
sudo apt install -y ca-certificates curl openssl caddy
docker --version
docker compose version
sudo systemctl enable --now caddy
Use Compose v2. Configure rotação de logs, monitoramento e exercícios de recuperação com a lista de preparação para produção.
Crie o diretório e restrinja os arquivos novos:
sudo install -d -m 0750 -o "$USER" -g "$USER" /opt/authentik
cd /opt/authentik
umask 077
curl -fsSLo compose.yml https://docs.goauthentik.io/compose.yml
O arquivo oficial fixa a versão atual no momento do download. Mantenha uma versão auditável em vez de trocar a tag por latest. Se o download da documentação falhar, obtenha e revise o Compose da mesma versão oficial; evite substituí-lo por um instalador de terceiros sem verificação.
Gere a senha do PostgreSQL e a chave de identidade, vinculando as duas portas web ao loopback:
{
printf 'PG_PASS=%s\n' "$(openssl rand -hex 32)"
printf 'AUTHENTIK_SECRET_KEY=%s\n' "$(openssl rand -hex 60)"
printf 'COMPOSE_PORT_HTTP=127.0.0.1:9000\n'
printf 'COMPOSE_PORT_HTTPS=127.0.0.1:9443\n'
} > .env
chmod 600 .env
docker compose config --quiet
Os comandos são para instalação nova: sobrescrevem o arquivo de ambiente. Não gere novamente os segredos de uma instância existente. Não envie .env para Git, conversas ou chamados. A saída completa de docker compose config expande segredos; use --quiet para validar a sintaxe.
O worker monta /var/run/docker.sock por padrão para administrar Outposts. O socket pode conceder controle do host. Remova a montagem se administrar Outposts manualmente ou avalie um Docker Socket Proxy limitado às operações necessárias e acessível apenas pelo worker.
Não monte /etc/timezone nem /etc/localtime nos contêineres. O Authentik trabalha em UTC internamente; essas montagens podem afetar OAuth, SAML e verificações de horário de certificados. Sincronize o relógio da VPS separadamente.
Baixe as imagens fixadas e inicie os serviços:
cd /opt/authentik
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=200 server worker postgresql
Confira os endereços de escuta:
ss -lnt | grep -E ':9000|:9443'
curl -fsSI http://127.0.0.1:9000/
A saída de ss deve mostrar 127.0.0.1:9000 e 127.0.0.1:9443, nunca 0.0.0.0 nem [::]. Verifique também de fora da VPS. Em reinicializações contínuas, examine a saúde do PostgreSQL e os logs de server/worker; alterar restart não corrige a causa.
Edite /etc/caddy/Caddyfile e substitua o domínio de exemplo:
sso.example.com {
encode zstd gzip
reverse_proxy 127.0.0.1:9000
header {
Strict-Transport-Security "max-age=31536000; includeSubDomains"
X-Content-Type-Options "nosniff"
Referrer-Policy "strict-origin-when-cross-origin"
}
}
Valide e recarregue:
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -fsSI https://sso.example.com/
O proxy precisa aceitar HTTP/1.1 e WebSocket, preservar Host e tratar corretamente X-Forwarded-Host, X-Forwarded-Proto, X-Forwarded-For, Connection e Upgrade. A diretiva reverse_proxy do Caddy trata o encaminhamento habitual e WebSocket. Bloqueie o acesso que contorna o proxy pela porta 9000.
Com Nginx Proxy Manager, siga o guia de HTTPS e proxy reverso e habilite WebSocket. Carregamento infinito, erros CSRF, callbacks HTTP e IPs incorretos costumam indicar problemas de cabeçalhos ou confiança no proxy. A confiança padrão do Authentik abrange loopback, redes privadas RFC1918 e endereços link-local; não inclua toda a internet. Ative HSTS para subdomínios somente quando todos os afetados estiverem prontos para HTTPS.
Abra https://sso.example.com. Na instalação nova, acesse o fluxo oficial /if/flow/initial-setup/ e defina uma senha forte para akadmin.
- Crie administradores identificáveis, sem compartilhar
akadminno dia a dia. - Ative TOTP ou WebAuthn/passkeys e preserve os métodos de recuperação.
- Defina Flows e políticas de senha adequados para administradores e usuários.
- Guarde offline as credenciais de um administrador de emergência e teste-o periodicamente.
- Configure marca, e-mail e recuperação de senha; teste a entrega real.
- Mantenha uma lista dos aplicativos dependentes para avaliar interrupções.
Antes de exigir MFA para todos, teste outro administrador e uma janela anônima. Códigos de recuperação, backups e acesso emergencial têm prioridade sobre a aparência do login.
Prefira OIDC/OAuth 2.0 nativo quando houver suporte:
- Crie um OAuth2/OpenID Provider no Authentik.
- Para um aplicativo de servidor, escolha cliente confidencial e gere Client ID e Client Secret. Clientes somente de navegador precisam do fluxo documentado de cliente público/PKCE.
- Cadastre a Redirect URI exata, incluindo protocolo, domínio, caminho e barra final.
- Crie uma Application associada ao Provider.
- Informe Discovery URL, Client ID e Client Secret na configuração de servidor do aplicativo.
- Teste login, logout, e-mail e grupos com um grupo de teste antes de liberar os demais.
Inclua openid; normalmente também são solicitados profile e email. Use o endereço OpenID Configuration/Discovery mostrado pelo Provider, sem adivinhar endpoints. Nunca exponha um Client Secret confidencial no código do navegador.
Para redirect_uri_mismatch, compare o callback real caractere por caractere. Se surgir http:// atrás de HTTPS, corrija cabeçalhos e detecção da URL externa em vez de autorizar esse callback inseguro.
Sem OIDC, SAML ou LDAP, crie um Proxy Provider. No modo proxy completo, o tráfego passa pelo Outpost; com Forward Auth, Caddy, Nginx ou Traefik consulta a decisão e depois acessa diretamente o backend.
- Single application: Provider e política próprios para cada aplicativo; recomendado para isolar acessos.
- Domain level: autenticação compartilhada por vários aplicativos de um domínio, com menos configuração, mas sem políticas independentes por aplicativo nesse modo.
Crie Provider e Application, atribua o Provider ao Embedded Outpost e use o trecho de proxy gerado pela interface atual. Endereço do Outpost, callback e endpoint precisam corresponder à instalação.
Forward Auth decide se a requisição entra; não cria automaticamente um usuário reconhecido pelo backend. Se ele consumir cabeçalhos de usuário, e-mail ou grupos, permita apenas os necessários, substitua valores enviados pelo cliente e bloqueie o acesso direto.
Preserve o banco, .env, compose.yml, data/, certs/ e custom-templates/, além dos overrides e da configuração Caddy.
sudo install -d -m 0700 -o "$USER" -g "$USER" /srv/backups/authentik
cd /opt/authentik
set -a
. ./.env
set +a
BACKUP_FILE="/srv/backups/authentik/authentik-$(date -u +%Y%m%dT%H%M%SZ).dump"
docker compose exec -T postgresql pg_dump \
-U "${PG_USER:-authentik}" \
-d "${PG_DB:-authentik}" \
-Fc > "$BACKUP_FILE"
test -s "$BACKUP_FILE"
docker compose exec -T postgresql pg_restore --list < "$BACKUP_FILE" | head
unset PG_PASS AUTHENTIK_SECRET_KEY PG_USER PG_DB
Arquive configuração e diretórios persistentes:
sudo tar --exclude='*.log' -czf \
"/srv/backups/authentik/files-$(date -u +%Y%m%dT%H%M%SZ).tar.gz" \
-C /opt/authentik .env compose.yml data certs custom-templates
Execute somente a partir de um diretório confiável: carregar o arquivo de ambiente executa sintaxe de shell. Confira montagens e diretórios existentes; um tar com erro não representa backup válido. Suspenda gravações ou reserve manutenção para um ponto consistente entre banco, arquivos e certificados. Preserve a chave secreta original.
Criptografe os backups de identidade, limite leitura, defina retenção e copie-os para fora do host. Listar um dump só verifica leitura, não uma recuperação completa. Em uma máquina isolada com versões compatíveis, restaure configuração e arquivos, inicie PostgreSQL, importe o dump em um banco vazio apropriado e inicie server/worker. Teste login, MFA, OIDC, Outposts e e-mail antes de mudar DNS. Não use o banco de produção para ensaios.
O Authentik não oferece downgrade. Siga cada sequência principal e chegue primeiro ao último patch da sequência atual. Server e todos os Outposts precisam de versões iguais.
cd /opt/authentik
# 先完成数据库和文件备份,再下载新 Compose 到临时文件
curl -fsSLo compose.yml.new https://docs.goauthentik.io/compose.yml
diff -u compose.yml compose.yml.new || true
docker compose -f compose.yml.new config --quiet
mv compose.yml compose.yml.previous
mv compose.yml.new compose.yml
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=200 server worker postgresql
O download do exemplo obtém o Compose mais recente. Antes de substituí-lo, confira se representa o próximo salto permitido, preserve bindings e overrides e leia as instruções de migração PostgreSQL. Trocar a imagem não migra automaticamente uma versão principal do banco.
Não pule sequências nem volte a uma imagem antiga depois de migrar o banco. Para recuperar, restaure banco, segredos e arquivos anteriores em uma instância compatível, após validar esse procedimento isoladamente.
cd /opt/authentik
docker compose config --quiet
docker compose ps
docker compose logs --tail=300 postgresql server worker
Confira .env, PG_PASS e AUTHENTIK_SECRET_KEY, espaço livre, permissões do volume e caminho de atualização.
sudo journalctl -u caddy -n 200 --no-pager
curl -fsSI http://127.0.0.1:9000/
curl -fsSI https://sso.example.com/
Se loopback funciona e o domínio falha, investigue DNS, TLS, WebSocket e cabeçalhos pelo diagnóstico em camadas. Não desative UFW nem exponha 9000 como atalho.
Use um domínio HTTPS externo consistente, Redirect URIs exatas e relógios sincronizados. Verifique logs dos dois sistemas; evite montar fuso horário e usar issuer/callback HTTP em uma instalação HTTPS.
Confira versões, acesso à URL externa, validade do token e conectividade esperada do socket ou proxy. Atualize Outposts junto com o server.
O mínimo oficial é 2 núcleos e 2GB RAM. Para produção pequena, planeje 2–4 vCPU, 4GB RAM e 40GB NVMe; monitore picos, crescimento e duração dos backups.
Ambos oferecem OIDC, SAML e identidade centralizada. Authentik destaca Flows visuais e proxy; Keycloak tem recursos empresariais e realms extensos. Escolha conforme protocolos, organização e experiência.
Não. Vincule a 127.0.0.1, publique 80/443 pelo Caddy e mantenha PostgreSQL 5432 sem exposição.
Sim, com Proxy Provider e Outpost em modo proxy ou Forward Auth. Use Single application quando cada aplicativo precisar de sua política.
Seus privilégios podem permitir controlar o host e ler segredos. Remova a montagem sem necessidade de gestão automática ou avalie um proxy estritamente limitado.
Não há downgrade suportado. Faça backups, avance sequencialmente e recupere a instância compatível completa se necessário.