青点青点校园

开发文档

部署激活流程与在线验证 API 说明，运维与开发同学可直接对照操作。

🚀 快速开始 · 部署激活

  1. 获取授权文件：在授权商城购买对应版本后，授权文件 .lic 会自动签发，可在用户中心下载。
  2. 环境要求：JDK 17 / 21、MySQL 5.7+、Redis 6+（SaaS 版），私有版可脱离 Redis 运行。
  3. 导入数据库：执行安装包内的 sql/init.sql，创建业务库并初始化基础数据。
  4. 配置环境变量：设置 DB_HOST / DB_USER / DB_PASS / DB_NAME 与 LICENSE_PUBLIC_KEY（公钥随授权文件一并提供）。
  5. 放置授权文件：将 .lic 文件放入应用目录 license/ 下，或通过管理后台上传。
  6. 启动服务：java -jar edu-admin.jar，首次启动自动校验授权并绑定机器码。
  7. 验证激活：浏览器打开 http://你的域名:端口，使用默认账号登录（admin / 首次登录强制改密）。
💡 授权与机器码绑定。更换服务器需在授权站「换绑」操作，每张授权每年含 2 次免费换机额度。

🔌 在线验证 API

除离线 .lic 校验外，可接入在线接口实时核验授权状态，吊销 / 过期立即生效。

请求

POST https://auths.qd-edu.cn/api/license/verify
Content-Type: application/json

{
  "license_key": "QD-XXXX-XXXX-XXXX",
  "machine_code": "MC-9F2E-...."    // 可选，传入时同时校验绑定关系
}

响应 · 有效

{
  "code": 0,
  "valid": true,
  "product": "edu-admin",
  "edition": "pro",
  "expires_at": "2027-10-26 00:00:00",
  "machine_bound": true
}

响应 · 无效

{
  "code": 4001,
  "valid": false,
  "reason": "EXPIRED | REVOKED | NOT_FOUND | MACHINE_MISMATCH"
}
reason 取值含义建议处理
EXPIRED授权已过期引导续费，可宽限运行 7 天只读模式
REVOKED授权已被吊销立即停止服务并提示联系商务
NOT_FOUND授权号不存在检查录入是否有多余空格或字符
MACHINE_MISMATCH机器码不匹配走换绑流程，勿重复重装尝试
⚠️ 接口限频 60 次 / 分钟 / IP。建议业务侧缓存验证结果 10 分钟，勿在每次请求时实时调用。

🧩 常见集成问题

启动报「授权校验失败」？
检查 .lic 是否放到正确目录、LICENSE_PUBLIC_KEY 是否与签发密钥成对；服务器时间偏差超过 5 分钟也会导致签名校验失败。
内网环境无法调用在线验证？
离线 .lic 可独立完成校验，在线验证是可选增强；纯内网部署无需配置外网出口。
如何迁移到新服务器？
新机器部署完成后，在授权站用户中心发起「换绑」，旧机器码自动解绑，授权即时转移到新机器。
接入支持咨询 查看常见问题