https://github.com/chenglinning/freemqtt
A MQTT Server in Python
https://github.com/chenglinning/freemqtt
broker mqtt server
Last synced: 2 months ago
JSON representation
A MQTT Server in Python
- Host: GitHub
- URL: https://github.com/chenglinning/freemqtt
- Owner: chenglinning
- License: apache-2.0
- Created: 2024-09-22T04:01:47.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-11-14T12:24:21.000Z (8 months ago)
- Last Synced: 2025-04-18T18:33:10.326Z (3 months ago)
- Topics: broker, mqtt, server
- Language: Python
- Homepage: https://freemqtt.cn
- Size: 186 KB
- Stars: 23
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## [FreeMQTTT](https://freemqtt.cn/)
MQTT broker implemented in python based on asyncio (async/await)
### Features
+ Implements the full set of MQTT 3.1.1 & MQTT 5.0 (except AUTH)
+ QoS0, QoS1, QoS2 support
+ MQTT over Websocket support
+ TLS/SSL support
+ Unique Application isolation security mechanism
+ Sytem metrics topic: $SYS/METRICS
+ Client online notification topic: $SYS/ONLINE
+ Client offline notification topic: $SYS/OFFLINE
+ Configuration using the TOML file
### Running environment
Python 3.9+
### Getting started
+ Get source code
```bash
$ git clone https://github.com/chenglinning/freemqtt.git
```
+ Install dependency packages
```bash
$ cd ./freemqtt
$ python -m pip install -r requirements.txt
```
+ Run the server in foreground
```bash
$ python ./freemqttd.py
[I 240921 16:54:11 freemqttd:91] freemqttd started
```
+ Run the server in background
```bash
$ python ./freemqttctl.py start
starting freemqttd ...
start freemqttd success.
```
+ Generate MQTT client login password (Token)
```bash
$ python ./freemqtt_token.py myapp
AppID: myapp
Token: gVRVsBqw3bQSD4CQ4rFOXtfGQMelHJmEaNlYtH7GS/A=
```
Documentation is available on [Read the Docs](https://freemqtt.cn)