ZKTeco и умный дом: совместимость с MQTT, Home Assistant и другими системами
ZKTeco — популярный бренд терминалов контроля доступа и биометрических считывателей. В статье разберём, какие модели можно подключить к умному дому, как это сделать через MQTT и Home Assistant, какие есть схемы wiring и с какими ограничениями придётся мириться. В конце — чек‑лист для инсталлятора и ссылки на раздел с домофонными/СКУД товарами на y-ss.ru.
Коротко о совместимости
ZKTeco выпускает разные устройства: контроллеры (InBio, SC), терминалы отпечатков и лица, сетевые видеодомофоны. Некоторые модели имеют сетевой API или TCP‑протокол (порт 4370 — «ZK protocol»), другие дают только аппаратные интерфейсы: Wiegand, RS485, реле. Нативного MQTT у большинства устройств нет. Так что обычно нужен мост — Raspberry Pi, сервер на Linux или Node‑RED, который переводит события в MQTT и управляет из Home Assistant.
Смотрите: многие терминалы ZKTeco не поддерживают MQTT напрямую — обычно используют TCP/SDK или Wiegand, а MQTT выполняет роль транспортного слоя в умном доме.
Способы интеграции — обзор
| Способ | Что требует | Плюсы | Минусы |
| TCP/SDK (порт 4370, UDP) |
Скрипт Python/Node, библиотека zklib/pyzk |
Доступ к событиям, пользователям |
Нет MQTT, нужен софт |
| HTTP/REST (у некоторых моделей) |
Прямые запросы |
Проще интегрировать в Home Assistant |
Реже встречается |
| Wiegand / RS485 |
Проводка к контроллеру |
Надёжно для доступа |
Только события/карты, без сетевых логов |
| MQTT через мост (Node‑RED, скрипт) |
Raspberry Pi/сервер |
Гибко, работает с Home Assistant |
Ещё одно звено, требуются навыки |
Практическая схема подключения
Пример простой схемы для дверного контроллера:
- Терминал ZKTeco (сетевая модель) подключается к LAN.
- Контроллер управляет замком через релейный выход NO/COM.
- Датчик двери (магнит) подключён к входу контроллера.
- На отдельном Raspberry Pi запущен Python‑скрипт, который по TCP опрашивает терминал и публикует события в MQTT (топик zkteco/door1/event).
- Home Assistant подписан на этот топик, отображает состояние и посылает команды (через MQTT до уровня скрипта, который вызывает релевый выход контроллера).
Wiegand‑схема: считыватель → контроллер доступа (например, SC или InBio) → реле замка; контроллер может иметь Ethernet для дальнейшей интеграции.
Шаги настройки MQTT и Home Assistant
1. Найдите IP устройства и включите сетевой доступ (в веб‑меню или через клавиатуру).
2. Проверьте доступность порта 4370 (или HTTP API) с компьютера.
3. На Raspberry Pi установите Python, библиотеку
pyzk или аналог. Есть готовые репозитории и примеры в сообществе.
4. Создайте скрипт, который:
- подключается к устройству,
- слушает события входа/выхода и состояния двери,
- публикует JSON в MQTT: topic zkteco/
/event, payload { "type":"card", "id":"1234", "time":"..." }.
5. В Home Assistant добавьте MQTT‑сенсоры и автоматизации, которые реагируют на события и могут отправлять команды (например, для отпирания двери).
6. Для управления из HA команды идут в MQTT topic zkteco//cmd, скрипт на RPi принимает и триггерит реле.
Пример JSON‑сообщения:
{"event":"access_grant","user_id":"U123","method":"card","time":"2025-10-29T12:34:56"}
Безопасность и закон
- Биометрические данные принадлежат людям — храните их защищённо. Разделяйте доступ к БД пользователей и логам.
- Устройства должны быть в защищённой сети. Закрывайте доступ к SDK‑портам из интернета.
- В коммерческих и гос. объектах проверьте местные правила о персональных данных и видеонаблюдении.
- Логи доступа пригодны для расследований, но требуют политики хранения и удаления.
Цены и где взять оборудование
Стоимость зависит от модели: простые считыватели — от доступных бюджетных цен, сетевые терминалы с биометрией и встроенными контроллерами дороже. Для домашних задач обычно достаточно сетевого считывателя и RPi‑моста; для бизнеса берите контроллеры InBio/SC с поддержкой Wiegand и реле.
Если нужно подбирать конкретные устройства или комплекты, смотрите раздел домофонных систем и СКУД на y-ss.ru:
https://y-ss.ru/skud/domofonnye-sistemy/
Чек‑лист перед установкой
- Проверили модель терминала и её интерфейсы (TCP, HTTP, Wiegand, RS485).
- Есть доступ к меню устройства и IP‑адрес.
- Определили, где будет запущен MQTT‑брокер (локально или облако).
- Настроили резервный канал логов и бэкапы базы пользователей.
- Установили физическую защиту реле и замка (защёлка, блокировка).
- Оформлена политика хранения данных и доступа для персонала.
Коротко о выборе
Если нужна быстрая интеграция с Home Assistant без программирования — ищите модели с REST/HTTP API или те, для которых есть готовые интеграции в сообществе. Если важна надёжность и скорость — лучше аппаратное решение с Wiegand и центральным контроллером. Для гибкой автоматики — мост MQTT под RPi даёт больше возможностей.
Небольшая финальная мысль: если хотите, чтобы дверная система стала частью умного дома, готовьтесь добавить один софт‑компонент между устройством и Home Assistant. Это даёт контроль и расширяет сценарии, но требует базовых навыков сети и скриптинга. Если нужен подбор оборудования или помощь с конфигурацией — в разделе y-ss.ru по ссылке выше вы найдёте подходящие модели и комплекты. 
