试用与许可证
新安装有 30 天的试用。之后用一份离线签名的许可证文件继续使用,不需要联网激活。
试用
新安装的部署,自首次初始化起有 30 天试用,期间全部模块都可以使用。试用的起点记录在数据库和审计记录里。
试用到期后,还有 14 天宽限期,功能照常,但控制台会显著提示。宽限期结束后,按下文「到期会怎样」处理。试用期间收到并安装了许可证,就由许可证取代试用。
许可证是什么
- 离线签名的文件:我们签发
.license.json文件,产品内置公钥,离线校验签名。支持 Ed25519 和国密 SM2 两种签名,和部署使用哪种算法套件无关。 - 授权的内容:可以使用的模块、有效期,以及数量上限。
- 绑定部署:许可证里写明部署 ID,只对这一个部署有效,拷到别的部署上会被拒绝。
- 不需要联网激活,没有心跳,也不按调用量计费。
- 核心本身始终可用。许可证只决定模块能不能被调用。
许可证文件的内容被签名保护,改动任何一个值,签名校验都会失败。
申请与安装
- 在 Nexus 控制台打开「系统设置 › 许可证」,复制部署 ID,它以
nxd-开头。 - 把部署 ID 发给我们,说明需要的模块、有效期和数量上限。
- 收到
.license.json后,在同一个页面上传。可以选择文件,也可以粘贴内容。 - 页面先校验,再安装。校验通过后立即生效,或者在文件写明的生效日期到达时生效。
许可证存进数据库,不需要挂载文件,也不需要改环境变量。同一个文件重复上传不会有副作用。「安装记录」里能看到每次上传的时间、操作人、有效期和现状(生效中、待生效、已被替换、无效)。
日期按北京时间(UTC+8)的日历日理解。写明到期日 2027-10-31,就是当天 23:59:59 到期。
数量上限
许可证可以对下面三项设上限,由核心执行:
| 上限 | 统计的是 | 检查的时机 |
|---|---|---|
| 控制台管理员数 | 启用的控制台账号 | 创建管理员账号时 |
| Agent 数 | 启用的 Agent | 创建 Agent 时 |
| Agent Key 数 | 启用的 Agent 名下,未撤销、未过期的 Key | 签发 Key 时 |
- 超过上限时,新建会被拒绝,并说明当前用量和上限。
- 已有的账号、Agent 和 Key 不会被自动停用或撤销。许可证调低上限之后,已有的继续工作,控制台显示「已超出」,只是不能再新增。
- 首个管理员不受上限限制,试用期间也不限制数量。
- 许可证还可以写明模块自己的上限。目前执行的是数脉的数据源数量,新建数据源超过上限时会被拒绝。其他模块上限只显示用量,不执行。
到期会怎样
状态变化会在控制台顶部以横幅提示,「系统设置 › 许可证」页面能看到当前状态和倒计时。
| 阶段 | 什么时候 | 模块调用 | 提示 |
|---|---|---|---|
| 试用中 | 首次初始化起 30 天内 | 全部模块可用 | 横幅显示剩余天数,最后 7 天为警告 |
| 试用宽限期 | 试用结束后 14 天 | 全部模块可用 | 显著警告 |
| 许可证有效 | 距到期超过 30 天 | 许可证包含的模块 | 无 |
| 即将到期 | 到期前 30 天内 | 许可证包含的模块 | 警告 |
| 宽限期 | 到期后 14 天 | 许可证包含的模块 | 显著警告 |
| 已停用 | 宽限期结束后 | 全部拒绝 | 错误横幅 |
有有效许可证时,没有写进许可证的模块也会被拒绝,即使试用期还没结束。这类调用会得到明确的中文错误,说明是许可证问题,和 Key 的权限无关,不需要重试。未授权的模块仍然列在 Agent 目录里。
宽限期结束后,什么仍然可用
- 控制台登录、许可证上传、审计、Agent 和 Key 管理、授权管理、模型设置、账号管理。
- 备份、恢复和套件切换。它们不经过核心接口,不受影响。
- 模块面板里的读取和导出。写操作会被拒绝。
- 各模块的定时任务(数脉的自动采集检查、知汇的定时同步、运枢的定时巡检、联枢的定时任务)不再启动新的一轮。上传新许可证后,下一次心跳到达时(至多 15 秒)各运行一次,不补跑错过的次数。
被拒绝的只是调用,产品不会修改或删除任何数据:模块数据、授权和 Key 都原样保留。上传有效的许可证后,立即恢复。
续期
续期时,我们签发一份新的许可证,你们照常上传。规则如下:
- 已经到了生效时间的许可证里,签发时间最晚的那一份生效。
- 可以提前上传续期许可证。它在自己的生效日期到达时,会在旧许可证到期时自动接替。
- 签发时间早于已安装许可证的文件不能再安装。例如我们缩减了模块之后,旧的、范围更大的许可证不能被重新上传。
换主机与恢复
部署 ID、试用起点和许可证都保存在核心数据库里,随备份一起保存。
- 用
restore.sh从备份恢复的部署,包括换到新主机,保留原来的部署 ID 和许可证。恢复后许可证继续有效。 - 全新安装会生成新的部署 ID,并且有新的 30 天试用。为旧部署签发的许可证不能用在新部署上,需要把新的部署 ID 发给我们重新签发。
备份和恢复的步骤见部署与初始化。
许可证的到期判断依赖主机时间。核心会记住观察到过的最晚时间,把主机时间往回调不会延长使用期限。请保持主机时间同步;如果时间曾被误调到未来,请联系我们换发有效期覆盖该时间的许可证。
上传被拒绝的常见原因
上传被拒绝时,页面会给出原因,括号里是对应的错误码。
| 原因 | 怎么处理 |
|---|---|
这份许可证属于另一个部署(DEPLOYMENT_MISMATCH) | 许可证里的部署 ID 和本部署不一致。核对「系统设置 › 许可证」页面上的部署 ID,必要时按这个 ID 重新申请。 |
已过期的许可证不能安装(EXPIRED) | 这份许可证的有效期已经结束。向我们申请新的许可证。 |
签发时间早于已安装的许可证(SUPERSEDED) | 已经安装了更新的许可证。需要的话,向我们确认应该使用哪一份。 |
签名校验失败(BAD_SIGNATURE) | 文件内容被改动过,或者在传输中损坏。请用我们发出的原始文件重新上传。 |
无法识别的签发密钥(UNKNOWN_KEY) | 当前版本不认这把签发密钥。请联系我们确认这份许可证适用的版本。 |
签名算法与密钥不一致(ALGORITHM_MISMATCH) | 文件内容不一致,请用我们发出的原始文件重新上传,仍然失败时联系我们。 |
测试用许可证(TEST_KEY_IN_PRODUCTION) | 用测试密钥签发的许可证不能用在正式部署上。请联系我们换发正式的许可证。 |
文件格式不对(MALFORMED、UNSUPPORTED_FORMAT) | 文件不是完整的许可证,或者是当前版本不支持的格式。文件不超过 32 KiB,请用原始的 .license.json 文件。 |
编号相同但内容不同(DUPLICATE_LICENSE_ID) | 已经安装过同一编号、内容不同的许可证。请联系我们确认。 |
每次安装和每次被拒绝,都会写进审计记录。