SQ AUTHORIZATION SYSTEM · v1.0.0 BETA · TESTING & DEBUGGING

把软件授权，做成一条可审计的闭环。

四端程序、密钥生命周期、设备绑定、离线激活、邮箱账号、告警规则与多渠道通知。单机 SQLite 部署，数据留在自己手里。

查看全功能部署到服务器

4: 独立程序
7: 告警指标
5: 通知渠道
3: 层完整性校验

SQ 管理端 · 密钥运营界面示意 · 演示数据 127.0.0.1:8765

系统概览近 7 天

密钥总数12,480+320

已激活9,73278.0%

在线并发1,286心跳 120s

未处理告警3风控 2 · 完整性 1

密钥版本状态到期

GSQ-82K4-****-7F1A专业版有效2027-03-18

GSQ-51QZ-****-2C9D企业版有效2026-12-02

GSQ-39MN-****-8AB0标准版冻结2026-11-21

GSQ-77XT-****-4E62专业版未使用—

GSQ-14PL-****-9D3C标准版已吊销2026-08-30

告警规则

激活率≥ 90%

在线并发≥ 500

完整性告警≥ 1

新硬件码抢占设备位已冻结 · 邮件已发送

attest 403 · 未登记版本

IP 网段跳动 · 已通知

FastAPI + SQLite PySide6 四端 HMAC-SHA256 请求签名 Ed25519 离线 / 响应签名 PBKDF2-SHA256 600,000 次 onefile exe · 免 Python

HMAC-SHA256 请求签名 Ed25519 离线 / 响应签名 PBKDF2-SHA256 600,000 次 AES-GCM 会话密钥 release_manifest 完整性校验 attest 发布白名单告警规则引擎 · 7 指标邮件队列与退避重试 Webhook · 钉钉 · 企微 · 飞书批次吊销与恢复离线激活码 LICACT1 硬件指纹绑定 Python SDK 嵌入单机 SQLite · 免 Python

四端产品，各司其职

四个独立程序共用同一个授权服务：服务端负责签发与校验，管理端负责运营，主控端负责系统管理，验证端面向最终用户。

本地服务器 · 授权核心

FastAPI + SQLite 的授权服务：签发与校验密钥、管理数据库、执行告警规则、投递通知。

REST API，默认监听 127.0.0.1:8765，可无界面（headless）运行
密钥签发、状态机、批次统计与离线激活码签发
告警规则引擎：7 类指标、阈值、冷却与事件状态
SMTP 邮件队列 + Webhook / 钉钉 / 企微 / 飞书通道投递
发布白名单（release_hashes / release_meta）与 attest 校验
数据库一键备份与恢复，含完整性校验

server_config.json运行中

host / port127.0.0.1:8765

attest_modeauto

SMTPsmtp.example.com:587 · STARTTLS

白名单4 个应用哈希 · 1 个 release_id

已导入发布清单：4 个应用哈希

email worker：sent 128 · failed 0 · dead 0

alert engine：evaluated 7 rules · fired 1

管理端 · 密钥运营

面向日常运营：批量发行与全生命周期管理，查看统计、告警与审计。

批量生成时长卡 / 激活次数卡，支持版本与备注
吊销、恢复、冻结、解冻、续期、删除、解绑
批次聚合统计、整批吊销 / 恢复、跨页批量操作
告警中心：规则配置、事件确认、通知渠道管理
用户管理：搜索、启用 / 禁用、强制脱绑
审计日志筛选、分页与 CSV 导出

密钥管理12,480 条

GSQ-82K4-****-7F1A有效

GSQ-39MN-****-8AB0冻结

GSQ-77XT-****-4E62未使用

GSQ-14PL-****-9D3C已吊销

批量吊销批量续期导出 CSV

主控端 · 系统管理

最高权限：管理员账号、邮箱与找回密码、系统级设置与发布白名单。

