RSSHub 是一个开源、简单易用、易于扩展的 RSS 生成器,可以给任何奇奇怪怪的内容生成 RSS 订阅源。RSSHub 借助于开源社区的力量快速发展中,目前已适配数百家网站的上千项内容。
本文讲解下关于 RSSHub 的基本概念、使用方法、镜像实例、自建方法以及关于插件的知识。
介绍
官网文档:https://docs.rsshub.app
开源在 GitHub:https://github.com/DIYgod/RSSHub
作者个人博客:https://diygod.cc
PS:目前 RSSHub 官网已经被墙,因此我们可以访问一些镜像网站来看文档,例如:rsshub.netlify.app
如何使用 RSSHub
接下来我们看看如何生成 RSS 源。官网文档是这样说的:
这个例子有点太简单了,我详细说明下。
首先,这个项目写好了很多代码,我们只需提供某些平台的用户名词/ID,就可以直接调用这些代码来生成 XML 文件(也叫 RSS 源,订阅源)
怎么看 RSSHub 支持什么平台呢?看文档,这里有很多的路由:
就比如社交媒体中,有 B 站、微博、知乎等等平台的订阅源生成说明。就比如 B 站用户动态:
可以看到路由是 /bilibili/user/dynamic/:uid/:routeParams?
然后我们将 uid 替换为你想关注的用户 ID,就是打开用户空间后,在网址上的那串数字:
就能得到这串字符:bilibili/user/dynamic/2267573
然后,我们将这个字符串加到 RSSHub 域名的后面:https://rsshub.app/bilibili/user/dynamic/2267573
就得到一个 RSS 源啦!
然后我们就可以在 RSS 阅读器里输入这个链接,就完成订阅了。
RSSHub 几乎订阅任何你所知道的平台,像上一篇博客里讲的“RSS 能订阅什么”里列了很多内容,在 RSSHub 都能找到对应的路由。
除此之外,还可以支持一些参数:
过滤想要的:filter=关键字(选出想要的标题和描述,多个关键字可以用竖线|
分隔)过滤不要的:filterout=关键字(去掉不要的标题和描述)条数限制:limit=10(用于排行榜类订阅源)全文输出:mode=fulltext (提取全文内容) 例如:https://rsshub.app/bilibili/user/video/35579947?filter=编程 | 摄影
还可以用 &
互相组合,例如:https://rsshub.app/bilibili/user/video/35579947?filter=编程 | 摄影&filterout=游戏&limit=10
RSSHub-Radar
如果每次想生成某些平台或者用户的 RSS 源,都去官网查路由、拼接字符串,未免也太麻烦了。
为此,RSSHub 的作者 diygod 又开源了另一个项目:RSSHub-Radar,这是一个浏览器插件。安装后,就可以通过插件来直接获取 RSS 源了:
除了插件,也可以使用油猴脚本 RSS+,原理都是一样的。
推荐阅读作者的博客:RSSHub Radar — 订阅一个 RSS 源不应该这么难 - DIYgod
移动端
此外,RSSHub 还提供了移动端辅助 App:RSSBud (iOS) 与 RSSAid (Android)
自建 RSSHub
自己建立一个 RSSHub 实例,才是最稳定的。搭建过程可以先看看官网文档,支持 Docker 和 npm 方式:
我个人用的是本地部署,因为服务器也是要花钱的,还得考虑被攻击的问题。
我个人认为该官网文档还是太简单了,限于篇幅,下一篇博客会详细介绍我的部署方式,这里先略过。
RSSHub 镜像
由于 RSSHub 被墙了,如何使用就是一个问题了,总不能一直用魔法上网。
由于 RSSHub 支持自建,很多网友都建了一份,并且分享了出来,我们可以叫这些网站为 RSSHub 的镜像网站。如果你不想动手,则完全搭其他网友的“便车”。
我目前知道的镜像有:
https://rsshub.rssforever.comhttps://i.scnu.edu.cn/subhttps://rsshub.anyant.xyzhttps://rss.injahow.cnhttps://rss.shab.funhttps://rss.injahow.cn
我个人认为第一个和第二个会长期有效,一个是 RSS 爱好者搭建的公益网站,另一个是华南师范大学网络协会搭建的网站。
就算真的失效了,只要再换一个镜像就行。
更多镜像可以参考 RSSHub 的官网,里面列出了很多,并且还标记了是否有效(up/down):
也可以用 bing 或 Google 搜索“Welcome to RSSHub”,这个是 RSSHub 首页的信息,能搜到说明这是一个 RSSHub 实例:
插件设置
既然更换了 RSSHub 镜像地址,那么插件里也需设置新的镜像地址。点击插件,然后点击设置:
然后就可以设置 RSSHub 实例地址了:
如果你使用的是油猴脚本 RSS+,也可以进行同样的设置:
RSS 阅读器的设置
如果镜像服务器失效了,RSS 阅读器里的订阅源地址也要更换。
一般情况下,RSS 阅读器都支持导入/导出订阅源(.opml
文件),我们可以导出,然后用文本编辑器打开,进行批量替换,再重新导入到 RSS 阅读器即可。
——完——