使用 K8S 部署 RSS 全套自托管解决方案- RssHub + Tiny Tiny Rss

前言

什么是 RSS?

RSS 是一种描述和同步网站内容的格式，是使用最广泛的 XML 应用。RSS 搭建了信息迅速传播的一个技术平台，使得每个人都成为潜在的信息提供者。发布一个 RSS 文件后，这个 RSS Feed 中包含的信息就能直接被其他站点调用，而且由于这些数据都是标准的 XML 格式，所以也能在其他的终端和服务中使用，是一种描述和同步网站内容的格式。

RSS 广泛用于网上新闻频道，blog 和 wiki。使用 RSS 订阅能更快地获取信息，网站提供 RSS 输出，有利于让用户获取网站内容的最新更新。网络用户可以在客户端借助于支持 RSS 的聚合工具软件，在不打开网站内容页面的情况下阅读支持 RSS 输出的网站内容。

为什么我还是需要 RSS?

两个目的：

1.通过 RSS 和 RSS 阅读器作为高效率的 Feed 集合器，免去每日浏览各个网站搜寻信息的时间，发现优质内容，提高阅读效率。2.通过 RSS Feed, 获取低频但重要的信息，如重要软件更新，预报预警等。

Tiny Tiny RSS 简介

Tiny Tiny RSS^[1] 是一款基于 PHP 的免费开源 RSS 聚合阅读器。需要自行托管和部署，为基于网页的 RSS 阅读器。

RssHub 简介

RSSHub 主页^[2]

RSSHub 是一个开源、简单易用、易于扩展的 RSS 生成器，可以给任何奇奇怪怪的内容生成 RSS 订阅源。RSSHub 借助于开源社区的力量快速发展中，目前已适配数百家网站的上千项内容

主要目的：

•将非 rss 格式转换为 rss 以便订阅；正如其 slogan 所言：「🍰 万物皆可 RSS」•发现更多有趣的订阅源。

比如我通过 RssHub 订阅的内容有：

•哔哩哔哩•InfoQ 热门话题•本地宝焦点资讯•豆瓣 - 正在上映的高分电影•所在城区停电通知•N 卡驱动更新•...

它是作为一个有聚合了很多内容 RSS 源的仓库来使用。

📚️ Reference:

比如我希望订阅 Twitter 上一个名为 DIYgod 的用户的时间线

根据 Twitter 用户时间线路由^[3] 的文档，路由为 /twitter/user/:id，把 :id 替换为用户名，得到路径为 /twitter/user/DIYgod，再加上域名 https://rsshub.app，一个订阅源就生成了：https://rsshub.app/twitter/user/DIYgod(opens new window)^[4]

然后我们可以把 https://rsshub.app/twitter/user/DIYgod 添加到任意 RSS 阅读器（当然也可以是 Tiny Tiny RSS) 里来使用

其中域名 https://rsshub.app 可以替换为你 自部署^[5] 的域名

另外，如果需要订阅一些特定的内容，比如：

•bilibili 用户（我自己）关注的内容•微博 个人时间线

等就需要将 RssHub 单独部署并进行配置。

部署架构

Overview

Tiny Tiny RSS 有一个公网 HTTPS 域名（如：https://ttrss.ewhisper.cn), 我直接登录该域名来进行 RSS 阅读；

Tiny Tiny RSS 订阅源可以来自：

1.支持 RSS 的网站，比如：OpenShift 博客^[6] 的对应 RSS 地址为：https://cloud.redhat.com/blog/rss.xml2.我自己部署的 RssHub, 公网 HTTPS 域名为：https://rss.ewhisper.cn

Tiny Tiny RSS

1.Tiny Tiny RSS 部署在 K8S 集群的 rss ns 里；2.基于 Awesome-TTRSS/docker-compose.yml at main · HenryQW/Awesome-TTRSS (github.com)^[7], 需要部署的组件有：1.tiny tiny rss, 需要有一个 PVC 存储，用于存放 icon2.tiny tiny rss 的 数据库 - postgresql 13, 需要有一个 PVC 存储，用于存放数据库数据。3.组件都是单节点部署，不考虑高可用；4.Tiny Tiny RSS 通过 Ingress + SVC 对外发布域名；

RssHub

