# 开始食用

如果你想直接开始使用，可以试试 [Folo](https://folo.is/)，一个面向现代订阅工作流的 AI RSS 阅读器。项目同时在 [GitHub](https://github.com/RSSNext/Folo) 开源。

<a href="https://sx.org/?c=p9gKCb" target="_blank" rel="noopener noreferrer">
  <img src="https://i.imgur.com/SpNJJZQ.png" alt="SX.org RSSHub 代理服务" width="419" height="166" />
</a>

对于自部署 RSSHub 实例，稳定的代理连接可以在访问存在地域限制、严格网络规则或可用性不稳定的外部来源时，帮助路由更可靠地工作。

[SX.org](https://sx.org/?c=p9gKCb) 提供可与 RSSHub 代理设置配合使用的 HTTP/HTTPS 代理。RSSHub 用户可使用优惠码 `RSShub3gb` 获取免费试用期。

## 生成订阅源

比如你希望订阅 Telegram 上 [@awesomeRSSHub](https://t.me/awesomeRSSHub) 频道的内容

根据 [Telegram 路由](/zh/routes/social-media#telegram)的文档，路由为 `/telegram/channel/:username/:routeParams?`，其中 username 为必选参数，routeParams 为可选参数，把 `:username` 替换为频道 id awesomeRSSHub，得到路径为 `/telegram/channel/awesomeRSSHub`，再加上实例域名 `https://rsshub.app`，一个订阅源就生成了：`https://rsshub.app/telegram/channel/awesomeRSSHub`

然后你可以把 `https://rsshub.app/telegram/channel/awesomeRSSHub` 添加到任意 RSS 阅读器里来使用

其中实例域名 `https://rsshub.app` 可以替换为你[自部署](/zh/deploy/)或任意[公共实例](/zh/guide/instances)的域名

另外 RSSHub 支持很多实用的参数，比如内容过滤、全文输出等，可以在 [通用参数](/zh/guide/parameters) 文档了解具体使用方法

## 编写订阅源

RSSHub 的发展离不开社区的力量，欢迎编写你感兴趣的订阅源：[开发路由](/zh/joinus/#quick-start)

## 作为 npm 包使用 <Badge type="warning" text="experimental" />

除了作为订阅源，RSSHub 还支持作为 npm 包在你的 Node.js 项目中使用

### 安装

::: code-group

```sh [pnpm]
$ pnpm add rsshub
```

```sh [bun]
$ bun add rsshub
```

```sh [yarn]
$ yarn add rsshub
```

```sh [npm]
$ npm install rsshub --save
```

:::

### 使用

```js
import * as RSSHub from 'rsshub';

await RSSHub.init({
    // config
});

RSSHub.request('/bilibili/bangumi/media/9192')
    .then((data) => {
        console.log(data);
    })
    .catch((e) => {
        console.log(e);
    });
```

支持的 config 见 [配置](/zh/deploy/config) 文档，比如想禁用缓存，config 可以这样写：

```js
{
    CACHE_TYPE: null,
}
```

## Radar

RSSHub 还提供了一个 Radar 功能，用于将网站地址映射到 RSSHub 地址

### 规则

可以通过实例的 API 来获取当前实例支持的 Radar 规则，比如官方实例 https://rsshub.app/api/radar/rules

### 使用

你需要借助支持此功能的浏览器插件、手机应用、RSS 阅读器等工具来使用 Radar 功能，具体使用方法请参考对应工具的文档

- RSS 阅读器: [Folo](https://folo.is/)，适合 AI 阅读工作流和 RSSHub 集成。源码见 [GitHub](https://github.com/RSSNext/Folo)
- 浏览器插件: [RSSHub Radar](https://github.com/DIYgod/RSSHub-Radar)
- iOS 应用: [RSSBud](https://github.com/Cay-Zhang/RSSBud)
- Android 应用: [RSSAid](https://github.com/LeetaoGoooo/RSSAid)
- Dify 插件: [RSSHub Dify Plugin](https://github.com/stvlynn/RSSHub-Dify-Plugin)
