IoTSharp

MQTTnet.AspNetCore.Routing

Pixiu

Extensions.Configuration.GitRepository

Gateways

IoTSharp

英文 | 中文

License Docs deploy NuGet packages 🚀 项目概览

IoTSharp 将构建生产级 IoT 平台所需的关键能力组合在一起:

• 支持 HTTP、MQTT、CoAP 等协议的设备与网关接入能力。
• 围绕遥测、属性、告警、产品、资产和租户形成统一的数据与管理模型。
• 通过规则链完成数据转换、通知下发、自动化动作和业务处理。
• 支持关系型数据库与时序数据库,以适配不同部署和扩展场景。
• 提供 Docker、Windows 服务、Linux 服务、安装向导与发布包等多种交付方式。
• 路线图已把 AI 工作台、MCP 工具与智能体辅助运维定义为横切能力,覆盖采集、规则与发布三大场景。

当前主应用基于 .NET 10,Web 控制台基于 Vue 3,并已全面统一为 IoTSharp 品牌界面。

🧭 快速开始

🖥️ 本地运行 IoTSharp

建议先从以下文档入口开始:

• 产品文档首页:https://iotsharp.net/docs/getting-started/installation-options
• 安装向导初始化:https://iotsharp.net/docs/deployment/docker-desktop-extension

前端本地开发默认端口为:

• 前端:http://localhost:27915

🤖 使用 OpenClaw 协助搭建 SQLite 体验实例

如果你希望让 OpenClaw 引导你完成本地 SQLite 版 IoTSharp 的安装,建议直接给它下面这两样内容:

• tools/prompts/openclaw-sqlite-instance.txt

运行手册里已经定义了 SQLite 引导流程、安装向导初始化路径、Docker Desktop 扩展的回退方案,以及后续通过 appsettings.{Environment}.Installer.json 安全切换数据库的规则。

🧩 支持的组件

如果你需要更细的数据库矩阵、时序引擎、消息中间件支持和配置示例,请直接查看文档:

• https://iotsharp.net/docs/configuration/appsettings
• 📦 部署方式
  • Docker:https://iotsharp.net/docs/deployment/docker-desktop-extension
  • Windows 服务:https://iotsharp.net/docs/deployment/linux-service
  • 应用配置:https://host.iotsharp.net

  🗂️ 仓库结构

  仓库中的关键目录如下:

  • IoTSharp:主 ASP.NET Core 应用。
  • ClientApp:Vue 3 前端控制台。
  • docs:Docusaurus 帮助手册站点。
  • docker-desktop-extension:Docker Desktop 扩展体验包。
  • IoTSharp.Installer.Windows:Windows 安装工程。
  • IoTSharp.Agent:面向未来本地桌面 companion / 语音入口的规划方向,当前仓库中尚无对应目录。
  • IoTSharp.SDKs:SDK 与面向客户端的相关项目。

  🌐 生态与相关项目

  NuGet 包与生态库包括:

  • IoTSharp.Sdk.Http
  • IoTSharp.Sdk.MQTT
  • IoTSharp.Extensions
  • IoTSharp.Extensions.AspNetCore
  • IoTSharp.Extensions.EFCore
  • IoTSharp.Extensions.QuartzJobScheduler
  • IoTSharp.HealthChecks.*
  • IoTSharp.X509Extensions

  相关仓库包括:

  • IoTSharp MQTT C SDK
  • IoTEdge paho.mqtt.c
  • IoTEdge nanoFramework
  • IoTSharp RT-Thread package

  📚 文档

  • 英文说明: README.md
  • 文档首页:ROADMAP.md
  • 变更记录: CHANGELOG.md

  🤝 参与贡献

  欢迎通过 Issue 与 Pull Request 参与 IoTSharp:

  • Pull Requests:https://github.com/IoTSharp/IoTSharp/issues

  在提交改动前,建议先阅读当前的文档结构、仓库模块划分以及发布与分发方向。

  💬 社区支持

  如果你在使用或部署 IoTSharp 时遇到问题,可以通过以下渠道获取帮助:

  • GitHub:https://gitee.com/IoTSharp/IoTSharp
  • 官网:❤️ 捐赠

    IoTSharp 采用 Apache 2.0 协议发布。如果你希望支持项目持续发展,可以通过以下方式:

    • OpenCollective:https://afdian.net/a/maikebing
    • 支持者列表: BACKERS.md

    ✨ 祝福

    • 愿你行善而不作恶。
    • 愿你学会宽恕自己,也宽恕他人。
    • 愿你乐于分享,不取多于所予。