1.RssHub 部署在 K8S 集群的 rss ns 里；2.基于 RSSHub/docker-compose.yml at master · DIYgod/RSSHub (github.com)^[8] , 需要部署的组件有：1.rsshub2.browserless chrome3.redis, 需要有一个 PVC 存储，用于存放缓存数据。3.组件都是单节点部署，不考虑高可用；4.RssHub 通过 Ingress + SVC 对外发布域名；

前提条件

1.需要有属于自己的域名，如：ewhisper.cn, 具体的域名为：1.ttrss.ewhisper.cn2.rss.ewhisper.cn2.且该域名已经在国内备案，80 和 443 端口可以正常使用；3.该域名托管在 DNSPod 或类似的 DNS 供应商，可以方便地修改 DNS Record;4.需要有对应域名的证书，本次需要有：ttrss.ewhisper.cn 和 rss.ewhisper.cn 的证书，可以是单域名证书，也可以是泛域名证书。5.已经搭建好 K8S 集群6.K8S 集群有 Ingress Controller7.K8S 集群有 StorageClass 或可以提供 PV 存储。（本文 K8S 集群默认提供 local-path storageclass)8.本次 2 个域名通过 K8S Traefik 的 IngressRoute 进行配置，配置 Ingress 和 证书；9.已安装：K8S 实用工具之五 -kompose - 东风微鸣技术博客 (ewhisper.cn)^[9], 该工具用于将 docker-compose.yml 快速转换为 K8S yaml

📚️ Reference:

可以通过 cert-manager 为 dnspod 在 Letsencrypt 上申请免费证书：

•使用 cert-manager 为 dnspod 的域名签发免费证书 | 作者 roc^[10]

实施

Tiny Tiny RSS 搭建

其 docker-compose.yml 在这里：

Awesome-TTRSS/docker-compose.yml at main · HenryQW/Awesome-TTRSS (github.com)^[11],

1. 修改 docker-compose

有 2 个地方需要修改：

1.环境变量：1.SELF_URL_PATH=https://ttrss.ewhisper.cn/ （你自己的域名）2.DB_PASS=changeit (postgresql 数据库密码）2.使用 kompose 转换，转换前，需要在 docker-compose.yml 补充相关信息以保证转换 k8s service 成功，具体为在各个 docker compose 的 service 里加上 ports 字段。docker-compose.yml 修改的内容见这里：

version: "3"services:  service.rss:    environment:      - SELF_URL_PATH=https://ttrss.ewhisper.cn/ # please change to your own domain      - DB_PASS=changeit # use the same password defined in `database.postgres`  ...  service.mercury:    ports:      - 3000:3000...  service.opencc: # set OpenCC API endpoint to `service.opencc:3000` on TTRSS plugin setting page    ports:      - 3000:3000...  database.postgres:    environment:      - POSTGRES_PASSWORD=changeit    ports:      - 5432:5432      

为方便查看，相关的 yaml 文件都放在这里了：east4ming/rsshub-ttrss-k8s-deploy (gitee.com)^[12]

修改后的 docker-compose.yml 在这里查看：ttrss/docker-compose.yml · east4ming/rsshub-ttrss-k8s-deploy - 码云 - 开源中国 (gitee.com)^[13]

2. 使用 kompose 转换

命令如下：

在 docker-compose.yml 所在目录下执行：

kompose convert -o ./k8s/ --pvc-request-size 2Gi

📝 Note:

--pvc-request-size 2Gi 按需调整。

转换后，目录结构如下：（转换后还会生成 NetWorkPolicy 文件，个人认为没必要，就删除掉了相关文件和 label; 另外，生成的文件中有的 字段包含 . , 以防万一，都替换为了 -):

└── ttrss    ├── docker-compose.yml    └── k8s        ├── database-postgres-claim0-persistentvolumeclaim.yaml        ├── database-postgres-deployment.yaml        ├── database.postgres-service.yaml        ├── feed-icons-persistentvolumeclaim.yaml        ├── service-mercury-deployment.yaml        ├── service-opencc-deployment.yaml        ├── service-rss-deployment.yaml        ├── service.mercury-service.yaml        ├── service.opencc-service.yaml        └── service.rss-service.yaml

除此之外还需要手动创建一个 ingress, 用于对外暴露服务（这里用的是 Traefik CRD - IngressRoute).

