Tutoriales de VPS
Authentik en una VPS: OIDC, MFA, HTTPS y recuperación comprobada
Despliegue Authentik con Docker Compose y PostgreSQL, proteja puertos privados con Caddy HTTPS, conecte OIDC y Forward Auth, configure MFA y conserve secretos y datos para actualizaciones y recuperación comprobada.

Cuando aumentan las aplicaciones alojadas en una VPS, la gestión de cuentas suele complicarse antes que los recursos del servidor. Grafana, Gitea y Nextcloud mantienen contraseñas distintas; dar de baja a una persona exige retirar permisos en varios sitios; las aplicaciones antiguas quizá no admitan OIDC. Authentik reúne esos accesos mediante OIDC, SAML o LDAP y permite proteger sitios sin inicio de sesión único con un Proxy Provider.
La guía utiliza Ubuntu 24.04, Docker Compose, PostgreSQL 16 y Caddy. El ejemplo del 15 de septiembre de 2026 partía de Authentik 2026.8.2. La versión oficial consultada el 16 de noviembre es 2026.8.5, cuyo Compose sigue usando PostgreSQL 16 y los servicios server/worker. Revise las notas antes de instalar: la URL de descarga sigue la versión actual y no reproduce automáticamente una instalación anterior.
Es útil para personas y equipos pequeños con varias aplicaciones que necesitan autenticación común, MFA y políticas de acceso:
- Admite OpenID Connect/OAuth 2.0, SAML, LDAP, SCIM y otros protocolos; compruebe los requisitos de edición de cada función.
- Los Flows visuales definen acceso, registro, recuperación de contraseña y MFA.
- En aplicaciones con OIDC nativo funciona como proveedor de identidad.
- Proxy Providers y Outposts protegen aplicaciones sin integración nativa.
- Usuarios, grupos, atributos y políticas determinan el acceso a cada aplicación.
- Desactivar una cuenta impide nuevos accesos autorizados mediante el proveedor conectado.
La desactivación no invalida necesariamente una sesión ya abierta en la aplicación ni un token emitido. Compruebe cierre de sesión, duración de tokens y revocación en cada integración al retirar accesos.
Authentik no es una bóveda para las contraseñas personales de otros sitios. Para una bóveda de equipo independiente, consulte Vaultwarden autoalojado.
| Opción | Ventaja | Mantenimiento | Uso apropiado |
|---|---|---|---|
| Authentik | Administración accesible, protocolos de identidad y Flows flexibles | Conocer server, worker, PostgreSQL y Outposts | Mezcla de OIDC y sitios antiguos |
| Keycloak | Ecosistema OIDC/SAML consolidado, realms, roles y directorios empresariales | Más configuración y planificación de recursos | Identidad organizativa y roles complejos |
| Authelia | Relativamente ligero para sitios detrás de un proxy | Menor alcance como plataforma y catálogo de aplicaciones | Pocos sitios internos, principalmente Forward Auth |
| Basic Auth | Configuración rápida | Sin ciclo de vida común, MFA ni auditoría detallada | Páginas temporales con pocos usuarios y exposición limitada |
Si necesita directorios empresariales o muchos realms y roles, lea la guía de Keycloak. Authentik suele facilitar el comienzo cuando varias aplicaciones Docker necesitan una entrada común.
El recorrido de un nodo es navegador o cliente OIDC → Caddy HTTPS → Authentik server/worker → PostgreSQL en la red privada de Docker:
浏览器 / OIDC 应用
|
| HTTPS :443
v
Caddy
|
| HTTP 127.0.0.1:9000
v
Authentik server + worker
|
| Docker 内部网络 :5432
v
PostgreSQL 16
El método oficial Compose está destinado a pruebas y producción pequeña, con un mínimo de 2 núcleos y 2GB de RAM. Ese mínimo deja poco margen si PostgreSQL, Caddy, workers y copias comparten servidor.
| Carga | VPS orientativa | Límite práctico |
|---|---|---|
| Pruebas, menos de 10 usuarios | 2 vCPU, 2GB RAM, 25GB SSD | Validación funcional, no acceso crítico |
| Equipo pequeño, decenas o cientos de usuarios | 2–4 vCPU, 4GB RAM, 40GB NVMe | Reservar margen para datos y actualizaciones |
| Picos de acceso o muchas aplicaciones | 4 vCPU, al menos 8GB RAM | Medir antes de separar la base de datos o añadir nodos |
Son estimaciones de planificación, no garantías de capacidad medida. Una sola VPS es un punto único de fallo. Prepare copias externas, accesos de emergencia propios de las aplicaciones cuando existan, un administrador de emergencia y una recuperación ensayada.
Utilice un nombre dedicado, como sso.example.com. Dirija el registro A a la IPv4 pública; añada AAAA únicamente si IPv6 funciona realmente.
Permita SSH, HTTP y HTTPS:
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status verbose
No abra 9000, 9443 ni 5432 en UFW o en el grupo de seguridad. Los puertos web se vinculan a 127.0.0.1 y PostgreSQL no publica puerto en el host. Verifique también los puertos publicados por Docker: las reglas UFW por sí solas no demuestran aislamiento. Si pierde SSH, use la consola del proveedor y la recuperación de un bloqueo de UFW.
Instale primero Docker Engine y el complemento Compose v2 con las instrucciones oficiales para Ubuntu. Instalar Caddy y consultar la versión de Docker no instala Docker. Revise las actualizaciones de paquetes y cualquier reinicio antes de convertir el servidor en la entrada del equipo.
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 y configure rotación de logs, supervisión y ejercicios de recuperación con la lista de preparación para producción.
Cree el directorio y restrinja los permisos de los archivos nuevos:
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
La descarga oficial fija la versión vigente en ese momento. Mantenga una versión auditable; no cambie la etiqueta por latest. Si falla la descarga documental, obtenga y revise el Compose de la misma versión oficial, sin sustituirlo por un instalador externo sin verificar.
Genere la contraseña de PostgreSQL y la clave de identidad, con ambos puertos web vinculados a 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
Estos comandos son para una instalación nueva: sobrescriben el archivo de entorno. No regenere los secretos de una instancia existente. No publique .env en Git, chats o incidencias. La salida completa de docker compose config expande los secretos; use --quiet para validar la sintaxis.
El worker monta por defecto /var/run/docker.sock para administrar Outposts. El socket puede permitir controlar el host. Elimine el montaje si administra los Outposts manualmente o evalúe un Docker Socket Proxy limitado a las operaciones necesarias y accesible solo desde el worker.
No monte /etc/timezone ni /etc/localtime en los contenedores. Authentik utiliza UTC internamente; esos montajes pueden alterar comprobaciones OAuth, SAML y certificados. Mantenga sincronizado el reloj de la VPS por separado.
Descargue las imágenes fijadas e inicie los servicios:
cd /opt/authentik
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=200 server worker postgresql
Compruebe las direcciones de escucha:
ss -lnt | grep -E ':9000|:9443'
curl -fsSI http://127.0.0.1:9000/
La salida de ss debe mostrar 127.0.0.1:9000 y 127.0.0.1:9443, nunca 0.0.0.0 ni [::]. Confirme también la exposición desde fuera. Ante reinicios constantes, revise salud de PostgreSQL y logs de server/worker; modificar restart no soluciona la causa.
Edite /etc/caddy/Caddyfile y sustituya el dominio de ejemplo:
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 y recargue:
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -fsSI https://sso.example.com/
El proxy debe admitir HTTP/1.1 y WebSocket, conservar Host y gestionar correctamente X-Forwarded-Host, X-Forwarded-Proto, X-Forwarded-For, Connection y Upgrade. La directiva reverse_proxy de Caddy gestiona la transmisión habitual y WebSocket. Impida el acceso directo al puerto 9000.
Con Nginx Proxy Manager, siga la guía de HTTPS y proxy inverso y active WebSocket. Carga infinita, errores CSRF, callbacks HTTP o IP incorrecta suelen apuntar a cabeceras o confianza en el proxy. Authentik confía por defecto en loopback, redes privadas RFC1918 y direcciones link-local; no añada todo Internet a la confianza. Active HSTS para subdominios solo cuando todos los afectados admitan HTTPS.
Abra https://sso.example.com. En una instalación nueva, entre en el flujo oficial /if/flow/initial-setup/ y establezca una contraseña fuerte para akadmin.
- Cree administradores identificables, sin compartir
akadminen el trabajo diario. - Active TOTP o WebAuthn/passkeys y conserve los métodos de recuperación.
- Defina Flows y políticas de contraseña adecuados para administradores y usuarios.
- Guarde fuera de línea las credenciales de un administrador de emergencia y pruébelo periódicamente.
- Configure marca, correo y recuperación de contraseña; verifique el envío real.
- Mantenga una relación de las aplicaciones dependientes para valorar una interrupción.
Antes de exigir MFA a todos, pruebe otro administrador y una sesión privada del navegador. Los códigos de recuperación, copias y accesos de emergencia tienen prioridad sobre la apariencia del login.
Prefiera OIDC/OAuth 2.0 nativo cuando la aplicación lo admita:
- Cree un OAuth2/OpenID Provider en Authentik.
- Para una aplicación de servidor, seleccione cliente confidencial y genere Client ID y Client Secret. Los clientes exclusivamente de navegador necesitan su flujo documentado de cliente público/PKCE.
- Añada la Redirect URI exacta: esquema, dominio, ruta y barra final.
- Cree una Application vinculada al Provider.
- Introduzca la Discovery URL mostrada, Client ID y Client Secret en la configuración de servidor de la aplicación.
- Pruebe acceso, salida, correo y grupos con un grupo de pruebas antes de habilitar al resto.
Incluya openid; suelen solicitarse también profile y email. Use la dirección OpenID Configuration/Discovery del Provider, sin adivinar los endpoints. Un Client Secret confidencial no debe llegar al código del navegador.
Ante redirect_uri_mismatch, compare el callback real carácter por carácter. Si aparece http:// detrás de HTTPS, corrija las cabeceras y la detección de URL externa en lugar de autorizar ese callback inseguro.
Cuando no haya OIDC, SAML o LDAP, cree un Proxy Provider. El modo proxy completo transmite el tráfico por el Outpost; Forward Auth permite que Caddy, Nginx o Traefik consulte la decisión de acceso y después contacte directamente con el backend.
- Single application: Provider y política propios por aplicación; recomendado para separar accesos.
- Domain level: autenticación compartida para varias aplicaciones de un dominio, con menos configuración pero sin políticas independientes por aplicación en ese modo.
Cree Provider y Application, asigne el Provider al Embedded Outpost y utilice el fragmento de proxy generado por la interfaz actual. Dirección del Outpost, callback y endpoint de autenticación deben corresponder a la instalación.
Forward Auth decide si entra la solicitud; no crea automáticamente un usuario reconocido por el backend. Si este consume cabeceras de usuario, correo o grupos, permita solo las necesarias, sobrescriba valores enviados por clientes y cierre el acceso directo.
Conserve la base de datos, .env, compose.yml, data/, certs/ y custom-templates/, además de overrides y configuración de 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
Archive configuración y directorios 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
Ejecute los comandos únicamente desde un directorio fiable: cargar el archivo de entorno ejecuta sintaxis de shell. Revise montajes y existencia de directorios; un tar fallido no constituye una copia válida. Detenga escrituras o reserve mantenimiento si necesita un punto coherente entre datos, archivos y certificados. Preserve la clave secreta original.
Cifre las copias de identidad, limite lectura, defina retención y cópielas fuera del host. Enumerar un dump solo demuestra que se puede leer, no que se restaura bien. En un servidor aislado y con versiones compatibles, restaure configuración y archivos, inicie PostgreSQL, importe el dump en una base vacía apropiada y arranque server/worker. Compruebe acceso, MFA, OIDC, Outposts y correo antes de cambiar DNS. No utilice la base de producción para ensayar.
Authentik no admite downgrades. Siga cada secuencia principal y llegue primero al último parche de la secuencia actual. Server y todos los Outposts deben tener versiones coincidentes.
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
La descarga del ejemplo obtiene el Compose más reciente. Antes de reemplazarlo, compruebe que representa el siguiente salto permitido, conserve bindings y overrides y lea los requisitos de migración PostgreSQL. Cambiar la imagen no migra por sí solo una versión principal de la base.
No salte secuencias ni vuelva a una imagen antigua tras migrar la base. Para recuperar, restaure base, secretos y archivos anteriores en una instancia compatible, después de verificar ese procedimiento por separado.
cd /opt/authentik
docker compose config --quiet
docker compose ps
docker compose logs --tail=300 postgresql server worker
Compruebe .env, PG_PASS y AUTHENTIK_SECRET_KEY, espacio libre, permisos del volumen y ruta de actualización.
sudo journalctl -u caddy -n 200 --no-pager
curl -fsSI http://127.0.0.1:9000/
curl -fsSI https://sso.example.com/
Si loopback funciona y el dominio falla, revise DNS, TLS, WebSocket y cabeceras mediante el diagnóstico por capas. No desactive UFW ni publique 9000 como atajo.
Use un dominio HTTPS externo consistente, Redirect URI exactas y relojes sincronizados. Revise logs de ambos sistemas; evite montajes de zona horaria e issuers/callbacks HTTP en un despliegue HTTPS.
Revise coincidencia de versiones, acceso a la URL externa, validez del token y conectividad esperada del socket o proxy. Actualice los Outposts junto con server.
El mínimo oficial es 2 núcleos y 2GB de RAM. Para producción pequeña, planifique 2–4 vCPU, 4GB RAM y 40GB NVMe; mida picos de acceso, crecimiento y duración de las copias.
Ambos ofrecen OIDC, SAML e identidad centralizada. Authentik destaca por Flows visuales y proxy; Keycloak dispone de amplias capacidades empresariales y realms. Decida según protocolos, organización y experiencia.
No: vincúlelos a 127.0.0.1, publique 80/443 mediante Caddy y mantenga PostgreSQL 5432 sin exposición.
Sí, con Proxy Provider y Outpost en modo proxy o Forward Auth. Use Single application si cada aplicación necesita su propia política.
Sus permisos pueden permitir controlar el host y leer secretos. Elimine el montaje cuando no necesite gestión automática o evalúe un proxy estrictamente limitado.
No existe downgrade admitido. Prepare copias, avance secuencialmente y recupere la instancia compatible completa si resulta necesario.