Home Assistant 智能门锁远程配置实操指南：从加网到发一次性密码

Home Assistant 智能门锁远程配置实操指南从加网到发一次性密码【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io周五晚上堵在回家路上手机推送前门未锁——这就是门锁接进 Home Assistant 之后的体验。下面按实操顺序走一遍怎么把智能门锁接入 Home Assistant 并实现远程锁控、访客密码下发和访问记录全程不抠协议细节。方案选型先选对接线方式动手前先看你手头有什么按这个顺序判断门锁品牌自带集成如 Nuki、Yale→ 直接在设置 设备与服务里添加最省事门锁是 Z-Wave 设备短距离、低功耗的网状无线协议穿墙比 Wi-Fi 稳→ 走 Z-Wave JS需要配一个 Z-Wave 控制器门锁或外接继电器走 MQTT 通信一种轻量级的发消息协议Home Assistant 可用加载项自带 broker→ 走 MQTT 锁路线要买的硬件一次性密码管理适合人群Z-Wave JSZ-Wave 控制器如官方 Connect ZWA-2内置set_lock_usercode动作密码直接写进锁装完三年不想再碰的人MQTT 锁无锁或继电器能发 MQTT 就行自己搭用code_format做校验想逐字节掌控消息的折腾党一句话有现成集成的优先走集成MQTT 是万能但最费手工的兜底方案。从零跑通第一步把通信链路拉起来Z-Wave 路线在设置 加载项里安装 Z-Wave JS按提示选择控制器所在的 USB 端口等加载项启动。启动后 Z-Wave 页面会显示网络状态和添加设备入口MQTT 路线确认 broker 加载项在运行然后在configuration.yaml里写门锁配置。最小可用版只需要一条命令主题# command_topic 必填锁控命令发到哪个主题 mqtt: - lock: name: Frontdoor command_topic: home/frontdoor/set state_topic: home/frontdoor/state # 设备回传状态否则只能靠乐观模式猜重启 Home Assistant实体就会出现。第二步把门锁拉进网络Z-Wave 路线Z-Wave 页面点添加设备让门锁进入配对模式多数机型是短按配对键直到指示灯快闪锁支持 S2 安全的话会要求输入 PIN印在锁底部标签上等配对完成即可。门锁上线后它的设备信息页能看到固件、传感实体和记录所有操作的 LogbookMQTT 路线没有配对环节主题配置对了锁就直接出现。最常踩的两个坑主题多了个结尾斜杠、大小写不一致——some-topic/和some-topic是两个不同的主题。第三步验证状态与控制仪表盘上放一张锁卡片点一次上锁/开锁。Z-Wave 锁的状态应该走完locking→locked的变化一直卡在unknown要么是锁没回传状态MQTT 路线要么是配对不完整Z-Wave 路线对照踩坑速查处理。配完之后能玩什么给保洁阿姨发一次性开门码Z-Wave 锁上有代码槽code slot每个槽存一个 PIN由锁本机执行——所以发密码就是往槽里写作废就是清掉。写入槽 3action: zwave_js.set_lock_usercode target: entity_id: lock.front_door data: code_slot: 3 usercode: 1234 # 必须加引号否则前导零会丢服务结束后调一次zwave_js.clear_lock_usercode这个码就永久失效。不靠手机转交、作废零延迟这是接门锁后最实用的一项。人全出门后自动锁门锁是标准的lock实体任何状态触发器都能用。比如最后一位家人离开 → 等 5 分钟 → 自动锁前门有人在家的时段锁被打开 → 推通知到手机。这类联动用 UI 自动化编辑器搭不用手写 YAML。留一份谁在什么时候开了门的记录Z-Wave 锁的设备页自带 LogbookMQTT 锁则写一条状态触发自动化把每次locked↔unlocked的变化连同触发来源记进日志事后可回溯整条访问记录。安全与边界先说清楚我们做的是加了个遥控器不是换了把锁。Z-Wave 路线建议启用 S2 安全锁不支持 S2 就用 S0配对过程加密PIN 用于防监听仿冒。MQTT 路线消息本身是明文broker 要自己做 TLS 加密并限制访问范围。官方文档特别提醒解锁主题别随意开retain持久化标记否则重启时一条遗留的解锁消息可能被重新投递真把门开了。权限模型Home Assistant 里只有 operator 及以上权限的账号能控制门锁给家人只开查看权限他们看得到状态但动不了锁。明确做不到的在锁本机登记的指纹和实体卡HA 看不见这类开锁事件锁被恢复出厂后网络配对作废需重新入网MQTT 的optimistic模式只是猜状态锁不回传时页面显示可能与现实不符。踩坑速查锁卡片一直 unknown→ 无状态回传或配对不完整 → MQTT 补state_topicZ-Wave 到设备信息页重新访谈re-interview。开锁命令没反应→ 主题不精确匹配结尾斜杠、大小写或控制器离线 → 查 MQTT 加载项的命令历史或 Z-Wave 页面的网络状态。门锁配对不进网→ 电池电量低或没真正进入配对模式 → 先换电池按说明书重新进配对模式再试。PIN 码前导零消失→ YAML 里数字没加引号 → 永远用引号包起来如0123。延伸资源MQTT 锁集成文档全部参数与完整配置示例Z-Wave JS 集成文档控制器配置、网络诊断与迁移设置锁用户码动作文档密码槽的写入、清除与细节锁实体通用文档锁实体的状态机与常用服务接下来可以具体试两件小事给锁加一条lock.locked触发器推送已锁门通知看看你的锁型号有没有 Matter 集成让 iPhone 和 Home Assistant 都能直接控它。如果你的锁品牌没有现成集成、或者找到了让它上报开锁日志的办法去 Home Assistant 社区论坛发个帖子大概率有人踩过同一个坑。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考