# EdgeLite Gateway
### 开源边缘AI网关 —— 采集 + 思考 + 视觉确认，让边缘节点会"思考"
[](LICENSE)
[](https://www.python.org/)
[](https://fastapi.tiangolo.com/)
[](https://vuejs.org/)
[](https://github.com/suoten/EdgeLiteGateway)
[](https://www.docker.com/)
[](https://onnxruntime.ai/)
**13种核心协议** · **3个自学习AI模型** · **传感器AI+视觉AI双确认** · **10分钟Docker部署** · **512MB即可运行**
[快速开始](#-快速开始) · [在线演示](https://edgelite.jjtt.net/) · [AI能力](#-边缘ai推理引擎) · [功能全景](#-功能全景) · [技术架构](#-技术架构) · [企业版](#-企业版) · [技术支持](#-技术支持)
**[English](README_EN.md)**
---
## EdgeLite 是什么？
EdgeLite Gateway 是一个面向工业物联网场景的**开源边缘AI网关**。它不是传统网关——只搬运数据；而是在边缘侧完成**设备数据采集 → AI实时推理 → 视频联动确认**的完整闭环，让边缘节点真正会"思考"。
**一句话**：采集 + 思考 + 视觉确认，数据不出厂，延迟 < 100ms。
### 为什么需要边缘AI网关？
| 现状痛点 | EdgeLite 的回答 |
|---------|----------------|
| 传统网关只采集，不思考 | 13种协议采集 + ONNX边缘推理 + 规则引擎联动 |
| AI推理依赖云端，延迟高、数据安全风险 | 边缘侧实时推理，单次延迟 < 100ms，数据不出厂 |
| 传感器告警误报多，缺乏交叉验证 | 传感器AI异常 → 调取摄像头 → 视觉AI二次确认 → 高置信告警 |
| 多协议设备各写一套采集程序 | 一个网关统一接入，Modbus/S7/OPC UA/MQTT...全覆盖 |
| AI模型训练一次永远不变 | 3个预置模型**开箱即学**，越用越准，精度从60%进化到90% |
---
## 🚀 快速开始
> 🎯 **不想部署？先体验演示站点**：[https://edgelite.jjtt.net/](https://edgelite.jjtt.net/) 用户名 `admin` / 密码 `Edgelite@123` ⚠️ **此凭据仅用于演示环境，请勿用于生产部署！**
> **只需安装 [Docker](https://docs.docker.com/get-docker/)，无需 Node.js / Python**
> **首次启动时若未设置环境变量，系统将随机生成管理员密码并打印到控制台日志中。**
> **请在首次启动后查看日志获取初始密码，并立即修改为安全密码。**
> ⚠️ **安全警告**：首次部署**必须**设置 JWT Secret Key，否则服务无法启动。编辑 `.env` 文件，将 `EDGELITE_SECURITY__SECRET_KEY` 替换为安全随机密钥：
> ```bash
> # 生成 256 位随机密钥（复制输出结果到 .env 文件）
> python -c "import secrets; print(secrets.token_urlsafe(32))"
> ```
> Docker 部署时，编辑 `docker/.env` 中的 `SECRET_KEY` 字段。**切勿使用占位符或默认值！**
> ⚠️ **Windows 用户**：请使用 **PowerShell**（不要用 CMD），右键开始菜单 → Windows PowerShell
```bash
# 1. 克隆仓库
git clone https://gitee.com/suoten/EdgeLiteGateway.git && cd EdgeLiteGateway
# 2. 生成配置文件（Windows PowerShell 用 Copy-Item 替代 cp）
cp docker/.env.example docker/.env
# 3. 构建并启动（首次约 3-5 分钟，之后秒启）
cd docker && docker compose build edgelite && docker compose up -d
# 4. 查看启动日志
docker compose logs -f edgelite # 看到 "Uvicorn running" 即成功，Ctrl+C 退出
```
> **首次启动后，请查看控制台日志获取初始管理员密码。**
> **首次登录后需强制修改密码。**