⚠️ 项目状态:作者已于 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 请求频率限制
安装与部署
直接运行
- 克隆仓库,或下载最新的发布版本
- 在项目目录中执行
npm install安装依赖 - 把
.env.example复制为.env,并填写配置 - 执行
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:检查间隔,单位为毫秒,默认 60000GITHUB_TOKENLOG_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 等计划。由于项目已归档,这些功能可能不会再实现
发现更多
MyIP
一站式 IP 工具箱。可轻松查看你的 IP 地址、IP 地理位置,检测 DNS 泄漏,检查 WebRTC 连接,进行速度测试、Ping 测试、MTR 测试,检测网站可用性等。
MySpeed
一款网速测试分析软件,可展示长达 30 天的网速记录。
Reactive Resume
一款独一无二、注重隐私保护的简历生成器。安全可靠、可自由定制、便于迁移,同时开源并永久免费。
URL-to-PNG
一款 URL 转 PNG 工具,使用 Playwright 进行并行渲染以生成截图,并支持通过本地存储、S3 或 CouchDB 进行存储缓存。
WeTTY
通过 http/https 在浏览器中使用的终端。
Anubis
通过“称量”传入 HTTP 请求的灵魂,来阻挡 AI 爬虫