软件授权
打开授权页
管理员登录后进入“系统中心 → 软件授权”。页面会显示：
- 授权状态、套餐、许可证有效期；
- 离线可用截止时间；
- 产品名称、实例 ID、最近成功验证时间；
- 当前许可证返回的真实功能权益；
- 激活、立即验证或解绑入口。
首次激活
- 确认当前站点就是许可证对应的矩阵盘实例；
- 输入正式渠道获得的
KG-...许可证； - 点击“激活许可证”；
- 等待远程激活、令牌验证和加密保存全部完成；
- 刷新页面，确认状态为已授权，并核对有效期和功能权益。
许可证属于敏感凭据。不要出现在截图、日志、URL、聊天记录或版本库中。
固定实例 ID
实例 ID 保存于持久化的 runtime/ 目录，重启和升级不会改变。以下行为风险很高：
- 删除或替换整个
runtime/； - 把已激活实例的运行目录复制给另一位客户；
- 恢复数据库却没有恢复原实例 ID 和配置加密密钥；
- 同时运行迁移前和迁移后的两个副本。
迁机前先确认许可证允许的实例数量和解绑流程。恢复备份不等于自动获得第二个可用实例。
立即验证与离线状态
“立即验证”会向 Keygate 核对当前许可证。网络暂时不可达时，只要本地签名令牌仍在允许期限内，页面会明确显示离线有效状态和剩余时间；这不等于重新延长授权。
Keygate 明确拒绝、许可证到期或本地令牌到期后，业务接口和新任务会停止。健康检查和必要的管理员登录、授权、升级与恢复入口仍保留。
解绑实例
解绑会使当前实例停止业务，但不会删除已有数据库和文件。执行前：
- 确认目标实例 ID；
- 确认没有正在运行的业务任务；
- 备份数据库、配置和完整
runtime/； - 阅读确认提示后再执行；
- 等待服务端确认成功，不要看到按钮点击就认为已经解绑。
解绑失败时保持原状态，并根据错误检查网络、许可证状态或上游响应。
常见问题
程序健康但搜索不可用：先检查授权状态；“服务存活”和“业务已获授权”不是同一个状态。
重启后变成未激活：检查 runtime/ 是否持久化，以及实例 ID、许可证状态和配置加密密钥是否一起恢复。
许可证输入后仍失败：确认产品、实例数量和许可证状态，不要关闭授权要求或尝试绕过签名验证。