管理员创建、启停、重置密码与角色管理
管理员邮箱绑定、验证码验证与找回密码
系统设置：监听地址、数据库、SMTP、AI 助手
发布白名单导入（release_manifest + 签名）
主控账号保护与强制改密闸门
与运营端导航区分：系统管理 / 密钥运营

管理员管理系统管理

admin已绑定邮箱

ops-01已验证

ops-02未验证

设置邮箱发送验证码重置密码

验证端 · 最终用户

邮箱账号或激活码双模式：联网校验、离线激活、心跳保活与资料管理。

邮箱注册 / 登录 / 找回密码，一个邮箱同时绑定一个密钥
激活码模式 + 离线激活码（LICACT1 请求码 / 激活码）
心跳带随机抖动，断网可回退离线授权
个人资料：显示名、头像（PNG / JPG / WebP ≤256KB）
续费请求、失效后自助脱绑；有效期内脱绑需管理员
可脱离发布文件独立运行，也可作为 Python SDK 嵌入第三方软件

验证端已激活

邮箱登录激活码

账号user@example.com

绑定密钥GSQ-82K4-****-7F1A

到期时间2027-03-18 · 剩余 132 天

心跳正常 · 下次间隔 23s

全功能矩阵

从密钥发行到告警投递的完整能力清单，共 8 个模块。

密钥发行

时长卡：分钟 / 小时 / 天 / 周 / 月 / 季 / 年，支持自定义单位
激活次数卡：1 ~ 100000 次，同一机器重复激活不重复计数
次数用尽自动吊销，无法恢复 / 续期，状态显示「已用尽」
版本（edition）、备注、自定义前缀，支持一次批量生成
密钥列表 CSV 导出，导出内容做公式注入防护

批次与状态机

批次号聚合生成量与激活量，支持关键词筛选
整批吊销、整批恢复、跨页批量操作与进度提示
状态：未使用 / 有效 / 冻结 / 吊销 / 过期 / 次数用尽
冻结指定时长后自动恢复；吊销可恢复，全程可追溯
续期同步更新设备绑定到期时间

设备与席位

硬件指纹：MachineGuid + 磁盘卷序列 + MAC + 处理器特征
max_devices 在事务内原子占用，并发激活不超卖
支持解绑换机，绑定历史与操作来源可查
心跳带随机抖动，服务端按时间窗统计在线并发
同一机器重复激活幂等，不重复扣减次数

激活方式

联网激活：HMAC-SHA256 请求签名 + nonce 防重放 + 时间窗
离线激活：Ed25519 签名码（LICREQ1 请求码 → LICACT1 激活码）
激活次数卡强制联网激活，保证次数扣减准确
验证端 standalone 模式：可脱离发布文件独立运行
Python SDK 可嵌入第三方软件，自动心跳与离线码校验

安全体系

请求 HMAC-SHA256、响应 Ed25519 固定公钥，双向签名
PBKDF2-SHA256 600,000 次迭代，改密后旧令牌全部失效
会话密钥 AES-GCM 落库加密，单独拷库无法伪造签名
EXE 发布清单 + Ed25519 签名 + 目录完整性校验
release_id 与 manifest 哈希校验 + 服务端 attest 白名单
登录 / 验证失败锁定、来源 IP 限流、恒定时间口令校验

账号与用户

管理员邮箱绑定、验证码验证与邮箱找回密码
验证端邮箱注册 / 登录 / 找回密码，一人一号
一个邮箱同时只绑定一个密钥；失效后可自助脱绑
个人资料：显示名、头像（PNG / JPG / WebP ≤256KB）
用户管理：搜索、启用 / 禁用、强制脱绑
记住账号 / 记住密码，Windows 下 DPAPI 加密保存

告警与通知

7 类指标：激活率、在线并发、过期率、7 天内到期、激活失败、风控事件、完整性告警
规则：运算符、阈值、统计窗口、级别、冷却时间、渠道与启停
事件三态：触发中 / 已确认 / 已处理；指标恢复自动 resolved
内置风控：新硬件码冻结、IP 跳动告警、完整性失败告警
SMTP 邮件队列 + Webhook / 钉钉 / 企微 / 飞书，失败指数退避重试
投递记录可查，Webhook 带 HMAC 签名，钉钉 / 飞书支持加签

