# 就是 备份出错的那一刻 。

> 备份失败时立刻收到推送通知，每天还有一条确认任务已运行的提醒。只需在 pg_dump、rsync 或 restic 任务中加一行，静默失败就会变成告警。

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

最后更新：2026-10-17

在 pg_dump、rsync、restic 或任何备份命令后串联一条告警。备份一出错，失败通知就会立即推送到你的手机，每日的成功通知则确认其余任务仍在运行。

## 三步，让备份更安心

1. **获取 CLI 或密钥** — 安装 Pocket Alert CLI 并运行 pocketalert auth，或者获取你的 API 密钥以便直接用 curl 调用。
2. **包装你的备份命令** — 在备份命令后串联 pocketalert send：失败时用 ||，成功时用 &&。
3. **安心入睡** — 失败时立即推送。成功通知则证明任务仍在正常运行。

## 重新信任你的备份

从未验证过的备份等于在赌运气。把静默失败变成告警，并确认每次运行都成功。

- **及时捕获静默失败** — 备份一出错，失败通知立即推送到你的手机，比空备份恢复时才发现问题早好几周。
- **确认已经运行** — 每次运行都发送一条成功通知，证明任务仍在正常工作。通知一旦停止到达，你就知道任务已经挂了。
- **查看失败原因** — 将 stderr 接入消息内容。告警会显示 pg_dump、rsync 或 restic 失败的具体原因。
- **适用于任何备份工具** — pg_dump、mysqldump、rsync、restic、borg 和 tar 都可以根据退出码触发告警。
- **合适的通知渠道** — 将失败通知和日常成功通知发送到不同的应用，让紧急告警不会淹没在大量消息中。
- **只需添加一行** — 在你已有的备份脚本后串联一行代码即可。无需代理，无需控制台，也不需要维护窗口。

## 保护你的备份任务

### 安装并登录 CLI

```
sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY
```

### 数据库转储失败时告警

使用 `||` 串联，使告警仅在退出码非零时触发：

```
pg_dump mydb | gzip > /backups/mydb.sql.gz || pocketalert send \
  -t "Backup failed: mydb" -m "pg_dump exited non-zero"
```

### restic，附带错误日志的最后几行

```
restic backup /data 2>/tmp/restic.err \
  && pocketalert send -t "Backup OK: data" -m "restic done $(date)" \
  || pocketalert send -t "Backup failed: data" -m "$(tail -n 3 /tmp/restic.err)"
```

### borg 或 rsync，通过 cron 定时运行

```
0 3 * * * borg create /repo::'data-{now}' /data \
  && pocketalert send "Backup OK: data" "borg finished" \
  || pocketalert send "Backup failed: data" "borg exited non-zero"
```

### 没有 CLI？使用 curl 调用 API

```
rsync -a /data /backup || curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Backup failed: rsync","message":"rsync exited non-zero","level":"critical"}'
```

[文档](https://info.pocketalert.app/getting-started.html)介绍了如何指定特定应用或设备。

## 常见问题

### 备份失败时如何收到告警？

在备份命令后面串联一条通知。使用 `||`，失败时会立即向你的手机发送推送通知，比等到恢复时才发现问题早好几天。

### 能确认备份确实运行了吗？

可以，这才是真正有价值的地方。每次运行都用 `&&` 发送一条成功通知。如果每天一条的“备份正常”通知不再到达，你就知道任务已经悄悄停止工作了。

### 能查看备份失败的原因吗？

捕获 stderr 并把它放进消息里。CLI 会把错误日志的最后几行接入告警，让你看到 pg_dump 或 rsync 失败的原因。

### 支持哪些备份工具？

凡是能用脚本执行的任务，都可以根据退出码触发告警：pg_dump、mysqldump、rsync、restic、borg、Duplicati、tar 任务，以及托管快照脚本。

### 如何避免成功通知造成干扰？

将失败通知和成功通知分别发送到不同的应用。失败通知进入你会密切关注的渠道，而每天一次的“备份正常”则放在一个安静、可供审计的渠道里。

### 备份失败的通知能突破勿扰模式吗？

可以。在失败分支中加上 `level=critical`，Android 会将其发布到可绕过勿扰模式的渠道，iPhone 则会以时效性通知的形式显示，并突破专注模式。每天的“备份正常”则使用 `level=silent` 发送，它会进入历史记录但不发出声音。
