RSSHub 开发实践 #01：Telegram 频道 RSS 订阅实现与部署方案

前言

最近在参与 Follow 以及 RSSHub 这两个开源项目的一些开发维护工作，因为牵扯到与很多订阅源的“斗智斗勇”，有一些很有意思的开发实践，于是开了这个新坑系列记录下来。

本篇是这几周使用 Telegram 官方 API 与 MTProxy 来实现对 TG 频道更新的开发实践与完整配置部署教程。

follow_telegram_channel

Follow 中提供了一种便捷的订阅信息源的方式，例如用户可以输入对应的 Telegram 频道名称（如 pseudoyulife）来订阅某个频道的更新，这样就无须跳转到各个频道里去逐个查看，这一部分特性依赖的是背后 RSSHub 的实现。

rsshub_homepage

RSS (Really Simple Syndication) 是一个古早的信息聚合标准，它通过统一的数据格式，让用户能够便捷地订阅和获取网站更新。然而，随着社交媒体和移动互联网的兴起，原生支持 RSS 的网站正在减少。

而 RSSHub 秉持着"万物皆可 RSS"的理念，通过开源社区的力量将包括 Telegram、YouTube、播客在内的众多现代内容平台转换为标准的 RSS 格式，让用户能够重新掌控自己的信息获取方式，远离算法推荐的干扰。

RSSHub 中现在包含了上千个平台，针对不同平台和类别也都有着包括但不限于网页爬虫、官方接口、逆向 API 调用等多种处理方式，能够涵盖绝大多数我们日常使用到的信息源，也非常适合作为对平台的一些加密算法和反爬机制学习的实践，例如下文所要介绍的 Telegram 频道 RSS 订阅的实现。

Telegram 网页预览

yu_channel_online_preview

Telegram 提供了频道的网页预览功能，例如可以通过 t.me/s/pseudoyulife 这一链接直接查看我频道的更新，因此 RSSHub 很早之前就实现了通过抓取网页上的内容并转换为 RSS 格式的方式集成了对 Telegram 频道更新的订阅。

telegram_channel_reorx_preview

然而后来许多用户反馈说部分频道抓不到，去测试了一下，发现 Telegram 用一种黑盒的机制来限制了部分频道的网页预览功能，例如我一直在订阅的「Reorx’s Forge」以及「Newlearnerの自留地」等频道，当使用 /s 来访问页面时会被强制重定向，提示需要打开客户端来查看内容，因此对于这类频道我们没办法直接抓取到内容并转化为 RSS。

Telegram APIs

为了解决这一问题，我又去查了 Telegram 的官方文档，发现他们将 API 分为以下几种：

其中 Telegram API 中的有一个 channels.getMessages 方法可以返回某个频道的消息，可以满足我们的需求，具体的实现逻辑在 RSSHub 代码仓库 —— lib/routes/telegram/channel.ts 和 lib/routes/telegram/tglib 这两部分，有兴趣的朋友可以看一下代码。

创建 Telegram App

manage_telegram_application

使用 Telegram API 需要访问 telegram core，通过手机号登录。

api_development_config

点击 API development tools 模块，创建一个 Telegram Application（详见「Creating your Telegram Application」）。

telegram_api_id_hash

在 App configuration 模块，我们能够获取到 api_id、api_hash 两个参数，记录下值，后续会用到。

获取 Telegram Session

使用 Telegram API 新建一个 client 的流程比较严格，需要通过 SMS 验证手机号登录，在代码中交互获取使用并不现实，因此我们需要预先创建 client 并且获取其 session，后续直接通过 session 来使用 api。

get_telegram_session

拉取脚本「pseudoyu/telegram-api-scripts」后，先运行 npm i 或 pnpm i 安装依赖，然后运行 npm run start 或 node index.js，按照提示输入 api_id 和 api_hash 和手机号（需要和申请 Telegram App 时的手机号一致），通过短信或 Telegram App 获取验证码后即可在命令行输出获取 session。

需要注意的是，由于我们后续需要在 RSSHub 服务中使用这个 session，尽量在 RSSHub 服务部署的同一服务器上运行脚本获取 session，这样能避免 Telegram 对于 IP、设备的一些限制。

注：如果 RSSHub 是使用的 Serverless 平台或其他方式，则也可以通过额外配置 MTProxy 的方式来保持 IP 一致，后文会详细说明。

