🚀 小小怪卡密验证系统 Pro

🎯 全新一代卡密验证解决方案 - 正式发布！-完全免费-团队维护更新

当前版本：网页版 v1.0.8 · 桌面版 v1.0.1（2026-07-06）

🔥 采用最新技术栈重构，性能提升300%，用户体验全面升级！

⚠️ 仓库迁移说明：旧版 GitHub 发布地址 xiaoxiaoguai-yyds/xxgkami-pro 已失效，请勿再从此仓库拉取安装脚本或 Releases。
当前新版本仓库与发布地址：xxg-yyds/xxgkami-pro · Releases 下载页

📦 快速部署指南

本项目提供五种灵活的部署方式，满足不同场景的需求。

方式一：Linux 一键脚本安装（推荐 🔥）

适用于 CentOS 7+ / Debian 10+ / Ubuntu 20.04+ 系统，全自动环境配置。

国内服务器（Gitee 源）：

curl -O https://gitee.com/xiaoxiaoguai-yyds/xxgkami-pro/raw/master/install.sh && chmod +x install.sh && sudo ./install.sh

海外服务器（GitHub 源）：

curl -O https://raw.githubusercontent.com/xxg-yyds/xxgkami-pro/refs/heads/master/install.sh && chmod +x install.sh && sudo ./install.sh

脚本功能：

✅ 自动检测网络环境（GitHub/Gitee 源自动切换）
✅ 自动安装 JDK 20, MySQL 8.0, Nginx, Node.js 环境
✅ 自动编译前后端代码并配置 Systemd 开机自启
✅ 自动配置 Nginx 反向代理与静态资源托管

方式二：本地文件部署（编译版）

适用于无法在服务器上编译、或希望直接上传制品快速上线的场景（Linux 服务器 + Nginx，不依赖宝塔面板亦可）。

1. 获取部署文件

编译制品（如 backend.jar、dist.zip 等）可通过以下渠道获取：

渠道	说明
GitHub Releases	https://github.com/xxg-yyds/xxgkami-pro/releases 下载最新发布包
GitHub 仓库	https://github.com/xxg-yyds/xxgkami-pro 查看源码与仓库内附带文件
官方 QQ 群	群号 `1050160397`，群内可获取最新编译包与部署答疑

2. 环境准备

JDK 20+
MySQL 8.0+
Nginx

3. 部署步骤

数据库：导入 kami.sql（或按安装文档初始化），在 application.properties 中配置数据库连接。
后端：上传 backend.jar 至服务器，执行：
```
nohup java -jar backend.jar > backend.log 2>&1 &
```
默认监听 8080，上下文路径为 /api。
前端：将 dist.zip 解压到网站根目录（如 /www/wwwroot/your-domain/）。
Nginx：配置静态站点，并将 API 反向代理到后端（注意 proxy_pass 末尾不要多加 /，以免去掉 /api 前缀）：
```
location /api {
    proxy_pass http://127.0.0.1:8080;
}
```
可参考仓库内 deployment/nginx.conf 与 deployment/README.md。

方式三：宝塔面板部署（编译版）

适用于已有宝塔面板的服务器，使用编译好的制品快速部署。

下载编译制品：从 Releases 下载最新的 backend.jar 和 dist.zip。
后端部署：
- 在宝塔“Java项目”中添加项目。
- 上传 backend.jar，选择 JDK 20。
- 配置端口 8080，并设置数据库连接信息（application.properties）。
前端部署：
- 在宝塔“网站”中添加静态站点。
- 上传并解压 dist.zip 到网站根目录。
- 配置 Nginx 反向代理：
```
location /api {
    proxy_pass http://localhost:8080/api;
}
```

方式四：手动编译部署

适用于开发者或需要深度定制的场景。

前提条件： JDK 20+, Maven 3.8+, Node.js 18+, MySQL 8.0+

克隆代码

git clone https://github.com/xxg-yyds/xxgkami-pro.git
cd xxgkami-pro

后端编译

cd backend
# 修改 src/main/resources/application.properties 中的数据库配置
mvn clean package -DskipTests
java -jar target/backend-0.0.1-SNAPSHOT.jar

前端编译

cd ../
npm install
npm run build
# 构建产物位于 dist/ 目录，可使用 Nginx 进行托管

