本地运行部署
约 1628 字大约 5 分钟
2026-08-21
一、后端环境准备
ThingsBrain 是基于 Dante Cloud 构建的物联网平台。本地开发运行环境与 Dante Cloud 微服务版本或者单体版本环境完全相同。您可以跟随 【环境准备】（在新窗口打开） 章节，准备以下内容：
重要
因不同的用户，个人经验、水平差异很大，就导致不同用户搭建环境方法以及配置也会出现较大差异。千万别小看基础环境的搭建，往往很多所谓的问题，都是因为基础环境搭建上产生的细小差异所导致。所以，建议您认真阅读【环境准备】中内容，尽可能保持与作者的环境和配置相一致，这样可以减少很多不必要的问题发生。即使出现问题，在沟通时也更容易排除环境干扰、定位真正问题。
如果您非常有信心自己可以解决相关的问题，那么也完全可以按照自己的思路和方式准备环境。最忌讳的就是：信心有余然能力不足，既对他人内容不屑一顾，除了问题自己又解决不了，描述问题又说不到重点，平白浪费时间而已。
二、后端运行部署
[一]全新部署应用
1. 创建数据库
这里以 PostgreSQL 为例，在 PostgreSQL 自带的命令行工具中，执行以下命令：
// 创建用户 athena 密码是 athena
CREATE USER athena WITH PASSWORD 'athena';
// 创建数据库 thingsbrain, 并将用户 athena 分配给该数据
CREATE DATABASE thingsbrain OWNER athena;
// 将数据库 thingsbrain 的所有权限分配给 athena
GRANT ALL PRIVILEGES ON DATABASE thingsbrain TO athena;2. 检出并编译代码
检出工程代码，使用 mvn install 或者通过 IDEA 界面操作进行编译。
说明
ThingsBrain 需要依赖 Dante Engine 和 Dante Cloud 工程代码。Dante Engine 和 Dante Cloud 工程模块已经上传至中央仓库，检出 ThingsBrain 工程代码后，无需任何操作依赖会自动下载。
如果要自行修改代码，需要检出 Dante Engine 和 Dante Cloud 工程代码。然后使用 mvn install 命令或者通过 IDEA 界面操作，先编译 Dante Engine 工程代码，再编译 Dante Cloud 工程代码。以上操作完成之后，本地 Maven 仓库就会生成相关的模块。
3. 创建数据表
代码检出后，在工程中找到 thingsbrain-monomer-application, 修改工程下 appliation.yml 中相关的配置信息。主要修改数据库连接和Redis连接即可。
然后，启动 ThingsBrainApplication 应用。ThingsBrainApplication 正常启动之后，会自动创建数据表以及自动完成基础信息的采集。
如果看到有数据库表创建，同时
sys_authority、sys_interface、sys_attribute等表中有数据，证明数据库表创建成功。
4. 数据库初始化
在工程中 thingsbrain-monomer-application 模块下，找到数据库初始化脚本，并导入到数据库中。
- 先执行
iot-data-postgresql.sql: 该脚本与 Dante Cloud 单体版数据初始化脚本完全相同 - 再执行
iot-standalone-data-postgresql.sql: 该脚本为 ThingsBrain 专用的数据初始化内容 - 最后执行
iot-test-data-postgresql.sql: 该脚本是可选的脚本，其中包含的是 Demo 用户的物模型等相关数据。可根据需要自行选择是否需要初始化。
5. 重置缓存
原理和设计与微服务版本完全相同，可以查阅 【重置缓存】 章节
6. 重启应用
以上步骤操作完成之后，再次启动 ThingsBrainApplication 应用即可以使用。整个安装部署工作就完成了。
[二]使用现有工程
说明
作为 Dante Cloud 的生态产品，ThingsBrain 既可以独立使用，也可以做 Dante Cloud 单体版模块或者微服务版中的一个服务来使用。
如果您已经搭建或者使用了 Dante Cloud 微服务版或者单体版，那么可以在此基础之上扩展 ThingsBrain 功能支持。
1. 检出并编译代码
检出工程代码，使用 mvn install 或者通过 IDEA 界面操作进行编译。
2. 创建数据表
代码检出后，在工程中找到 thingsbrain-monomer-application, 修改工程下 appliation.yml 中相关的配置信息。主要修改数据库连接和Redis连接即可。
然后，启动 ThingsBrainApplication 应用。ThingsBrainApplication 正常启动之后，会自动创建数据表以及自动完成基础信息的采集。
如果看到有
iot_开头的数据库表创建，证明数据库表创建成功。
3. 数据库初始化
在工程中 thingsbrain-monomer-application 模块下，找到数据库初始化脚本，并导入到数据库中。
- 先执行
iot-standalone-data-postgresql.sql: 该脚本为 ThingsBrain 专用的数据初始化内容 - 再执行
iot-test-data-postgresql.sql: 该脚本是可选的脚本，其中包含的是 Demo 用户的物模型等相关数据。可根据需要自行选择是否需要初始化。
4. 重置缓存
原理和设计与微服务版本完全相同，可以查阅 【重置缓存】 章节
5. 重启应用
以上步骤操作完成之后，再次启动 ThingsBrainApplication 应用即可以使用。整个安装部署工作就完成了。
提示
以上内容主要针对的是 Dante Cloud 单体版，Dante Cloud 微服务版操作过程也相同。将 ThingsBrainApplication 更换为 dante-cloud-iot-ability 服务即可。
三、前端运行部署
ThingsBrain 的前端，并没有使用独立的前端工程，还是使用的 Dante Cloud 前端 herodotus-cloud-ui-vuetify 工程。所以，参照 【前端系统运行】 章节，检出代码部署运行即可。
提示
如果您之前已经部署使用了 Dante Cloud 单体版或者微服务版，那么参照前面内容部署好了 ThingsBrain 后端应用之后。更新前端代码重启前端应用，就可以看到 ThingsBrain 的前端。
警告
目前，仅在 herodotus-cloud-ui-vuetify 工程中，完成了 ThingsBrain 前端的开发。基于 Quasar 的旧版前端工程 dante-cloud-ui 中，ThingsBrain 相关功能还在开发中，尚不能使用。
