esutwo/privacyidea

PrivacyIdea Docker镜像

https://github.com/esutwo/privacyidea-docker

该镜像用于打包PrivacyIdea，因官方未提供官方镜像，旨在简化PrivacyIdea的部署流程。

镜像概述和主要用途

PrivacyIdea是一款开源多因素认证系统，支持TOTP、HOTP、YubiKey等多种令牌类型。本Docker镜像为非官方打包版本，解决官方镜像缺失问题，提供容器化部署方案，适用于企业级身份验证、开发测试及小型团队认证管理场景。

核心功能和特性

• 环境变量配置：核心参数（如数据库连接、加密密钥）通过环境变量灵活配置，无需手动修改配置文件
• 持久化存储：支持挂载/pi/mnt目录，持久化存储数据库文件、加密密钥和审计日志密钥
• 数据库兼容性：默认使用SQLite，可通过DATABASE_URI配置MySQL等外部数据库
• 自动文件生成：缺失时自动生成加密令牌文件(PI_ENCFILE)和审计日志密钥对(PI_AUDIT_KEY_PRIVATE/PII_AUDIT_KEY_PUBLIC)
• 调试支持：通过DEBUG变量启用调试日志和测试服务器，便于问题排查
• 数据库等待机制：设置DB_CHECK=True可循环等待数据库服务上线

使用场景和适用范围

• 企业内部认证：部署多因素认证系统保护敏感系统访问
• 开发测试环境：快速搭建PrivacyIdea测试环境，验证功能和集成兼容性
• 小型部署场景：简化安装维护流程，适合对部署复杂度敏感的小型团队

详细使用方法和配置说明

构建与运行容器

构建镜像

bash
docker build -t privacyidea:latest .

启动容器

bash
docker run --rm -it -v $(pwd)/data:/pi/mnt \
           -e SECRET_KEY='your_unique_secret' \
           -e PI_PEPPER='your_unique_pepper' \
           -p 8000:8000 \
           privacyidea:latest

• -v $(pwd)/data:/pi/mnt：挂载本地目录至容器，持久化存储数据
• -e SECRET_KEY/PI_PEPPER：加密密钥，建议使用唯一且高强度值
• -p 8000:8000：映射端口，访问Web界面（http://localhost:8000）

创建管理员用户

容器运行后，通过以下命令创建管理员：

bash
docker exec -it privacyidea /opt/privacyidea/bin/pi-manage admin <用户名> -p <密码>

示例（创建用户bob，密码bobspwd）：

bash
docker exec -it privacyidea /opt/privacyidea/bin/pi-manage admin bob -p bobspwd

环境变量配置

高级配置示例

连接MySQL数据库

bash
docker run --rm -it -v $(pwd)/data:/pi/mnt \
           -e SECRET_KEY='secure_key' \
           -e PI_PEPPER='secure_pepper' \
           -e DATABASE_URI='mysql+pymysql://user:pass@mysql-host:3306/privacyidea?charset=utf8' \
           -e DB_CHECK=True \
           -p 8000:8000 \
           privacyidea:latest

启用调试模式

bash
docker run --rm -it -v $(pwd)/data:/pi/mnt \
           -e DEBUG=True \
           -p 8000:8000 \
           privacyidea:latest