运维与扩展

审计日志：关键词 / 类型 / 时间筛选、分页、CSV 导出、按保留期清理
数据库一键备份与恢复，恢复前做结构与完整性校验
统计结果缓存、过期扫描节流、热点索引，服务端不卡顿
REST API 全量开放；Python SDK 直接嵌入第三方程序
发布包卫生检查：只分发 release_package（exe + 清单 + 签名）
首次运行引导、强制改密、控制台隐藏与深色模式适配

适用场景

同一套授权内核，覆盖自研软件、内网离线、客户端订阅与渠道分发。

自研软件厂商

给桌面软件发卡、绑定设备、控制版本与有效期，发行与回收全程有记录。

内网 / 离线环境

无外网也能完成授权：请求码加签名激活码，离线校验不依赖网络。

客户端订阅产品

邮箱账号登录加心跳在线；到期数量进入告警指标，续费请求直达运营。

渠道与分销

按批次生成与分发密钥，核销与激活状态可追溯，整批吊销随时兜底。

03 开发中 · DEV

动手试试：四个交互演示

所有交互都在本页模拟，不发送任何请求。用它直观感受密钥格式、授权链路、风控裁决、告警规则与部署组合。

交互 01DEV

激活与风控模拟器

先点「激活」走通设备绑定，再注入风险，看服务端如何裁决。

SQ 验证端 · 开发中 未激活

授权密钥设备硬件码

样本

提示：先点「激活」，再点「校验」或「心跳」。

服务端裁决

密钥状态未使用

绑定设备—

到期时间—

会话密钥—

注入风险

[demo] 等待操作…

交互 02DEV

告警规则沙盒

调整阈值与窗口，看规则在曲线上的触发位置。

指标条件阈值 500 窗口

指标采样阈值线触发点

调整参数后点「评估一次」。

交互 04DEV

密钥批量生成器

按真实规则生成 GSQ 密钥：大写、不含 I/O/0/1，4 组 × 5 位。演示数据不会入库。

数量 8 卡密模式时长 / 次数设备上限

点「生成密钥」按真实格式生成一批演示密钥。

04 开发中 · DEV

软件全景模拟 · 八个页面全可点

不播视频、不贴静态图：左侧八个页面是真能切换的，生成密钥会真的生成、冻结吊销会真的改状态、告警能处理、审计能筛选。提示条停留 6 秒以上并带进度条，鼠标悬停或手指按住会暂停计时。

SQ 管理端 · v1.0.0 Beta 127.0.0.1:8765 · 已连接

SQ suadmin超级管理员

系统概览 近 7 天 · 演示数据（非真实运营数据）

密钥总数0本周 +96

已激活080.3%

在线并发0心跳 120s

待处理告警0风控 2 · 完整性 1

近 7 日激活趋势单位：次

一二三四五六日

三维观影 · 七个界面一条时间轴

鼠标按住左右拖、手机左右滑、方向键点按都能切；松开自动吸附到最近的卡片，远处卡片自动缩小、后退、虚化。点「自动巡览」让它自己走，触摸或拖动时会先停下来。

01系统概览管理端

密钥总数12,480 已激活9,732 在线1,286

02生成密钥管理端

GSQ-7K2MF-9QXAR-4TZWDGSQ-3P8ND-2LVBM-8QK6TGSQ-9WQ4H-6ZRJC-3MSVN

03密钥管理管理端

GSQ-82K4-****-7F1A有效 GSQ-39MN-****-8AB0冻结 GSQ-14PL-****-9D3C吊销 GSQ-77XT-****-4E62未使用

04离线激活验证端

8F3A1-0C4D9-7E2B5

LICACT1.eyJkZXYiOiI4RjNBMS…

05告警中心管理端

新硬件码抢占设备位已冻结
IP 网段跳变 3 次邮件已发
EXE 完整性不一致已拒绝