1.Tiny Tiny Rss1.Deployment: service-rss-deployment.yaml (🐾这里还需要添加一个 ENV: DB_HOST, 以通过 DB SVC 访问 DB)2.Service: service.rss-service.yaml （用于对接 Ingress, 对外提供服务）3.IngressRoute: ingress-rss-service.yaml2.DB - PostgreSQL1.Deployment: database-postgres-deployment.yaml2.SVC: database.postgres-service.yaml (Tiny Tiny Rss 通过该 SVC 连接到 DB)3.PVC: database-postgres-claim0-persistentvolumeclaim.yaml（申请持久化存储）3.其他服务 - opencc1.Deployment: service-opencc-deployment.yaml2.Service: service-opencc-deployment.yaml4.其他服务 - mercury1.Deployment: service-mercury-deployment.yaml2.Service: service.mercury-service.yaml

具体的 K8S yaml 内容见这里：ttrss/k8s · east4ming/rsshub-ttrss-k8s-deploy - 码云 - 开源中国 (gitee.com)^[14]

📝 Note:

ttrss/k8s/ingress-rss-service.yaml · east4ming/rsshub-ttrss-k8s-deploy - 码云 - 开源中国 (gitee.com)^[15] 的配置沿袭于我的另一篇文章：《基于 Traefik 的激进 TLS 安全配置实践 - 东风微鸣技术博客 (ewhisper.cn)^[16]》

3. 部署

使用 kubectl 部署：

kubectl -n rss create -f ./k8s/

4. 配置 DNS Record

在 DNS 提供商控制台（本例为 DNSPod) 配置对应域名 <ttrss.ewhisper.cn> 的 DNS Record:

•ttrss, A 记录，指向 K8S 集群 Ingress 对应的公网地址

5. 访问验证

访问首页：https://ttrss.ewhisper.cn/ , 默认账户：admin 密码：password，请第一时间更改。

效果如下：

RssHub 搭建

RssHub 搭建的步骤几乎和 Tiny Tiny RSS 一样。具体如下：

1. 修改 docker-compose

使用 kompose 转换，转换前，需要在 docker-compose.yml 补充相关信息以保证转换 k8s service 成功，具体为在各个 docker compose 的 service 里加上 ports 字段。

2. 使用 kompose 转换

命令如下：

在 docker-compose.yml 所在目录下执行：

kompose convert -o ./k8s/ --pvc-request-size 2Gi

📝 Note:

--pvc-request-size 2Gi 按需调整。

转换后，目录结构如下：

.├── docker-compose.yml└── k8s    ├── browserless-deployment.yaml    ├── browserless-service.yaml    ├── redis-data-persistentvolumeclaim.yaml    ├── redis-deployment.yaml    ├── redis-service.yaml    ├── rsshub-deployment.yaml    └── rsshub-service.yaml
1 directory, 8 files

除此之外还需要手动创建一个 ingress, 用于对外暴露服务（这里用的是 Traefik CRD - IngressRoute).

1.RssHub1.Deployment: rsshub-deployment.yaml2.Service: rsshub-service.yaml （用于对接 Ingress, 对外提供服务）3.IngressRoute: rsshub-ingress.yaml2.Browserless - Chrome1.Deployment: browserless-deployment.yaml2.SVC: browserless-service.yaml (RssHub 通过该 SVC 连接到 Browserless )3.Redis1.Deployment: redis-deployment.yaml2.Service: redis-service.yaml3.PVC: redis-data-persistentvolumeclaim.yaml

具体的 K8S yaml 内容见这里：rsshub/k8s · east4ming/rsshub-ttrss-k8s-deploy - 码云 - 开源中国 (gitee.com)^[17]

📝 Note:

rsshub/k8s/rsshub-ingress.yaml · east4ming/rsshub-ttrss-k8s-deploy - 码云 - 开源中国 (gitee.com)^[18] 的配置沿袭于我的另一篇文章：《基于 Traefik 的激进 TLS 安全配置实践 - 东风微鸣技术博客 (ewhisper.cn)^[19]》

3. 部署

使用 kubectl 部署：

kubectl -n rss create -f ./k8s/

4. 配置 DNS Record

在 DNS 提供商控制台（本例为 DNSPod) 配置对应域名 <rss.ewhisper.cn> 的 DNS Record:

•rss, A 记录，指向 K8S 集群 Ingress 对应的公网地址

5. 访问验证