（可选）使用 MTProxy 保持 IP 一致

之前在 Follow 的 RSSHub 实例上添加了 Telegram API 相关逻辑和配置后，过一会儿就会报一个 AuthKeyDuplicatedError 错误，查看了一下很多开发者也遇到过 —— 「AuthKeyDuplicatedError Eror problem #1488」，猜测是由于我们的 RSSHub 实例是 k8s 集群部署的，会从不同的机器调用 Telegram API，因而受到了一些限制。

于是又开始找针对这一情况的解决方案，发现 Telegram 提供了一种叫 MTProxy 的专属代理协议，可以通过部署一个 MTProxy Server 来代理所有的 API 请求，这样能够确保不同机器发送的请求都来自同一个 IP。

找到了「Dofamin/MTProxy-Docker」这个项目，拉取仓库后，新建一个 .env 文件，添加 MTPROTO_REPO_URL 这一环境变量（默认的官方代码已经不怎么维护，这个版本添加了一些补丁）：

MTPROTO_REPO_URL=https://github.com/GetPageSpeed/MTProxy

SECRET 默认值为 ec4dd80983dbf12d6b354cf7bcfe9a48，也可以选择自定义的值；IP 不填写则会自动通过 curl ifconfig.co 获取本机 IP；其他环境变量可以查看仓库的 README.md 文件自行修改。

配置完成后，运行 docker compose up -d 启动，代理服务则运行在 <IP>:8443 上。

注：如果 RSSHub 是通过 Docker、Docker Compose 等方式单实例进行部署，且能够保障在同一台部署机器上运行脚本获取 Session，则可以跳过这个代理步骤。

经过了上述的服务部署，我们获取了以下信息：

Telegram API 的 api_id 和 api_hash
Telegram 的 session 字符串
MTProxy 的 SECRET、IP、PORT

这时可以开始部署/更新我们的 RSSHub 实例了，具体可以根据文档选择不同的方式，例如 Docker、Docker Compose、Serverless 等。

推荐通过 Docker Compose 的方式来部署，比较便于维护，需要在 docker-compose.yml 的 RSSHub 服务中添加如下变量：

environment:
  - TELEGRAM_API_ID=<Telegram API ID>
  - TELEGRAM_API_HASH=<Telegram API Hash>
  - TELEGRAM_SESSION=<Telegram Session>
  - TELEGRAM_PROXY_HOST=<MTProxy IP，如 123.123.123.123>
  - TELEGRAM_PROXY_PORT=8443
  - TELEGRAM_PROXY_SECRET=<MTProxy SECRET>

我是通过自己维护的模板部署在 Zeabur 平台上的，可视化部署，比较易用，只需要在部署完成后在 RSSHub 服务的 Variables 模块中添加以下变量并重启服务即可生效：

TELEGRAM_API_ID=<Telegram API ID>
TELEGRAM_API_HASH=<Telegram API Hash>
TELEGRAM_SESSION=<Telegram Session>
TELEGRAM_PROXY_HOST=<MTProxy IP，如 123.123.123.123>
TELEGRAM_PROXY_PORT=8443
TELEGRAM_PROXY_SECRET=<MTProxy SECRET>

测试

yu_rsshub_homepage

经过上述步骤后，我们拥有了自己添加了 Telegram 相关配置的 RSSHub 实例，访问主页显示如上页面即部署成功，可以通过 <RSSHub URL>/telegram/channel/<Channel Name> 来订阅 Telegram 频道。

例如可以通过我的公开实例 https://rsshub.pseudoyu.com/telegram/channel/NewlearnerChannel 来订阅「Newlearnerの自留地」频道。

总结

本篇记录了通过 Telegram API 在 RSSHub 中实现对部分受限制频道的更新订阅的开发实践与部署方案，受限于平台，方案可能会在未来某个时刻失效，我们也会持续研究更稳定的解决方案，使用中有任何问题可以留言或在 RSSHub 仓库中提 Issue 反馈/交流。

推荐订阅源

pseudoyu

前言

Telegram 网页预览

Telegram APIs

创建 Telegram App

获取 Telegram Session

（可选） 使用 MTProxy 保持 IP 一致

测试

总结

（可选）使用 MTProxy 保持 IP 一致