06邮箱账号验证端

user@example.com 绑定 GSQ-7K2MF-****-2HN8P

您的密钥将在 7 天后到期，请及时续费。
检测到异常登录，已临时冻结授权。

07审计日志管理端

10:42 admin 吊销 GSQ-14PL-****-9D3C
10:31 风控冻结 GSQ-39MN-****-8AB0
10:07 邮件投递成功 user@example.com
09:58 登录成功 admin · 127.0.0.1

06 开发中 · DEV

4D 授权链路调试器

这一块不是为了好看：它把一次授权请求真正走过的路径摊开给你看。挑一个故障场景点「运行」，光点会沿着链路走一遍，走到哪一步被拦、为什么被拦、触发了哪条告警、邮件发给了谁，场景和右栏会同步告诉你。点任意节点还能看到它对应的职责与约束。

链路就绪拖动 · 转视角点节点 · 看职责

--FPS

5链路节点

0已跑步骤

故障场景 待运行

选一个场景，点「运行整条链路」看它怎么走；也可以「单步」一格一格看。

不是装饰，是调试器

五个节点对应真实分层：客户端、API、授权内核、风控与完整性、通知通道；光点走的就是一次请求的真实顺序。

五种故障可复现

正常激活、密钥过期、新硬件码抢占、IP 网段跳动、发布文件被改——每种都能看到卡在哪一步、结论是什么。

视角即操作

拖动旋转链路、双指或滚轮推纵深、点节点看职责；离开视口或切到后台自动停止渲染，不吃你的电。

安全体系：三层裁决

本地自检负责快速拒绝，发布白名单负责最终裁决，会话与传输负责全程防篡改。

客户端自校验

构建期生成 release_manifest.json 与 Ed25519 签名，逐文件记录 SHA-256 与大小，并绑定 release_id。

EXE 自身哈希 / 大小与目录完整性校验
缺失、多出、改动文件一律拒绝启动
失败时弹窗 + 本地日志 + 上报服务端

服务端 attest 白名单

已发布版本进入 release_hashes / release_meta，attest 通过后签发短期 token。

activate / verify / heartbeat 强制携带 X-Attest-Token
release_id 与 manifest 哈希一并校验，混用清单判 release_mismatch
attest_mode：auto（默认）/ strict / off

会话与传输

请求与响应双向签名，会话密钥加密落库，口令高成本哈希。

HMAC-SHA256 覆盖方法 / 路径 / 查询串 / 时间戳 / nonce / 请求体摘要
Ed25519 响应签名固定公钥；会话密钥 AES-GCM 加密存储
PBKDF2-SHA256 600,000 次；远程部署要求 HTTPS

attest 校验

POST /api/client/attest
body { release_id, manifest_sha256, exe_hash, machine_code }
 
403 客户端完整性校验未通过，已拒绝访问
     code = unknown_build | release_mismatch
 
→ 写入 tamper_events
→ 触发告警规则（完整性告警 ≥ 1）
→ 邮件 / Webhook / 钉钉 / 企微 / 飞书 通知

告警与通知

把授权数据变成可执行的运营信号：阈值可配、事件可追踪、通知多渠道。

指标口径

激活率窗口内创建的许可证中已激活占比

在线并发心跳时间窗内的活跃设备数

过期率窗口内到期许可证中已过期的占比

7 天内到期有效许可证即将到期的数量

激活失败窗口内「激活失败」审计记录数

风控事件窗口内新增风险事件数

完整性告警窗口内新增 tamper_events 数

新硬件码

设备位已满仍出现新硬件码，判定为克隆或共用：直接封禁授权 + 高等级告警，主控可解封 / 换绑。

IP 跳动

同一密钥在时间窗内跨网段跳动，超过 2 次即自动发告警通知；窗口与阈值仍可在规则引擎里调整。

完整性失败

未知版本、清单不匹配、目录被改动，全部写入完整性告警并通知管理员与绑定邮箱。

邮件SMTP 队列 · 指数退避重试

