RSSHub RSS 生成器 — 一键安装

简介

RSSHub 是一个开源、易于使用且可扩展的 RSS 源生成器。它几乎能够为任何内容生成 RSS 源。

RSSHub 提供来自各类来源的数百万聚合内容，我们充满活力的开源社区正持续推动 RSSHub 新路由、新功能和错误修复的交付。

RSSHub 可与浏览器扩展 RSSHub Radar 以及移动端辅助应用 RSSBud (iOS) 和 RSSAid (Android) 配合使用。

English docs | Telegram 群组 | Telegram 频道 | Twitter | 中文文档

使用方法

为了生成一个源，您需要将一个带有参数的有效 URL 附加到您的 RSSHub 实例主域名之后，具体 URL 结构因每个不同的应用而异。关于每个受支持服务或应用的详细使用指南，请参阅 https://docs.rsshub.app/guide/，以及 https://docs.rsshub.app/guide/parameters 了解如何在给定 URL 中对源进行过滤、排序或限制。

RSSHub 配置 / 添加账户

您自己的实例配置必须通过环境变量完成，可以通过取消注释 {$APP_DATA_DIR}/app-data/data/app.env 中已存在的 .env 文件里的环境变量，或者直接修改 docker-compose.yml 文件来实现，具体细节请参考 https://runtipi.io/docs/guides/customize-app-config。

有关 RSSHub 可用配置环境变量的更多信息，请查阅 https://docs.rsshub.app/deploy/config。但请注意，该文档仅包含用于配置特定应用或功能的部分环境变量，而少数环境变量可能文档记录不全或行为与官方文档描述不符（例如 UA）。为了全面了解所有内容，除了阅读官方文档外，还需要浏览 https://github.com/DIYgod/RSSHub/blob/master/lib/config.ts 处的代码。此应用提供的 app.env 文件已结合两个信息来源列出了所有可用的变量，并包含了其中指定的默认值，但任何环境变量的确切工作原理，只能在阅读文档基础知识后直接查阅源代码才能理解。

访问控制

RSSHub 提供访问控制功能，用于限制哪些用户可以在您的实例内生成源。这可以通过环境变量 ACCESS_KEY 来启用，该变量可以在安装时通过 Runtipi 的应用商店配置，也可以通过 RSSHub 应用的 docker-compose.yml 或 app.env 中的环境变量配置。默认值为空 ("")，这意味着通过 URL 访问源不需要额外的密钥。

请注意，ACCESS_KEY 是全局启用的，但可以按应用粒度控制访问权限，即只向用户提供特定应用的_访问码_，如 https://docs.rsshub.app/deploy/config#access-control-configurations 上的图表所示。

+ -----------------------------------------------------------------------------------------------------------------+
| 访问密钥       | 路由               | 生成访问码                           | 访问码                            |
|------------------------------------------------------------------------------------------------------------------|
| ILoveRSSHub	 | /qdaily/column/59 | md5('/qdaily/column/59' + 'ILoveRSSHub')	| 0f820530128805ffc10351f22b5fd121 |
+ -----------------------------------------------------------------------------------------------------------------+

* 路由可通过访问码访问，例如：https://rsshub.app/qdaily/column/59?code=0f820530128805ffc10351f22b5fd121
* 或直接使用密钥，例如：https://rsshub.app/qdaily/column/59?key=ILoveRSSHub

为什么选择自托管而非使用公共实例？

如前所述，此应用通过无头浏览器或有时直接通过 API 访问来为特定网站生成源。某些社交网络或功能，例如 OpenAI 的 GPT 访问，需要有效的订阅访问令牌来总结帖子或执行其他 AI 任务。对于设置了某种付费墙的社交媒体/内容应用，如 X (Twitter)、Instagram 或 Medium，需要有效的账户才能生成来自该处“动态”的源。

相关项目

• RSSHub Radar：一款浏览器扩展，可帮助您快速发现并订阅当前网站的 RSS 和 RSSHub。
• RSSBud：面向 iOS 平台的 RSSHub Radar，专为移动生态系统优化而设计。
• RSSAid：使用 Flutter 构建的 Android 平台 RSSHub Radar。
• DocSearch：将 RSSHub DocSearch 链接到 Raycast。