dootask/resources/ai-kb/zh/howto/license/apply.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
license.howto	申请与录入 License	howto	license	super-admin	zh	申请 License 录入 License 怎么填 License 提交 License 上传授权 License 填哪里 终端绑定 怎么扩容用户数			需要进入「系统设置」→「License」页面（仅管理员可见） 保存 License 仅超级管理员（第一个注册用户）可执行	不能在终端外部直接编辑 License 文件，必须走管理端 API 一份 License 仅对当前终端的 SN + MAC 有效，换机或换网卡需重新申请 不支持把 License 拆给多个独立部署共享	v1.7.90

申请与录入 License

入口

桌面端：左上角头像 →「系统设置」→「License」（仅管理员可见）。 对应后端：POST api/system/license，type=save 写入。

操作步骤

第 1 步 - 获取当前终端信息

在「License」页面顶部，DooTask 会显示：

• doo_sn — 终端 SN（机器指纹，每次部署生成）
• macs — 当前服务器网卡 MAC 列表（用于绑定校验）
• doo_version — 当前主程序版本号
• user_count — 当前真实用户数（剔除机器人和禁用号）

这些字段是申请 License 时必须提供给签发方的信息。

第 2 步 - 申请 License

访问 DooTask 官网（或销售渠道）提交：

• 终端 SN（必填）
• 终端 MAC（一张或多张）
• 期望的最大用户数
• 期望的有效期
• 是否需要按 SN 严格绑定

收到 License 原文（加密字符串）后进入下一步。

第 3 步 - 录入 License

1. 把官方返回的 License 原文整段复制
2. 粘贴到「License」页的输入框
3. 点击「保存」（接口字段 license，调用 type=save）
4. 后端用 Doo::licenseSave() 写入终端 License 文件
5. 页面自动刷新校验结果：info 字段重新解析，error 数组为空表示通过

校验结果解读

返回结构里 error 数组列出当前不满足的规则：

• 终端SN与License不匹配 — License 对应的 SN ≠ 当前 doo_sn（多发生在换机迁移）
• 终端MAC与License不匹配 — License MAC 名单与本机网卡无交集
• 终端用户数超过License限制 — user_count > people，需要扩容或停用账号
• 终端License已过期 — expired_at 已经过去

详细处理见 license.expire.faq。

不支持

• 普通管理员能看 License 信息但不能保存；只有超级管理员（id=1）能 save
• 不支持上传文件方式，仅接受文本字段
• 3 人以下的部署不强制 License，但用户数严格限制为 3