# 第一时间知道 家里发生异常时 。

> 把家庭实验室的告警推送到手机。只需一条 curl，就能将 Uptime Kuma、Home Assistant 或 bash 脚本接入 Pocket Alert。无需端口转发，个人使用免费。

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

最后更新：2026-08-11

随时随地监控你的家庭实验室。Home Assistant、Uptime Kuma 或任何自托管设备，都能在不暴露任何端口的情况下把消息送达你的手机。免费套餐即可满足个人实验室的需求。

## 三步开启家庭实验室告警

1. **获取 URL 或 CLI** — 复制你的应用 Webhook URL，或在设备上安装 Pocket Alert CLI。
2. **接入你的设备** — 在脚本末尾接一条 curl，转发 Kuma 或 Home Assistant 的 Webhook，或使用 systemd 的 OnFailure。
3. **随时随地监控** — 触发事件后，你的手机就会震动，即使在 NAT 后面、无需暴露任何端口也一样。

## 为你的家庭实验室提供监控

自托管同样需要有人盯着。把你的家庭实验室连接到手机，告别云监控账单。

- **兼容你的技术栈** — Uptime Kuma、Home Assistant、Proxmox、Pi-hole 和 *arr 系列应用可以转发 Webhook，或接一条 curl。
- **无需暴露端口** — 仅使用出站 HTTPS。无需公网 IP，在 NAT 或 VPN 后面也能正常运行。
- **按机器分通道** — 每台机器使用一个应用，让 NAS、Proxmox 和 Pi-hole 的告警各自留在独立通道中。
- **随处可脚本化调用** — 可以从 bash、systemd 单元、Docker 健康检查或 cron 任务中调用。
- **个人爱好免费使用** — 免费套餐即可满足个人家庭实验室的需求，没有按席位收费。
- **亚秒级送达** — 送达耗时不到一秒，家里的问题无论你身在何处都能即时收到。

## 连接你的家庭实验室

### 1. 通过 bash 或 cron 脚本（CLI）

```
pocketalert auth YOUR_API_KEY
pocketalert send -t "NAS · disk degraded" -m "pool tank · drive 2 FAULTED"
```

或者不使用 CLI，直接在任意脚本中通过 curl 调用消息 API：

```
curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Proxmox backup failed","message":"vzdump job on pve1 exited 1","level":"high"}'
```

### 2. 通过 Home Assistant

```
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 }}"}'
```

### 3. 通过 Uptime Kuma（Webhook）

在 [Webhook](https://pocketalert.app/zh/webhooks) 页面创建一个 Webhook，并复制其接收 URL，例如 `https://p4a.me/wh/1234abcd`。在 Uptime Kuma 中添加一个指向该 URL 的 **Webhook** 通知，然后使用 GJSON 模板映射 Kuma 的负载，例如 `%monitor.name% is %heartbeat.status%`。

所有通信均通过出站 HTTPS 完成，因此无需端口转发。请参阅[文档](https://info.pocketalert.app/getting-started.html)。

## 常见问题

### 如何从家庭实验室发送告警？

任何能发起 HTTP 请求的自托管设备都能联系你。你可以在脚本末尾接一条 curl，转发 Uptime Kuma 或 Home Assistant 的 Webhook，或从 systemd 单元调用 CLI。无论服务器运行在哪里，告警都能送达你的手机。

### 它能与自托管应用配合使用吗？

可以。Pocket Alert 支持与 Uptime Kuma、Home Assistant、Proxmox 钩子、Pi-hole、*arr 系列应用以及普通 bash 脚本配合使用。只要能发送 JSON POST 请求，就能正常工作。

### 我需要暴露服务器吗？

不需要公网 IP，也无需端口转发。你的服务器会向 Pocket Alert 发起出站 HTTPS 请求，因此在 NAT、家用路由器或 VPN 后面同样可以使用。

### 我能区分不同的机器吗？

为每台设备或每项服务创建一个应用。NAS、Proxmox 和 Pi-hole 的告警会分别进入独立的通道，便于区分。

### 个人爱好使用有免费选项吗？

可以。免费套餐即可满足个人家庭实验室的需求。没有按席位收费，也不需要签订企业监控合同，就能收到 NAS 出故障的通知。

### 告警能在夜间突破勿扰模式吗？

可以。发送时设置级别为 critical，在 Android 上会进入一个专用通知通道，可绕过勿扰模式，甚至可以全屏显示。你只需授予一次勿扰模式访问权限。在 iPhone 上，high 和 critical 级别的通知会以时效性通知的形式送达，能够突破专注模式。能覆盖静音开关的完整 critical 提示音正在随 Apple 授予相应权限而逐步推出。免费套餐中，critical 会以 high 级别送达：依然是即时送达，但不会绕过勿扰模式。
