智能门锁与门禁接入 Home Assistant：指纹锁状态同步、临时密码与回家离家自动化

摘要

智能门锁是家庭入口的第一道智能节点。把它接入 Home Assistant（HA）后，你不仅能随时查看门锁状态、远程生成临时密码，还能用"开门"这一个事件触发回家灯光、撤防、播报等一整套自动化。本文从硬件选型到配置、自动化编排，给出可落地的实战路径。

为什么要把门锁接进 HA

传统门锁只是"能开锁"，接入 HA 后它变成了一个可被感知、可被联动的状态源：

家人指纹开门 → 自动撤防、开玄关灯、播报"欢迎回家"；
离家上提反锁 → 自动布防、关灯、关空调；
快递/保洁到访 → 下发一次性临时密码，过期自动失效；
异常撬动或长时间未关 → 推送告警。

它的价值不在"远程开锁"（这反而有安全风险），而在状态同步与事件驱动。

硬件与协议选型

常见接入方式有三类，按成本与稳定性排序：

Wi-Fi 直连门锁：如不少国产指纹锁自带 WiFi 模块，可通过官方集成或 localtuya/b possession 等第三方集成接入。优点是无需额外网关；缺点是依赖厂商云或需抓包做本地化。
Zigbee/Thread 门锁 + 网关：如 Aqara、Schlage 等，配合 ZHA 或 Matter 网关接入，断外网也能本地联动，延迟低，最推荐。
门磁 + ESPHome 间接判断：门锁本身不支持联网时，在门框贴一个 Zigbee/ESPHome 门磁，用"门磁开合"近似判断开关门。成本最低，但拿不到"谁开的"。

本文以最稳妥的 Zigbee 门锁 + HA ZHA 为主线，并补充门磁方案。

方案一：Zigbee 门锁接入 ZHA

确保门锁在 HA 的 Zigbee 网络覆盖内，进入配对模式后在 HA「设置 → 设备与服务 → ZHA → 添加设备」中搜索。配对成功后会自动出现 lock.<名称> 实体，以及 sensor.<名称>_lock_state（locked/unlocked）、sensor.<名称>_battery 等。

临时密码通过 lock 实体的"密码槽"管理。用 lock.set_lock_user_code 服务下发：

service: lock.set_lock_user_code
target:
  entity_id: lock.front_door
data:
  code_slot: 3
  user_code: "483920"

撤销则用 lock.delete_lock_user_code，指定同一 code_slot 即可。

方案二：门磁间接判断（低成本）

若门锁不可联网，用 ESPHome 门磁感知：

binary_sensor:
  - platform: gpio
    pin:
      number: GPIO4
      mode: INPUT_PULLUP
      inverted: true
    name: "入户门状态"
    device_class: door

门磁开合会生成 binary_sensor.入户门状态，配合 history_stats 可统计开关频率，作为开门事件源。

回家 / 离家自动化编排

以 Zigbee 门锁的"解锁"事件触发回家场景：

automation:
  - alias: 指纹开门触发回家模式
    trigger:
      - platform: state
        entity_id: lock.front_door
        to: "unlocked"
    condition:
      - condition: time
        after: "17:00"
        before: "23:59"
    action:
      - service: scene.turn_on
        target:
          entity_id: scene.回家灯光
      - service: alarm_control_panel.alarm_disarm
        target:
          entity_id: alarm_control_panel.home

离家则监听"上锁"事件（to: "locked"）反向操作。建议加一个 for: "00:00:10" 防抖，避免误触。

注意事项

安全优先：不要开放"远程一键开锁"的对外端口；临时密码务必设短时效与独立槽位。
断网兜底：Zigbee/本地方案在路由器故障时仍能本地联动，优于纯云方案。
电池与告警：在 HA 里对 battery 实体设低于 20% 推送更换提醒，避免被锁门外。
隐私：开门记录属于敏感日志，不要同步到第三方云。

小结

门锁接入 HA 的核心收益是"状态可感知、事件可编排"。选 Zigbee/Matter 本地方案最稳，门磁方案可作低成本平替；临时密码与回家/离家自动化是上手即用的高价值场景。先接入、再编排，循序渐进即可。