# DTCloud
**Repository Path**: dtcloud360/dtcloud
## Basic Information
- **Project Name**: DTCloud
- **Description**: DTCloud智能建造工业互联网平台包括(文档管理,BIM管理,IOT管理), 微信服务号, 钉钉应用集成,微信小程序商城, 中国城市数据,无码开发平台,报表设计器,权限设计器, DTCloud Python API, CMS新闻发布系统,可视化大屏设计器, 工作流, IoT网关,调度器,智能工厂,FF Model
- **Primary Language**: Python
- **License**: LGPL-3.0
- **Default Branch**: DTCloud-5.18
- **Homepage**: http://www.dtcloud360.com
- **GVP Project**: No
## Statistics
- **Stars**: 640
- **Forks**: 274
- **Created**: 2020-11-28
- **Last Updated**: 2026-07-22
## Categories & Tags
**Categories**: iot
**Tags**: DTCloud, IOT, BIM, CIM, ERP
## README
# DTCloud 亿智云建筑行业软件开发平台
[](LICENSE)
[](https://www.python.org/)
[](https://gitee.com/dtcloud360/dtcloud)
[](.gitee/workflows/ci.yml)
## 📖 项目介绍
**DTCloud** 是中亿丰数字科技集团自主研发的面向工程智能建造场景的工业 APP 开发平台。属于智能建造数字建筑领域 PaaS 平台,以模块化组件拼装方式完成建筑数字化领域的各项应用软件开发。
平台采用 **BIM/CIM + AIoT** 技术架构、低代码模式、高性能云计算,全面整合数字孪生技术,助力智能建造类软件的快速应用开发。
### 核心特性
- 🏗️ **BIM/CIM 可视化** — 3D 空间图形展示,数据集中管理
- 📡 **IoT 数据中台** — 实时感知企业/园区运行状态,提前预知风险
- 🤖 **AI 分析引擎** — 仿真模拟分析,实现物理与数字空间的信息同步
- 📱 **多端支持** — 智慧大屏、移动端 APP、Web 页面全覆盖
- 🔌 **海量接口** — 集成 50+ 大门类、300+ 接口,开箱即用
- 🧩 **低代码开发** — 模块化组件拼装,快速构建智慧场景解决方案
---
## 🚀 快速开始
### 环境要求
- Python **3.10+**(推荐 3.10.9)
- PostgreSQL **12+**
- Redis(可选,用于队列任务)
### 安装部署
```bash
# 1. 克隆仓库
git clone https://gitee.com/dtcloud360/dtcloud.git
cd dtcloud
# 2. 安装依赖
pip install -r requirements.txt
# 3. 配置数据库
createdb DTCloud5
# 4. 复制配置模板并填入真实信息
cp .env.example .env
cp dtcloud.conf.example dtcloud.conf
# 编辑 .env 或 dtcloud.conf,填入数据库密码、管理员口令等
# 5. 启动服务
python dtcloud.py -c dtcloud.conf
```
> ⚠️ **安全提醒**:`.env` 和 `dtcloud.conf` 已加入 `.gitignore`,不会提交到仓库。首次登录后请**立即修改默认口令**。生产环境请使用强密码并通过环境变量注入凭证。
### queue_job 队列服务
```bash
python dtcloud.py jobqueue -c dtcloud.conf
```
### 端口说明
| 端口 | 服务 | 描述 |
| ----- | ------------ | ---------------- |
| 9099 | DTCloud | 网站访问端口 |
| 9098 | DTCloud | 长连接 |
| 9097 | Upload | 上传文件端口 |
| 9096 | Preview_url | 文件附件预览接口 |
| 9095 | download_url | 文件下载接口 |
| 5432 | PostgreSQL | 数据库接口 |
| 9091 | Print | 套打打印端口 |
| 9100 | ZPL | 指令打印端口 |
| 10001 | GOAPI | 对外服务的接口 |
### Docker 部署
```bash
# 使用 Docker Compose 快速启动
version: '3'
services:
db:
image: postgres:14
environment:
POSTGRES_DB: DTCloud5
POSTGRES_USER: dtcloud
POSTGRES_PASSWORD: 请替换为强密码
ports:
- "5432:5432"
volumes:
- pgdata:/var/lib/postgresql/data
dtcloud:
build: .
depends_on:
- db
ports:
- "9099:9099" # 网站访问
- "9098:9098" # 长连接
- "9097:9097" # 上传文件
- "9096:9096" # 文件预览
- "9095:9095" # 文件下载
- "9091:9091" # 套打打印
- "9100:9100" # 指令打印
environment:
DB_HOST: db
DB_PORT: 5432
DB_USER: dtcloud
DB_PASSWORD: 请替换为强密码
DB_NAME: DTCloud5
volumes:
- ./dtcloud:/app/dtcloud
- ./addons:/app/addons
volumes:
pgdata:
```
---
## 📚 文档导航
| 文档 | 说明 |
|-----|------|
| [贡献指南](CONTRIBUTING.md) | 如何报告 Bug、提交 PR、代码规范 |
| [许可证合规说明](LICENSE-COMPLIANCE.md) | 依赖许可证清单、兼容性分析 |
| [许可证](LICENSE) | LGPL-3.0 许可证全文 |
| [配置模板](.env.example) | 环境变量配置模板 |
| [配置模板](dtcloud.conf.example) | 配置文件模板 |
---
## 🤝 贡献
我们欢迎任何形式的贡献!详见 [贡献指南](CONTRIBUTING.md)。
### 快速贡献流程
1. Fork 本仓库
2. 创建特性分支:`git checkout -b feature/your-feature`
3. 提交变更:`git commit -m 'feat: add xxx'`
4. 推送到分支:`git push origin feature/your-feature`
5. 发起 Pull Request
> 新手可关注 [`good_first_issue`](https://gitee.com/dtcloud360/dtcloud/issues?label_ids=good_first_issue) 标签的 Issue。
---
## 📋 项目状态
| 指标 | 数据 |
|-----|------|
| ⭐ Star | 638 |
| 🔄 Fork | 272 |
| 📝 许可证 | LGPL-3.0 |
| 🐍 Python | 3.10+ |
| 🌐 语言 | 中文(主要) |
---
## 👥 主要开发者
扶程星云、sugar、yu.qian
---
## 📄 许可证
本项目基于 **LGPL-3.0** 许可证开源。详情请参阅 [LICENSE](LICENSE) 和 [LICENSE-COMPLIANCE.md](LICENSE-COMPLIANCE.md)。
---
Copyright © 2012-2026 中亿丰数字科技集团有限公司