mirror of
https://github.com/kuaifan/dootask.git
synced 2026-08-01 19:05:55 +00:00
78 lines
2.7 KiB
Markdown
78 lines
2.7 KiB
Markdown
---
|
||
id: license.howto
|
||
title: 申请与录入 License
|
||
type: howto
|
||
feature: license
|
||
scope: super-admin
|
||
locale: zh
|
||
aliases:
|
||
- 申请 License
|
||
- 录入 License
|
||
- 怎么填 License
|
||
- 提交 License
|
||
- 上传授权
|
||
- License 填哪里
|
||
- 终端绑定
|
||
- 怎么扩容用户数
|
||
related_tools: []
|
||
related_pages: []
|
||
prerequisites:
|
||
- 需要进入「系统设置」→「License」页面（仅管理员可见）
|
||
- 保存 License 仅超级管理员（第一个注册用户）可执行
|
||
negative:
|
||
- 不能在终端外部直接编辑 License 文件，必须走管理端 API
|
||
- 一份 License 仅对当前终端的 SN + MAC 有效，换机或换网卡需重新申请
|
||
- 不支持把 License 拆给多个独立部署共享
|
||
last_verified: 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
|