aguacongas/theidserver.duende Docker 镜像 - 轩辕镜像

TheIdServer 镜像文档

镜像概述

TheIdServer 是一个基于 Duende IdentityServer 构建的身份认证与授权服务器，支持 OpenID/Connect、OAuth2 和 WS-Federation 协议。该镜像提供了完整的身份服务解决方案，包含管理界面和后端服务，适用于构建企业级身份认证系统。

注意：商业用途需 获取 Duende IdentityServer 许可证。

核心功能与特性

管理应用（Admin App）

提供直观的 Web 管理界面，支持以下功能：

• 用户管理：创建、编辑、删除用户，分配角色和权限
• 角色管理：定义角色及权限，实现基于角色的访问控制（RBAC）
• 客户端管理：配置 OAuth2/OpenID Connect 客户端应用
• API 管理：注册和管理受保护的 API 资源
• API 作用域管理：定义 API 的访问作用域（Scopes）
• 身份资源管理：配置 OpenID Connect 身份资源（如用户信息字段）
• 信赖方管理：配置 WS-Federation 信赖方应用
• 外部身份提供者管理：集成第三方身份提供者（如 Google、***）
• 本地化支持：多语言界面配置
• 配置导入/导出：备份或迁移系统配置
• 密钥管理：管理用于令牌签名和加密的密钥

服务器（Server）

• 多协议支持：完整实现 OpenID/Connect、OAuth2 和 WS-Federation 协议
• 多数据库支持：可对接 SQL Server、PostgreSQL、MySQL 等主流数据库
• 动态外部提供者配置：无需重启服务即可配置第三方身份提供者
• 公私网部署支持：支持公网暴露或内网私有部署模式
• Docker 化部署：提供官方 Docker 镜像，支持容器化部署
• 声明提供者：自定义用户声明的生成逻辑
• 外部声明映射：将第三方身份提供者的声明映射到本地用户声明
• 动态客户端注册：支持 OpenID Connect 动态客户端注册协议
• 过期令牌自动清理：自动删除过期的访问令牌、刷新令牌等
• 密钥轮换：支持签名密钥的自动/手动轮换，增强安全性

使用场景与适用范围

• 企业级身份认证服务：为企业内部系统提供统一的用户认证和授权
• 第三方应用授权：允许第三方应用通过 OAuth2/OpenID Connect 获取用户授权
• 多协议兼容场景：同时支持现代应用（OpenID Connect）和传统应用（WS-Federation）
• SaaS 应用身份集成：作为 SaaS 平台的统一身份服务，支持多租户配置
• DevOps 环境快速部署：通过 Docker 快速搭建开发、测试或生产环境的身份服务

使用方法与配置说明

Docker 快速部署

1. 直接运行 Docker 容器

使用默认配置（内存数据库，仅用于测试）：

bash
docker run -d -p 5000:80 -p 5001:443 --name theidserver aguacongas/theidserver.duende:latest

访问 https://localhost:5001 即可打开管理界面，默认登录信息：

• 用户名：alice
• 密码：Pass123$

2. 连接外部数据库（生产环境）

以 SQL Server 为例，指定数据库连接字符串：

bash
docker run -d -p 5000:80 -p 5001:443 \
  --name theidserver \
  -e DATABASE_PROVIDER=SqlServer \
  -e CONNECTION_STRING="Server=sqlserver;Database=TheIdServer;User Id=sa;Password=YourStrong!Passw0rd;TrustServerCertificate=True" \
  -e DUENDE_LICENSE_KEY="your-duende-license-key" \
  aguacongas/theidserver.duende:latest

3. Docker Compose 部署（含数据库）

创建 docker-compose.yml：

yaml
version: '3.8'

services:
  theidserver:
    image: aguacongas/theidserver.duende:latest
    ports:
      - "5000:80"
      - "5001:443"
    environment:
      - DATABASE_PROVIDER=SqlServer
      - CONNECTION_STRING=Server=sqlserver;Database=TheIdServer;User Id=sa;Password=YourStrong!Passw0rd;TrustServerCertificate=True
      - DUENDE_LICENSE_KEY=your-duende-license-key
      - ASPNETCORE_ENVIRONMENT=Production
    depends_on:
      - sqlserver
    restart: unless-stopped

  sqlserver:
    image: mcr.microsoft.com/mssql/server:latest
    environment:
      - SA_PASSWORD=YourStrong!Passw0rd
      - ACCEPT_EULA=Y
    ports:
      - "1433:1433"
    volumes:
      - sqlserver-data:/var/opt/mssql
    restart: unless-stopped

volumes:
  sqlserver-data:

启动服务：

bash
docker-compose up -d

关键环境变量配置

数据库配置

根据 DATABASE_PROVIDER 选择对应的连接字符串格式：

• SQL Server：Server=host;Database=dbname;User Id=user;Password=pass;TrustServerCertificate=True
• PostgreSQL：Host=host;Database=dbname;Username=user;Password=pass
• MySQL：Server=host;Database=dbname;Uid=user;Pwd=pass;SslMode=None
• SQLite：Data Source=/data/theidserver.db（容器内路径，建议挂载数据卷）

从源码构建

如需自定义镜像，可从源码构建：

bash
# 克隆仓库
git clone [***]
cd TheIdServer

# 构建 Duende 版本镜像
docker build -t aguacongas/theidserver.duende:dev -f "./src/Aguacongas.TheIdServer.Duende/Dockerfile" .

# 构建管理应用镜像（前端）
docker build -t aguacongas/theidserverapp:dev -f "./src/Aguacongas.TheIdServer.BlazorApp/Dockerfile" .

贡献与支持

贡献代码

欢迎通过以下方式贡献：

• 提交 Issue 反馈问题或建议
• 提交 Pull Request 修复 bug 或新增功能

请先阅读 贡献指南 和 行为准则。

赞助支持

如果该项目对您有帮助，欢迎通过以下方式赞助：

• GitHub Sponsor

• ---

• IssueHunt

演示环境

可访问官方演示环境体验功能：
[***]
登录信息：用户名 alice，密码 Pass123$（基于内存数据库，数据会定期重置）。