简单卡密服务端
本地生成卡密
python -m license_server.manage --db data/app.db create --days 30 --count 10 --customer demo
python -m license_server.manage --db data/app.db list
python -m license_server.manage --db data/app.db revoke DG-XXXX-XXXX-XXXX-XXXX-XXXX
python -m license_server.manage --db data/app.db unbind DG-XXXX-XXXX-XXXX-XXXX-XXXX
服务端接口
GET /api/v1/health
POST /api/v1/activate
POST /api/v1/verify
POST /api/v1/verify_license
POST /api/v1/redeem/external/create
POST /api/v1/redeem/claim
GET /redeem/{token}
GET /api/v1/update/manifest
GET /api/v1/update/download/{filename}
GET /admin
/api/v1/activate 请求:
{
"card_key": "DG-XXXX-XXXX-XXXX-XXXX-XXXX",
"machine_fingerprint": "客户端机器码"
}
成功后返回 license 字段,客户端本地验签通过才会写入 license.dat。
闲鱼自动发货接入
自动发货系统不要直接拿真实卡密,只调用服务端生成一次性兑换链接。买家打开兑换链接后,服务端才生成正式 DG- 卡密。
服务端先配置外部接口 token:
export DYGJ_LICENSE_EXTERNAL_API_TOKEN="一段足够长的随机密钥"
外部自动发货系统请求:
POST /api/v1/redeem/external/create
Authorization: Bearer 一段足够长的随机密钥
{
"platform": "xianyu",
"external_order_id": "闲鱼订单号",
"customer": "买家备注",
"days": 30,
"max_devices": 1,
"expires_hours": 72
}
返回只包含 claim_url,不返回真实卡密:
{
"ok": true,
"claim_url": "https://dy.absfan.cn/redeem/xxxx",
"token_hint": "xxxx...xxxx",
"expires_at": "2026-06-24T12:00:00Z"
}
把 claim_url 通过闲鱼聊天自动发给买家即可。这个设计可以避免员工、闲鱼自动发货项目或聊天日志直接接触真实卡密库存。
Docker 部署
cd /opt/douyin-license-server
mkdir -p data secrets
docker compose up -d --build
第一版建议通过 1Panel/OpenResty 把 HTTPS 域名反代到:
http://127.0.0.1:18100
客户端配置:
{
"license": {
"activation_url": "https://你的域名/api/v1/activate",
"timeout_seconds": 10
}
}
注意:必须显式配置 DYGJ_LICENSE_PRIVATE_KEY_PATH 或 DYGJ_LICENSE_PRIVATE_KEY_PEM。
secrets/private_key.pem 只能放服务器,不能随客户端分发。
最小网页后台
后台和激活接口共用同一个服务端口,不需要额外开放端口:
http://服务器IP:18100/admin
打开后会显示网页登录页,密码填写管理员 token。管理员 token 建议放在服务器:
/opt/douyin-license-server/secrets/admin_token.txt
服务启动时设置:
export DYGJ_LICENSE_ADMIN_TOKEN="$(cat secrets/admin_token.txt)"
不要把管理员 token 放到 URL 里,避免进入浏览器历史、访问日志或截图。
生产环境默认关闭 /docs、/redoc 和 /openapi.json;确实需要临时查看时设置 DYGJ_LICENSE_ENABLE_DOCS=1。
生产环境建议显式设置 DYGJ_LICENSE_PUBLIC_BASE_URL=https://你的域名,服务会用它生成兑换链接和更新下载地址。
设置 HTTPS 的 DYGJ_LICENSE_PUBLIC_BASE_URL 后,后台 Cookie 会默认带 Secure;如需手动覆盖,可设置 DYGJ_LICENSE_SECURE_COOKIES=1。
服务端会校验 Host 头,默认允许 dy.absfan.cn、127.0.0.1、localhost 和测试域名;自定义域名可设置 DYGJ_LICENSE_ALLOWED_HOSTS=你的域名,备用域名。
只有在前面有可信反向代理时,才设置 DYGJ_LICENSE_TRUST_FORWARDED_FOR=1。
自动更新
卡密后台同一个网站也负责发布客户端更新,不需要额外端口:
http://服务器IP:18100/admin
登录后在“在线更新”区域先上传新版安装包 .exe,填写版本号(例如 3.3.4)后点击“上传并发布”。服务端会:
- 保存安装包到
data/updates/ - 自动计算安装包 SHA256
- 生成
/api/v1/update/manifest - 使用服务端私钥给 manifest 签名
默认上传大小限制:完整安装包最大 700 MB,差量包最大 250 MB。需要调整时设置:
export DYGJ_LICENSE_MAX_INSTALLER_UPLOAD_MB=700
export DYGJ_LICENSE_MAX_DELTA_UPLOAD_MB=250
如果要发布差量更新,再上传 DouyinGuaji-旧版本_to_新版本_delta.zip,并填写来源版本和目标版本。新客户端会优先下载匹配自己当前版本的差量包;没有匹配差量包时,才回退下载完整安装包。
生成差量包示例:
python -m tools.update_delta build \
--old dist/DouyinGuaji-3.3.5 \
--new dist/DouyinGuaji-3.3.6 \
--out dist/delta/DouyinGuaji-3.3.5_to_3.3.6_delta.zip \
--from-version 3.3.5 \
--to-version 3.3.6
打包后的客户端默认读取:
https://dy.absfan.cn/api/v1/update/manifest
如果后台未发布更新,manifest 返回 version=0.0.0,客户端不会下载。发布高于客户端当前版本的更新后,客户端启动时会校验 manifest 签名、下载并校验 SHA256,然后退出旧进程执行差量更新或完整安装。