CLARYEL Perimetro待讨论项目
技术文档 · 第 3 份,共 3 份

软件方案

本地服务器上的 Home Assistant:适用于任何手机、平板或浏览器的一个应用,受限的权限,以及即使手机静音也能送达的警报。

Home AssistantAndroid · iPhone · 浏览器按角色分配权限关键警报一切本地、加密、无云
1

我们从自己的技术栈中选了什么,以及原因

在我们本地服务器上已运行的技术栈中,只需要少数几个组件。其余部分——AI 分析、加密归档、录像——留在 Home Assistant 之外。

  1. 1

    Home Assistant

    系统的唯一中枢:接收周界事件,管理用户及其权限,向手机发送警报。自由软件,在我们的服务器上本地运行。

  2. 2

    MQTT (Mosquitto)

    现场节点(ESP32)、AI 分析与 Home Assistant 之间的本地消息通道。事件以简短文本消息传递,不含图像。

  3. 3

    NUT(UPS 状态)

    把备用电源的状态带入 Home Assistant:停电或电池放电会立即变成技术警报。

  4. 4

    应用 Home Assistant Companion

    适用于 Android 和 iPhone/iPad 的官方客户端:警报通过它送达,并打开已批准的仪表板。

  5. 5

    WireGuard

    项目已为连接规划好的受保护通道:需要时可在楼宇之外使用应用,无需云订阅。

留在 Home Assistant 之外:AI 分析、加密归档和录像留在服务器上,应用无法显示它们。
2

示意图:从服务器到客户端、角色和权限

现场点位

摄像头或 Wi-Fi CSI 模块,带信号提示

本地服务器

AI 分析、加密、归档、UPS 和数据备份

Home Assistant

事件、用户、权限、警报

客户端

一个应用或浏览器

  • Android
  • iPhone / iPad
  • 浏览器(电脑)
  • 平板

角色与权限

每个人只能看到已批准的内容

  • 技术管理员
  • 指定人员
  • 居民

Home Assistant 只接收事件(文字、时间、围栏路段):没有照片或视频。不在 Home Assistant 中的内容,应用中就看不到。

3

适用于任何设备的一个客户端

客户端是官方应用 Home Assistant Companion 或只是浏览器:选您已有的即可。

  • Android

    来自应用商店的应用 Home Assistant Companion:警报、已批准的仪表板、快捷操作。

  • iPhone 和 iPad

    适用于 iOS 和 iPadOS 的应用 Home Assistant Companion:警报(包括关键警报)和已批准的仪表板。

  • 电脑上的浏览器

    只需打开 Home Assistant 的地址:无需安装。

  • 平板

    应用或浏览器;配上专用用户,可作为固定面板留在墙上,例如在入口处。

访问在楼宇本地网络内进行,或在楼宇之外通过受保护的 WireGuard 通道进行。无需订阅 Home Assistant Cloud。
4

受限权限的访问

所有人都用自己的用户名和密码登录(如已启用则配合两步验证),并且只能看到为其角色批准的内容。下列角色是供讨论的建议。

  • Home Assistant 的管理员

    技术管理员

    配置系统、用户和自动化。账户很少,配合两步验证;可只允许从本地网络访问。

  • 没有管理员权限的用户

    指定人员

    接收带操作按钮的警报,用于确认事件。归档中的图像适用为指定人员保留的程序,并带有访问日志。

  • 没有管理员权限的用户

    居民

    接收警报(仅文字)并查看系统状态的已批准仪表板。无法访问摄像头、归档或设置。

谁能做什么技术管理员指定人员居民
接收警报通知
查看系统状态(已批准的仪表板)
通过操作按钮确认事件
查看归档中的图像(仅指定人员,带日志)
管理接收人名单和警报设置
更改设置、用户和自动化

如何实现限制

  • 没有管理员权限的用户无法访问设置,也无法管理用户、设备、自动化和仪表板。
  • 每个仪表板都可以限定给管理员;为居民分配单独的、已批准的仪表板。
  • 对每个用户都可以只允许从本地网络访问,并可启用两步验证。
  • 每台设备都可以通过从个人资料中移除其访问令牌来断开;用户的账户可以停用。
  • 最强的界限是结构性的:Home Assistant 在界面中不提供按设备的权限,因此进入其中的只有已批准的信息(警报事件、系统状态、UPS 状态)。图像和归档留在外面。
5

即使手机静音也能送达的警报

周界发生危险入侵时,警报会以关键级别发送:按下文所述配置,即使手机处于静音并开启“勿扰”,也就是所有来电都被屏蔽时(例如夜间),它也会响铃。

锁屏
03:12
手机静音已开启勿扰
警报关键警报

注意!在受监控的围栏路段检测到有人。

iPhone
锁屏
03:12
手机静音已开启勿扰
警报alarm_stream

注意!在受监控的围栏路段检测到有人。

Android

配置示例(来自 Home Assistant Companion 官方文档)

iPhone 和 iPad:关键警报

  • iOS 的关键警报(Critical Alerts)显示在锁屏最上方,位于所有其他通知之上,即使开启“勿扰”或 iPhone 处于静音也会发声。
  • 此外,它们还可以突破应用通知的频率限制。

1× 一次:在 iOS 设置中,为应用 Home Assistant 允许通知,包括关键警报。

data:
  push:
    sound:
      name: "default"
      critical: 1
      volume: 1.0

Android:高优先级和警报通道

  • 使用高优先级和生存时间 0,通知会立即送达,即使手机静止不动或屏幕已长时间熄灭。
  • 使用“闹钟”音频流(alarm stream),手机在静音或振动模式下也会响。

1× 一次:在应用的系统设置中打开警报通道,并允许它绕过“勿扰”(默认不会绕过)。

data:
  ttl: 0
  priority: high
  channel: alarm_stream

需要注意什么

  • 警报的设计目标是即使在静音状态下也能送达,但无法保证绝对送达:手机必须开机且可联系到(移动数据或 Wi-Fi),并且每部手机都需要完成一次性配置。
  • 消息只有文字,没有照片、视频或个人数据。
  • 通常发送到手机会经过 Apple 或 Google 的推送通知基础设施,和任何应用一样。在楼宇本地网络中,还可通过 WebSocket 进行本地送达(Local Push),绕过 Apple 或 Google。
  • 我们建议定期发送检查警报,以便及时发现某部手机是否已不再接收警报。
6

不只是周界:其他重要警报

同一通道也可以传送其他重要消息,紧急程度各不相同。铃声和优先级按各级别分别选择。

  • 关键

    周界危险入侵:始终响铃,即使手机处于静音。

  • 紧急(技术)

    停电或 UPS 电池放电、与现场点位的连接中断、服务器无法访问。

  • 通知

    箱内温度或湿度异常或漏水,以及与业主委员会商定的其他消息。可以保持静音。

在 iOS 中,“关键”级别甚至绕过静音,“time-sensitive”(紧急)绕过专注模式,“被动”则连屏幕都不会点亮。

一切本地、加密、无云

分析、归档和访问都留在本地服务器上,经过加密,不使用云服务。发生警报时,对归档的访问立即关闭,事件录像受到保护,不可修改和删除,如项目中所述。

✉

有问题或意见吗?

请给我们留言:我们很乐意回复。您也可以使用项目表单。

前往项目表单

供与居民及业主委员会管理层讨论的项目文件:只有获得必要的批准后才可实施。