RSSHub 入门
# 300.RSSHub 入门
RSSHub 是一个开源、简单易用、易于扩展的 RSS 生成器，可以给任何奇奇怪怪的内容生成 RSS 订阅源。RSSHub 借助于开源社区的力量快速发展中，目前已适配数百家网站的上千项内容。
本文讲解下关于 RSSHub 的基本概念、使用方法、镜像实例、自建方法以及关于插件的知识。
# 介绍
官网文档：https://docs.rsshub.app (opens new window)
开源在 GitHub：https://github.com/DIYgod/RSSHub (opens new window)
作者个人博客：https://diygod.cc (opens new window)
PS：目前 RSSHub 官网已经被墙，因此我们可以访问一些镜像网站来看文档，例如：rsshub.netlify.app (opens new window)
# 如何使用 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 (opens new window)，这是一个浏览器插件。安装后，就可以通过插件来直接获取 RSS 源了：
除了插件，也可以使用油猴脚本 RSS+ (opens new window)，原理都是一样的。
推荐阅读作者的博客：RSSHub Radar — 订阅一个 RSS 源不应该这么难 - DIYgod (opens new window)
# 移动端
此外，RSSHub 还提供了移动端辅助 App：RSSBud (opens new window) (iOS) 与 RSSAid (opens new window) (Android)
# 自建 RSSHub
自己建立一个 RSSHub 实例，才是最稳定的。搭建过程可以先看看官网文档，支持 Docker 和 npm 方式：
我个人用的是本地部署，因为服务器也是要花钱的，还得考虑被攻击的问题。
我个人认为该官网文档还是太简单了，限于篇幅，下一篇博客会详细介绍我的部署方式，这里先略过。
# RSSHub 镜像
由于 RSSHub 被墙了，如何使用就是一个问题了，总不能一直用魔法上网。
由于 RSSHub 支持自建，很多网友都建了一份，并且分享了出来，我们可以叫这些网站为 RSSHub 的镜像网站。如果你不想动手，则完全搭其他网友的“便车”。
我目前知道的镜像有：
https://rsshub.rssforever.com
https://i.scnu.edu.cn/sub
https://rsshub.anyant.xyz
https://rss.injahow.cn
https://rss.shab.fun
https://rss.injahow.cn
2
3
4
5
6
我个人认为第一个和第二个会长期有效，一个是 RSS 爱好者搭建的公益网站，另一个是华南师范大学网络协会搭建的网站。
就算真的失效了，只要再换一个镜像就行。
更多镜像可以参考 RSSHub 的官网，里面列出了很多，并且还标记了是否有效（up/down）：
也可以用 bing 或 Google 搜索“Welcome to RSSHub”，这个是 RSSHub 首页的信息，能搜到说明这是一个 RSSHub 实例：
# 插件设置
既然更换了 RSSHub 镜像地址，那么插件里也需设置新的镜像地址。点击插件，然后点击设置：
然后就可以设置 RSSHub 实例地址了：
如果你使用的是油猴脚本 RSS+ (opens new window)，也可以进行同样的设置：
# RSS 阅读器的设置
如果镜像服务器失效了，RSS 阅读器里的订阅源地址也要更换。
一般情况下，RSS 阅读器都支持导入/导出订阅源（.opml 文件），我们可以导出，然后用文本编辑器打开，进行批量替换，再重新导入到 RSS 阅读器即可。
——完——
