Files
2026-06-09 18:40:21 +02:00

4.0 KiB


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
GitHub Koenkk/zigbee2mqtt
License GPL-3.0
Langage TypeScript
Étoiles GitHub 14k
Catégorie [[cat-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é)

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

# 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

Pages Liées