# iot-dc3

**Repository Path**: pnoker/iot-dc3

## Basic Information

- **Project Name**: iot-dc3
- **Description**: IoT DC3 是一个基于 Spring Cloud 的 100% 完全开源的、分布式的物联网(IoT)平台，用于快速开发物联网项目和管理物联设备，是一整套物联系统解决方案。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: https://doc.dc3.site
- **GVP Project**: Yes

## Statistics

- **Stars**: 9109
- **Forks**: 3817
- **Created**: 2019-05-13
- **Last Updated**: 2025-06-17

## Categories & Tags

**Categories**: iot

**Tags**: 物联网, plc, modbus, mqtt, IOT

## README

<p align="center">
	<img src="dc3/images/logo-blue.png" width="400" alt="IoT DC3 Logo">
<br>
<a href='https://gitee.com/pnoker/iot-dc3/stargazers'>
    <img src='https://gitee.com/pnoker/iot-dc3/badge/star.svg?theme=gvp' alt='star'/>
</a>
<a href='https://gitee.com/pnoker/iot-dc3/members'>
    <img src='https://gitee.com/pnoker/iot-dc3/badge/fork.svg?theme=gvp' alt='fork'/>
</a>
<br>
<strong>DC3 是基于 Spring Cloud 的开源可分布式物联网 (IOT) 平台,用于快速开发, 部署物联设备接入项目,是一整套物联系统解决方案。</strong>
</p>

---

# 1 DC3 架构设计

![iot-dc3-architecture](dc3/images/architecture1.jpg)

## 1.1 DC3 模块划分, 四层架构

- 驱动层: 用于提供标准或者私有协议连接物理设备的 `SDK`, 负责南向设备的数据采集和指令控制, 基于 `SDK` 可实现驱动的快速开发;
- 数据层: 负责设备数据的收集和入库, 并提供数据管理接口服务;
- 管理层: 用于提供微服务注册中心, 设备指令接口, 设备注册与关联配对, 数据管理中心, 是所有微服务交互的核心部分, 负责各类配置数据的管理, 并对外提供接口服务;
- 应用层(部分完成): 用于提供数据开放, 任务调度, 报警与消息通知, 日志管理等, 具备对接第三方平台能力。

## 1.2 DC3 功能设计, 定位目标

- 可伸缩: 水平可伸缩的平台,构建使用领先的 `Spring Cloud` 开源技术;
- 容错: 没有单点故障弱,集群中的每个节点是相同的;
- 健壮和高效: 单一服务器节点可以处理甚至数百成千上万的设备根据用例;
- 可定制: 添加新的设备协议,并注册到服务中心;
- 跨平台: 使用 `Java` 环境可异地, 分布式多平台部署;
- 自主可控: 私有云, 公有云, 边缘部署;
- 完善性: 设备快速接入, 注册, 权限校验;
- 安全: 数据加密传输;
- 多租户: 命名空间, 多租户化;
- 云原生: Kubernetes;
- 容器化: Docker。

# 2  开源贡献

- 从 `main` 分支 `checkout` 一个新分支(**注**: 请务必保证 `main` 代码是最新的)
- 新分支命名格式: `feature/you_name/feature_description`, 例如: `feature/pnoker/mqtt_driver`
- 在新分支上编辑文档, 代码, 并提交
- 提交 `PR` 合并到 `develop` 分支, 等待作者合并即可
- 合并通过后我们会添加你的 UserID 到 [鸣谢](https://doc.dc3.site/contributor)

# 5 开源协议

`IOT DC3` 开源平台遵循 [Apache 2.0 协议](https://www.apache.org/licenses/LICENSE-2.0.html)。 允许商业使用, 但务必保留类作者, Copyright 信息。