周六下午三小时:把门口摄像头接进 Home Assistant 面板

门口那台摄像头装了半年,一直只活在厂商自己的 App 里。想看一眼门口,得先等 App 打开、等广告过去、等登录状态恢复。家里其他设备早已收进 Home Assistant,只剩它还在外面单干。这个周六下午,我决定把它也接进来,目标只有一个:在 Home Assistant 的面板上直接看到门口的实时画面。

14:00 动手之前:先把风险想在前面

接摄像头之前,先备份 Home Assistant 的配置。设置里做一次完整备份,下载到电脑上存好。万一接的过程中改错了什么,还能整个恢复,不用从头重装。

先改掉摄像头的默认密码。很多摄像头出厂就是 admin 加一串简单密码,说明书上写着,网上也搜得到。接进局域网之前,先在厂商 App 里把密码改成只有自己知道的强密码,再给 Home Assistant 单独建一个只看画面的账号,不要拿管理员账号去接流。

不要把摄像头的端口映射到公网。RTSP 流在多数家用摄像头上是不加密的,一旦暴露到互联网,等于把门口的画面敞开给所有人看。只在家里局域网内看,人在外面想看就走 Home Assistant 自己的远程访问,不要图省事在路由器上开端口。

装的位置先和家里人商量好。摄像头只对着门口和玄关,不对卧室、不对卫生间,家里人要知道它在拍哪里、谁能看到画面。隐私问题比方便更重要,这一步没有商量余地。

14:20 先确认:这台摄像头能不能接出来

动手第一步不是去 Home Assistant 里点点点,而是先确认摄像头本身支不支持对外输出画面。主流的办法有两种:RTSP 流和 ONVIF 协议。RTSP 是一路持续的视频流,ONVIF 则是一套标准,除了视频还能带设备发现和移动侦测事件。按 Home Assistant 官方文档的说明,Camera 集成是一个基础模块,不能直接添加,而是由其他集成提供摄像头实体,支持实时播放、抓快照和录制等动作,核实日期为 2026-11-10。

我翻出摄像头的说明书,在厂商 App 的设置里找到网络或高级设置,确认了它支持 RTSP,也支持 ONVIF。具体开关在哪个菜单里,不同品牌差别很大,本文不写死路径,以你手里那台的说明书和 App 界面为准,这个细节未核实,请以官方说明书为准。

确认之后,我在摄像头里做了三件事:打开 RTSP 开关,打开 ONVIF 开关,新建一个只给 Home Assistant 用的普通账号。账号密码单独记在一张纸上,不和管理员密码混用。官方 ONVIF 集成的说明里也建议给摄像头建专用的普通用户,而不是复用管理员账号,核实日期为 2026-11-10。

15:00 在 Home Assistant 里添加摄像头

准备工作做完,才轮到 Home Assistant。打开设置,进设备与服务,点右下角添加集成,搜索 Generic Camera。这个集成就是用来接任何能输出 RTSP 流的摄像头的,官方文档把它作为通用摄像头接入方式,核实日期为 2026-11-10。

填表的时候要注意三处:流地址填摄像头给出的 RTSP 地址,里面包含摄像头的局域网地址和端口;用户名和密码填刚才新建的专用账号;传输协议选 TCP。TCP 比 UDP 稳的说法未核实,请以实际测试的画面效果为准。提交之后稍等片刻,设备列表里出现摄像头实体,点进去能看到画面,就算第一步成了。

如果提交后一直转圈或者报无法连接,先别急着重装。最常见的几个原因都很好查:摄像头和 Home Assistant 是不是在同一个局域网,RTSP 地址里的端口和路径有没有抄错,专用账号的密码有没有输错,摄像头的 RTSP 开关是不是真的保存成功了。一个一个排除,比反复删除重加管用。

15:40 画面黑屏:换一路 H.264 子码流

我的第一路流加上之后,实体出来了,画面却是黑的。查了一圈,问题出在编码上:这台摄像头的主码流默认是 H.265,Home Assistant 的 ONVIF 集成只接 H.264 编码的视频流。按官方 ONVIF 集成的说明,它只添加视频编码为 H.264 的配置文件,核实日期为 2026-11-10。

解决办法不用换摄像头:回厂商 App 的视频设置里,把子码流改成 H.264,再把子码流的 RTSP 地址填进 Generic Camera。主码流继续留在 H.265,给厂商自己的 App 和录像用,子码流走 H.264,专门给 Home Assistant 看。改完保存,等十几秒,画面就出来了,门口的台阶、信箱和那盆绿植都清清楚楚。

这个坑值得单独记下来:画面黑屏不一定是地址错了,先看编码。很多摄像头出厂默认 H.265,第一次接 Home Assistant 的人几乎都会在这里卡一次。

16:30 把画面放上仪表盘

画面通了,下一步是让它出现在每天都会看的面板上。我在仪表盘上加了一张摄像头实体卡,选门口这台摄像头,卡片标题写成门口。点开卡片能放大看实时画面,平时缩略图挂在面板上,进出门之前扫一眼就够了。

Home Assistant 还提供一个预加载流量的选项,打开后会在启动时就把流保持住,点开画面时延迟更低。按官方 Camera 集成文档的说明,预加载会占用更多机器资源,核实日期为 2026-11-10。我家这台中枢性能一般,只给门口这一路开了预加载,其他以后再加的摄像头先不开,用的时候再加载。

17:10 快照、录像和自动化的边界

画面能看之后,我又试了两个官方动作:抓快照和录制一段画面。按 Home Assistant 官方 Camera 集成文档的说明,它提供 camera.snapshot 抓快照和 camera.record 录制画面这两个动作,核实日期为 2026-11-10。我设了一个简单的自动化:门口有人按门铃,就自动抓一张快照存下来,手机上收到通知时能直接看到是谁。

但有一点要说清楚:Home Assistant 本身不是一台录像机。它能按你的指令录一段、抓一张,要做到 24 小时连续录像、按时间回看、智能识别人形,还得靠专门的本地录像软件来接管,比如 Frigate 这类开源方案。Frigate 的具体安装和配置方法未核实,本文不展开,需要的话请以 Frigate 官方文档为准。

晚上复查:这个下午留下的清单

晚上吃完饭,我又打开面板看了一次。门口画面正常,快照自动化也触发了一次,家里人用手机打开面板,不用再去翻厂商 App 了。这一下午的收获,可以收成一张清单:

第一,摄像头先在自己的 App 里打开 RTSP 或 ONVIF,改掉默认密码,建一个专用账号。第二,Home Assistant 里用 Generic Camera 集成接 RTSP 流,协议选 TCP。第三,画面黑屏先查编码,留一路 H.264 子码流给 Home Assistant。第四,画面只上局域网内的面板,不做端口映射,位置和权限先和家里人商量好。

如果你也有一台只活在厂商 App 里的摄像头,找一个周六下午,按这个时间线走一遍,大概率能在天黑之前把它请进自家的面板。想进一步了解集中管理智能家居的思路,可以看看本站这篇家里五个 App 各管一摊?一个家庭集中管理智能家居的真实转变。