小小怪卡密验证系统 Pro

全新一代卡密验证解决方案，完全免费开源。本教程将带你从零完成系统部署与使用。

视频教程

跟随视频一步步完成小小怪卡密的安装与配置。

若视频无法播放，请前往 B 站观看： BV1Hs766FE4j

环境要求

部署前请确认服务器满足以下条件。

工作流教程

以下流程基于宝塔面板部署，按顺序完成即可上线小小怪卡密系统。

安装宝塔面板

在服务器上安装宝塔面板，作为后续部署的管理入口。

1. 安装宝塔 前往 宝塔官网 获取对应系统的安装命令，在服务器终端执行并完成初始化。
2. 登录面板 安装完成后记录面板地址、用户名与密码，通过浏览器登录宝塔面板。

环境准备

登录宝塔面板后，在「软件商店」中安装以下组件。

• Java — 必须安装 JDK 17 或更高版本（推荐 JDK 20）
• MySQL — 8.0 或 5.6 及以上（MariaDB 请选择 5.6+ 兼容）
• Nginx — 用于反向代理与静态资源托管
• Redis — 用于缓存
• Node.js — 如需自行构建前端时安装

获取安装包

可通过 QQ 群文件或开源仓库两种方式获取部署文件。

方式一：群文件下载

加入官方 QQ 群 1050160397，在群文件中下载最新安装包（含 dist.zip 与后端 jar 包）。

点击按钮一键加群

方式二：开源仓库下载

在 Releases 页面可直接下载编译好的 dist.zip 与 backend-0.0.1-SNAPSHOT.jar。国内用户推荐 Gitee，海外用户推荐 GitHub。

上传与解压

将前端与后端文件上传至服务器对应目录。

1. 上传 dist.zip 在宝塔「文件」管理中，进入网站根目录（如 /www/wwwroot/你的域名/），上传 dist.zip 并解压。
2. 上传后端 Jar 将 backend-0.0.1-SNAPSHOT.jar（或重命名后的 xxgkami-pro.jar）上传至服务器，建议放在独立目录便于管理。

编辑 Jar 配置

修改后端 Jar 包内的数据库等连接配置。

1. 用压缩软件打开 Jar Jar 本质是 zip 格式，使用 WinRAR、7-Zip 等工具直接打开 backend-0.0.1-SNAPSHOT.jar，无需先解压整个文件。
2. 编辑配置文件 找到并编辑路径：

   BOOT-INF\classes\application.properties

   配置 MySQL 数据库连接、Redis 地址等参数，保存后关闭压缩软件（会自动更新 Jar 内文件）。数据库版本支持 MySQL 8.0 或 5.6+，具体导入方式可在首次访问时的系统初始化向导中选择。
3. 手动导入（可选） 若跳过向导，也可在 MySQL 中手动创建数据库并导入 kami.sql。使用 MySQL 5.6 / MariaDB 时，系统会在初始化时自动转译为兼容脚本。

添加 Java 项目

在宝塔面板中创建 SpringBoot 项目并启动后端服务。

1. 进入 Java 项目管理 在宝塔左侧菜单点击「网站」→「Java 项目」。
2. 添加 Java 项目 点击「添加 Java 项目」，按以下参数填写：

确认无误后点击「提交」，等待项目启动成功。

配置 Nginx 反向代理

为网站添加 API 反向代理，使前端能正常访问后端接口。

1. 打开网站配置 在宝塔「网站」中找到您的站点，点击「设置」→「配置文件」。
2. 定位插入位置 找到如下静态资源缓存配置块：

   location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
   {
       expires      30d;
       error_log /dev/null;
       access_log /dev/null;
   }

3. 在其下方添加 API 代理

   location /api/ {
       proxy_pass http://127.0.0.1:8080/api/;
       proxy_set_header Host $host;
       proxy_set_header X-Real-IP $remote_addr;
       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
   
       # 禁用缓存，防止 API 数据不刷新
       add_header Cache-Control "no-cache, no-store";
   }

4. 保存并生效 点击「保存」，Nginx 会自动重载配置。访问您的域名，首次打开将进入系统初始化向导完成数据库配置。

系统初始化

前后端部署完成并访问站点后，首次打开会进入「系统初始化向导」。向导将自动检测运行环境并完成数据库配置，完成后不再显示本页。

环境自动检测

向导第一步会自动检测当前服务器环境，无需手动填写。

检测项包括：

数据库版本选择

第二步根据实际安装的 MySQL / MariaDB 版本选择对应脚本，系统提供两种方式。

一键脚本安装

适用于 CentOS 7+ / Debian 10+ / Ubuntu 20.04+，全自动配置 JDK、MySQL、Nginx 等环境。推荐首选此方式。

国内服务器（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

本地文件部署

适用于无法在服务器编译、或希望直接上传制品快速上线的场景。

1. 获取部署文件 从 Gitee Releases 或 GitHub Releases 下载最新的 backend.jar 和 dist.zip，或在官方 QQ 群（1050160397）群文件中获取。
2. 数据库初始化 首次访问站点，通过系统初始化向导完成数据库导入。支持 MySQL 8.0 或 5.6+，也可手动导入 kami.sql。
3. 启动后端

   nohup java -jar backend.jar > backend.log 2>&1 &

   默认监听 8080，上下文路径为 /api。
4. 部署前端 将 dist.zip 解压到网站根目录（如 /www/wwwroot/your-domain/）。
5. 配置 Nginx

   location /api {
       proxy_pass http://127.0.0.1:8080;
   }

   注意：proxy_pass 末尾不要加 /，否则会去掉 /api 前缀导致 404。

手动编译部署

适用于开发者或需要深度定制的场景。前提：JDK 20+、Maven 3.8+、Node.js 18+、MySQL 8.0 或 5.6+

克隆代码

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 托管

管理员后台

提供完整的卡密管理与系统配置能力。

用户中心

面向终端用户的卡密购买与验证功能。

开发者 API

提供标准化 RESTful 接口，支持卡密核销、状态查询、WebHook 回调，API Key 签名认证保障安全。

# 卡密核销示例 (GET)
curl "https://your-domain.com/api/open/use_card?api_key=YOUR_KEY&card_key=YOUR_CARD&machine_code=DEVICE_ID"

常见问题

更新历程

当前版本 v1.0.7 · 构建日期 2026-06-04。 仓库： GitHub · Gitee

# 国内 · 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

联系我们

官方网站

www.xxgkami.com

体验地址

demo.xxgkami.com

QQ 交流群

1050160397（售后 / 技术支持）

联系邮箱

xxgyyds@vip.qq.com

Gitee

xiaoxiaoguai-yyds/xxgkami-pro

GitHub

xxg-yyds/xxgkami-pro

赞助支持

爱发电赞助