Home Assistant Yerel Otomasyon Mimarisi: Bulut Bağımsız MQTT Broker ve Zigbee2MQTT Entegrasyonu
Bölüm 1: Bu Nedir ve Neden Hayati Önem Taşır?
Düşün ki evinin beyni, binlerce kilometre uzaktaki bir sunucuda değil, salonundaki küçük bir kutucukta ya da boşta duran bir eski laptopta yaşıyor. İnternet kesilse bile ışıkların yanması, kapı sensörünün alarm vermesi, sıcaklığın ayarlanması durmuyor. İşte bu, Home Assistant’ın (HA) sunduğu “yerel öncelikli” (local-first) felsefenin ta kendisi.
Çoğumuz akıllı ev yolculuğuna “bulut tabanlı” cihazlarla başlarız: Telefonundaki bir uygulamaya dokunursun, komut Çin’deki bir sunucuya gider, oradan evindeki ampulün içindeki çipe ulaşır. Bu zincirdeki herhangi bir halka koparsa — internetin donması, firmanın sunucularının çökmesi, hatta firmanın bir gün “artık bu cihazı desteklemiyoruz” diyerek kapatması — eviniz aniden “aptal” bir ev haline gelir. Yerel mimari ise bu bağımlılığı kırar. Veri evinizin duvarları içinde döner, komutlar milisaniyeler içinde cevaplanır ve en önemlisi; evinizin kontrolü tamamen sizdedir. Bu bir lüks değil, dijital çağda ev sahipliğinin yeni standartıdır.
Bölüm 2: Perde Arkası: Sistem Nasıl Çalışıyor?
Bu mimarinin kalbi üç ana unsurdur: Home Assistant (Orkestra Şefi), MQTT Broker (Postacı) ve Zigbee2MQTT (Çevirmen).
Hayal edin ki evinizde onlarca farklı dille konuşan vatandaş var: Xiaomi sensörleri Çince fısıldar, IKEA ampulları İsveççe haykırır, Sonoff röleleri kendi protokolünde mırıldanır. Zigbee2MQTT bu babel kulesini yıkar. Zigbee donanımı (bir USB dongle/koordinatör) takar, havadaki Zigbee sinyallerini yakalar ve hepsini evrensel, hafif ve standart bir dile — MQTT mesajlarına — çevirip MQTT Broker‘a (genellikle Mosquitto) teslim eder.
Broker ise merkezi bir “panoya” benzer. “Salon hareket sensörü: HAREKET VAR” mesajını panoya asar. Home Assistant bu panoyu sürekli izler. Mesajı görür, “Aha, salon hareket sensörü tetiklendi, o zaman salon lambasını aç” kuralını (otomasyonu) çalıştırır ve lambayı kontrol eden Zigbee cihazına tekrar Broker üzerinden “YAN” komutunu gönderir. Tüm bu trafik kablonuzun veya Wi-Fi’nizin içinde döner, dışarıya tek bir bayt bile çıkmaz.

