# 第一时间 有人出现在摄像头前 。

> Frigate 检测到人或车时，立刻在手机上收到推送通知。通过 Home Assistant 自动化或 Node-RED 流程，只需一次 HTTP POST，即可把 Frigate 的 MQTT 事件转发到 Pocket Alert。

<!-- source: https://pocketalert.app/zh/use-cases/frigate-nvr-alerts -->

最后更新：2026-08-11

Frigate 在车道上检测到有人，提醒会在一秒内到达你的手机。Home Assistant 自动化或 Node-RED 流程监听 Frigate 的 MQTT 事件，并向 Pocket Alert 发送一次 HTTP POST 请求。通过标签和分数过滤，夜间检测以 critical 级别发送时，还能突破勿扰模式。

## 三步接收摄像头告警

1. **获取令牌或 URL** — 创建一个 API 密钥，或为每个摄像头复制应用的 Webhook URL。
2. **配置桥接** — 在 frigate/events MQTT 主题上添加 Home Assistant 自动化或 Node-RED 流程。
3. **收到推送** — 从摄像头前走过，你的手机会在一秒内震动，通知出现在该摄像头对应的通道中。

## 无需额外插件，即可接收 Frigate 推送通知

你已经在运行 NVR。添加一个自动化，摄像头中出现的人就能推送到你的手机，并经过过滤、划分优先级，同时保存在历史记录中。

- **只关注人，不关注树叶** — 在自动化中匹配 label 为 "person" 并设置分数阈值。树枝摇动不会吵醒你。
- **每个摄像头一个通道** — 每个摄像头一个应用，车道、门廊和车库的通知分别在不同的通道中。
- **关键时刻才打扰你** — 夜间的人员检测以 critical 级别发送，可绕过勿扰模式。日常事件保持静默。
- **画面留在家里** — Frigate 完全在本地运行。离开你网络的只有你发送的告警文字，画面永远不会外传。
- **兼容你现有的桥接方案** — Home Assistant 自动化或 Node-RED 流程只需一次 HTTP POST，即可转发 MQTT 事件。
- **检测历史记录** — 每条转发的检测记录都会进入可搜索的历史，并附带统计数据，方便你回看外出时发生的事。

## 连接 Frigate

### 1. 创建 API 密钥

在 [API 密钥](https://pocketalert.app/zh/account/apikeys)页面创建一个密钥。你的桥接工具在每次向消息 API 发送 POST 请求时，都需要在 `Token` 请求头中携带该密钥。

### 2. 在 Home Assistant 中添加 rest_command

```
rest_command:
  pocketalert:
    url: "https://api.pocketalert.app/v1/messages"
    method: POST
    headers:
      Token: "YOUR_API_KEY"
    content_type: "application/json"
    payload: '{"title":"{{ title }}","message":"{{ message }}","level":"{{ level | default(''high'') }}"}'
```

### 3. 在 Frigate 事件触发时执行

```
automation:
  - alias: "Person on driveway"
    trigger:
      - platform: mqtt
        topic: frigate/events
    condition:
      - "{{ trigger.payload_json['type'] == 'new' }}"
      - "{{ trigger.payload_json['after']['label'] == 'person' }}"
      - "{{ trigger.payload_json['after']['top_score'] > 0.7 }}"
    action:
      - service: rest_command.pocketalert
        data:
          title: "Person on {{ trigger.payload_json['after']['camera'] }}"
          message: "Frigate detected a person ({{ (trigger.payload_json['after']['top_score'] * 100) | round }}% confidence)"
          level: critical
```

### 4. 或使用 Node-RED 桥接

没有 Home Assistant？在 `mqtt in` 上放置一个 `frigate/events` 节点，在 `switch` 上放置一个 `msg.payload.after.label` 节点，再添加一个 `http request` 节点，携带你的 `https://api.pocketalert.app/v1/messages` 请求头，将标题和消息 POST 到 `Token`。完整的消息 API 请参阅[文档](https://info.pocketalert.app/getting-started.html)。

## 常见问题

### 如何将 Frigate 通知推送到手机？

Frigate 会将每次检测结果以 MQTT 事件的形式发布。一个 Home Assistant 自动化（或 Node-RED 流程）监听 frigate/events 主题，然后向 Pocket Alert 消息 API 发送一次 HTTP POST 请求，包含标题和消息内容。推送通知会在一秒内到达你的手机。

### 我需要 Home Assistant 吗？

不需要。任何能订阅 MQTT 并发送 HTTP POST 的工具都可以，比如 Node-RED、一段简短的 Python 脚本，或者你已经在用的 Home Assistant。Frigate 本身不发送通知，它只发布事件，由你选择的桥接工具负责转发。

### 夜间有人出现时，能把我叫醒吗？

发送时附带 "level":"critical"。Android 会通过专用通道投递，可绕过勿扰模式，你只需授权一次勿扰模式访问权限。在 iPhone 上，high 和 critical 级别会作为时效性通知送达，可突破专注模式。在免费套餐中，critical 会按 high 投递，依然是即时送达，但不会绕过勿扰模式。

### 如何避免每次移动都推送一条通知？

在自动化中过滤，而不是在手机上过滤。只匹配 type 为 "new" 且 label 为 "person"（或 "car"）的事件，并设置分数阈值，避免树枝摇动时触发。为每个摄像头配置独立的应用，日常检测使用 silent 级别发送，它们会进入历史记录但不发出声音。

### 我的摄像头画面会保留在本地吗？

可以。Frigate 的录像和检测完全在你自己的硬件上运行。离开你网络的，只有你选择发送的告警文字，比如"车道上有人"这样的标题加上一段简短消息。

### 之后还能回看过去的检测记录吗？

你转发的每次检测都会保存在应用和网页控制台的可搜索历史记录中，并附带按应用统计的数据。当你回家后，想回看外出期间摄像头拍到了什么时，这很有用，而不只是看最新一条推送。
