许可证管理仓库镜像

概述

许可证管理仓库镜像是一个用于集中化管理软件许可证的Docker化解决方案，提供许可证全生命周期管理功能，包括创建、存储、分发、验证及过期监控，帮助企业和开发团队高效管控软件授权资源，降低合规风险。

核心功能和特性

许可证存储：支持多种格式（JSON、XML、文本）许可证文件的加密存储，确保数据安全性
分发控制：基于角色和权限的许可证分发机制，支持按团队、项目或用户维度分配
验证接口：提供RESTful API用于第三方应用集成许可证验证，支持在线/离线两种验证模式
生命周期管理：自动跟踪许可证有效期，提供到期预警（邮件/API通知）和过期吊销功能
版本追踪：记录许可证变更历史，支持版本回溯和变更审计
权限管理：基于RBAC（基于角色的访问控制）模型，细化操作权限粒度

使用场景和适用范围

企业软件授权管理：统一管控商业软件、开发工具及内部系统的许可证资源
多团队协作：支持跨部门、跨团队的许可证共享与分配，避免资源闲置和重复采购
开源项目商业化：为开源项目的商业授权版本提供客户许可证管理平台
软件供应商工具：作为B2B软件供应商的客户许可证交付与管理系统

使用方法和配置说明

快速启动

通过以下命令快速部署许可证管理仓库：

bash
docker run -d \
  --name license-repo \
  -p 8080:8080 \
  -v /host/license-data:/app/data \
  -e SPRING_DATASOURCE_URL=jdbc:mysql://mysql-host:3306/license_db \
  -e SPRING_DATASOURCE_USERNAME=admin \
  -e SPRING_DATASOURCE_PASSWORD=SecurePass123! \
  -e JWT_SECRET=your-jwt-signing-key \
  license-repo:latest

环境变量配置

环境变量	描述	可选值	默认值
`SPRING_DATASOURCE_URL`	数据库连接URL（支持MySQL/PostgreSQL）	-	`jdbc:h2:mem:license_db`
`SPRING_DATASOURCE_USERNAME`	数据库用户名	-	`sa`
`SPRING_DATASOURCE_PASSWORD`	数据库密码	-	空
`JWT_SECRET`	JWT令牌签名密钥（生产环境必填）	-	自动生成（重启失效）
`LOG_LEVEL`	日志级别	`DEBUG`, `INFO`, `WARN`, `ERROR`	`INFO`
`MAX_LICENSE_SIZE`	单许可证文件最大体积（MB）	1-100	10
`NOTIFICATION_EMAIL`	许可证到期通知接收***	逗号分隔多个***	空

持久化配置

为确保数据持久化，需挂载数据卷存储许可证文件和配置：

bash
# 创建本地数据目录
mkdir -p /host/license-data/{files,config,logs}

# 带持久化的启动命令
docker run -d \
  --name license-repo \
  -p 8080:8080 \
  -v /host/license-data/files:/app/data/files \
  -v /host/license-data/config:/app/config \
  -v /host/license-data/logs:/app/logs \
  -e SPRING_DATASOURCE_URL=jdbc:mysql://mysql-host:3306/license_db \
  -e SPRING_DATASOURCE_USERNAME=admin \
  -e SPRING_DATASOURCE_PASSWORD=SecurePass123! \
  -e JWT_SECRET=your-permanent-jwt-key \
  -e NOTIFICATION_EMAIL=***,*** \
  license-repo:latest

集成与使用

部署完成后，通过访问 http://<容器IP>:8080 进入Web管理界面，或通过API进行操作：

获取API文档：http://<容器IP>:8080/swagger-ui.html
创建许可证示例（curl）：

bash
curl -X POST "http://<容器IP>:8080/api/v1/licenses" \
  -H "Authorization: Bearer <jwt-token>" \
  -H "Content-Type: application/json" \
  -d '{"name":"IntelliJ IDEA","type":"COMMERCIAL","expireDate":"2024-12-31","assignedTo":"dev-team","content":"<base64-encoded-license-file>"}'

查看更多 adeptia-connect-license 相关镜像 →