简单卡密服务端
本地生成卡密
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
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。
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。
如果服务通过 HTTPS 访问,建议设置 DYGJ_LICENSE_SECURE_COOKIES=1。
只有在前面有可信反向代理时,才设置 DYGJ_LICENSE_TRUST_FORWARDED_FOR=1。
自动更新
卡密后台同一个网站也负责发布客户端更新,不需要额外端口:
http://服务器IP:18100/admin
登录后在“在线更新”区域上传新版安装包 .exe,填写版本号(例如 3.3.4)后点击“上传并发布”。服务端会:
- 保存安装包到
data/updates/ - 自动计算安装包 SHA256
- 生成
/api/v1/update/manifest - 使用服务端私钥给 manifest 签名
打包后的客户端默认读取:
https://dy.absfan.cn/api/v1/update/manifest
如果后台未发布更新,manifest 返回 version=0.0.0,客户端不会下载。发布高于客户端当前版本的安装包后,客户端启动时会下载、校验签名和 SHA256,然后启动安装器并退出旧进程。