中国 帮助

计费形态与价格

永久授权、订阅、版本买断在凭证里怎么写,到期与宽限怎么判,收回动作到底拦什么。

计费形态与价格
封面

> 本文整理自平台文档 docs/wujies/5.x/license/pricing.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-bd5324e33162-cover.svg)

谈订单,或者客户问「到期之后我这套系统会怎样」,用这一页。价格数字目前没有对外公布的口径,这页给的是期限形态、到期判定和收回的后果。

一台部署一枚凭证

授权是部署级事实。app_license 这张表全库只有一行(license_id 固定为 1),记的是「这台部署买了什么」:

  • 不按租户隔离。表里没有 tenant_id 列,一份凭证覆盖这台部署上的所有租户,多租户不等于多份授权。也因此它必须写进 application.yml 顶层的 tenant: excludes:;漏配不会报错,症状是授权页永远读不到状态。
  • 凭证原文是权威。tier、expire_at、grant_type 这些列只是投影,方便页面与 SQL 读;本机每次读取都按 credential 重新验签、重新算名单。
  • 续费是覆盖那一行,不插第二行。本机备注留空时沿用上一次写的那句,activated_at 只在第一次成功激活时落定。

凭证里写了什么

线格式是 wjl1.<base64url(内容)>.<base64url(签名)>:三段、点分隔、整段可粘贴,签名覆盖前两段拼出的那串字符的 UTF-8 字节(那两段只含 base64url 字符,取出来的字节与 ASCII 同形)。解码后再序列化的 JSON 不进签名,所以格式化过的 JSON 会改掉被签的字节,同一份授权必须只对应一串字节。

内容里的键按固定顺序写:v(格式版本)、iss(签发方标识)、lic(授权编号)、dom(绑定域名)、tier(档位)、grant(期限形态)、apps(解锁名单)、from / to(版本上下限)、iat(签发时刻)、exp(到期时刻)。时间一律 epoch 秒,缺省的键整键省略:exp 缺席才是永久,写成 "exp": 0 会被读成 1970 年到期。

前缀里的 wjl1 那个 1 是格式版本。将来换签名算法必须另起前缀,好让「旧凭证」和「坏凭证」在报错里能区分开。

授权编号的形态是 WJ-<档位>-XXXX-XXXX,随机段的字母表去掉了 0/O/1/I:编号会在电话里念、在手写工单里抄,也会进对账表格。它用 SecureRandom 生成,同时是台账里唯一的对账凭据(建了唯一索引)。

签发方那侧另有三张台账表(订单、激活记录、兑换码),回答的是「卖出去了哪几枚」,和这台部署上的一行是两件事:台账归账号,本机那一行归部署。两边怎么配、怎么签,见[许可证插件](/docs/wujies/5.x/plugins/license)。

三种期限形态

对齐的是「一次买断 / 按年续 / 买断到某个版本」三种商务做法,凭证里的键名分别是 grant、exp、to:

形态凭证里的值签发时的校验到期时间
永久授权 perpetual不写 exp不许带到期时刻,带了这枚「永久」会真的到期页面显示「永久」
订阅 subscription必须写 exp到期时刻必须晚于当前时间;闭源签发内核还限最长 36 个月到期后进宽限期
版本买断 version_lock写 to(版本上限)上限是这一形态独有的字段;闭源签发内核还会拒掉「永久或订阅却带 to」的签发由版本区间决定

三种形态都签成同一种凭证(以 wjl1. 开头的一整段文本),后台的激活动作完全一样,见[激活与查看档位](/docs/wujies/5.x/license/activation)。

36 个月这个上限写在签发内核里,页面那三枚快捷按钮只是顺带受限:只靠前端限长,直接调接口(批量生成兑换码那条路也算)就能签出一枚十年的订阅,把续费绕过去。两处签发内核(开源平台那份与闭源插件那份)对 version_lock 能不能不带到期时刻的口径还不一致,签之前以实际调用那一份的报错为准。

价格

本页不列数字:三档的价格目前还没有对外公布的口径。要报价、下单或续费,通过 Gitee Issue 工单或邮件联系平台方, 按你的场景签发一枚本机授权凭证,你在后台粘贴激活。付费部分的具体商用条款(授权范围、能否再分发、 能否用于交付给客户)随订单与协议文本走,公开仓库里没有替代它的文本。

