Home Assistant 智能门锁完整指南远程控制与临时访客密码一次接好【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io深夜独自开门时你希望家里门锁能远程掌控而不是只能干等。本文带你把智能门锁接入 Home Assistant从选协议到上线自动化走完全流程。接上门锁后你能做什么先说结论接入后你的门锁不再只是本地按键而变成一个可被系统指挥、可被系统观测的实体entity。典型能力有 4 点状态随时可见locked / unlocked 状态在仪表盘上实时刷新出门没锁门一眼就能发现远程开锁/上锁在界面、手机 App 或语音里一条指令完成操作密码可编程下发访客码、保洁码按槽位写入或清空不用在 App 里手动改事件可驱动每次开锁都能触发通知、联动摄像头、写入日志 值得折腾吗如果你家已经有 MQTT 或 Z-Wave 网关且门锁支持其中之一那接入成本很低收益立竿见影。三条路怎么选MQTT / Z-Wave / 厂商集成先给结论能走 Z-Wave 就走 Z-Wave锁控场景优先稳定性设备本身就是 MQTT 网关形态就选 MQTT品牌锁且官方有集成直接用厂商集成省心。维度MQTTZ-Wavezwave_js厂商专用集成典型设备自组网/网关型门锁主流品牌智能锁Nest、Schlage 等品牌锁上手难度中要配 topic 和 payload低入网即识别低按向导走可控程度完全自定义控制逻辑高支持用户码槽操作受厂商能力上限约束稳定性依赖 broker 质量高协议自带安全机制厂商优化好下面分别走通前两条路线。路线 AMQTT 门锁上线这一节帮你把一台支持 MQTT 的门锁从 broker 接到 Home Assistant 实体。硬件前提一台跑着 MQTT broker如 Mosquitto的机器且门锁能与 broker 正常通信。写配置在configuration.yaml中加一个 lock 组件核心是状态在哪个 topic 读、命令往哪个 topic 发mqtt: - lock: name: Frontdoor state_topic: home-assistant/frontdoor/state command_topic: home-assistant/frontdoor/set payload_lock: LOCK payload_unlock: UNLOCK如果你的锁要带密码操作再加两行用code_format限定 4 位数字用command_template把密码拼进下发报文code_format: ^\\d{4}$ command_template: { action: {{ value }}, code: {{ code }} }⚠️ 注意retain: true的风险重启后可能重放旧的解锁消息不确定的设备别开保留。验证成功重启 Home Assistant 后设备列表里出现lock.frontdoor状态显示 locked再用mosquitto_pub -h 127.0.0.1 -t home-assistant/frontdoor/set -m LOCK手动发一条消息实体状态变化就说明链路通了。更多参数细节见 MQTT 锁组件文档。路线 BZ-Wave 门锁上线这一节帮你把 Z-Wave 门锁入网并写好用户码全程以 Home Assistant Connect ZWA-2 控制器 Z-Wave JS 集成为例。第一步装好控制器。把 ZWA-2 插到主机上在设置中按向导完成 Z-Wave JS 加载项安装生成或输入 S0/S2 网络安全密钥等待加载项启动。第二步门锁入网。进入 Z-Wave 集成面板执行添加入网把门锁切换到配对模式通常按机身按键设备列表出现后若门锁支持 S2 安全输入机身印的 PIN 完成安全握手。第三步写入用户码。入网后你得到lock.front_door实体访客密码用zwave_js.set_lock_usercode按槽位下发比如写到 5 号槽action: zwave_js.set_lock_usercode target: entity_id: lock.front_door data: code_slot: 5 usercode: 1234服务参数说明可查 set lock user code 动作文档集成整体用法见 zwave_js 文档。不走到门口也能开门三种操作入口接入成功后你不必再摸手机 AppHome Assistant 里有三条现成通道仪表盘卡片把 lock 实体拖成卡片点按钮即锁/开锁这是最直接的界面控制移动 App登录你的 Home Assistant 实例后在实体列表里点门锁卡片操作配合通知可以人在公司也能远程解锁语音控制结合 Assist 功能一句锁上前门即可执行在语音助手的意图配置里把 lock 域的意图映射到实体测试通过后即可日常使用三种方式本质都是调用同一组锁服务lock.lock/lock.unlock所以权限与校验逻辑完全一致。三套现成自动化访客码、日志、警报这一节给你三块可以直接抄的积木分别对应给临时权限知道谁进过门发现异常。1. 临时访客密码用一个 input_text 存访客邮箱自动化里生成密码、写入用户码槽、发通知- action: zwave_js.set_lock_usercode target: entity_id: lock.front_door data: code_slot: 5 usercode: {{ states(input_text.guest_code) }} - action: notify.email data: message: 你的临时访问密码: {{ states(input_text.guest_code) }}访客离开后用zwave_js.clear_lock_usercode清空该槽位即可收回权限。2. 访问日志监听lock.front_door的状态变化每次变动写一条 logbook 记录- trigger: - type: opened platform: lock entity_id: - lock.front_door action: - action: logbook.log data: name: 前门 message: 状态变为 {{ trigger.to_state.state }}3. 异常开锁警报全家离开 门锁从 locked 变 unlocked 时推通知并触发警报面板- condition: state entity_id: person.family state: not_home满足条件后执行notify.mobile_app_phone发通知再调用alarm_control_panel.alarm_trigger拉响家中警报。⚠️ 触发条件里的实体 ID 记得换成你家的实际人员实体。卡住了高频故障速查Q实体一直显示 unknown 或状态不动先确认state_topic大小写和斜杠是否完全一致some-topic/和some-topic是两个 topic再用mosquitto_sub订阅看锁是否真的在发布状态。Q发命令没反应但订阅能看到消息查command_topic是否与锁端固件约定一致并确认 payload 完全匹配多了空格也算不匹配。MQTT 锁没有回执机制建议开optimistic前先确认设备行为。QZ-Wave 门锁入网失败看信号与距离把控制器尽量靠近门锁再试S2 设备要确认输入的 PIN 是锁上对应密钥类型的 PIN输错会握手失败。Q自动化不触发在自动化的运行记录里看有没有触发但被条件拦下再单独手动调用一次相关服务确认是触发器问题还是执行链路问题。写在最后到这里你的门锁已经从本地开关升级成系统里可查、可控、可追溯的实体。下一步建议给解锁动作加上位置校验仅到家范围内可开以及把访客码自动化串进日历事件权限管理会更省心。延伸资料MQTT 锁组件文档Z-Wave JS 集成文档set lock user code 动作【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考