# 卡密验证系统

**Repository Path**: kaxio_admin/camkey-verification-system

## Basic Information

- **Project Name**: 卡密验证系统
- **Description**: 一个非常好用的卡密验证系统、docker一键安装
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-09-07
- **Last Updated**: 2026-09-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CDKey 卡密管理系统

> 开源、轻量、Docker 一键部署的卡密（CDKey）管理平台。

## 功能特性

- **项目分类管理**：支持项目 → 子类 → 标签三级结构
- **批量生成卡密**：前缀格式 `项目-子类-标签-随机后缀`，后缀长度自定义
- **卡密生命周期**：未使用 / 已使用 / 已过期 三种状态
- **验证与查询**：API 验证卡密有效性，根据卡密反查用户信息
- **RESTful API**：完整的 API 接口，方便对接业务系统
- **Docker 一键部署**：`docker-compose up -d` 即可运行

## 快速开始

### 1. 克隆仓库

```bash
git clone https://gitee.com/gaohaibin005/camkey-verification-system.git
cd camkey-verification-system
```

### 2. Docker 一键部署

```bash
docker-compose up -d
```

访问 http://localhost:5000 即可使用。

### 3. 手动运行（开发环境）

```bash
# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

# 运行
python app.py
```

## 项目结构

```
cdkey-system/
├── app.py              # Flask 主应用
├── config.py           # 配置文件
├── models.py           # 数据库模型
├── requirements.txt    # Python 依赖
├── Dockerfile          # Docker 镜像
├── docker-compose.yml  # Docker Compose
├── routes/
│   ├── __init__.py
│   ├── keys.py         # 卡密 API
│   ├── projects.py     # 项目 API
│   └── auth.py         # 认证中间件
├── utils/
│   └── helpers.py      # 工具函数
├── static/
│   └── index.html      # 前端管理页面
└── README.md
```

## API 文档

基础地址：`/api/v1`

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/keys/validate` | 验证卡密是否有效 |
| POST | `/keys/use` | 使用卡密 |
| GET | `/keys/info?key=xxx` | 查询卡密信息 |
| POST | `/keys/generate` | 批量生成卡密 |
| GET | `/keys` | 卡密列表（分页、筛选） |
| DELETE | `/keys/<id>` | 删除卡密 |
| POST | `/keys/batch-delete` | 批量删除 |
| GET | `/keys/stats` | 统计信息 |
| GET | `/projects` | 项目列表 |
| POST | `/projects` | 创建项目 |

### 验证卡密

```bash
curl -X POST http://localhost:5000/api/v1/keys/validate \
  -H "Content-Type: application/json" \
  -d '{"key": "项目A-子类1-标签X-aB3dEfGhIjKl"}'
```

### 使用卡密

```bash
curl -X POST http://localhost:5000/api/v1/keys/use \
  -H "Content-Type: application/json" \
  -d '{"key": "xxx", "user": "user@example.com"}'
```

### 批量生成

```bash
curl -X POST http://localhost:5000/api/v1/keys/generate \
  -H "Content-Type: application/json" \
  -d '{
    "project": "项目A",
    "subclass": "子类1",
    "tag": "标签X",
    "count": 10,
    "length": 12,
    "days": 30
  }'
```

## 环境变量

| 变量 | 说明 | 默认值 |
|------|------|--------|
| `SECRET_KEY` | Flask 密钥 | `dev-secret-key` |
| `DATABASE_URL` | 数据库连接 | `sqlite:///data/cdkey.db` |
| `API_KEY` | API 认证密钥（可选） | 无 |

## 技术栈

- **后端**：Python 3.11 + Flask + SQLAlchemy + Gunicorn
- **数据库**：SQLite（默认，零配置）/ 可切换 PostgreSQL / MySQL
- **前端**：原生 HTML/CSS/JS（无构建依赖）
- **部署**：Docker + Docker Compose

## 开源协议

MIT License