License 激活与验证：Key 格式说明、激活接口、激活失败的排查步骤
关于 License，公开资料能确认的是激活方式、在线 / 离线模式、namespace 绑定与激活后重启 enterprise 服务的要求。
这篇培训内容的一个重点，是要把“公开可确认的部分”和“需要内部补充的部分”明确分开。公开文档已经足以支持一版激活流程培训：包括在线 / 离线激活、离线模式需要切换 licenseMode、激活后需重启 dify-enterprise、以及 namespace 绑定关系。但关于 License Key 的内部格式、商务发放机制和某些后台字段，公开资料确实没有完整披露。
一、从公开资料能确认的 License 激活边界
1. 激活流程是部署流程的一部分，不是独立动作
官方文档已经明确把激活放在 Enterprise Dashboard 初始化与部署步骤之后，这意味着培训时必须把“部署完成 → 后台初始化 → License 激活”讲成一条连续链路。
2. 在线与离线流程都已公开可确认
公开文档已经给出两套流程：
- 在线激活：输入 License ID
- 离线激活：切
licenseMode、复制 Cluster ID、回填 Offline Code
3. 验证动作至少包括状态确认与服务重启
官方文档明确说明，激活或刷新后需要重启 dify-enterprise，因此培训时不能把“看到已激活”当作结束，而应再验证服务生效状态。
二、已知公开信息
- 支持在线激活与离线激活
- 离线模式需要在 values.yaml 中切换
licenseMode - 激活完成后需要重启
dify-enterprise - License 与 namespace 绑定
三、验证步骤建议
- 登录 Enterprise Dashboard
- 检查 License 状态
- 确认功能是否按授权生效
- 重启 enterprise 后再次确认状态保持
四、激活失败排查
- namespace 是否与预期一致
- 网络是否允许在线激活
- 离线码是否匹配当前 Cluster ID
- enterprise 服务是否已重启
五、需要你补充的部分
公开资料未充分披露 License Key 的内部格式细节与完整激活接口字段。如果你们内部培训需要展示这部分，请在本文件补充企业版后台截图、Key 样例脱敏版或正式 SOP。
公开资料线索
note.com
- 当前暂无特别强的 note.com 直接命中文章，当前更适合以 Enterprise 官方 License 文档为依据。
zenn.dev / 官方文档 / 其他公开页面
- License Activation - Dify Enterprise Docs | https://enterprise-docs.dify.ai/versions/3-0-x/en-us/deployment/license-activation
- Kubernetes - Dify Enterprise Docs | https://enterprise-docs.dify.ai/en-us/deployment/prerequisites/kubernetes
- Dify Helm Chart - Dify Enterprise Docs | https://enterprise-docs.dify.ai/en-us/deployment/advanced-configuration/dify-helm-chart
这篇当前能从公开资料确认的有效信息
- License 激活支持在线与离线两种模式
- 离线激活需要切换
licenseMode并使用 Cluster ID / Offline Code - 激活或刷新后需要重启
dify-enterprise才会生效