如果看到这个页面，证明已经部署成功：

可以通过 TTRss 的页面订阅 RssHub 的源来验证 RssHub 是否正常运行，如下图：

点击订阅后成功，如下图：

证明 RssHub 已经正常运行。

🎉🎉🎉

总结

通过如上的配置，我们可以通过自己的基于浏览器的 Tiny Tiny RSS 阅读器来订阅并阅读消息，并可以通过 RssHub 来将各种各样的信息转换为可订阅的 Rss 路由。

参考资料

•rss（简易信息聚合）_百度百科 (baidu.com)^[20]•介绍 | RSSHub^[21]•🐋 Awesome TTRSS | 🐋 Awesome TTRSS (henry.wang)^[22]

References

[1] Tiny Tiny RSS: https://tt-rss.org/
[2] RSSHub 主页: https://docs.rsshub.app/
[3] Twitter 用户时间线路由: https://docs.rsshub.app/social-media.html#twitter
[4] https://rsshub.app/twitter/user/DIYgod(opens new window): https://rsshub.app/twitter/user/DIYgod
[5] 自部署: https://docs.rsshub.app/install/
[6] OpenShift 博客: https://cloud.redhat.com/blog
[7] Awesome-TTRSS/docker-compose.yml at main · HenryQW/Awesome-TTRSS (github.com): https://github.com/HenryQW/Awesome-TTRSS/blob/main/docker-compose.yml
[8] RSSHub/docker-compose.yml at master · DIYgod/RSSHub (github.com): https://github.com/DIYgod/RSSHub/blob/master/docker-compose.yml
[9] K8S 实用工具之五 -kompose - 东风微鸣技术博客 (ewhisper.cn): https://ewhisper.cn/posts/35291/
[10] 使用 cert-manager 为 dnspod 的域名签发免费证书 | 作者 roc: https://imroc.cc/k8s/trick/cert-manager-webhook-dnspod/
[11] Awesome-TTRSS/docker-compose.yml at main · HenryQW/Awesome-TTRSS (github.com): https://github.com/HenryQW/Awesome-TTRSS/blob/main/docker-compose.yml
[12] east4ming/rsshub-ttrss-k8s-deploy (gitee.com): https://gitee.com/caseycui/rsshub-ttrss-k8s-deploy
[13] ttrss/docker-compose.yml · east4ming/rsshub-ttrss-k8s-deploy - 码云 - 开源中国 (gitee.com): https://gitee.com/caseycui/rsshub-ttrss-k8s-deploy/blob/main/ttrss/docker-compose.yml
[14] ttrss/k8s · east4ming/rsshub-ttrss-k8s-deploy - 码云 - 开源中国 (gitee.com): https://gitee.com/caseycui/rsshub-ttrss-k8s-deploy/tree/main/ttrss/k8s
[15] ttrss/k8s/ingress-rss-service.yaml · east4ming/rsshub-ttrss-k8s-deploy - 码云 - 开源中国 (gitee.com): https://gitee.com/caseycui/rsshub-ttrss-k8s-deploy/blob/main/ttrss/k8s/ingress-rss-service.yaml
[16] 基于 Traefik 的激进 TLS 安全配置实践 - 东风微鸣技术博客 (ewhisper.cn): https://ewhisper.cn/posts/14331/
[17] rsshub/k8s · east4ming/rsshub-ttrss-k8s-deploy - 码云 - 开源中国 (gitee.com): https://gitee.com/caseycui/rsshub-ttrss-k8s-deploy/tree/main/rsshub/k8s
[18] rsshub/k8s/rsshub-ingress.yaml · east4ming/rsshub-ttrss-k8s-deploy - 码云 - 开源中国 (gitee.com): https://gitee.com/caseycui/rsshub-ttrss-k8s-deploy/blob/main/rsshub/k8s/rsshub-ingress.yaml
[19] 基于 Traefik 的激进 TLS 安全配置实践 - 东风微鸣技术博客 (ewhisper.cn): https://ewhisper.cn/posts/14331/
[20] rss（简易信息聚合）_百度百科 (baidu.com): https://baike.baidu.com/item/rss/24470
[21] 介绍 | RSSHub: https://docs.rsshub.app/
[22] 🐋 Awesome TTRSS | 🐋 Awesome TTRSS (henry.wang): https://ttrss.henry.wang/zh/