github.com · DIYgod/RSSHub
RSSHub - 开源琅嬛阁
项目介绍
RSSHub 是全球规模最大的开源 RSS 路由网络之一, slogan 是「Everything is RSSible」。它为 B 站、微博、Twitter、Telegram 等原本不提供 RSS 的平台编写抓取路由,输出标准 RSS/Atom 订阅源,方便接入 Folo、FreshRSS、Miniflux 等阅读器。项目采用 AGPL-3.0 许可,拥有 1300+ 贡献者与数千个预置路由,既可使用公共实例,也支持 Docker 或 Node.js 自托管。
核心特性
- 数千条预置路由,覆盖社交媒体、新闻、视频、学术等常见信息源
- 标准 RSS/Atom 输出,兼容主流 RSS 阅读器与自动化工具
- 支持内容过滤、全文输出等 URL 参数,可按需定制订阅内容
- Radar 规则与 RSSHub Radar 浏览器扩展,可快速发现当前网站的 RSS 地址
- 提供 npm 包,可在 Node.js 项目中以 API 方式调用路由
- Docker Compose 一键部署,可选 bundled Chromium 以支持需 Puppeteer 的路由
对用户价值
许多平台不再提供官方 RSS,RSSHub 把「找源 → 写爬虫 → 维护格式」封装成统一路由。用户只需按文档拼出 URL(如 https://rsshub.app/telegram/channel/awesomeRSSHub),即可在阅读器里集中追踪分散在各 App 里的更新,减少手动刷信息流的时间成本。
与替代方案
- 相比 Feed43、FeedBurner 等在线转制服务,RSSHub 开源可自托管,路由社区维护、覆盖面更广。
- 相比 Huginn、n8n 等通用自动化平台,RSSHub 专注 RSS 输出,路由即用、对阅读器场景更直接。
- 相比为每个站点单独写爬虫,RSSHub 提供统一协议与共享路由,但复杂站点仍可能因反爬或页面改版而失效,需关注路由状态或自行维护 fork。
适应人群
- 依赖 RSS 追踪资讯、社交动态或 UP 主更新的重度阅读者。
- 希望自托管订阅基础设施、控制数据与访问频率的技术用户。
- 需要把多平台内容汇聚到 Folo、FreshRSS 等工作流的开发者与运营者。
如何使用
前置条件
- 使用公共实例时:任意 RSS 阅读器即可,无需本地环境。
- 自托管时:Docker 与 Docker Compose(推荐),或 Node.js 与 pnpm;部分路由需 Redis 缓存或 Chromium/Puppeteer 依赖。
安装方式
Docker Compose(推荐):
wget https://raw.githubusercontent.com/DIYgod/RSSHub/master/docker-compose.ymldocker-compose up -d或单容器快速体验:
docker run -d --name rsshub -p 1200:1200 diygod/rsshub手动部署:
git clone https://github.com/DIYgod/RSSHub.gitcd RSSHubpnpm ipnpm buildpnpm start首次运行
浏览器访问 http://localhost:1200(自托管)或查阅 路由文档 找到目标平台路径。将实例域名与路由拼接成完整 URL,例如 Telegram 频道 @awesomeRSSHub 对应 /telegram/channel/awesomeRSSHub,加入阅读器订阅列表。
验证是否成功
在阅读器中确认新订阅能拉取到条目;若路由需参数,对照文档检查 username、ID 等占位符是否填写正确。自托管实例可访问 /api/radar/rules 查看当前支持的 Radar 规则。
常见坑 / 注意事项
- 公共实例
rsshub.app有访问频率限制,高频或生产用途建议自托管。 - 无 Chromium 的镜像不支持依赖 Puppeteer 的路由,需使用
diygod/rsshub:chromium-bundled或 Docker Compose 完整栈。 - 部分源会因目标站反爬、登录或页面改版而失效,可查阅 GitHub Issues 或社区 Telegram 获取路由状态。
- AGPL-3.0 对网络服务部署有传染性要求,商业场景部署前请阅读许可证条款。