WebhookJSON 回调 · X-SQ-Signature HMAC

钉钉Markdown 消息 · 官方加签

企业微信Markdown 消息 · 错误码校验

飞书文本消息 · 时间戳加签

账号与用户

管理员与终端用户各有一套账号体系：邮箱验证、密码找回、一人一号、资料与用户管理。

01注册
邮箱 + 验证码创建账号，邮箱即登录名。
02登录
密码登录，支持记住账号 / 记住密码（DPAPI 加密）。
03绑定密钥
一个邮箱同时绑定一个 Key，建立绑定历史。
04激活设备
提交硬件码，事务内占用设备位，幂等不重复计数。
05校验心跳
会话签名校验与抖动心跳，维持在线与授权状态。
06续费 / 脱绑
发起续费请求；失效后可自助脱绑，有效期内需管理员处理。

验证端资料

显示名、头像（PNG / JPG / WebP，≤256KB）、邮箱
头像可上传 / 移除，加载失败回退默认图标
管理员邮箱支持验证码绑定与邮箱找回密码

用户管理

按邮箱 / 显示名搜索，按状态筛选
查看绑定 Key、许可证状态、到期时间与最后登录
启用 / 禁用账号（禁用后旧令牌立即失效）
管理员强制脱绑，释放设备并写入历史

部署与运维

单机即可运行，也可放到服务器远程部署；运维有备份、有审计、有性能兜底。

单机部署

FastAPI + SQLite，默认监听 127.0.0.1:8765；无需额外数据库服务。

免 Python

四个程序均为 onefile 单文件 exe，Windows 10 / 11 双击即用。

备份恢复

一键备份数据库并做完整性校验，恢复前校验表结构，避免残缺文件覆盖线上库。

性能兜底

统计结果缓存、过期扫描节流、热点索引、空队列不抢写锁，心跳高峰不卡顿。

远程部署

远程部署必须使用 HTTPS 并固定服务端响应公钥；明文 HTTP 会被客户端拒绝。

发布规范

构建产物 release_package 只含 exe + 清单 + 签名，自动做卫生检查，防止密钥 / 数据库外泄。

当前处于测试与调试阶段

请勿直接替换现有生产环境的授权服务：先在独立环境跑通升级与回滚，再按 release_package 流程发布。

命令行

# 无界面启动本地服务器
python server/main.py --headless

# 导出客户端需要固定的服务端公钥
python server/main.py --print-public-key

# 忘记主控密码（保留全部授权数据）
python server/main.py --reset-master-password

接入与扩展

REST 接口就是协议边界；Python SDK 可直接嵌入第三方软件。

POST/api/client/activate设备激活与席位占用

POST/api/client/verify会话签名校验

POST/api/client/heartbeat心跳与在线口径

POST/api/portal/login邮箱账号登录

POST/api/alerts/rules配置告警规则

POST/api/channels配置通知渠道

POST/api/release/import导入发布白名单

GET/api/email/outbox邮件投递记录

Python SDK · sdk.LicenseClient

from sdk import LicenseClient

client = LicenseClient(
    "https://license.example.com",
    RESPONSE_PUBLIC_KEY,      # 服务端响应公钥，固定写死
)

result = client.activate("GSQ-XXXXX-XXXXX-XXXXX-XXXXX")
print(result["ok"], result["remaining"])

# 自动心跳与请求签名由 SDK 处理；
# 离线码可用 client.verify_offline(code) 校验。

attest_modeauto / strict / off

sdk_attest_exemptSDK 宿主白名单豁免开关

require_manifest_hash强制校验 manifest 哈希

channel_allow_private_hosts允许内网通知地址

常见问题

部署与使用中最常被问到的几个问题。

现在是测试与调试阶段，能直接用于正式环境吗？

当前版本处于测试与调试阶段：授权核心流程可用，但界面、接口字段与性能仍在联调。建议先在测试机跑通完整流程，正式发布时使用构建生成的 release_package，并保留回滚方案。

