返回服务列表

AlertHub

接收来自 GitHub 发布版本的提醒通知。

查看 AlertHub 的替代品
建议修改
最近评价

替代服务

技术栈

还没有添加技术栈。 登录后可以建议添加

⚠️ 项目状态:作者已于 2025 年 10 月 26 日将该仓库归档,现为只读,不再维护。如果用于新部署,请先考虑这一点。

简介

在 GitHub 上关注一个仓库后,你也会收到它的 Issue、评论等所有动态。GitHub 本身没有办法只关注新版本,或只关注提交和标签。专门做这件事的服务 sibbell.com 在 2018 年 5 月 15 日停止运营,作者 Ardakilic 因此开发了 AlertHub。

AlertHub 是一个没有图形界面的命令行工具。它按设定好的列表检查仓库动态,有新内容就推送通知,还会生成一个按时间排序的 RSS 订阅源,可以放进 RSS 阅读器或接入 IFTTT 等服务。配置一次之后基本不用再管。

作者在 README 中提到,GitHub 后来支持了只关注 Releases,但他认为这个功能仍有问题,而且没有 AlertHub 提供的推送通知。

主要功能

  • GitHub 监控:关注 Releases、Tags、Commits 和 Issues;Issues 可以设置过滤条件
  • GitLab 监控:关注 Tags 和 Commits
  • 按分支监控提交:可以只关注指定分支,用 * 表示所有分支
  • 第三方源:通过 EXTRAS 直接添加既不在 GitHub 也不在 GitLab 上的 RSS 源
  • 多种通知渠道:
    • 邮件(SMTP)
    • PushBullet
    • PushOver
    • Telegram 机器人(可推送到频道或指定的 Chat ID)
  • 汇总 RSS 订阅源:内置 RSS 服务,默认端口为 3444;每个仓库的条目数和订阅源的总条目数都可以设置

适合谁用

  • 想及时知道所依赖的库或工具出了新版本的开发者和运维人员
  • 只想要版本更新、不想被 Issue 和评论刷屏的人
  • 习惯用 RSS 阅读器或 IFTTT 管理信息的用户

技术要求

  • Node.js 20.x 或更新版本;也可以直接用 Docker 运行
  • 可选:PushBullet API Key、PushOver API Key、SMTP 账号、Telegram 机器人 Token 和 Chat ID
  • 可选:GitHub Token,用来避开 API 请求频率限制

安装与部署

直接运行

  1. 克隆仓库,或下载最新的发布版本
  2. 在项目目录中执行 npm install 安装依赖
  3. 把 .env.example 复制为 .env,并填写配置
  4. 执行 npm start 启动;也可以用 pm2 start npm -- start 让它常驻后台

Docker(官方推荐)

docker run --name alerthub -d --env-file .env -p 3444:3444 ghcr.io/ardakilic/alerthub:2

也可以不用 .env 文件,通过 -e 逐个传入环境变量。

仓库还附带一个 Makefile,所有命令都在 Docker 中执行(如 make install、make test、make start),本地不需要安装 Node.js。

配置说明

所有配置都通过环境变量完成:

  • 通用设置:
    • INTERVAL:检查间隔,单位为毫秒,默认 60000
    • GITHUB_TOKEN
    • LOG_LEVEL
  • 监控列表:使用 JSON 格式,包括 GITHUB_RELEASES、GITHUB_TAGS、GITHUB_COMMITS、GITHUB_ISSUES、GITLAB_TAGS、GITLAB_COMMITS、EXTRAS
  • 通知开关和凭据:各渠道都有独立的启用开关和对应凭据

配置示例:

GITHUB_RELEASES='["Ardakilic/alerthub","expressjs/express"]'
GITHUB_COMMITS='{"laravel/laravel":["*"]}'

值得注意的特点

  • 以 MIT 许可证开源,数据和服务都在自己手里
  • 没有 Web 界面,所有设置都写在配置文件或环境变量里
  • 功能列表中,监控 GitHub 私有仓库这一项已被划掉,即暂不支持。作者在待办事项中写着要想办法恢复这项支持(见 Issue #80)
  • 待办事项中还有 Bitbucket 支持、Gitea 支持、多用户和按仓库设置 Webhook 等计划。由于项目已归档,这些功能可能不会再实现