Portabase通知通道配置实战:让备份告警通过Telegram、Slack推送到你的手机
Portabase通知通道配置实战:让备份告警通过Telegram、Slack推送到你的手机
Portabase 是一个开源的数据库备份与恢复工具,支持 PostgreSQL、MySQL、MsSQL、MariaDB、Firebird、SQLite、MongoDB、Redis 和 Docker Volume。它的通知通道功能可以把备份失败、恢复失败等关键事件,实时推送到 Telegram、Slack、Discord、邮件等 12 种渠道,让告警第一时间出现在你的手机上。这篇文章手把手带你完成配置。
Portabase 通知通道是什么?
Portabase 的通道分两类:
- 通知通道(Notification Channel):负责"告诉你"——备份失败、健康检查异常等事件发生时,向 Telegram、Slack、Email 等渠道发送消息
- 存储通道(Storage Channel):负责"存文件"——把备份文件写到 S3、Google Drive、SFTP 等位置
本文只讲通知通道。它的设计非常简洁:
- 建通道:在后台创建一条通道并填入第三方凭据(Bot Token、Webhook 地址等)
- 绑策略:把通道和具体事件(如"备份失败")绑定,可精确到某个数据库,也可以应用到整个项目
- 收推送:事件发生时,Portabase 自动把标题、详情、级别和附带数据推送出去
通道的数据库结构定义在 src/db/schema/09_notification-channel.ts,告警策略定义在 src/db/schema/10_alert-policy.ts。
手把手配置 Telegram 通知通道
Telegram 是最适合"告警推送到手机"的渠道,只需两个参数:Bot Token 和 Chat ID。
第一步:获取 Bot Token 和 Chat ID
- 在 Telegram 中搜索并打开 @BotFather,发送
/newbot,按提示起名,完成后得到 Bot Token(形如123456:ABC-DEF...) - 先给你的新 Bot 随便发一条消息,再打开 @BotFather 发送
/mybots可随时查看 Token - 获取 Chat ID:把 Bot 加进你的告警群(或私聊它),然后用任意"Chat ID 查询" Bot 发送
/id,私聊得到正数 ID,群组得到负数 ID
第二步:在 Portabase 后台创建通道
进入管理面板的 Notifications → Channels 页面(源码见 app/(customer)/dashboard/(admin)/notifications/channels/page.tsx/dashboard/(admin)/notifications/channels/page.tsx)),点击"添加通道",选择 Telegram,填入:
| 字段 | 说明 | 必填 |
|---|---|---|
| Bot Token | @BotFather 发放的机器人令牌 | ✅ |
| Chat ID | 接收告警的私聊或群组 ID | ✅ |
| Topic ID | 论坛式群组的置顶话题 ID | 可选 |
保存后,Portabase 会调用 Telegram 官方接口发送 HTML 格式消息,包含事件标题、详情、级别(CRITICAL / WARNING / INFO)和附带数据,推送逻辑见 src/features/channel/components/notifications/telegram/telegram.ts。
三步搞定 Slack 推送
Slack 的接入比 Telegram 更简单,只需要一个 Webhook 地址:
- 在 Slack 工作区创建一个 Incoming Webhook 集成,选定接收频道,得到形如
hooks.slack.com/services/...的地址 - 回到 Portabase 的通道页面,选择 Slack,把 Webhook 地址粘贴进去
- 点击保存即可
配置项定义在 src/features/channel/components/notifications/slack/slack.schema.ts。推送时 Portabase 会带上级别标签(如 *<a href="https://link.gitcode.com/i/86251e42f3f5be0b81c1a2ac7df13b79" target="_blank">CRITICAL] 备份失败*)和事件数据块,方便团队在频道里快速定位问题,实现见 [src/features/channel/components/notifications/slack/slack.ts。
12 种通知通道选项一览
Portabase 内置的推送渠道覆盖了绝大多数团队的工作方式,全部列在 src/features/channel/components/channels-notification-helper.tsx 中:
| 渠道 | 适合场景 |
|---|---|
| Telegram | 个人手机告警,最轻量 |
| Slack | 团队协作频道推送 |
| Discord | 社区 / 游戏团队 |
| Microsoft Teams | 微软生态企业 |
| Email (SMTP) | 传统运维、归档留痕 |
| Pushover | iOS / Android 高优先级推送 |
| ntfy.sh | 自建推送服务 |
| Gotify | 自托管通知服务器 |
| Nextcloud Talk | Nextcloud 用户 |
| Webhook | 对接任意自建系统 |
| Apprise | 一次配置支持上百种渠道 |
| Healthchecks.io | 心跳监控平台 |
各渠道的表单校验规则统一收口在 src/features/channel/schemas/channel-form.schema.ts,所有表单都做了必填和格式校验,填错 Token 或 Webhook 会直接提示,不用等到真实故障时才发现。
绑定告警策略:哪些事件会触发推送?
通道建好后,还需要在数据库或项目的告警策略里把它和事件关联起来。策略表单见 src/features/database/components/channels-policy-form.tsx,支持的事件类型定义在 src/features/database/schemas/channels-policy.schema.ts:
| 事件 | 含义 |
|---|---|
| Error Backup | 备份失败 ⚠️ |
| Success Backup | 备份成功 |
| Error Restore | 恢复失败 |
| Success Restore | 恢复成功 |
| Health Ping Fail | 数据库健康检查失败 |
| Backup File Missing | 备份文件丢失检测 |
| Backup File Recovered | 丢失的备份文件已找回 |
两个实用技巧:
- 按数据库绑定:策略可以只挂到某个数据库上,比如只给生产库推"备份失败",测试库则静默
- 项目级兜底:如果某个数据库没有自己的策略,Portabase 会自动回退使用项目级策略,逻辑见 src/features/database/utils/policy-resolution.ts
一键测试:离开页面前先验证通道
每个通道卡片上都有一个绿色的 Test Channel 按钮,点击后 Portabase 会立即向该渠道发送一条测试消息。收到消息,说明配置无误;报错则会提示你检查凭据。测试功能实现在 src/features/channel/components/channel-test-button.tsx。
建议养成习惯:每新增一个通道,先测试再绑定策略。另外所有推送的成功 / 失败记录都会写进通知日志,可以在 Notifications → Logs 页面回溯,再也不用担心"到底发没发出去"。
常见问题避坑清单
- Telegram 提示 Chat Not Found:确认 Bot 已被拉进目标群组,且群组 ID 用的是负数
- Slack 消息没出现:检查 Webhook 绑定的频道是否为公共频道,私聊频道收不到
- 测试成功但真实事件没收到:检查告警策略的
enabled开关是否打开,策略和通道两级开关都要生效 - 想推送到论坛群组的指定话题:Telegram 通道填写 Topic ID 即可,会自动附加
message_thread_id - 同一事件推给多个渠道:为同一个数据库添加多条策略,分别指向不同通道即可
总结
用不到 10 分钟,你就可以让 Portabase 的备份状态直接推送到 Telegram 手机通知栏或 Slack 团队频道:创建通道 → 填写凭据 → 点测试 → 绑定事件策略。对于托管着多个数据库的运维场景(PostgreSQL、MySQL、MsSQL、SQLite 等都在其支持列表内),这套"事件 + 策略 + 通道"的组合让告警触达变得既灵活又可靠,值得作为生产环境备份体系的最后一块拼图来配置。


