Files

5.1 KiB
Raw Permalink Blame History

简单卡密服务端

本地生成卡密

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,然后退出旧进程执行差量更新或完整安装。