Portabase通知通道配置实战:让备份告警通过Telegram、Slack推送到你的手机

原创2026-10-10 13:46:191,729 阅读

Portabase通知通道配置实战:让备份告警通过Telegram、Slack推送到你的手机

Portabase 是一个开源的数据库备份与恢复工具,支持 PostgreSQL、MySQL、MsSQL、MariaDB、Firebird、SQLite、MongoDB、Redis 和 Docker Volume。它的通知通道功能可以把备份失败、恢复失败等关键事件,实时推送到 Telegram、Slack、Discord、邮件等 12 种渠道,让告警第一时间出现在你的手机上。这篇文章手把手带你完成配置。

Portabase支持的MySQL数据库备份

Portabase 通知通道是什么?

Portabase 的通道分两类:

  • 通知通道(Notification Channel):负责"告诉你"——备份失败、健康检查异常等事件发生时,向 Telegram、Slack、Email 等渠道发送消息
  • 存储通道(Storage Channel):负责"存文件"——把备份文件写到 S3、Google Drive、SFTP 等位置

本文只讲通知通道。它的设计非常简洁:

  1. 建通道:在后台创建一条通道并填入第三方凭据(Bot Token、Webhook 地址等)
  2. 绑策略:把通道和具体事件(如"备份失败")绑定,可精确到某个数据库,也可以应用到整个项目
  3. 收推送:事件发生时,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

  1. 在 Telegram 中搜索并打开 @BotFather,发送 /newbot,按提示起名,完成后得到 Bot Token(形如 123456:ABC-DEF...)
  2. 先给你的新 Bot 随便发一条消息,再打开 @BotFather 发送 /mybots 可随时查看 Token
  3. 获取 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 地址:

  1. 在 Slack 工作区创建一个 Incoming Webhook 集成,选定接收频道,得到形如 hooks.slack.com/services/... 的地址
  2. 回到 Portabase 的通道页面,选择 Slack,把 Webhook 地址粘贴进去
  3. 点击保存即可

配置项定义在 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

Portabase守护SQLite等多种数据库的备份状态

一键测试:离开页面前先验证通道

每个通道卡片上都有一个绿色的 Test Channel 按钮,点击后 Portabase 会立即向该渠道发送一条测试消息。收到消息,说明配置无误;报错则会提示你检查凭据。测试功能实现在 src/features/channel/components/channel-test-button.tsx。

建议养成习惯:每新增一个通道,先测试再绑定策略。另外所有推送的成功 / 失败记录都会写进通知日志,可以在 Notifications → Logs 页面回溯,再也不用担心"到底发没发出去"。

Portabase支持MsSQL等数据库的告警推送

常见问题避坑清单

  • Telegram 提示 Chat Not Found:确认 Bot 已被拉进目标群组,且群组 ID 用的是负数
  • Slack 消息没出现:检查 Webhook 绑定的频道是否为公共频道,私聊频道收不到
  • 测试成功但真实事件没收到:检查告警策略的 enabled 开关是否打开,策略和通道两级开关都要生效
  • 想推送到论坛群组的指定话题:Telegram 通道填写 Topic ID 即可,会自动附加 message_thread_id
  • 同一事件推给多个渠道:为同一个数据库添加多条策略,分别指向不同通道即可

总结

用不到 10 分钟,你就可以让 Portabase 的备份状态直接推送到 Telegram 手机通知栏或 Slack 团队频道:创建通道 → 填写凭据 → 点测试 → 绑定事件策略。对于托管着多个数据库的运维场景(PostgreSQL、MySQL、MsSQL、SQLite 等都在其支持列表内),这套"事件 + 策略 + 通道"的组合让告警触达变得既灵活又可靠,值得作为生产环境备份体系的最后一块拼图来配置。

登录后查看全文
portabase