# thingspanel-backend-community

**Repository Path**: ThingsPanel/thingspanel-backend-community

## Basic Information

- **Project Name**: thingspanel-backend-community
- **Description**: 开源插件化物联网平台，Go语言开发。支持MQTT、Modbus多协议、多类型设备接入与可视化、自动化、告警、规则引擎等功能。
QQ群：371794256。
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: https://www.thingspanel.cn/
- **GVP Project**: No

## Statistics

- **Stars**: 648
- **Forks**: 270
- **Created**: 2022-01-24
- **Last Updated**: 2025-09-12

## Categories & Tags

**Categories**: iot

**Tags**: None

## README

[![DeepSource](https://deepsource.io/gh/ThingsPanel/thingspanel-backend-community.svg/?label=active+issues)](https://deepsource.io/gh/ThingsPanel/thingspanel-backend-community/)

English | [中文](./README_ZH.md)
# ThingsPanel
ThingsPanel is a **lightweight, componentized** open-source IoT application support platform, designed to reduce development efforts and accelerate IoT project construction through reusable plugins.

## Key Plugins
- **Device Function Templates**: Integrates physical models with charts.
- **Device Configuration Templates**: Combines device function templates with protocol plugins.
- **Protocol Access Plugins**: Addresses various protocol access issues.
- **Service Access Plugins**: Allows device access through third-party platforms.
- **Dashboard Cards**: Extends dashboard display capabilities.
- **Visualization Plugins**: Expands functionality for large-screen visualization.
- **Dependency Plugins**: Building blocks for industry solutions.

Using these plugins **repeatedly** can greatly improve R&D efficiency.

## Usage Examples
1. [Connecting Humidity and Temperature Sensors to ThingsPanel-v1.0.0 via Youman M300 Gateway using MQTT](https://www.thingspanel.cn/posts/80)
2. [Fox-Shifu Integration with ThingsPanel](https://bianwuji.feishu.cn/docx/LQS4dyVf4o5WMrxzPlKcP5Ftnpg)
3. [Fox-Edge IoT Edge Computing Platform Integration with ThingsPanel](http://docs.fox-tech.cn/#/fox-edge-3rd-cloud-thingspanel)
4. [Controlling Fan Speed with ThingsPanel via ESP8266](http://thingspanel.cn/posts/72)
5. [Measuring Atmospheric Pressure with ESP-8266 and BMP280 Sensor - ThingsPanel](http://thingspanel.cn/posts/71)

## Product Screenshots
Desktop Interface
<div align="center">
  <img src="https://pub-dd72232484fd4c78b094868481918d04.r2.dev/tp-1.0.0-homepage.png" width="45%" alt="Homepage">
  <img src="https://pub-dd72232484fd4c78b094868481918d04.r2.dev/tp-1.0.0-devicelist.png" width="45%" alt="Device List">
</div>
<div align="center">
  <img src="https://pub-dd72232484fd4c78b094868481918d04.r2.dev/tp-1.0.0-telemetry.png" width="90%" alt="Telemetry Data">
</div>
Dynamic Effect Demonstration
<div align="center">
  <img src="https://pub-dd72232484fd4c78b094868481918d04.r2.dev/weatherstation-800.gif" width="42%" alt="Weather Station">
  <img src="https://pub-dd72232484fd4c78b094868481918d04.r2.dev/electric2-s.gif" width="50%" alt="Power System">
</div>
<div align="center">
  <img src="https://pub-dd72232484fd4c78b094868481918d04.r2.dev/huanrezhan.gif" width="92.5%" alt="Heat Exchange Station">
</div>
Mobile Application Interface
<div align="center">
  <img src="https://pub-dd72232484fd4c78b094868481918d04.r2.dev/tp-app-login.webp" width="30%" alt="Mobile App Login">
  <img src="https://pub-dd72232484fd4c78b094868481918d04.r2.dev/tp-app.webp" width="30%" alt="Mobile App">
</div>

## Demo
URL: http://demo.thingspanel.cn

Account: test@test.cn

Password: 123456

## Quick Installation
Containerized deployment is the fastest way to set up ThingsPanel.

1. Clone the docker-compose source:

    ```bash
    git clone https://github.com/ThingsPanel/thingspanel-docker.git
    ```

2. Enter the directory and start the service:

    ```bash
    cd thingspanel-docker
    docker-compose -f docker-compose.yml up
    ```

3. Login:
    ```text
    URL: http://server-ip:8080
    Account: super@super.cn
    Password: 123456
    ```

## Applications
- Unified device management
- IoT middleware
- Device vendor's management backend

## Problems Solved
- **Hobbyists**: An open architecture that unleashes creative fun.
- **System Integrators**: A single platform delivers all smart projects.
- **Solution Providers**: Saves time and costs to quickly achieve business goals.
- **Device Manufacturers**: Focus on hardware without worrying about software.
- **End Customers**: A single platform to integrate all devices, establishing an IoT data middleware.

## Unique Advantages
- **Ease of Use**: Simplifies IoT, making it more understandable.
- **Compatibility**: Compatible with various device protocols, reducing system expansion costs.
- **Componentization**: Open architecture, multiple component design, quick setup.

## Feature Overview
- **Multitenancy**: Super admin management, tenant account management systems, tenant users manage devices and view data.
- **Device Access**: Edit and create projects, manage devices by groups, view device push status, access devices via plugins, gateway and sub-device access, Modbus RTU/TCP protocol access, TCP protocol access, GB28181 security camera access, custom protocol plugin access.
- **Monitoring Dashboard**: Monitor charts after adding devices, set dashboard as menu or homepage, create multiple dashboards.
- **Device Function Templates**: Set physical models, Web and App charts, can export to JSON.
- **Device Configuration Templates**: Associate devices, attributes, and functions, protocol configurations, data processing, automation, alerts, extended information, device settings, one-type-one-secret settings.
- **Device Map**: Filter devices by project and group, filter by device type.
- **Visualization**: Basic visualization editing, open architecture, pre-bound data charts, add your own graphics, loosely coupled with the system, supports SCADA, large screens, 3D, Three.js.
- **Product Management**: Create products, bulk management, QR code data, manual activation, pre-registration management.
- **Firmware Upgrade**: Add firmware to products, create upgrade tasks, firmware upgrade reports.
- **Automation**: Scene linkage, scene logs, timer triggers, device triggers, various triggers.
- **Alarm Information**: Show alarms by project and group, filter by time period.
- **Notification Features**: SMS, email, phone, webhook notifications.
- **System Logs**: IP access paths, device operation records.
- **Application Management**: Device plugin management, plugin generator, plugin installation, app market.
- **Protocol Access**: Develop custom protocol configurations, configuration after access parameters.
- **Service Access**: Access devices through third-party platforms.
- **User Management**: Casbin scheme, page permission control, project permission control, multiple role definitions.
- **Rule Engine**: Data forwarding to third parties, receiving device data and converting, accessing various protocols, real-time data calculations.
- **Data Gateway**: OpenAPI, database SQL-to-HTTP, interfacing with third-party systems, IP and data range restrictions, authorized reading.
- **System Settings**: Change logo, system title, theme style.
- **IoT App**: Uniapp development, scan to add devices, view monitoring values, switch projects and device groups, manual control, set control policies, view operation logs, manage personal accounts, mobile verification code login.
- **Dependency Plugins**: Dependency plugins for industry solutions, based on device plugins and other features and data, visualization invocation, iframe code inclusion, plugin reuse.

## Technology Stack
* Golang: Inherent excellent concurrency performance, saves hardware costs, suitable for edge devices.
* Vue.js (3): Simple and easy to get started.
* Node.js (16.13): Free, open-source, cross-platform.
* Databases
  * PostgreSQL: Broad community support and low cost.
  * TimescaleDB: Time-series database, PostgreSQL plugin.
  * TDengine: High-performance domestic time-series database.
  * Cassandra: Open-source distributed Key-Value storage system.
  * TDSQL-PostgreSQL: Tencent's self-developed distributed database system.
  * PloarDB-PostgreSQL: Alibaba Cloud's self-developed high-performance cloud-native distributed database.
  * KingBase: Renmin University of China's data warehouse.
* Nginx: High-performance web server.
* MQTT Broker
  * GMQTT: High-performance message queuing.
  * VerneMQ: High-performance distributed MQTT message broker.
* Redis: NoSQL cache database.

## Contribution Guide
Directly clone the project, modify and submit a PR.

## API Documentation Link
[API Documentation](https://docs.qq.com/doc/DZVZKc2FCTE1EblBX)

## Licensing and Commercial Licensing

ThingsPanel is now released under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). This is a permissive open-source license that allows users:

* **Permissive Use**: Can be used in private or commercial environments without requiring derivative works to be open-sourced
* **Freedom to Modify**: Allows modification and redistribution of source code
* **Patent Grant**: Contributors automatically grant users necessary patent rights
* **Copyright Notice Required**: Must retain copyright notices and license terms

While Apache 2.0 already allows commercial use, we also provide **Enterprise Edition**, **Customized Support Services**, and **Enhanced Feature Licensing** for enterprise customers to meet higher production-grade requirements, including but not limited to:

* Enterprise-level technical support and deployment consulting
* Custom development and integration services
* Security hardening, private deployment, and SLA support
* Brand customization and OEM licensing

If you wish to obtain more commercial support or customized services, please contact us.

## Community and Support

QQ Group 1: 260150504 (Full)

QQ Group 2: 371794256

## Acknowledgments
Thank you for your contributions to ThingsPanel!
Special thanks to [paddy235](https://gitee.com/paddy235) for developing the ThingsPanel simulation test script, which can be used for simulation and stress testing. The script is available at: [ThingsPanel Simulation Test Script](https://gitee.com/paddy235/thingspanel_simulation_python).

![Contributors](https://contrib.rocks/image?repo=ThingsPanel/ThingsPanel-Go)