Aktualizováno: 2026-10-05 · Platí pro: Homebridge 2.x (2.4.0); Matter bridge od 2.2.0

Homebridge

Co to je: Lehký Node.js server v domácí síti, který emuluje HomeKit Accessory Protocol (HAP). Přes pluginy napojí na Apple Home a Siri zařízení, která HomeKit sama neumí: cloudy výrobců, kamery, televize, termostaty. dok. Homebridge Je to komunitní, nekomerční open-source projekt bez vazby na Apple. Od verze 2 umí pluginy vystavit zařízení i přes Matter, tedy i do Google Home nebo Alexy. Aktuální verze je 2.4.0 (08/2026). dok. Homebridge

Cesty zařízení do Apple Home
Tři cesty do Apple Home: nativní HomeKit/Matter, Homebridge a Node-RED s NRCHKB. Vlastní schéma (Syntéza) podle dok. Homebridge, podpory Apple a NRCHKB.

Kdy Homebridge a kdy něco jiného

Syntéza podle dok. Homebridge, podpory Apple a NRCHKB:

Situace	Cesta
Zařízení umí HomeKit nebo Matter	přidat přímo do Apple Home
Zařízení HomeKit neumí, existuje plugin, automatizace stačí v Apple Home	Homebridge
Zařízení potřebuje logiku, data nebo kombinaci zdrojů	Node-RED + NRCHKB

Každé zařízení vystav jen jednou cestou, jinak se v aplikaci Domácnost objeví dvakrát.
Plugin je komunitní kód, který běží s přístupy Homebridge. Vybírej udržované pluginy s aktivním repem.

Instalace

Oficiálně: Raspberry Pi image, Linux (Debian/Ubuntu, RHEL, Arch), macOS, Windows (Hyper-V), Docker a NAS (Synology, Unraid, QNAP, TrueNAS). dok. Homebridge
Umbrel: aplikace homebridge (image homebridge/homebridge, verze 2.4.0), network_mode: host, běží jako root, UI na portu 8581. zdroje Umbrel
Syntéza: host síť je pro HomeKit potřeba, protože objevování jde přes mDNS v lokální síti. UI chraň heslem a nevystavuj ho do internetu.

Přidání do Apple Home

V aplikaci Domácnost: Přidat příslušenství a naskenovat QR kód z Homebridge UI nebo z logu. dok. Homebridge
Bez pluginů hlásí Home „Je potřeba další nastavení“. To je v pořádku, další zařízení se pak objeví bez nového párování. dok. Homebridge
Kamery a většina televizí se párují zvlášť jako samostatná příslušenství. dok. Homebridge
Pro automatizace a ovládání mimo domov je potřeba domácí centrum (Apple TV nebo HomePod). podpora Apple

Child bridges

Plugin běží jako samostatný bridge ve vlastním procesu (od 1.3.0). Nastavuje se v UI volbou Child Bridge Config. dok. Homebridge

Pád pluginu neshodí ostatní, Homebridge ho sám restartuje.
Pomalý plugin nezdržuje ostatní. Home se při otevření ptá na stav všech příslušenství jednoho bridge najednou.
Obejde limit 150 příslušenství na bridge (limit HomeKitu).
Syntéza: u pluginů na cloudová API (nestabilní, pomalé) je child bridge rozumná výchozí volba.

mDNS a objevování

Homebridge se v síti ohlašuje přes mDNS. Advertiser jde přepnout: dok. Homebridge

Bonjour-HAP: výchozí, starší a náročnější.
Ciao: doporučený mimo Linux. V kontejnerech může špatně vybrat síťové rozhraní.
Avahi: pro Linux nejlepší. V Dockeru potřebuje namapovat D-Bus a socket avahi-daemon.
systemd-resolved: experimentální, pro pokročilé.
Do jiné VLAN než iPhone se HomeKit ohlášení dostane jen přes mDNS proxy na gateway, viz VLAN.

Matter (Homebridge 2)

Podle dok. Homebridge:

Zapíná se pro každý bridge zvlášť (blok matter v konfiguraci) a plugin musí Matter podporovat. Každý Matter bridge se páruje samostatně a umí multi-admin, takže může být zároveň v Apple Home i Google Home.
Implementace (matter.js) není certifikovaná CSA. Ovladač může při párování varovat, to je očekávané.
Párování potřebuje stejný IP subnet, funkční mDNS a IPv6, stejně jako HomeKit. Přesun mezi ovladači znamená nový commissioning.
Matter bridge (od 2.2.0) má vlastní mDNS responder na portu 5353. Když přestanou fungovat adresy .local přes IPv4, pomůže disableIpv4: true v bloku matter.

Troubleshooting

Podle dok. Homebridge:

iOS Homebridge nenajde: přepni advertiser (Bonjour-HAP ↔ Ciao) a vyčisti DNS cache v iOS (zapnout a vypnout režim letadlo).
„Příslušenství už je přidané“: reset Homebridge.
Přejmenování v Homebridge se do Home nepropíše, přejmenuj zařízení i v aplikaci Domácnost.
Siri dává přednost vlastním frázím. Zařízení pojmenované „Radio“ spustí rádio, proto volíš jména, která nekolidují.

Souvislosti

Apple Home (HomeKit), Node-RED, Matter, Umbrel Home, Docker, VLAN

Zdroje

Homebridge: README a wiki (child bridges, mDNS advertiser, Matter): README a wiki (child bridges, mDNS, Matter, limity).
umbrelOS / Umbrel Home (README, app store, produktová stránka): aplikace Homebridge na Umbrelu (image, port, host síť, root).
Apple Support: domácí centrum, Matter v aplikaci Domácnost, aktualizace Apple Home: domácí centrum.
node-red-contrib-homekit-bridged (NRCHKB): README, npm, issues: alternativa přes Node-RED.