ThingsBoard 的版本控制使用 Gitee
正文与配图来自原稿。把仪表板、规则链、设备等实体像代码一样提交到 Gitee,可回滚。
1、准备 Gitee 仓库
注册 Gitee,创建空间与仓库,用于存 ThingsBoard 版本数据:

2、租户层配置版本控制
进入租户 → 版本控制,填写:
| 项 | 示例(请换成你的) |
|---|---|
| 仓库 URL | https://gitee.com/<你的空间>/<仓库>.git |
| 分支 | master(或 main) |
| 身份验证 | 密码或访问令牌 |
| 用户名 | Gitee 用户名 |

注意(本地跑 TB): 删除仓库后若报目录仍被引用(如C:\Users\…\AppData\Local\Temp\repositories),先停掉 TB,清掉该临时目录再启动。
请使用访问令牌,勿把账号密码写进文档或提交到 Git。
3、测试
3.1、设备页创建版本
点击创建版本:

弹窗确认后创建:


Gitee 上可见提交:

修改设备后出现变更:


再点创建版本会提交:


还原
还原到某一版本:

查看还原后数据:

自动提交策略
在 Settings 配置自动提交(如对设备开启):

修改设备描述后出现自动提交:



自动提交说明(原稿):
通过 UI 或 REST 保存实体时,可自动提交仪表板、规则链等;异步执行以改善体验。将实体分配给客户(改所有者)时不会自动提交,此时应对该实体类型用覆盖策略提交全部实体。
恢复界面:下拉列表中是可恢复实体,去掉不需要的项后点 Restore:

总结
ThingsBoard 版本控制本质是对接 Git:实体可版本化、可回滚,用法接近日常代码提交。
补充(辅)
- 需租户开通版本控制能力(CE/PE 与版本以你环境为准)。
- 生产建议用 Personal Access Token,仓库私有。
- 大实体、频繁自动提交会增加 Git 体积,按需选择实体类型。
