staugur/passportd repository overview
passportd
认证、授权、统一登录 — 基于 Flask 的 SSO 单点登录服务。
核心功能
- 本地账号系统：支持用户名、手机号、邮箱注册与登录
- OAuth2 第三方登录：内置 GitHub 和 Gitee OAuth2 登录插件
- OpenID Connect Provider：支持 OIDC Server 模式，可作为独立 SSO 服务
- 插件扩展：基于 Flask-PluginKit 的插件架构，方便扩展更多登录方式
- 多数据库支持：SQLite（开发） / MySQL / PostgreSQL（生产）
- JWT 认证：支持 HMAC-SHA256 和 RS256 双算法 JWT 签名
- RESTful API：提供完整的注册、登录、用户信息、OIDC 客户端管理接口
快速开始
pip 安装
# 安装
pip install passportd
# 确保 Redis 已启动
# 启动
passportd run
访问 http://localhost:10030/ 即可看到登录页面。
Docker 运行
# 拉取镜像
docker pull staugur/passportd:latest
# 启动容器（需要先启动 Redis）
docker run -d \
--name passportd \
-p 10030:10030 \
-e PASSPORT_REDIS_URI="redis://:pwd@redis:6379/0" \
-e PASSPORT_DB_URI="sqlite:///app/data/passportd.db" \
-e PASSPORT_ENV="production" \
-v passportd-data:/app/data \
staugur/passportd:latest
也可以通过 docker-compose.yml 一键启动（包含 Redis）：
version: "3.8"
services:
redis:
image: redis:7-alpine
restart: unless-stopped
volumes:
- redis-data:/data
passportd:
image: staugur/passportd:latest
restart: unless-stopped
ports:
- "10030:10030"
environment:
- PASSPORT_ENV=production
- PASSPORT_REDIS_URI=redis://redis:6379/0
- PASSPORT_DB_URI=sqlite:///app/data/passportd.db
volumes:
- passportd-data:/app/data
depends_on:
- redis
volumes:
redis-data:
passportd-data:
文档
完整文档请访问 passportd.readthedocs.io
本地构建文档：
pip install -r requirements/docs.txt
cd docs && make html
许可证
Apache License 2.0
备注
沿用 1.x 设计思路，使用 OIDC 标准协议重构实现，除核心代码外大部分使用 AI 生成。
Tag summary
Content type
Image
Digest
sha256:93bb1ece0…
Size
74 MB
Last updated
24 days ago
docker pull staugur/passportd