# Open supOS Deploy

**Repository Path**: NBopen/supos-ce-deploy

## Basic Information

- **Project Name**: Open supOS Deploy
- **Description**: Open supOS  肩负“变革工业软件、升华数字体验”的使命而生。

面向工业与智慧城市，我们推出新一代 IIoT 平台——Open supOS,助您连接现场、分析数据、重塑工厂运营。通过高效的数据利用，全面提升数字化能力，解锁更智能的洞察。supOS 社区版现已发布，立即下载体验！

我们不仅在打造解决方案，更在重新想象未来的可能性，突破边界，去创造一个前所未有的世界。
- **Primary Language**: Shell
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: https://www.supos.com/product/supos/ce
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 11
- **Created**: 2026-01-14
- **Last Updated**: 2026-01-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# supOS: 开源工业物联网 (IIoT) 平台

[English](README.md) | [中文](README-CN.md)

## 黑客松
欢迎各位积极参加由开放原子基金会主办的：[工业OS 开源生态开发赛](https://competition.atomgit.com/competitionInfo?id=6c27a6e632a8a2d6773d9533ec27a96e#heading-0-0)

---

## 介绍
Open supOS 是基于UNS 的最佳开源实践，基于UNS 统一工厂数据访问。连接多源数据，包括边缘设备、第三方系统和数据库。
![输入图片说明](assert/image/11.png)
![输入图片说明](assert/image/22.png)
![输入图片说明](assert/image/33.png)
![输入图片说明](assert/image/44.png)

## 平台架构

### 基础架构
![输入图片说明](assert/image/1.png)
![输入图片说明](assert/image/2.png)

### 核心组件

- **微服务架构**：集成多个容器（如后端、前端、EMQX、Node-RED 等），构建可扩展、模块化的 IIoT 平台。
- **API 网关与管理**：使用 **Kong** 作为 API 管理网关，并通过 **Konga** 提供可视化 UI 进行控制。
- **边缘计算与物联网数据处理**：**EMQX** 处理实时 MQTT 消息，**Node-RED** 用于低代码物联网开发。
- **数据库与时序数据存储**：**PostgreSQL (TimescaleDB)** 和 **TDengine** 提供优化的时序数据存储方案。
- **可观测性与日志管理**：**Elasticsearch、Filebeat 和 Kibana** 进行集中日志管理和可视化。
- **SCADA 及可视化仪表板**：**FUXA** 用于 SCADA 监控，**Grafana** 提供可定制的数据分析面板。
- **安全与认证**：**Keycloak** 负责集中式 SSO 及身份管理。
- **对象存储**：**MinIO** 提供高性能、S3 兼容的存储解决方案。
- **GraphQL 集成**：**Hasura** 提供基于 PostgreSQL/TimescaleDB 的实时 GraphQL API。

### 案例视频

[设备OEE](https://bucket-suplink.oss-cn-hangzhou.aliyuncs.com/video/demo_oee.mp4)

[数字孪生](https://bucket-suplink.oss-cn-hangzhou.aliyuncs.com/video/demo_twin.mp4)

[智慧工厂](https://bucket-suplink.oss-cn-hangzhou.aliyuncs.com/video/demo_mgmt.mp4)

### 使用手册

[在线使用手册](https://www.supos.com/devc/document?id=2114)



## 安装指南

### 1. Linux

#### 1.1 运行环境
- **操作系统**：目前已在 Ubuntu Server 24.04 + Docker 进行测试，欢迎对其他发行版的反馈。
- **Docker**：我们假设你已经安装了 Docker（包含 `docker compose` 和 `buildx`），测试版本如下：
  - Docker Engine - Community: 27.4.0
  - Docker Buildx: v0.19.2
  - Docker Compose: v2.31.0
  - containerd: 1.7.24
  
#### 1.2 使用方法
1. **使用 Git Bash 克隆项目**：
   ```bash
   git clone <this repo>
   ```
2. **修改 `.env` 环境变量文件**：
   - 进入 `supos-ce-deploy` 目录，并编辑 `.env` 文件。
   - 修改 `VOLUMES_PATH`（项目数据存储路径）。
   - 修改 `ENTRANCE_DOMAIN`（前端入口域名/IP 地址）。
   - 根据需要修改其他变量。

3. **启动项目**：
   ```bash
   bash bin/install.sh
   ```
   - 运行后等待容器拉取和初始化，首次启动可能需要几分钟。

如果尚未安装 Docker，我们提供的脚本可以在 Ubuntu Server 24.04 上自动安装。其他操作系统请参考官方 Docker 文档。

### 2. Windows

#### 2.1 运行环境
- 在 Windows 10 或 Windows 11 上安装最新版 **Docker Desktop** 和 **Git**。
- 建议使用 **Git Bash** 进行所有操作。

#### 2.2 使用方法
1. **克隆项目**：
   ```bash
   git clone <this repo>
   ```
2. **编辑 `.env` 文件中的环境变量**：
   - `VOLUMES_PATH`（存放项目数据的目录）
   - `ENTRANCE_DOMAIN`（请勿使用 127.0.0.1）
   - 其他必要的环境变量

3. **启动项目**：
   ```bash
   bash bin/install.sh
   ```
   - 等待容器拉取并初始化，首次启动可能需要几分钟。

### 3. 访问平台
   - 在浏览器中访问 `http://<YOUR-DOMAIN>:<YOUR-PORT>`（根据 `.env` 文件中的 `ENTRANCE_DOMAIN` 和 `ENTRANCE_PORT` 设置）。



### 4. 离线下载
   - 访问产品主页：https://www.supos.com/product/supos/ce 
     提供有针对windows、linux 的离线下载包，如下所示：![输入图片说明](assert/image/image.png)





## 许可证
   - 本项目基于木兰宽松 许可证发布，详情请参见 LICENSE 文件。



## 联系我们
   - 如果你有任何问题，请提交 issue 或发送邮件与我们联系。