Files
douyi_guaji_main/license_server/README.md
T

2.9 KiB

简单卡密服务端

本地生成卡密

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,然后启动安装器并退出旧进程。