密钥管理系统 (License Management System)

现代化License管理系统,支持密钥生成、验证、设备管理等功能

系统截图1

系统截图2

系统截图3

系统特性

系统截图4

系统截图5

📚 文档导航

本系统提供完整的技术文档,按照不同用户角色进行分类:

📖 用户指南

面向最终用户的使用文档:

🔧 开发者指南

面向开发者的技术文档:

⚙️ 管理员指南

面向系统管理员的运维文档:

根据您的需求,快速选择相应的文档:

👤 我是最终用户

想要安装和使用系统

👨‍💻 我是开发者

想要集成API或了解技术细节

👨‍💼 我是系统管理员

想要配置和维护系统

🚀 快速开始

🐳 Docker部署

最新版本部署

# 创建数据目录(持久化)
mkdir -p ${PWD}/license-data

# 设置目录权限(Linux/macOS)
sudo chown -R 1000:1000 ${PWD}/license-data
sudo chmod -R 755 ${PWD}/license-data

# 停止并删除旧容器
docker stop license-management-system
docker rm license-management-system

# 启动容器
docker run -d \
  --name license-management-system \
  --restart unless-stopped \
  -p 3005:3005 \
  -v ${PWD}/license-data:/app/data \
  -e JWT_SECRET="your-super-secret-jwt-key-change-this-in-production" \
  -e LICENSE_SECRET_KEY="your-super-secret-license-key-change-this-in-production" \
  -e PORT="3005" \
  -e NODE_ENV="production" \
  -e DEBUG_MODE="false" \
  -e LOG_LEVEL="warn" \
  zhoujie218/license-management-system:latest

可选环境变量

# 全局请求速率限制:每分钟最多允许 2000 个请求
-e RATE_LIMIT_MAX_REQUESTS="2000" \

# API 接口的请求限制:每分钟最多允许 5000 个 API 请求
-e API_RATE_LIMIT_MAX_REQUESTS="5000" \

# 登录尝试限制:最多允许 20 次失败的登录尝试
-e LOGIN_RATE_LIMIT_MAX_ATTEMPTS="20" \

# 允许的访问来源域名(多个使用英文逗号分隔,无空格)
-e ALLOWED_DOMAINS="https://yourdomain.com,https://www.yourdomain.com" \

# 允许加载的 CDN 链接(多个使用英文逗号分隔)
-e ALLOWED_CDNS="https://cdn.bootcdn.net,https://static.cloudflareinsights.com,https://*.cloudflare.com" \

验证部署

# 使用Docker Compose
docker-compose up -d

# 或使用Docker Hub镜像
docker run -d -p 3005:3005 zhoujie218/license-management-system:latest

访问系统

打开浏览器访问:http://localhost:3005

默认账户

  • 用户名: admin
  • 密码: admin123

🌐 域名配置(重要)

如果您需要部署到自己的域名,请配置以下环境变量:

# 在 .env 文件中添加
ALLOWED_DOMAINS=https://yourdomain.com
ALLOWED_CDNS=https://cdn.bootcdn.net,https://cdn.jsdelivr.net

# 默认cos允许所有域名和cdn

详细配置说明: 请参考用户指南中的部署配置章节。

注意: 如果看到CSP错误(如Cloudflare Insights被阻止),这是正常的。如果系统功能正常,可以忽略这些错误。

🏗️ 技术架构

本系统采用应用-密钥类型架构,已废弃旧的产品-套餐模型:

  • 应用 (Application): 每个密钥必须属于一个应用
  • 密钥类型 (License Type): 每个应用下有多个密钥类型
  • 密钥 (License): 基于应用和密钥类型生成

核心特性

  • ✅ 应用-密钥类型架构
  • ✅ 设备管理策略(宽松期/严格期)
  • ✅ 密钥激活逻辑(首次验证激活)
  • ✅ 批量管理功能(导出、删除、复制)
  • ✅ 用户管理功能
  • ✅ IP地址记录
  • ✅ 速率限制
  • ✅ 暂停/恢复功能
  • ✅ 搜索和过滤功能
  • ✅ 在线备份还原功能
  • ✅ 备份文件管理

📞 支持与反馈

如有问题或建议,请:

  1. 查看对应分类的文档
  2. 提交Issue描述问题
  3. 联系技术支持

相关链接


密钥管理系统 - 让License管理更简单、更高效!