运行 exe 需要安装 Python 吗？

不需要。四个程序均为 onefile 单文件打包，双击即可运行。

忘记主控密码怎么办？

不要删除数据库。停止服务器后执行 本地服务器.exe --reset-master-password，会为 admin 重新生成一次性密码并保留全部授权数据，登录后需立即改密。

可以放到服务器上远程部署吗？

可以，但必须配置 HTTPS / 受信证书，并把 --print-public-key 导出的服务端响应公钥固定到客户端配置；明文 HTTP 会被客户端拒绝。

验证端提示连接失败？

确认本地服务器已启动、8765 端口未被占用且未被防火墙拦截；远程地址需勾选允许连接受信 HTTPS 服务端。

第三方软件能不能内嵌授权校验？

可以。使用 sdk.LicenseClient，把 core/ 与 sdk/ 随程序分发即可；SDK 不读取配置文件、不依赖发布清单，响应验签与设备绑定仍然生效。

发布文件怎么对外分发？

只分发构建生成的 release_package 目录（四个 exe + release_manifest.json + 签名 + releases 副本）。不要分发整个 dist，避免把配置或数据库带出去。

作者与项目

从授权内核到四个客户端界面，由一个人从头写到尾：没有外包、没有拼装框架，逻辑与界面同源。

苏丠

独立开发者 · 设计与实现同一个人

负责 SQ 密钥授权系统的全部工作：授权内核、四端 PySide6 界面、离线激活签名链、告警规则引擎、邮件队列、审计与备份，以及你现在看到的这个宣传站。偏好把复杂链路拆成可验证的小闭环，先能跑通，再谈好看。

Python
FastAPI
PySide6
SQLite
Ed25519
HMAC-SHA256
AES-GCM
PyInstaller
原生 JS
Canvas 2D

0独立程序

0REST 接口

0告警指标

0完整性层

01
授权内核密钥生命周期、设备绑定、心跳续期、批次吊销与恢复，单机 SQLite 落地。
02
四端程序管理端 / 验证端 / 服务器 / 工具端，onefile 打包，双击即用，不依赖 Python 环境。
03
安全链路HMAC-SHA256 请求签名、Ed25519 响应与离线激活验签、PBKDF2 60 万次口令派生。
04
运营闭环邮箱账号、阈值告警、风控冻结、邮件队列与退避重试、多渠道通知与审计留痕。

项目当前处于测试与调试阶段，接口字段与界面仍在联调；正式发布时请以构建生成的 release_package 为准。

把授权链路握在自己手里。

单机部署、离线可用、客户端可自校验；异常有告警，操作有审计。

查看部署方式邮件联系

测试请联系

想试用、想定制、想报 Bug，直接发邮件。

2376990248@qq.com QQ 邮箱 · 工作日 24 小时内回复

发送申请邮件

当前处于测试与调试阶段，欢迎索取测试版本、反馈缺陷或聊定制需求。邮件里请不要附真实授权数据、密钥或数据库文件。

单机部署 · SQLite HMAC-SHA256 请求签名 Ed25519 响应验签 attest 发布白名单 7 类告警指标 5 种通知渠道邮箱账号登录离线激活审计与备份 Python SDK

把软件授权， 做成一条 可审计的闭环。

本地服务器 · 授权核心

管理端 · 密钥运营

主控端 · 系统管理

验证端 · 最终用户

密钥发行

批次与状态机

设备与席位

激活方式

安全体系

账号与用户

告警与通知

运维与扩展

适用场景

自研软件厂商

内网 / 离线环境

客户端订阅产品

渠道与分销

不是装饰，是调试器

五种故障可复现

视角即操作

客户端自校验

服务端 attest 白名单

会话与传输

新硬件码

IP 跳动

完整性失败

验证端资料

用户管理

单机部署

免 Python

备份恢复

性能兜底

远程部署

发布规范

苏丠

把授权链路握在自己手里。

想试用、想定制、想报 Bug，直接发邮件。

把软件授权，做成一条可审计的闭环。