Bölüm 3: Bilim Dünyası ve Uzmanlar Nasıl İnceliyor?
Açık kaynak topluluğu ve sistem mühendisleri bu mimariyi “dayanıklılık” (resilience) ve “gözlemci etkisi” (observer effect) açısından incelerler. Bulut bağımlı sistemlerde ağ gecikmesi (latency) rastgele bir değişkendir; 50ms de olabilir, 5 saniye de. Yerel mimaride bu gecikme deterministiktir, yani neredeyse her zaman 10-20ms civarındadır. Bu, “kapı açıldığında ışığın anında yanması” ile “içeri girdikten 3 saniye sonra ışığın yanması” farkıdır; ikincisi insanda “sistem bozuk” algısı yaratır.
Güvenlik araştırmacıları ise “saldırı yüzeyini” (attack surface) küçültmesi için severler. Cihazlarınız internete çıkmıyorsa, bir botnet saldırısına alet edilemezler, üreticinin veri sızıntısından etkilenmezsiniz. Akademik literatürde buna “Edge Computing” (Uç Bilişim) denir; veriyi nerede ürettiysen orada işlersin. Home Assistant topluluğu bu teoriyi, “YAML yazmadan otomasyon kurmak” gibi pratik araçlarla (Blueprint’ler, Visual Automation Editor) herkesin erişimine sunmuştur.
Bölüm 4: Önemli Parametreler ve Karşılaştırma Rehberi
| Parametre | Bulut Tabanlı (Örn: Tuya, SmartLife) | Yerel MQTT + Zigbee2MQTT (Home Assistant) | Pratik Anlamı | Günlük Hayata / Sisteme Etkisi |
|---|---|---|---|---|
| İnternet Bağımlılığı | %100 (Komut buluta gider) | %0 (Sadece uzaktan erişim için VPB/Cloudflare Tunnel gerekir) | İnternet kesilse ev “akıllı” kalır mı? | Modem arızalanırsa bile alarm, ısıtma, ışık çalışır. |
| Gecikme (Latency) | 200ms – 5000ms (Değişken) | 10ms – 50ms (Sabit, Deterministik) | Komut ne kadar hızlı cevaplanır? | Tuşa basar basmaz lamba yanar; “lag” hissi yok. |
| Veri Sahipliği | Üretici/Firma (Sunucularda) | Siz (Kendi diskinizde/DB’nizde) | Kim gece gündüz ne yaptığınızı bilir? | Verileriniz satılmaz, profil çıkarılmaz, GDPR/KVKK kolay. |
| Cihaz Çeşliliği | Sadece o markanın ekosistemi | Binlerce marka/model (Zigbee standartı) | Xiaomi + IKEA + Sonoff + Aqara bir arada mı? | Tek hub ile her markayı kontrol edersiniz, kilitlenmezsiniz. |
| Yedek Alma / Geri Yükleme | Uygulama ayarları (Sınırlı) | Tam sistem yedeği (Snapshot/Backup) | Sistem bozulursa ne kadar sürede ayağa kalkar? | 5 dakikada tam donanım değişimi yapıp devam edersiniz. |
| Gelişmiş Otomasyon | Basit “Eğer-Oise” (Basit) | Karmaşık durum makineleri, şablonlar, scriptler | “Akşam 19:00-22:00 arası hareket varsa %30 ısık” mümkin mü? | Hayal edebileceğiniz her senaryo kodlanabilir. |
| Donanım Maliyeti | Hub dahili (Cihazda gizli) | Ayrı bir Sunucu/Raspberry Pi + Dongle (~$50-100) | Başlangıç masrafı var mı? | Uzun vadede hub satın almaya gerek kalmaz, cihazlar ucuzdur. |
| Kurulum Zorluğu | “Tak-Çalıştır” (Kolay) | Orta (Docker/HAOS, YAML/Config bilgi) | Ne kadar teknik bilgi ister? | Bir kez kurarsınız, yıllarca dokunmazsınız; topluluk desteği devasa. |
| Firmware Güncelleme | Otomatik/Zorunlu (Riskli) | Manuel/Seçmeli (Güvenli) | Cihazınız bir güncellemeyle çöp olabilir mi? | “Brick” olma riski sıfır, istediğiniz sürümde kalırsınız. |
| Enerji Verimliliği | Wi-Fi cihazları (Yüksek tüketim) | Zigbee/Thread (Çok Düşük, Yıllar pil) | Sensör pillerini ne sıklıkla değiştirirsiniz? | Kapı sensörü pili 2-3 yıl gider, Wi-Fi sensörü aylık. |
Bölüm 5: Günlük Hayatta ve Doğada Nerede Karşımıza Çıkar?
Bu mimari, sadece “geek”lerin oyuncağı değil, evinizin sinir sistemidir. Senaryo 1: Gece yarısı su basması. Banyo altındaki Zigbee su sensörü (Aqara/Xiaomi) suyla temas eder. 200ms içinde MQTT mesajı uçar: water_leak: true. Home Assistant bunu yakalar, ana vanayı kapatan Zigbee motorlu vanayı (Sonoff/Zigbee) tetikler, size Telegram ve sesli asistan üzerinden “SU KAÇAĞI! VANA KAPATILDI” bildirimi gönderir. İnternet yoksa bile vana kapanır, sadece size bildirim gitmez (VPN/Tailscale kuruluysa gider).
Senaryo 2: Misafir modu. Arkadaşlarınız geliyor. Wi-Fi şifrenizi vermek yerine, onlara “Misafir” etiketiyle bir NFC etiketi veya QR kodu verirsiniz. Telefonu yaklaştırırlar, tarayıcıda açılan Home Assistant arayüzünden (HTTPS/Cloudflare Tunnel sayesinde) sadece salon lambalarını ve klima kontrolünü görürler. Ana yatak odası, güvenlik kameraları, alarm paneli onlardan gizlidir.
Senaryo 3: Enerji takibi. Her prizin, her ampulün anlık watt değerini MQTT üzerinden alıp InfluxDB’ye yazdırır, Grafana ile güzel grafikler çizersiniz. “Bu ay klima 350kWh yedi, faturam ne olur?” diye tahmin yaparsınız. Bu veriler asla elektrik dağıtım şirketine veya Çin sunucularına gitmez.

