使用 RSSHub 为任意网址生成订阅源
最近在学习 APISIX 时，发现它的 官方博客 有不少的干货内容，于是想着能在我的阅读器里订阅这个博客的更新，不过找了半天都没有找到这个博客的订阅入口，后来在博客的页面代码里找到了 rss.xml 和 atom.xml 两个订阅链接，不过打开一看全都是 404 Page Not Found。
其实遇到这种情况，也有不少的解决方法，有很多网站提供了 RSS 生成的功能，比如 RSS.app、FetchRSS 或 feed43 等都提供了免费的 RSS 源转换功能，不过这些工具要么使用起来不太好用，要么访问速度巨慢，要么就是有各种各样的限制。于是便想实现一个自己的 RSS 生成服务，正好前几天看到了一个叫做 RSSHub 的项目，这是一个开源、简单易用、易于扩展的 RSS 生成器，口号是 万物皆可 RSS，可以给任何奇奇怪怪的内容生成 RSS 订阅源，而且看社区也挺活跃，于是就利用周末时间折腾一下，使用 RSSHub 搭建了一个自己的 RSS 生成服务。
快速开始
RSSHub 和那些在线的 RSS 生成服务不一样，它是通过编写扩展的方式来添加新的 RSS 订阅源。不过在编写自己的扩展之前，可以先到官网上搜索一下，看看有没有其他人已经写过了，官网上目前已经适配了数百家网站的上千项内容。由于我要订阅的 APSIX 博客比较小众，目前还没有人写过，所以就只能自己动手了。
RSSHub 是基于 Node.js 实现的，所以先确保机器上已经安装了 Node.js 运行环境：
$ node -v
v16.14.2以及包管理器 Npm 或 Yarn，我这里使用的是 Npm：
$ npm -v
8.5.0然后，下载 RSSHub 的源码：
$ git clone https://github.com/DIYgod/RSSHub.git进入 RSSHub 的根目录，运行以下命令安装依赖：
$ cd RSSHub
$ npm install依赖安装成功后，运行以下命令在本地启动 RSSHub：
$ npm run dev启动成功后，在浏览器中打开 http://localhost:1200 就可以看到 RSSHub 的首页了：
新建路由
此时 RSSHub 内置的上千个订阅源，都可以在本地访问，比如通过 /bilibili/ranking/0/3/1 这个地址可以订阅 B 站三天内的排行榜。这个订阅源的格式一般分为三个部分：
/命名空间/路由/参数新建命名空间
命名空间应该和 RSS 源网站的二级域名相同，所以 B 站的命名空间为 bilibili，而我们要新建的 APISIX 博客地址为 apisix.apache.org/zh/blog，所以命名空间应该为 apache。
每个命名空间对应 lib/v2 目录下的一个子文件夹，所以我们在这个目录下创建一个 apache 子文件夹：
$ mkdir lib/v2/apache注册路由
第二步，我们需要在命名空间子文件夹下按照 RSSHub 的 路由规范 来组织文件，一个典型的文件夹结构如下：
├───lib/v2
│ ├───furstar
│ ├─── templates
│ ├─── description.art
│ ├─── router.js
│ ├─── maintainer.js
│ ├─── radar.js
│ └─── someOtherJs.js其中，每个文件的作用如下：
router.js- 注册路由maintainer.js- 提供路由维护者信息radar.js- 为每个路由提供对应 RSSHub Radar 规则someOtherJs.js- 一些其他的代码文件，一般用于实现路由规则templates- 该目录下是以.art结尾的模版文件，它使用 art-template 进行排版，用于渲染自定义 HTML 内容
编写 router.js 文件
其中最重要的一个文件是 router.js，它用于注册路由信息，我们创建该文件，内容如下：
module.exports = (router) => {
router.get('/apisix/blog', require('./apisix/blog'));
};RSSHub 使用 @koa/router 来定义路由，在上面的代码中，我们通过 router.get() 定义了一个 HTTP GET 的路由，第一个参数是路由路径，它需要符合 path-to-regexp 语法，第二个参数指定由哪个文件来实现路由规则。
在路由路径中，我们还可以使用参数，比如上面 bilibili 的路由如下：
router.get('/ranking/:rid?/:day?/:arc_type?/:disableEmbed?', require('./ranking'));其中 :rid、:days、:arc_type 和 :disableEmbed 都是路由的参数，每个参数后面的 ? 表示这是一个可选参数。路由参数可以从 ctx.params 对象中获取。
编写 maintainer.js 文件
maintainer.js 文件用于提供路由维护者信息，当用户遇到 RSS 路由的问题时，他们可以联系此文件中列出的维护者：
module.exports = {
'/apisix/blog': ['aneasystone'],
};编写路由规则
接下来我们就可以实现路由规则了。首先我们需要访问指定网址来获取数据，RSSHub 提供了两种方式来获取数据：
这其实就是爬虫技术，我们获取的数据通常是 JSON 或 HTML 格式，如果是 HTML 格式，RSSHub 提供了 cheerio 方便我们进一步处理。
上面在注册路由时我们指定了路由规则文件为 ./apisix/blog，所以接下来，创建 ./apisix/blog.js 文件。路由规则实际上就是生成 ctx.state.data 对象，这个对象包含三个字段：
title- 源标题link- 源链接item- 源文章
我们先编写一个最简单的路由规则，文件内容如下：
module.exports = async (ctx) => {
ctx.state.data = {
title: `Blog | Apache APISIX`,
link: `https://apisix.apache.org/zh/blog/`,
item: [{}],
};
};这时虽然源文章列表还是空的，但是我们已经可以通过 http://localhost:1200/apache/apisix/blog 地址来访问我们创建的 RSS 源了：
只不过源文章中的 title 和 description 都是 undefined。
接下来要做的事情就是如何获取源文章了，很显然，我们需要访问 APISIX 的博客，并从页面 HTML 中解析出源文章。首先使用 got 发送 HTTP 请求获取页面 HTML：
const url = 'https://apisix.apache.org/zh/blog/';
const { data: res } = await got(url);得到 HTML 之后，使用 cheerio 对其进行解析：
const $ = cheerio.load(res);cheerio 有点类似于 jQuery，可以通过 CSS 选择器对 HTML 进行解析和提取，我们可以很方便地在页面中提取出源文章列表：
const articles = $('section.sec_gjjg').eq(1).find('article');
const results = [];
articles.each((i, elem) => {
const a = $(elem).find('header > a');
const time = $(elem).find('footer').find('time').text();
const author = $(elem).find('footer').find('img').attr('src');
results.push({
title: a.find('h2').text(),
description: a.find('p').text(),
link: a.attr('href'),
pubDate: timezone(parseDate(time, 'YYYY年M月D日'), +8),
author,
});
});
return results;每个源文章包含以下几个字段：
title- 文章标题link- 文章链接description- 文章正文pubDate- 文章发布日期author- 文章作者（可选）category- 文章分类（可选）
至此，我们的路由规则就创建好了，可以在浏览器中对我们的路由进行验证和调试。我们这里的路由规则比较简单，稍微复杂一点的例子可以参考 RSSHub 官方文档 制作自己的 RSSHub 路由，使用缓存 和 日期处理。另外，lib/v2 目录下有很多其他人编写的路由规则，也是很好的参考资料。
其他工作
实现自己的订阅源之后，还可以编写 radar.js 文件，为每个路由提供对应 RSSHub Radar 规则。RSSHub Radar 是 RSSHub 的一款浏览器插件，方便用户查找某个网站是否存在 RSS 订阅源。最后为你的路由 添加相应的文档，一个订阅源就开发完成了。
不过如果只是自己部署使用，这些工作也可以跳过。
部署
最后，将 RSSHub 部署到自己的服务器上，官方提供了几种 部署方式，比较推荐的是 Docker 或 Docker Compose 部署。
我这里使用 Docker 来简化部署流程。由于我希望将 Redis 作为我的 RSSHub 缓存，这样可以保证每次重启 RSSHub 之后缓存不会失效。首先启动一个 Redis 实例：
$ docker run -d -p 6379:6379 redis:alpine然后启动 RSSHub 即可：
$ docker run --name rsshub \
-d -p 1200:1200 \
-e NODE_ENV=production \
-e CACHE_TYPE=redis \
-e REDIS_URL=redis://172.18.0.1:6379/ \
-v /root/rsshub/v2:/app/lib/v2 \
diygod/rsshub注意我们将 lib/v2 目录挂载进容器，这样才能让我们的订阅源生效。我制作了三个 RSS 订阅源，有需要的小伙伴可以自取：