diff --git a/docs/zh/14-reference/01-components/13-license-center/assets/image-20260501002702206.png b/docs/zh/14-reference/01-components/13-license-center/assets/image-20260501002702206.png new file mode 100644 index 000000000000..56a46d16c0e7 Binary files /dev/null and b/docs/zh/14-reference/01-components/13-license-center/assets/image-20260501002702206.png differ diff --git a/docs/zh/14-reference/01-components/13-license-center/assets/license-center-access-cls-login.png b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-access-cls-login.png new file mode 100644 index 000000000000..ec92ce8ae4ca Binary files /dev/null and b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-access-cls-login.png differ diff --git a/docs/zh/14-reference/01-components/13-license-center/assets/license-center-cls-license-import-dialog.png b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-cls-license-import-dialog.png new file mode 100644 index 000000000000..fa19f93a70fe Binary files /dev/null and b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-cls-license-import-dialog.png differ diff --git a/docs/zh/14-reference/01-components/13-license-center/assets/license-center-cls-license-imported.png b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-cls-license-imported.png new file mode 100644 index 000000000000..b84044b69315 Binary files /dev/null and b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-cls-license-imported.png differ diff --git a/docs/zh/14-reference/01-components/13-license-center/assets/license-center-cls-quota-management.png b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-cls-quota-management.png new file mode 100644 index 000000000000..1a9e5748cfb7 Binary files /dev/null and b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-cls-quota-management.png differ diff --git a/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-cls-created.png b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-cls-created.png new file mode 100644 index 000000000000..0a756308f20c Binary files /dev/null and b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-cls-created.png differ diff --git a/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-cls-register-form.png b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-cls-register-form.png new file mode 100644 index 000000000000..b90fa987f275 Binary files /dev/null and b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-cls-register-form.png differ diff --git a/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-customer-create-entry.png b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-customer-create-entry.png new file mode 100644 index 000000000000..a118620e54e0 Binary files /dev/null and b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-customer-create-entry.png differ diff --git a/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-customer-create-form.png b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-customer-create-form.png new file mode 100644 index 000000000000..12b396759297 Binary files /dev/null and b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-customer-create-form.png differ diff --git a/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-customer-created.png b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-customer-created.png new file mode 100644 index 000000000000..5290f11b2c4d Binary files /dev/null and b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-customer-created.png differ diff --git a/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-license-create-form.png b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-license-create-form.png new file mode 100644 index 000000000000..d31c907901a5 Binary files /dev/null and b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-license-create-form.png differ diff --git a/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-license-created.png b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-license-created.png new file mode 100644 index 000000000000..bdff6e2f0e61 Binary files /dev/null and b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-license-created.png differ diff --git a/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-offline-token-download.png b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-offline-token-download.png new file mode 100644 index 000000000000..bcc6f6a95a86 Binary files /dev/null and b/docs/zh/14-reference/01-components/13-license-center/assets/license-center-els-offline-token-download.png differ diff --git a/docs/zh/14-reference/01-components/13-license-center/index.mdx b/docs/zh/14-reference/01-components/13-license-center/index.mdx new file mode 100644 index 000000000000..c09cae085635 --- /dev/null +++ b/docs/zh/14-reference/01-components/13-license-center/index.mdx @@ -0,0 +1,172 @@ +--- +title: License-Center 参考手册 +sidebar_label: License-Center +toc_max_heading_level: 4 +--- + +License Center 是一个用于管理 TDengine TSDB / IDMP 授权的 Web 服务,包含中心侧的 ELS 管理端和本地侧的 CLS 管理端。本文以当前本地已部署的 CLS 为例,介绍离线授权的完整操作流程。 + +## 前置条件 + +### 部署安装 + +解压安装包: + +```bash +license-center-cls-0.1.0-linux-amd64.tar.gz +``` + +解压后即可看到部署相关脚本: + +```bash +scripts/ +├── install.sh +├── start.sh +├── status.sh +├── stop.sh +└── uninstall.sh +``` + +执行 install.sh,start.sh 后即可启动服务。 + +### 配置信息 + +默认配置文件在 `/etc/taoscls/taoscls.toml`: + +```toml +[local] +listen = "0.0.0.0" +http_port = 6072 +rpc_port = 6073 + +[els] +host = "192.168.2.158" +port = 8094 +enable = true + +[database] +path = "/var/lib/taoscls" + +[log] +level = "info" +file = "/var/log/taoscls/taoscls.log" +``` + +参数说明: + +- `local.listen`: 表示服务监听的地址,默认 0.0.0.0 表示监听所有网卡地址 +- `local.http_port`: 表示开启的 http api 服务端口 +- `local.rpc_port`: 表示与 ELS 服务通信端口 +- `els.host`: 表示 ELS 服务的地址 +- `els.port`: 表示 ELS 服务的端口 +- `els.enable`: 表是否开启与 ELS 的通信 +- `database.path`: 表示数据存放路径 +- `log.level`: 表示日志级别 +- `log.file`:表示日志路径 + +### 服务信息 + +- 已在本地启动 CLS 服务,默认情况下会在本机管理端显示 `CLS ID` 和公钥令牌。 +- 浏览器可正常访问: + - CLS:`http://localhost:6072` +- 本文示例中的本地体验账号均为: + - 用户名:`root` + - 密码:`taosdata` + +## 本地体验部署与访问 + +启动完成后,在浏览器中分别打开 CLS 管理端并登录。 + +![CLS 登录页](./assets/license-center-access-cls-login.png) + +## 离线授权操作流程 + +### 1. 在 ELS 中创建客户 + +登录 ELS 后,进入左侧 **客户管理**,点击右上角 **创建客户**。填写客户名称、邮箱、公司等信息后提交。 + +![进入客户管理](./assets/license-center-els-customer-create-entry.png) + +![填写客户信息](./assets/license-center-els-customer-create-form.png) + +创建成功后,客户会出现在列表中。 + +![客户创建完成](./assets/license-center-els-customer-created.png) + +### 2. 在 ELS 中注册 CLS + +登录 CLS 后,可以在左侧 **本机信息** 页面查看并复制当前设备的 `CLS ID` 与 **公钥令牌 (Base64)**。拿到公钥令牌后,回到 ELS 的 **CLS 管理** 页面,点击 **创建 CLS**,选择刚创建的客户并粘贴公钥令牌,完成注册。 + +![填写 CLS 注册信息](./assets/license-center-els-cls-register-form.png) + +注册成功后,可以在 CLS 列表中看到新建记录以及对应的 `CLS ID`。 + +![CLS 注册完成](./assets/license-center-els-cls-created.png) + +### 3. 在 ELS 中签发许可证 + +在 **CLS 管理** 或 **许可证管理** 中为目标 CLS 发起签发。当前界面会要求选择许可证类型、有效期、TSDB 配额数量和 IDMP 配额数量,并自动带出授权项。 + +![填写许可证信息](./assets/license-center-els-license-create-form.png) + +签发完成后,许可证会出现在 **许可证管理** 列表中。 + +![许可证签发完成](./assets/license-center-els-license-created.png) + +### 4. 在 ELS 中导出离线令牌 + +打开刚签发的许可证详情页,在右侧 **离线令牌** 区域点击 **下载令牌**,浏览器会下载文件 `offline-license.token`。 + +![下载离线令牌](./assets/license-center-els-offline-token-download.png) + +### 5. 在 CLS 中导入 `offline-license.token` + +回到 CLS 的 **许可证管理** 页面,点击右上角 **离线导入**,选择刚从 ELS 下载的 `offline-license.token`,然后点击 **导入**。 + +![选择离线令牌文件](./assets/license-center-cls-license-import-dialog.png) + +导入成功后,许可证会出现在 CLS 的许可证列表中。 + +![离线令牌导入完成](./assets/license-center-cls-license-imported.png) + +### 6. 在 CLS 中查看配额管理 + +进入左侧 **配额管理** 页面,可以查看该许可证拆分后的配额和授权项明细,包括许可证 ID、配额 ID、授权项、类别、类型、值和过期时间。 + +![查看配额管理](./assets/license-center-cls-quota-management.png) + +## 后续说明 + +完成离线授权后,启动 IDMP / TSDB 并开始正常上报心跳,相关集群与使用量信息会逐步出现在 ELS 和 CLS 的 **集群管理** 页面中,便于后续持续查看授权使用情况。 + +## TSDB 集群配置 + +### 使用 SQL 配置 + +TSDB 配置可以使用如下 4 个 SQL 指令配置 CLS 服务相关信息,示例如下: + +```bash +ALTER ALL DNODES 'clsEnabled' '1'; +ALTER ALL DNODES 'clsRefreshInterval' '15'; +ALTER ALL DNODES 'clsUrl' 'http://192.168.2.158:6072'; +ALTER ALL DNODES 'clsLicenseId' 'lic-53467044-2dad-4be2-9280-adacb201a644'; +``` + +说明: + +`clsEnabled`: 表示是否开启 CLS 许可证功能 + +`clsRefreshInterval`: 表示与 CLS 服务通信间隔 + +`clsUrl`: 表示 CLS 服务地址 + +`clsLicenseId`: 表示要获取的许可证 ID + +### 使用 taos-explorer 配置 + +在 taos-explorer 组件的 系统管理/许可证 页面,点击激活许可证按钮后,可以看到如下配置页面: + +![image-20260501002702206](./assets/image-20260501002702206.png) + +配置字段含义和 SQL 配置一致。 +