kopia lustrzana https://github.com/Yakifo/amqtt
52 wiersze
2.0 KiB
Markdown
52 wiersze
2.0 KiB
Markdown
# Home
|
|
|
|
|
|
|
|
`aMQTT` is an open source [MQTT](http://www.mqtt.org) broker and client, natively implemented with Python's [asyncio](https://docs.python.org/3/library/asyncio.html).
|
|
|
|
## Features
|
|
|
|
- Full set of [MQTT 3.1.1](http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html) protocol specifications
|
|
- Communication over multiple TCP and/or websocket ports, including support for SSL/TLS
|
|
- Support QoS 0, QoS 1 and QoS 2 messages flow
|
|
- Client auto-reconnection on network lost
|
|
- Plugin framework for functionality expansion; included plugins:
|
|
- `$SYS` topic publishing
|
|
- AWS IOT-style shadow states
|
|
- x509 certificate authentication (including cli cert creation)
|
|
- Secure file-based password authentication
|
|
- Configuration-based topic authorization
|
|
- MySQL, Postgres & SQLite user and/or topic auth (including cli manager)
|
|
- External server (HTTP) user and/or topic auth
|
|
- LDAP user and/or topic auth
|
|
- JWT user and/or topic auth
|
|
- Fail over session persistence
|
|
|
|
## Installation
|
|
|
|
`amqtt` is available on  [PyPI](https://pypi.python.org/pypi/amqtt)
|
|
|
|
## Documentation
|
|
|
|
`amqtt` docs are available on  [Read the Docs](http://amqtt.readthedocs.org/).
|
|
|
|
## Containerization
|
|
|
|
Launch from  [DockerHub](https://hub.docker.com/repositories/amqtt)
|
|
|
|
```shell
|
|
$ docker run -d -p 1883:1883 amqtt/amqtt:latest
|
|
```
|
|
|
|
## Testing
|
|
|
|
The `amqtt` project runs a test aMQTT broker/server at [test.amqtt.io](https://test.amqtt.io) which supports: MQTT, MQTT over TLS, websocket, secure websockets.
|
|
|
|
|
|
## Support
|
|
|
|
`amqtt` development is available on  [GitHub](https://github.com/Yakifo/amqtt). Bug reports, patches and suggestions welcome!
|
|
|
|
 [Open an issue](https://github.com/Yakifo/amqtt/issues/new) or join the  [discord community](https://discord.gg/S3sP6dDaF3).
|
|
|