120 lines
4.0 KiB
Markdown
120 lines
4.0 KiB
Markdown
---
|
|
title: Zigbee2MQTT
|
|
created: 2026-06-08
|
|
updated: 2026-06-08
|
|
type: app
|
|
tags: [catalogue, internet-of-things, mqtt, zigbee, domotique, app-marathon3-rattrapage-a]
|
|
confidence: high
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=IoT, https://zigbee2mqtt.io/]
|
|
---
|
|
|
|
# 🔌 Zigbee2MQTT
|
|
|
|
> **Pont Zigbee vers MQTT** : pilotez 3000+ appareils Zigbee (Xiaomi, IKEA, Philips Hue, Sonoff) sans dépendance cloud — un seul dongle USB suffit.
|
|
|
|
## 📋 Informations Générales
|
|
|
|
| Champ | Valeur |
|
|
| :--- | :--- |
|
|
| **Site web** | [zigbee2mqtt.io](https://zigbee2mqtt.io/) |
|
|
| **GitHub** | [Koenkk/zigbee2mqtt](https://github.com/Koenkk/zigbee2mqtt) |
|
|
| **License** | GPL-3.0 |
|
|
| **Langage** | TypeScript |
|
|
| **Étoiles GitHub** | 14k ⭐ |
|
|
| **Catégorie** | [[cat-internet-of-things|Internet of Things]] |
|
|
|
|
## 📝 Description
|
|
|
|
**Zigbee2MQTT** est né en 2017 du projet personnel de **Koen Kanters (Koenkk)**, frustré par la nécessité d'avoir un hub propriétaire par marque. Il permet d'utiliser un **seul coordinateur Zigbee** (clé USB) pour piloter des appareils de toutes marques.
|
|
|
|
Fonctionnalités :
|
|
- ✅ **3000+ appareils Zigbee supportés** : Xiaomi/Aqara, IKEA Tradfri, Philips Hue, Sonoff, OSRAM, Sengled, Innr, Gledopto...
|
|
- ✅ **Coordinateurs supportés** : Texas Instruments CC2652, ConBee II, RaspBee, ZBDongle-E, ZBDongle-P
|
|
- ✅ **Appairage via interface web** (Zigbee2MQTT-frontend)
|
|
- ✅ **Topic MQTT standard** : `zigbee2mqtt/<device>` publish/subscribe
|
|
- ✅ **OTA updates** : mises à jour firmware des appareils depuis l'UI
|
|
- ✅ **Groupes, scènes, bindings** Zigbee natifs
|
|
- ✅ **Touchlink** : appairage par proximité
|
|
- ✅ **Home Assistant auto-discovery** : aucune config manuelle
|
|
- ✅ **Logging avancé** : debug, sniffer réseau
|
|
|
|
**Différence vs deCONZ/ZHA** : Zigbee2MQTT = projet indépendant plus complet et réactif, expose tout en MQTT (pas de daemon propriétaire). ZHA = intégration Home Assistant native, moins d'appareils supportés.
|
|
|
|
**Pour qui** : amateurs de domotique, labs smart-home, intégrateurs, et toute personne qui veut s'affranchir des écosystèmes cloud Xiaomi/Hue.
|
|
|
|
## 🚀 Installation
|
|
|
|
### Docker Compose (recommandé)
|
|
|
|
```yaml
|
|
version: '3.8'
|
|
services:
|
|
zigbee2mqtt:
|
|
image: koenkk/zigbee2mqtt:latest
|
|
container_name: zigbee2mqtt
|
|
restart: unless-stopped
|
|
devices:
|
|
- /dev/ttyUSB0:/dev/ttyUSB0 # dongle Zigbee
|
|
ports:
|
|
- "8080:8080" # Frontend web
|
|
environment:
|
|
- TZ=Europe/Paris
|
|
volumes:
|
|
- ./data:/app/data
|
|
- run/udev:/run/udev:ro
|
|
labels:
|
|
- "traefik.enable=true"
|
|
- "traefik.http.routers.z2m.rule=Host(`zigbee.example.com`)"
|
|
- "traefik.http.routers.z2m.tls.certresolver=letsencrypt"
|
|
depends_on:
|
|
- mosquitto
|
|
```
|
|
|
|
### Configuration initiale
|
|
|
|
```yaml
|
|
# data/configuration.yaml
|
|
mqtt:
|
|
base_topic: zigbee2mqtt
|
|
server: mqtt://mosquitto:1883
|
|
user: mqtt_user
|
|
password: changeme
|
|
serial:
|
|
port: /dev/ttyUSB0
|
|
adapter: zstack
|
|
frontend:
|
|
port: 8080
|
|
```
|
|
|
|
## 🔄 Alternatives
|
|
|
|
### Open Source
|
|
- [[app-mosquitto]] — broker MQTT
|
|
- [[app-z-wave-js-ui]] — pont Z-Wave
|
|
- **deCONZ** — passerelle ConBee officielle Phoscon
|
|
- **ZHA** — intégration Home Assistant native
|
|
- **ioBroker** — multi-protocole domotique
|
|
|
|
### Propriétaires
|
|
- **Philips Hue Bridge** — fermé, app Hue obligatoire
|
|
- **Xiaomi Mi Hub** — cloud-only, latence élevée
|
|
- **SmartThings Hub** — écosystème Samsung
|
|
|
|
## 🔐 Sécurité
|
|
- **Chiffrement Zigbee 3.0** natif (AES-128)
|
|
- **Clé réseau** Zigbee2MQTT : `network_key` dans `configuration.yaml`
|
|
- **Pairing sécurisé** : `permit_join: false` par défaut
|
|
- **Réseau local** : aucune donnée Zigbee envoyée au cloud
|
|
- **Mises à jour régulières** : suivre la branche `dev` pour les correctifs
|
|
|
|
## 📚 Ressources
|
|
- [Documentation](https://www.zigbee2mqtt.io/guide/)
|
|
- [GitHub](https://github.com/Koenkk/zigbee2mqtt)
|
|
- [Liste des appareils supportés](https://www.zigbee2mqtt.io/supported-devices/)
|
|
|
|
## Pages Liées
|
|
- [[cat-internet-of-things]] — Catégorie IoT
|
|
- [[app-mosquitto]] — Broker MQTT
|
|
- [[recettes-docker-compose]] — Templates Docker
|