企业官网建设流程全解析

4步上手ThingsBoard物联网平台：从一键部署到完成第一次界面改造

【免费下载链接】thingsboardOpen-source IoT Platform - Device management, data collection, processing and visualization.项目地址: https://gitcode.com/GitHub_Trending/th/thingsboard

搭一个能用的IoT平台，常被"Java后端+前端+消息队列+数据库"的依赖链劝退。这篇文章带你用4条Docker命令部署ThingsBoard物联网平台，再亲手改一次界面主题色——读完你能独立跑起设备管理与数据可视化环境，并完成第一个真实改动。

项目速览：ThingsBoard 能做什么

ThingsBoard 是一个开源 IoT 平台，覆盖设备管理、遥测数据采集、规则引擎处理和仪表盘可视化四个核心环节：设备通过 MQTT/HTTP/CoAP/LwM2M 等协议接入，数据经可编排的规则链（Rule Chain）加工，最终以实时仪表盘呈现，还能配置告警与通知。技术栈一句话：后端 Java + Spring Boot，前端 Angular 20，消息队列支持 Kafka/RabbitMQ 等，可整体容器化运行。

最短路径跑起来：Docker 一键安装

环境要求：已安装 Docker 与 Docker Compose，端口 8080 空闲。默认使用 PostgreSQL 数据库（docker/.env 中DATABASE=postgres），无需额外配置。

git clone https://gitcode.com/GitHub_Trending/th/thingsboard cd thingsboard/docker ./docker-install-tb.sh --loadDemo ./docker-start-services.sh

看到什么算成功：浏览器打开http://localhost（端口 8080），出现 ThingsBoard 登录页。用系统管理员sysadmin@thingsboard.org / sysadmin登录；因为加了--loadDemo，还能用tenant@thingsboard.org / tenant看到预置的演示设备与仪表盘。

关键目录速查：代码在哪

动手改：把平台主色调换成自己的颜色

定位。ThingsBoard 前端主题色集中在 ui-ngx/src/scss/constants.scss 第 37 行，被 ui-ngx/src/theme.scss 的 Material 色板引用：

$tb-primary-color: #305680; // 改成你喜欢的颜色，例如 #c0392b

修改。前端开发服务器会自动代理到本地 8080 的后端（见 ui-ngx/proxy.conf.js），所以保持上面 Docker 服务运行，然后：

cd ui-ngx yarn install yarn start

验证。yarn start启动后浏览器打开对应地址，登录页按钮、侧边栏选中态等主色区域应变为新颜色——这就是你第一次改完 ThingsBoard 界面。

踩坑与排查：新手最常遇到的4个问题

1. 页面打不开或 502→ 现象：安装脚本跑完立刻访问失败。原因：初始化数据库耗时，容器尚未就绪。解法：docker-compose ps查看状态，docker-compose logs -f跟踪 tb-core 日志，全部 Up 后再访问。
2. 8080 端口被占用→ 现象：start 脚本报端口冲突。原因：本机已有应用占用。解法：停掉占用进程，或修改 docker/docker-compose.yml 中8080的端口映射。
3. 登录后看不到演示设备→ 现象：只有空的系统管理界面。原因：安装时漏加--loadDemo。解法：重装时带上该参数，或用 sysadmin 账号手工创建设备。
4. ui-ngx 装依赖失败→ 现象：yarn install报版本或网络错误。原因：项目锁定 Node 22（见 ui-ngx/pom.xml），且部分依赖（如 echarts）指向远程压缩包，必须能出网。解法：切到 Node 22，确保网络可达后重试。

继续深入：下一步去哪

• 官方帮助文档就在仓库里：ui-ngx/src/assets/help/en_US/，200 多篇 Markdown 覆盖从接入设备到规则链的完整流程
• 想懂规则链怎么执行，从 rule-engine/rule-engine-components/ 读起
• 后端行为配置在 application/src/main/conf/thingsboard.conf
• 微服务独立部署的镜像构建脚本在 msa/

改完主题色只是起点，规则链与仪表盘都值得继续折腾 🚀

提示：升级前先看一眼 ui-ngx/package.json 与 docker/.env 里的版本号，保持前后端与容器镜像版本一致，能避开大部分兼容性坑。

【免费下载链接】thingsboardOpen-source IoT Platform - Device management, data collection, processing and visualization.项目地址: https://gitcode.com/GitHub_Trending/th/thingsboard