软件方案
本地服务器上的 Home Assistant:适用于任何手机、平板或浏览器的一个应用,受限的权限,以及即使手机静音也能送达的警报。
我们从自己的技术栈中选了什么,以及原因
在我们本地服务器上已运行的技术栈中,只需要少数几个组件。其余部分——AI 分析、加密归档、录像——留在 Home Assistant 之外。
- 1
Home Assistant
系统的唯一中枢:接收周界事件,管理用户及其权限,向手机发送警报。自由软件,在我们的服务器上本地运行。
- 2
MQTT (Mosquitto)
现场节点(ESP32)、AI 分析与 Home Assistant 之间的本地消息通道。事件以简短文本消息传递,不含图像。
- 3
NUT(UPS 状态)
把备用电源的状态带入 Home Assistant:停电或电池放电会立即变成技术警报。
- 4
应用 Home Assistant Companion
适用于 Android 和 iPhone/iPad 的官方客户端:警报通过它送达,并打开已批准的仪表板。
- 5
WireGuard
项目已为连接规划好的受保护通道:需要时可在楼宇之外使用应用,无需云订阅。
示意图:从服务器到客户端、角色和权限
现场点位
摄像头或 Wi-Fi CSI 模块,带信号提示
本地服务器
AI 分析、加密、归档、UPS 和数据备份
Home Assistant
事件、用户、权限、警报
客户端
一个应用或浏览器
- Android
- iPhone / iPad
- 浏览器(电脑)
- 平板
角色与权限
每个人只能看到已批准的内容
- 技术管理员
- 指定人员
- 居民
Home Assistant 只接收事件(文字、时间、围栏路段):没有照片或视频。不在 Home Assistant 中的内容,应用中就看不到。
适用于任何设备的一个客户端
客户端是官方应用 Home Assistant Companion 或只是浏览器:选您已有的即可。
Android
来自应用商店的应用 Home Assistant Companion:警报、已批准的仪表板、快捷操作。
iPhone 和 iPad
适用于 iOS 和 iPadOS 的应用 Home Assistant Companion:警报(包括关键警报)和已批准的仪表板。
电脑上的浏览器
只需打开 Home Assistant 的地址:无需安装。
平板
应用或浏览器;配上专用用户,可作为固定面板留在墙上,例如在入口处。
受限权限的访问
所有人都用自己的用户名和密码登录(如已启用则配合两步验证),并且只能看到为其角色批准的内容。下列角色是供讨论的建议。
- Home Assistant 的管理员
技术管理员
配置系统、用户和自动化。账户很少,配合两步验证;可只允许从本地网络访问。
- 没有管理员权限的用户
指定人员
接收带操作按钮的警报,用于确认事件。归档中的图像适用为指定人员保留的程序,并带有访问日志。
- 没有管理员权限的用户
居民
接收警报(仅文字)并查看系统状态的已批准仪表板。无法访问摄像头、归档或设置。
| 谁能做什么 | 技术管理员 | 指定人员 | 居民 |
|---|---|---|---|
| 接收警报通知 | |||
| 查看系统状态(已批准的仪表板) | |||
| 通过操作按钮确认事件 | |||
| 查看归档中的图像(仅指定人员,带日志) | |||
| 管理接收人名单和警报设置 | |||
| 更改设置、用户和自动化 |
如何实现限制
- 没有管理员权限的用户无法访问设置,也无法管理用户、设备、自动化和仪表板。
- 每个仪表板都可以限定给管理员;为居民分配单独的、已批准的仪表板。
- 对每个用户都可以只允许从本地网络访问,并可启用两步验证。
- 每台设备都可以通过从个人资料中移除其访问令牌来断开;用户的账户可以停用。
- 最强的界限是结构性的:Home Assistant 在界面中不提供按设备的权限,因此进入其中的只有已批准的信息(警报事件、系统状态、UPS 状态)。图像和归档留在外面。
即使手机静音也能送达的警报
周界发生危险入侵时,警报会以关键级别发送:按下文所述配置,即使手机处于静音并开启“勿扰”,也就是所有来电都被屏蔽时(例如夜间),它也会响铃。
注意!在受监控的围栏路段检测到有人。
注意!在受监控的围栏路段检测到有人。
配置示例(来自 Home Assistant Companion 官方文档)
iPhone 和 iPad:关键警报
- iOS 的关键警报(Critical Alerts)显示在锁屏最上方,位于所有其他通知之上,即使开启“勿扰”或 iPhone 处于静音也会发声。
- 此外,它们还可以突破应用通知的频率限制。
1× 一次:在 iOS 设置中,为应用 Home Assistant 允许通知,包括关键警报。
data:
push:
sound:
name: "default"
critical: 1
volume: 1.0Android:高优先级和警报通道
- 使用高优先级和生存时间 0,通知会立即送达,即使手机静止不动或屏幕已长时间熄灭。
- 使用“闹钟”音频流(alarm stream),手机在静音或振动模式下也会响。
1× 一次:在应用的系统设置中打开警报通道,并允许它绕过“勿扰”(默认不会绕过)。
data:
ttl: 0
priority: high
channel: alarm_stream需要注意什么
- 警报的设计目标是即使在静音状态下也能送达,但无法保证绝对送达:手机必须开机且可联系到(移动数据或 Wi-Fi),并且每部手机都需要完成一次性配置。
- 消息只有文字,没有照片、视频或个人数据。
- 通常发送到手机会经过 Apple 或 Google 的推送通知基础设施,和任何应用一样。在楼宇本地网络中,还可通过 WebSocket 进行本地送达(Local Push),绕过 Apple 或 Google。
- 我们建议定期发送检查警报,以便及时发现某部手机是否已不再接收警报。
不只是周界:其他重要警报
同一通道也可以传送其他重要消息,紧急程度各不相同。铃声和优先级按各级别分别选择。
- 关键
周界危险入侵:始终响铃,即使手机处于静音。
- 紧急(技术)
停电或 UPS 电池放电、与现场点位的连接中断、服务器无法访问。
- 通知
箱内温度或湿度异常或漏水,以及与业主委员会商定的其他消息。可以保持静音。
在 iOS 中,“关键”级别甚至绕过静音,“time-sensitive”(紧急)绕过专注模式,“被动”则连屏幕都不会点亮。
一切本地、加密、无云
分析、归档和访问都留在本地服务器上,经过加密,不使用云服务。发生警报时,对归档的访问立即关闭,事件录像受到保护,不可修改和删除,如项目中所述。
有问题或意见吗?
请给我们留言:我们很乐意回复。您也可以使用项目表单。
供与居民及业主委员会管理层讨论的项目文件:只有获得必要的批准后才可实施。