Bölüm 6: Karşılaşılan Zorluklar ve Pratik Çözümler
1. “Zigbee Mesh Ağının Kurulamaması / Cihazların Düşmesi”
Yanıltıcı: Yeni alınan sensör hub’a bağlanmıyor veya 1 günde bir “unavailable” oluyor.
Gerçek: Zigbee bir “mesh” (örümcek ağı)dır. Sadece koordinatöre (dongle’ye) bağlanmazlar, birbirlerine de bağlanarak sinyali taşırlar. Çözüm: Her odada en az bir “yönlendirici” (router) cihaz (şarjlı priz, ampul, röle) bulundurun. Pil ile çalışan sensörler (end device) yönlendirici olamazlar. Dongle’ınızı USB 3.0 portundan uzaklaştırın (Uzatma kablosu + alüminyum folyo şilding), Wi-Fi 2.4GHz kanalı 1, 6 veya 11’e sabitleyin, Zigbee kanalı 15, 20 veya 25’e (Wi-Fi kanalları arası boşluk) ayarlayın.
2. “MQTT Broker Çöküyor / Mesaj Kayboluyor”
Yanıltıcı: Mosquitto loglarda “max connections exceeded” veya “out of memory” hatası veriyor.
Gerçek: Varsayılan ayarlar hobi seviyesindedir. Çözüm: max_connections: 0 (sınırsız), message_size_limit: 0, persistent_client_expiration: 0 ayarlayın. Eğer HA ve Broker aynı makinedeyseniz Docker network modunu host yapın, localhost yerine container adı (mqtt://mosquitto) kullanın. QoS 1 (En az bir kez teslim) kullanın, QoS 2 (Tam bir kez) kaynak yiyor, ev otomasyonunda genelde gerekmez.
3. “Zigbee2MQTT Frontend Açılmıyor / Port Çakışması”
Yanıltıcı: Port 8080/8099 dolu, ya da HA içinden Ingress çalışmıyor.
Gerçek: Genellikle port çakışması veya reverse proxy (Nginx Proxy Manager) header ayarlarıdır. Çözüm: configuration.yaml içinde frontend: port: 8099 (veya boş bir port) verin. HA’da Settings > Add-ons > Zigbee2MQTT > Network kısmından “Host network” işaretliyse port çakışması olmaz. Ingress için ingress: true yeterlidir, ayrı reverse proxy kurmaya gerek yoktur.
4. “Cihaz Tanımlama (Interview) Başarısız Oluyor”
Yanıltıcı: Yeni cihaz “Interview” aşamasında takılı kalıyor.
Gerçek: Bazı cihazlar (özellikle Tuya markalıları) “manufacturer specific” cluster kullanır. Çözüm: Zigbee2MQTT experimental: new_api: true açın. Cihazı eşleştirirken (pairing) cihazın reset tuşuna tekrar tekrar basın (battery cihazlarda her 1-2 saniyede bir 10-15 saniye). device_options ile legacy: false deneyin. Yine olmazsa external_converters ile topluluk yazılımlı converter ekleyin.
Bölüm 7: Gelecek Perspektifi ve Yeni Gelişmeler
Gelecek Thread ve Matter standartlarında, ama yol yine MQTT‘den geçiyor. Matter cihazları (Google, Apple, Amazon, Samsung ortak standardı) Thread radyosu ile gelirler. Home Assistant artık Open Thread Border Router (OTBR) eklentisiyle bir Thread Border Router’dır. Yani gelecekte Zigbee dongle yerine Thread dongle (veya ikisi bir arada: SkyConnect, Sonoff Dongle Plus-E) takarsınız, Matter cihazları HA’ya doğrudan yerel olarak (Matter/Thread üzerinden) bağlarsınız.
Ancak Matter henüz “bridge” (köprü) cihazları tam standardize etmediği için, mevcut Zigbee envanterinizi çöpe atmayacaksınız. Zigbee2MQTT hâlâ en esnek, en hızlı güncelleme alan, en çok cihaz destekleyen köprüdür. Yeni sürümlerde MQTT Discovery iyileştirmeleriyle HA’ya cihaz tanıtımı saniyeler sürüyor. Ayrıca Home Assistant Yellow (kendi donanımı) ve Home Assistant Green gibi “tak-çalıştır” kutular, bu karmaşıklıyı “kurulum sihirbazı”na sarmaya başladı. Yakında “Docker compose yazmak” bilmeyen bir kullanıcı da kutuyu prizine takıp, Zigbee dongle takıp 10 dakikada bu mimariyi kurabilecek.
Bölüm 8: Merak Edilen Sorular ve Cevaplar (SSS)
Soru 1: “Ben Linux/Docker bilmiyorum, bu sistemi kurabilir miyim?”
Cevap: Evet, kesinlikle. Home Assistant OS (HAOS) indirip bir Raspberry Pi 4/5’e (veya eski bir Intel NUC/Mini PC’ye) BalenaEtcher ile yazdırın. Takın, açın, tarayıcıdan homeassistant.local yazın. 5 dakikada “Supervisor” menüsünden “Add-on Store” -> “Mosquitto Broker” -> “Zigbee2MQTT” kurarsınız. Kod yazmana gerek yok, arayüzden tıklarsınız.
Soru 2: “Zigbee dongle (koordinatör) hangisini almalıyım? Çok mu pahalı?”
Cevap: Pahalı değil, 15-25$ civarı. Sonoff Zigbee 3.0 USB Dongle Plus (Model: ZBDongle-E) veya Texas Instruments CC2652P chipli herhangi bir dongle (Slaesh, Electrolama vb.) alın. Eski CC2531 chipli “çubuk” dongleleri almayın, yavaşlar, zayıf sinyal verirler, modern Zigbee 3.0 cihazları desteklemezler.
Soru 3: “Wi-Fi ampullerim (Tuya, Tapo, Meross) var, onları da bu sisteme alabilir miyim?”
Cevap: Alabilirsiniz ama Zigbee/Thread/Matter kadar “yerel” ve hızlı olmazlar. Tuya/Tapo cihazları yerel API (Local Tuya, Tapo Control entegrasyonları) ile HA’ya eklenebilir. Ancak bunlar Wi-Fi kullanır, pil ömrü yoktur (prizlıdır), ağ trafiği yaparlar ve bazen bulut bağlantısı kesilse bile yerel çalışırlar ama Zigbee kadar güvenilir değildir. Yeni alacaksanız Zigbee/Matter alın.
Soru 4: “Evim çok büyük/duvarlar kalın, Zigbee sinyali yetmez, ne yapmalıyım?”
Cevap: Zigbee bir “mesh” ağıdır. Sinyal yaymak için her odaya bir tane şarjlı Zigbee cihazı (priz, ampul, röle, tekrar edici) koyun. Bu cihazlar sinyali bir sonraki odağa iletir. Eğer yine yetmezse (örneğin bahçe, ayrı bina), ikinci bir Zigbee koordinatörü kurup Zigbee2MQTT “Multi-PAN” (Çoklu Ağ) özelliğiyle birleştirebilirsiniz (İleri seviye). Veya Thread/Matter cihazlarıyla Thread Mesh genişletin.
Soru 5: “Yedek alma (Backup) nasıl yapılır? SD kartım bozulursa ne olur?”
Cevap: HA arayüzünden Settings > System > Backups -> “Create Backup” (Tam yedek). Bunu Google Drive, Dropbox, S3, NAS (Samba/NFS), GitHub gibi uzak bir yere otomatik gönderin (Add-on: “Google Drive Backup” veya “Samba Backup”). SD kart bozulursa: Yeni karta HAOS yazdır, tak, aç, “Restore from backup” de, dosyayı seç. 10 dakikada eviniz aynen olduğu gibi ayağa kalkar.
Soru 6: “Güvenlik kameralarım (RTSP/ONVIF) var, onları da bu yerel mimariye sokabilir miyim?”
Cevap: Kesinlikle. Frigate (NVR) eklentisini kurun. Kameralarınızın RTSP URL’lerini verin. Frigate, Google Coral TPU (USB veya PCIe, ~60$) veya CPU ile nesne tespiti (Kişi, Araç, Hayvan) yapar, MQTT üzerinden frigate/events topic’ine JSON atar. HA bunu alıp “Bahçede kişi görüldü -> Bahçe lambasını yak -> Telegram’a foto gönder” der. Tüm video kayıtları ve AI işlemi evinizde kalır, buluta tek bayt gitmez.
Soru 7: “Zigbee2MQTT ayarlarını (configuration.yaml) yanlış düzenledim, sistem açılmıyor, ne yaparım?”
Cevap: Panik yapmayın. HAOS konsoluna (klavye+monitör veya SSH/Portainer) girin. cd /addon_configs/zigbee2mqtt (veya data klasörü) gidin. configuration.yaml dosyasını nano ile açın, hatayı düzeltin (genelde girinti/boşluk hatasıdır). Ya da configuration.yaml.backup dosyasını geri yükleyin. Zigbee2MQTT add-on’u yeniden başlatın.
Bölüm 9: Bilmeniz Gereken Temel Terimler
MQTT Broker (Mesaj Merkezi): Evdeki tüm akıllı cihazların ve Home Assistant’ın birbiriyle konuştuğu, mesaj bıraktığı ve aldığı merkezi “panoda”. En popüléri Mosquitto‘dur. Postane müdürü gibidir; mektupları (mesajları) alır, kime gideceğini bilir, teslim eder.
Zigbee2MQTT (Evrensel Çevirmen): Farklı markaların (Xiaomi, IKEA, Sonoff, Aqara) Zigbee cihazlarının konuştuğu “kendi dillerini” (cluster/attribute), Home Assistant’ın anlayacağı standart MQTT mesajlarına çeviren yazılımdır. Bir nevi “Babel Balık”tır.
Zigbee Koordinatör / Dongle (Anten): Bilgisayarınıza/Raspberry Pi’nize takılan, evinizde Zigbee radyo ağını yaratan küçük USB çubuğu. Ağın “babası”dır; adres dağıtır, şifreler, ağ kurar. Ohne diesen gibt es kein Zigbee-Netz.
Home Assistant OS (HAOS) (İşletim Sistemi): Sadece Home Assistant’ı çalıştırmak için optimize edilmiş, Linux tabanlı, konteyner (Docker) yöneten, kendini güncelleyen, yedek alan, “tak-çalıştır” bir işletim sistemi. Raspberry Pi, x86-64 (PC) için hazır imajlar vardır.
Entity / Varlık (HA Terimi): Home Assistant’ın anladığı en küçük birim. “Salon Lambası” bir entity’dir (aç/kapa, parlaklık, renk). “Sıcaklık Sensörü” bir entity’dir (değer: 22.5°C). Otomasyonlar bu entity’ler üzerinde kurulu.
Automation / Otomasyon (HA Terimi): “Tetikleyici -> Koşul -> Eylem” zinciri. Örn: Tetikleyici: Hareket sensörü “Açık” oldu. Koşul: Saat 20:00 – 06:00 arası. Eylem: Koridor lambasını %50 aç, 2 dakika bekle, kapat.
Add-on (Eklenti / Yan Uygulama): HAOS’in yanında aynı makinede, izole bir konteynerde çalışan yardımcı programlar. Mosquitto Broker, Zigbee2MQTT, Frigate (NVR), File Editor, VS Code, InfluxDB, Grafana hepsi Add-on’dür. Ayrı sunucu kurmanıza gerek kalmaz.
Snapshot / Yedek (Tam Sistem Yedeği): HA’nın veritabanı, ayarlar, şifreler, eklentiler, temalar, Lovelace panoları… Hepsinin tek bir .tar dosyasında birleşimi. Bu dosya ile “Sıfırdan kurulum” 10 dakikaya indirgenir.
Bölüm 10: Ozet ve Cikarilmasi Gereken Dersler
Evinizin akıllı olması, markanın uygulamasının ne kadar güzel olduğuyla değil, verinin kimin elinde olduğu ve internet kesildiğinde ne olup olmadığıyla ölçülür. Bu makalede anlattığımız Home Assistant + MQTT Broker (Mosquitto) + Zigbee2MQTT üçlüsü, bu özgürlüğün en sağlam, en ucuz ve en topluluk desteği güçlü yoludur.
**Altın