方式五：Windows 桌面版（Electron）

适用于 Windows 本地一键运行，无需单独部署 Nginx，内置前端静态服务与后端 JAR，适合个人电脑、内网或云桌面场景。

1. 下载安装包

渠道	说明
GitHub Releases	标签 `electron-v1.0.1`，下载 `XXG-KAMI-PRO-Setup-1.0.1.exe`
Gitee Releases	标签 `electron-v1.0.1`，下载 `XXG-KAMI-PRO-Setup-1.0.1.exe`

桌面版版本号与网页业务版独立：当前 桌面版 v1.0.1，内置 网页业务版 v1.0.8。

2. 环境要求

Windows 10 / 11（64 位）
JDK 20+（桌面版启动前自动检测）
MySQL 8.0+（首次运行可在向导中配置连接并在线检测）

3. 使用说明

运行安装程序，按向导完成安装（支持自定义安装目录）。
首次启动：检测 Java / MySQL → 配置数据库连接 → 启动前后端服务。
再次启动：跳过环境检测页，自动静默拉起后端与前端 HTTP 服务（127.0.0.1:5174）。
支持启动时自动检查桌面版更新，下载安装包后可选择覆盖更新或全新安装。

4. 开发者本地打包

# 先编译后端 JAR
cd backend && mvn -DskipTests package && cd ..

# 打包 Windows NSIS 安装程序（输出至 ../xxgkami-electron-release/）
npm run build:electron:safe

产物示例：XXG-KAMI-PRO-Setup-1.0.1.exe

桌面版特性：

✅ 内置 dist 与 backend-0.0.1-SNAPSHOT.jar，离线可用
✅ 独立 CMD 终端显示前后端日志，8080 端口冲突可一键清理
✅ 系统信息页展示桌面版版本与内置业务版本，支持在线更新

📊 功能模块

🎛️ 管理员后台

📈 数据概览 - 实时统计面板，掌控全局数据
🔑 卡密管理 - 批量生成、导出、状态管理，支持多种卡密类型
📋 订单管理 - 订单实时监控、状态跟踪、补单操作
🔌 API管理 - 接口密钥生成、权限控制、WebHook回调配置
⚙️ 系统设置 - 网站信息配置、支付接口对接、邮件通知设置
🛡️ 安全中心 - IP黑白名单、访问日志审计

👤 用户中心

🏠 个人面板 - 账户信息概览、近期活动记录
🛒 购买中心 - 在线选购卡密、支持多种支付方式
📱 卡密验证 - 快速验证卡密有效性、查看使用说明
💰 钱包管理 - 余额充值、消费明细查询
🎫 我的卡密 - 已购卡密历史记录、一键复制

🔌 开发者接口

✅ 卡密验证 API - 标准化 RESTful 接口，轻松集成
📊 状态查询 API - 实时查询卡密状态和剩余次数/时间
🔔 WebHook 回调 - 卡密核销实时推送通知
🛡️ 安全认证 - 支持 API Key 签名认证，保障数据安全

🖥️ Windows 桌面版（Electron）

📦 一键安装 - NSIS 安装包，内置前后端，无需 Nginx
🔧 环境向导 - 首次运行检测 Java 20+ / MySQL 8.0+，支持数据库在线测试
🚀 本地服务 - 前端 HTTP（127.0.0.1:5174）+ 后端 API（8080），独立终端日志
🔄 在线更新 - 启动时检查桌面版更新，支持下载进度与确认安装

🎯 使用场景

💼 软件授权

🖥️ 桌面软件激活
📱 移动应用授权
🎮 游戏道具验证
🔧 插件功能解锁

🎓 在线教育

📚 课程访问控制
🎥 视频观看权限
📝 考试系统验证
🏆 证书颁发管理

💰 电商平台

🎁 优惠券系统
🎪 会员权益管理
🛍️ 限时抢购控制
💎 VIP服务激活

📈 性能对比

功能特性	旧版本	新版本 Pro	提升幅度
🚀 页面加载速度	3.2s	0.8s	300% ⬆️
💾 内存占用	120MB	45MB	62% ⬇️
📊 数据处理能力	1000/s	5000/s	400% ⬆️
🔄 并发支持	100	1000	900% ⬆️
📱 移动端适配	60%	100%	40% ⬆️