每个 Cyberun 部署都运行在一份由 Cyberun 颁发的许可证之上。一个与其余组件一起部署的 License Server 组件负责校验许可证,并向 API 服务器和网关签发短期租约(lease)。许可证决定了部署对外暴露哪些功能,以及适用哪些容量上限。 本页关注生命周期 —— 许可证承载哪些内容、到期时会发生什么、续订如何进行、气隙部署如何处理。被门控内容的完整枚举见功能目录。Documentation Index
Fetch the complete documentation index at: https://docs.cyberun.cloud/llms.txt
Use this file to discover all available pages before exploring further.
许可证承载什么
签名许可证文件内含两部分载荷:- 功能 —— 一组布尔授权。每个标志启用一种能力(MCP 服务器、webhooks、容器服务、Nerfstudio、OIDC 提供商、自定义模型等)。每个部署模板的默认值的完整列表见功能目录。
- 配额 —— 数值上限。用户、团队、代理、并发任务、单团队成员数、单团队集成凭证数等若干计数。
-1表示不限,0表示禁用,>0是硬上限。按键的命名空间不同,执行落在每团队或每部署层级。
校验如何进行
校验不是一次性的本地文件检查。它通过 License Server 进行 —— 这是你在每个 Cyberun 安装中都要部署的组件:- License Server 读取许可证文件,使用嵌入的公钥校验签名,并把许可证绑定到主机或集群。
- 启动时,API 服务器和网关通过一次质询-响应握手(challenge-response)经 HTTP 连接到 License Server,然后请求一份初始租约(lease)—— 即功能与配额载荷的一份短期、已签名快照。
- 后台刷新按节奏续订租约,因此许可证的撤销或变更会在数分钟内生效,无需重启。
CYBERUN_LICENSE_SERVER_ADDRESSES 中的地址访问 License Server(默认 http://localhost:9400)。你可以列出多个地址用于故障转移;系统按顺序逐个尝试,直到有一个应答。部署要能启动并持续运行,License Server 必须已部署且可达。
如果 License Server 变得不可达,API 服务器和网关会在一个宽限窗口内(当前为 24 小时)继续以最后一份有效租约提供服务。超过该窗口后,受管操作将被阻止,直到 License Server 重新可达。核心管理路径保持可用,以便你恢复。
有效的许可证除功能与配额载荷外还携带过期日期。当过期日期一过,校验便开始返回许可证过期错误。续订是一次许可证重新颁发 —— Cyberun 用更新的日期签发新文件,并通过约定的通道交付。
当许可证过期或校验失败时
被门控的操作开始以503(服务不可用)拒绝请求。在仍然有效的许可证中被关闭的功能则返回 403。错误响应会标识具体情况,让控制台得以呈现说明性页面而不是空壳。
被标记为 core 的操作仍能正常工作 —— 登录、列出团队、基础读取路径、许可证重载。设计意图是让管理员能够续订而不会把自己锁在门外。
上面描述的不可达宽限窗口不适用于过期:一旦许可证自身的过期日期一过,便没有宽限期。请在到期前规划续订。Cyberun 的续订提醒节奏与合作伙伴侧提醒工具正在编写中;目前续订需在到期日之前与 Cyberun 协调。
续订
对于 Cyberun 托管服务,许可证续订由平台团队自动处理 —— 无需运维方操作。 对于自托管合作伙伴部署:- Cyberun 用更新的过期日与协商好的任何功能变更签发新的许可证文件。
- 通过约定的通道交付已签名的文件(安全文件传输、密钥托管人等)。
- 运维方把文件放到 License Server 读取的路径下(取决于部署),并重启 License Server,使其重新读取并重新校验该文件。
- API 服务器和网关在下一次租约刷新时接入新的功能与配额载荷 —— 这些组件无需重启。
气隙部署
气隙部署与联网部署的工作方式完全相同。License Server 在气隙环境内部本地运行,因此 API 服务器、网关与 License Server 之间的质询-响应握手和租约刷新都无需出站连接。校验路径上的任何环节都不会访问公共互联网。 确实需要人工步骤的是许可证文件的重新颁发,因为 Cyberun 在气隙边界之外为其签名:- Cyberun 离线签发已续订的许可证文件。
- 合作伙伴管理员通过现有的介质管控流程把它带入气隙环境,并为本地 License Server 安装它。
- 本地 License Server 重新读取新文件,API 服务器和网关在下一次租约刷新时接入该变更。