beryju/authentik

authentik Docker镜像文档

概述

authentik是一个开源的身份验证和授权服务，提供企业级身份管理功能。该Docker镜像提供了一种简单、快速部署authentik服务的方式，无需复杂的系统配置即可实现强大的身份验证解决方案。

核心功能与特性

• 单点登录(SSO)支持，兼容SAML 2.0、OAuth 2.0/OpenID Connect
• 多因素认证(MFA)，包括TOTP、WebAuthn等多种验证方式
• 自定义流程和策略，支持复杂的身份验证规则
• 直观的管理界面，简化用户和权限管理
• API优先设计，方便与其他系统集成
• 审计日志和事件跟踪，满足合规要求
• 支持用户自助服务门户

使用场景

• 企业内部应用的单点登录解决方案
• 保护内部和外部应用程序的访问安全
• 实现集中式用户身份管理
• 满足合规性要求的身份验证系统
• 为开发团队提供快速集成的认证服务

快速开始

基本部署

使用以下命令快速启动authentik服务：

bash
docker run -d \
  --name authentik \
  -p 80:80 \
  -p 443:443 \
  -v ./data:/data \
  authentik/server:latest

使用Docker Compose部署

推荐使用docker-compose进行部署，创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  postgresql:
    image: postgres:14
    volumes:
      - postgres_data:/var/lib/postgresql/data
    environment:
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_USER=postgres
      - POSTGRES_DB=authentik

  redis:
    image: redis:alpine
    volumes:
      - redis_data:/data

  server:
    image: authentik/server:latest
    restart: unless-stopped
    depends_on:
      - postgresql
      - redis
    volumes:
      - ./media:/media
      - ./custom-templates:/templates
    environment:
      - AUTHENTIK_REDIS__HOST=redis
      - AUTHENTIK_POSTGRESQL__HOST=postgresql
      - AUTHENTIK_POSTGRESQL__USER=postgres
      - AUTHENTIK_POSTGRESQL__PASSWORD=postgres
      - AUTHENTIK_POSTGRESQL__NAME=authentik
      - AUTHENTIK_SECRET_KEY=change_this_to_a_random_string
      - AUTHENTIK_ERROR_REPORTING__ENABLED=true
    ports:
      - "9000:9000"

  worker:
    image: authentik/server:latest
    restart: unless-stopped
    command: worker
    depends_on:
      - postgresql
      - redis
    volumes:
      - ./media:/media
      - ./custom-templates:/templates
    environment:
      - AUTHENTIK_REDIS__HOST=redis
      - AUTHENTIK_POSTGRESQL__HOST=postgresql
      - AUTHENTIK_POSTGRESQL__USER=postgres
      - AUTHENTIK_POSTGRESQL__PASSWORD=postgres
      - AUTHENTIK_POSTGRESQL__NAME=authentik
      - AUTHENTIK_SECRET_KEY=change_this_to_a_random_string
      - AUTHENTIK_ERROR_REPORTING__ENABLED=true

volumes:
  postgres_data:
  redis_data:

启动服务：

bash
docker-compose up -d

配置说明

环境变量

authentik支持多种环境变量配置，主要包括：

• AUTHENTIK_SECRET_KEY: 用于加密的密钥，必须设置为随机字符串
• AUTHENTIK_POSTGRESQL__*: PostgreSQL数据库连接配置
• AUTHENTIK_REDIS__*: Redis连接配置
• AUTHENTIK_LOG_LEVEL: 日志级别，默认为info
• AUTHENTIK_ERROR_REPORTING__ENABLED: 是否启用错误报告

持久化数据

为确保数据持久化，需要挂载以下目录：

• /media: 存储用户上传的文件
• /templates: 自定义模板文件

访问与使用

服务启动后，可通过以下地址访问：

• 管理界面: http://<your-server-ip>:9000/if/admin/
• 用户界面: http://<your-server-ip>:9000/

初始管理员凭据：

• 用户名: akadmin
• 密码: 首次启动时在容器日志中显示，或通过docker-compose logs server | grep "Initial Admin Password"命令查看

更多信息

完整文档和详细配置选项，请访问官方网站：

• authentik官方文档
• https://hub.docker.com/u/authentik
• https://github.com/goauthentik/authentik