从零部署 IoT DC3:四步快速启动实录

"从 clone 到看到数据"的耗时是评估开源平台的重要指标。本文基于 DC3 当前主干演示完整流程。前置条件:JDK 21、Maven 3.9+、Podman 或 Docker 及可联网环境。

第一步:起基础设施

bash 复制代码
git clone https://github.com/pnoker/iot-dc3.git
cd iot-dc3
make up-db

这一步用 compose 启动 PostgreSQL(含 TimescaleDB、pgvector、AGE 扩展的定制镜像)与 RabbitMQ。国内网络环境可使用 make up-db-cn(阿里云镜像源)。

第二步:编译

bash 复制代码
source dc3/env/dev.env.sh
mvn -s .mvn/settings.xml clean package

首次编译需拉取依赖,视网络情况约 5--15 分钟;仅需验证编译时可使用 mvn -s .mvn/settings.xml -q -DskipTests compile。

第三步:起全栈

bash 复制代码
make up-dev

网关、四大中心服务、驱动逐一启动。可选观测组件(EMQX、ELK、Prometheus、Grafana)通过 make up-optional 启动。

第四步:验证

浏览器打开 http://localhost:8080 登录后:

  1. 看首页:仪表盘起来,说明网关与各中心服务通信正常;
  2. 验证数据链路:启用 Virtual 虚拟驱动,其模拟设备持续上报位值,设备列表、实时数据、历史曲线均可立即验证;
  3. 体验 AI Chat:配置模型后,用自然语言查设备与点位数据;
  4. 可选 :导入演示数据集 dc3/dependencies/postgres/demo/iot-dc3-demo.sql,获得预置设备与点位。

完成上述步骤后即可进入验证环节。

常见问题(实测确认)

  • 8080 端口占用:其他服务占用 8080 时前端页面空白,更换端口即可;
  • 首次建库失败 :seed 初始化仅在空数据卷时执行,失败后需 make down 确认卷已清理再重试;
  • 国内镜像拉取慢 :使用 -cn 后缀的 make 目标;
  • 其他问题:docs.dc3.site 的 Troubleshooting 章节支持按报错关键字检索。

实事求是的边界

  • 本流程覆盖验证链路;接入真实设备的时间取决于协议与点位建模,与部署环节无关;
  • 生产部署请看 dc3/doc/DEPLOYMENT.md:K8s / Helm / Swarm 配置、TLS、容量规划都在那里,本文的 compose 流程适合开发与体验。

仓库 :GitHub pnoker/iot-dc3 · Gitee pnoker/iot-dc3(GVP)

文档:docs.dc3.site(Quickstart / Troubleshooting)· book.dc3.site · demo.dc3.site

相关推荐
byte轻骑兵14 小时前
如何为你的 Web 应用添加文档编辑能力:ONLYOFFICE 文档集成实战
docker·私有化部署·系统集成·在线协作·wsl2·onlyoffice docs
好用斋18 小时前
内网测速 LibreSpeed:网页版 Docker 测速服务
运维·docker·容器
菜地里的小菜鸟1 天前
Docker 19.03.8 升级到 20.10.24
docker·云原生·容器·docker19038升级到201024
lambo mercy2 天前
01初识docker
运维·docker·容器
时间的拾荒人2 天前
Docker 容器、仓库与数据管理实战
docker·容器·eureka
时间的拾荒人2 天前
Docker 入门实战:从核心概念、安装配置到镜像操作与 Dockerfile 定制
运维·docker·容器·eureka
时间的拾荒人2 天前
Docker Compose 编排实战:从命令详解到 Redis Cluster 三主三从部署
docker·部署·集群
AI开源软件3 天前
Kubernetes 网络实战:打通 Pod、Service 与集群外任务调度器的双向调用
docker·nacos·kubernetes·xxl-job·calico·微服务部署·ruoyi office
csdn_aspnet3 天前
Docker 啟動MySQL Server連上MySQL Workbench
mysql·docker·容器
月夏3 天前
我把全栈项目塞进已有 nginx 的服务器,卡我最久的是三个斜杠
nginx·react.js·docker