ramblurr/authentik

定制版authentik镜像（NFS优化）

镜像概述

本镜像为authentik的定制构建版本，针对NFS（网络文件系统）挂载场景进行了特别优化。authentik是一款开源身份认证与授权平台，提供身份管理、单点登录（SSO）、多因素认证（MFA）等核心功能。本定制版本解决了标准authentik在NFS存储环境下可能存在的权限兼容、挂载稳定性及文件操作适配问题，确保在依赖NFS共享存储时能够稳定运行。

核心功能与特性

• 完整继承authentik核心能力：包含身份管理、用户目录、单点登录（支持SAML、OIDC等协议）、多因素认证、授权策略管理等标准功能
• NFS挂载优化：针对NFS文件系统特性（如权限模型、文件锁定机制、网络延迟）进行适配，提升在NFS存储环境下的运行稳定性
• 兼容性增强：支持主流NFS版本（NFSv3、NFSv4），兼容常见NFS服务器配置（如Synology、TrueNAS、Linux NFS服务）
• 数据持久化支持：通过NFS挂载实现配置文件、证书、用户数据、日志等关键数据的持久化存储，支持多容器实例共享数据

使用场景与适用范围

• 企业级身份认证服务部署，且依赖NFS进行存储资源池化管理
• 多服务器/多节点环境下，需要通过NFS共享authentik配置和用户数据
• 容器化部署架构中，需将敏感数据（如SSL证书、加密密钥）存储在NFS共享卷中
• 对存储灵活性、可扩展性及数据备份有较高要求的authentik实例

使用方法与配置说明

基本部署（docker run）

bash
docker run -d \
  --name custom-authentik \
  -p 80:80 \
  -p 443:443 \
  -v /path/to/nfs/mount:/data \  # NFS挂载点，用于持久化数据
  -e AUTHENTIK_SECRET_KEY="your-strong-secret-key" \
  -e DATABASE_URL="postgres://user:password@db-host:5432/authentik" \
  -e AUTHENTIK_REDIS_URL="redis://redis-host:6379/0" \
  your-registry/custom-authentik:latest

Docker Compose配置示例

yaml
version: '3.8'

services:
  authentik:
    image: your-registry/custom-authentik:latest
    container_name: custom-authentik
    restart: unless-stopped
    ports:
      - "80:80"    # HTTP端口
      - "443:443"  # HTTPS端口
    volumes:
      - /path/to/nfs/mount:/data  # NFS共享卷挂载
    environment:
      - AUTHENTIK_SECRET_KEY=your-strong-secret-key  # 用于加密的密钥，建议至少32字符
      - DATABASE_URL=postgres://user:password@db:5432/authentik  # PostgreSQL数据库连接
      - AUTHENTIK_REDIS_URL=redis://redis:6379/0  # Redis缓存连接
      - AUTHENTIK_LOG_LEVEL=info  # 日志级别：debug/info/warn/error
      - NFS_MOUNT_OPTIONS=vers=4,sec=sys  # NFS挂载选项（可选）
    depends_on:
      - db
      - redis

  db:
    image: postgres:14-alpine
    volumes:
      - postgres-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=authentik

  redis:
    image: redis:alpine
    volumes:
      - redis-data:/data
    command: redis-server --save 60 1 --loglevel warning

volumes:
  postgres-data:
  redis-data:

关键配置参数说明

环境变量

NFS挂载注意事项

• 权限配置：确保NFS共享目录权限允许容器内运行用户（默认UID 1000）读写，可通过chown 1000:1000 /path/to/nfs/mount设置
• NFS版本：推荐使用NFSv4以获得更好的权限处理和性能，NFSv3需注意UID/GID映射配置
• 挂载选项：高并发场景建议添加rsize=1048576,wsize=1048576（增大读写块大小）和async（异步写入）提升性能
• 服务器配置：NFS服务器需允许容器所在主机的IP访问，可通过/etc/exports文件配置（如/path/to/share 192.168.1.0/24(rw,sync,no_root_squash)）

数据持久化路径

容器内/data目录为主要持久化路径，通过NFS挂载后将包含以下关键数据：

• /data/media：用户上传的媒体文件
• /data/certificates：SSL证书和密钥
• /data/config：自定义配置文件
• /data/logs：应用日志文件
• /data/static：静态资源文件

建议定期备份NFS共享目录以防止数据丢失。