工单标题里注明「授权」即可,公开仓库入口见 [Gitee 组织](https://gitee.com/wujies)。

本机后台只接受整段凭证:粘进输入框的内容不以 wjl1. 开头就当场报错。兑换码那半属于签发侧(平台 /app/license/redeem 与插件 /app/issuer/license/redeem),默认被 app-market.license.issuer-enabled: false 挡着,在客户部署上不通;要不要打开、私钥配在哪,见[许可证插件](/docs/wujies/5.x/plugins/license)。

到期与状态

一台部署此刻是什么状态,由 LicenseState 判:

状态判据名单是否生效页面上会看到
社区版 none本机没有授权记录只有社区件档位标记显示「社区版」,不报错
有效 valid未到期生效剩余天数
宽限期 grace已过期,但在 grace-days 内生效到期时间 + 续费提醒
已过期 expired已过期且超出宽限期收回提示续费后重新激活即可恢复
版本超出 version_out平台版本升过凭证的 to收回这一态当前不会出现,见下
凭证无效 invalid验签失败、内容被改动,或本机没配公钥收回明确报错并说明原因

none 与 invalid 是两个值,判据与文案都分开。LicenseState 的注释写得很直:把它们合成一个值,等于把验签失败伪装成「你还没买」。付了钱而凭证没生效,和从来没买过,是两件必须分开说的事。

宽限期是商业让步。到期当天就把客户的生产系统降级成社区版,会把一次续费变成一次事故。

天数取整按整天:剩余不足一天算 0 天、仍然有效;刚过期不足一天算 0 天、落进宽限。差几个小时不会把人降级。

宽限天数由 app-market.license.grace-days 决定,默认 7。中心与每台部署要填同一个数,否则会出现「页面说还在宽限、目录已经不给私有应用」这种分歧:两边的名单计算各读各的配置,谁也没错,合起来看不一致。

### 状态由四个输入算出来

一台部署算出自己的状态,只用这四样:app_license 里那串凭证原文、本机配置的验签公钥、grace-days、以及本机的当前时间。中心与签发方都不参与,这是「离线也能判档」的原因,也是它的代价:

  • 本机时钟比真实时间快,就会提前进宽限、提前过期。到期日在页面上算错、enforce 下应用提前装不上,而凭证本身没变。排查这类报障先看那台机器的系统时间与 NTP,再看授权。
  • 公钥换了,所有旧凭证立刻判无效。轮换签发密钥意味着把每一台部署的配置一起换掉,没有中间态。
  • grace-days 是本机配置,改它等于改这台部署的到期口径,改完两边(中心与每台部署)要一致。
  • 这四个输入里没有任何「这台部署装了哪些应用」,所以解除授权与降级都不会动已装的应用与数据,见下面「收回动作到底拦什么」。

### 「版本超出」这一态目前不会出现

凭证里有 from / to 两个版本字段,后台也会把「版本上限」显示出来,但部署侧还没有比较它的代码:Java 侧没有一个可信的「当前版本号」来源(AGENTS.md §3.15 把这条列为未闭合的三件事之一)。所以 version_out 现在没有产出方,版本买断形态此刻只按期限字段判,上限拦截要等这一条补上。给客户讲这一档时,别说「升到某个版本就用不了」,现在还不会。

收回动作到底拦什么

名单收回之后拦不拦得住,取决于 app-market.license.mode:

模式行为
off完全不判(内网自建、排查问题时的逃生阀)
warn默认值:照常放行,把「这台没解锁这个应用」写进日志
enforce没解锁的应用不让装、不让加载

两个判断落点:部署链路 AppPackageDeployService 与运行时装载 PluginRuntimeManager,都调 LicenseGuard.evaluate,只有 Decision.blocked()(enforced && !allowed)才抛错。日志里 warn 命中的前缀是「授权告警(未拦截,mode=warn)」,enforce 命中的是「授权拦截」。

切 enforce 之前先确认 public-key 已经配好。 没配公钥时任何凭证都验不过、名单恒为空,这时候开 enforce 等于凭空少一批应用,而少掉的那些看起来像 bug,不像授权问题(这条判断写在 LicenseMode 与 LicenseProperties 的注释里)。改错了也没人提醒你:mode 是字符串注入,写成空串或拼错都退回 warn,退回的是放行那一档。

无论哪一

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-bd5324e33162-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容