License 管理

发布版本

License 功能首次随以下平台组件版本发布：

历史项目升级时，应同时核对以上三个组件的实际版本，避免因部分组件未升级导致 License 功能不完整。

License 功能概览

License 用于记录平台授权信息，为项目交付、续期和授权异常处理提供依据。

功能入口：超级管理员 → 管理后台 → 授权管理。授权管理页包含 授权概览 和 通知策略配置 两个页签。

申请 License 需要的信息

首次申请或重新申请 License 前，应确认：

• 客户正式名称

• 项目名称和部署环境，例如生产、测试或演示环境

• 授权产品

• License 生效日期和到期日期

• 授权用户数

• 客户访问平台使用的域名、IP 或 CIDR

• 申请类型，例如首次申请、续期、扩容、客户信息变更或访问地址变更

重新申请时，还应提供当前 License ID，并说明重新申请的原因和发生变化的授权信息。

历史项目处理

历史项目升级至包含 License 功能的版本时，升级过程不会自动生成 License。生产环境升级前，应完成 License 申请并取得有效 License，同时按照现有升级规范准备数据备份和回退方案。

推荐流程如下：

1. 盘点当前部署环境及 deepfos-platform、frontend、web-gateway 的版本，确认本次升级的目标版本。

2. 确认客户名称、授权产品、有效期、授权用户数及实际使用的域名、IP 或 CIDR，提交 License 申请。

3. 在升级前取得有效 License，并确认其生效日期覆盖计划升级时间。

4. 运维人员在升级窗口内完成三个组件的升级和 License 配置。

5. 升级后进入授权管理页核对授权状态和授权信息，并使用客户实际访问入口验证平台访问。

6. 验证通知接收人及测试邮件，留存 License ID、授权页面截图、到期日期和续期负责人。

客户实际使用的域名、IP 或 CIDR 应完整包含在 License 白名单中，否则升级后可能无法访问平台。如果授权状态或平台访问异常，应先检查 License 是否已部署、生效日期和到期日期是否正确、授权信息及白名单是否匹配，再协调运维人员检查部署配置和服务状态。

新项目交付流程

新项目应在首次部署前完成 License 申请并取得有效 License，避免平台上线后再补充授权，影响验收和客户使用。

1. 确认计划部署的 deepfos-platform、frontend、web-gateway 均为包含 License 功能的版本。

2. 在合同或售前阶段确认客户名称、授权产品、有效期、授权用户数及实际使用的域名、IP 或 CIDR，提交 License 申请。

3. 在部署前取得有效 License，确认其生效日期覆盖计划上线时间，且白名单包含客户实际访问入口。

4. 运维人员在平台部署时完成三个组件的部署和 License 配置。

5. 部署后进入授权管理页核对授权状态和授权信息，并使用客户实际访问入口验证平台访问。

6. 验证通知接收人及测试邮件，留存 License ID、授权页面截图、到期日期和续期负责人。

续期、扩容和变更

License 不支持直接修改。出现以下情况时，需要重新申请 License：

• License 到期续期

• 授权用户数变化

• 客户名称或授权产品变化

• 客户访问域名、IP 或 CIDR 变化

• 新增或切换部署环境

• 其他授权范围变化

推荐流程如下：

1. 确认当前 License ID、重新申请的原因、发生变化的授权信息及计划生效时间。

2. 按照新的授权范围提交 License 申请。

3. 续期应在当前 License 到期前完成申请和配置；扩容或变更应在新授权范围正式使用前完成。

4. 重新申请完成并取得 License 后，由运维人员在部署侧完成配置。

5. 配置完成后，核对授权状态和授权信息，使用客户实际访问入口验证平台访问，并更新项目记录。

宽限期仅用于异常情况下的短期缓冲，不应作为常规续期周期。进入宽限期后，应按高优先级完成重新申请和配置；进入硬停状态后，用户无法继续访问平台，应按紧急事项处理。

常见问题

历史项目升级后为什么显示未授权？

常见原因是 License 尚未配置、部署配置错误、License 无效或尚未到生效日期。应确认是否已取得有效 License 并完成部署，同时核对生效日期；仍无法解决时，再协调运维人员检查部署配置和服务状态。

是否可以先升级、后申请 License？

生产环境不应先升级、后申请 License。升级过程不会自动生成 License，应在升级前完成申请并取得有效 License，再由运维人员在升级窗口内完成配置。

到期提醒邮件没收到怎么办？

先确认企业管理员邮箱是否有效，以及额外接收人是否已启用并保存，再发送测试邮件。如果测试邮件仍未收到，应协调运维人员检查邮件服务配置和网络连通性。