Vercel 免费搭建 RSSHub 超详细教程（2026 最新版，新手零门槛）

在信息爆炸的时代，我们每天被各类 App、网页的推送淹没，却很难集中获取关注内容——RSS 订阅正是解决这个问题的利器，而 RSSHub 作为开源的 RSS 生成神器，能将几乎所有网站（社交、新闻、博客、电商等）的内容转化为 RSS 源，让我们通过一款阅读器就能统揽所有关注的动态。

搭建 RSSHub 无需购买服务器，借助 Vercel 的免费额度就能实现零成本部署，全程可视化操作，新手也能在 10 分钟内完成。本文将详细拆解每一步流程，同时解决 2026 年部署中常见的 Node.js 版本冲突、路由访问、环境变量配置等问题，让你快速拥有专属 RSS 服务。

一、前置准备（3 分钟搞定）

搭建前需要准备两个基础账号，均为免费注册，无需实名认证，全程无门槛。

  1. GitHub 账号：用于 Fork RSSHub 源码（RSSHub 托管在 GitHub 上），同时方便与 Vercel 关联，实现自动化部署。注册地址：https://github.com/，直接用邮箱或第三方账号（Google、Apple 等）注册即可。

  2. Vercel 账号：用于免费部署 RSSHub 应用，提供全球 CDN 加速，每月免费额度足够个人使用（无流量限制，仅限制函数执行时间，个人自用完全够用）。注册地址：https://vercel.com/，推荐用 GitHub 账号直接登录，后续可直接导入 GitHub 上的项目，省去授权麻烦。

小提示：Vercel 注册时会让选择计划，直接选「Hobby」（免费计划）即可，无需升级付费版本，个人使用完全满足需求。

二、核心步骤：Vercel 免费部署 RSSHub（关键避坑）

这一步是核心，全程在浏览器操作，无需编写代码，重点解决 2026 年最新的 Node.js 版本冲突问题（很多新手部署失败都是因为这个原因）。

步骤 1：Fork RSSHub 源码到个人 GitHub

  1. 打开 RSSHub 官方 GitHub 仓库：https://github.com/DIYgod/RSSHub；

  2. 点击页面右上角的「Fork」按钮，将源码复制到自己的 GitHub 仓库中；

  3. 关键操作：Fork 时取消勾选「Copy the master branch only」（默认是勾选的），必须取消！因为 RSSHub 最新的 master 分支要求 Node.js 版本 ≥22，而 Vercel 免费计划目前最高仅支持 Node.js 20.x，无法满足要求，我们需要部署兼容低版本 Node.js 的 legacy 分支，取消勾选才能 Fork 所有分支代码。

  4. 等待 1-2 秒，Fork 完成后，会跳转到你个人 GitHub 下的 RSSHub 仓库页面，说明源码复制成功。

步骤 2：将 GitHub 项目导入 Vercel

  1. 登录 Vercel 账号（已用 GitHub 登录的话，直接进入控制台）；

  2. 点击页面右上角的「Add New」→「Project」，进入项目导入页面；

  3. Vercel 会自动关联你的 GitHub 账号，显示你所有的仓库，找到刚才 Fork 的「RSSHub」仓库，点击「Import」导入；

  4. 若未找到仓库，点击「Adjust GitHub App Permissions」，重新设置 GitHub 授权，勾选 RSSHub 仓库的访问权限，返回后即可看到。

  5. 导入后，Vercel 会自动识别项目类型，无需修改默认配置（项目名称可自定义，比如「my-rsshub」），直接点击「Deploy」开始部署。

步骤 3：解决部署失败（Node.js 版本冲突）

2026.03 测试发现master分支已经可以正常部署

此时直接部署大概率会失败（报错提示 Node.js 版本不兼容），因为默认部署的是 master 分支，而 Vercel 不支持该分支要求的 Node.js 22 版本，解决方案如下：

  1. 部署失败后，点击页面中的「Go to Project」，进入项目首页；

  2. 点击顶部导航栏的「Settings」，进入项目设置页面；

  3. 在左侧菜单中找到「Git」，点击进入 Git 配置页面；

  4. 找到「Production Branch」（生产分支），将默认的「master」改为「legacy」，点击「Save」保存；

  5. 设置部署触发：在「Deploy Hooks」区域，填写 Hook 名称（如「legacy-deploy」），分支名称填写「legacy」，点击「Create Hook」；

  6. 创建成功后，会生成一个部署链接，复制该链接并在浏览器中访问，即可手动触发基于 legacy 分支的重新部署；

  7. 等待 1-2 分钟，部署完成后，页面会显示「Deployment Ready」，点击「Visit」即可访问你的 RSSHub 应用。

步骤 4：获取专属 RSSHub 域名

  1. 部署成功后，Vercel 会自动分配一个免费域名（格式为：[项目名]-[用户名].vercel.app），可直接用于访问；

  2. 若想自定义域名，点击项目首页的「Settings」→「Domains」，输入自己的域名（需提前备案），按照提示完成 DNS 解析即可；

  3. 测试访问：在浏览器中输入你的 RSSHub 域名，若能看到 RSSHub 的首页（显示路由列表），说明部署成功。RSSHub没有后台管理功能，所有参数都在环境变量中配置。

image.png

三、进阶配置：优化 RSSHub 体验（可选）

部署完成后，可根据需求配置环境变量，优化访问速度、添加访问控制、解决反爬问题，以下是常用配置（均在 Vercel 中操作）。

1. 配置环境变量（关键优化）

环境变量用于配置 RSSHub 的缓存、代理、访问控制等功能，设置方法如下：

  1. 进入 Vercel 项目的「Settings」→「Environment Variables」（环境变量）页面；

  2. 点击「Add New」，输入环境变量名称和值，选择应用环境（默认全部勾选），点击「Save」；

  3. 设置完成后，必须重新部署项目（点击「Deployments」→「Redeploy」），环境变量才能生效。

常用环境变量推荐（按需配置）：

  • CACHE_TYPE：缓存类型，默认是「memory」（内存缓存），个人使用无需修改；若需要持久化缓存，可配置 Redis（需自行搭建 Redis 服务），填写「redis」并配置「REDIS_URL」；

  • CACHE_EXPIRE：路由缓存过期时间，单位为秒，默认 300 秒（5 分钟），可改为 600 秒（10 分钟），减少请求频率，提升访问速度；

  • ACCESS_KEY：访问密钥，用于限制他人访问你的 RSSHub（防止滥用），设置后，访问 RSS 源时需携带「?key=你的密钥」或生成访问码，具体生成方式可参考 RSSHub 官方文档；配置后访问示例 https://yourexample.com/qdaily/column/59?key=yourACCESS_KEY

  • PROXY_URI：代理地址，部分网站反爬严格（如某些新闻网站），可配置代理解决数据获取失败问题，格式为「http://host:port」；

  • UA：用户代理，模拟浏览器访问，避免被目标网站拦截，可填写「Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36」。

注意：环境变量修改后必须重新部署，否则不生效；敏感信息（如访问密钥、代理账号）会被 Vercel 加密存储，无需担心泄露。

2. 路由使用方法

RSSHub 的核心是「路由」，每个路由对应一个网站的 RSS 源，格式为：你的域名/路由路径。

示例：

  • 知乎热榜：https://你的域名/zhihu/hotlist

  • 微信公众号（需配置 Cookie）：https://你的域名/wechat/mp/公众号ID

  • GitHub 仓库更新：https://你的域名/github/repo/DIYgod/RSSHub

所有支持的路由可参考 RSSHub 官方文档：https://docs.rsshub.app/，也可在你的 RSSHub 首页查看路由列表（开启 DEBUG_INFO 环境变量后可见）。
官方网站国内无法访问，可以访问 镜像站

3. 搭配 RSS 阅读器使用

搭建好 RSSHub 后，需要用 RSS 阅读器订阅生成的 RSS 源，推荐几款常用阅读器：

  • 电脑端：Feedly、Inoreader、Edge 浏览器自带 RSS 阅读器；

  • 手机端：Reeder（iOS）、Flow（Android）、小而美 RSS；

  • 网页端：Miniflux、Tiny Tiny RSS（可自建）。

使用方法：在阅读器中添加「新建订阅」，粘贴你的 RSS 源地址（如 https://你的域名/zhihu/hotlist），即可实时获取内容更新。

四、常见问题排查（新手必看）

部署或使用过程中遇到问题，可按以下步骤排查，覆盖 90% 的常见问题。

1. 部署失败，提示 Node.js 版本错误

原因：未切换到 legacy 分支，master 分支要求 Node.js ≥22，Vercel 免费计划不支持。

解决方案：按步骤 3 操作，切换生产分支为 legacy，重新触发部署。

2. 访问 RSS 源时显示 404 错误

原因：路由路径错误，或 RSSHub 未加载该路由，或环境变量配置错误。

解决方案：

  • 核对路由路径是否正确（参考 RSSHub 官方文档）；

  • 检查是否部署的是 legacy 分支，该分支支持大部分常用路由；

  • 若开启了 ACCESS_KEY，访问时需携带「?key=你的密钥」。

3. 能访问首页，但无法获取 RSS 内容（显示空白或报错）

原因：目标网站反爬、网络问题，或未配置代理。

解决方案：

  • 配置 PROXY_URI 环境变量，使用代理访问；

  • 修改 UA 环境变量，模拟浏览器访问；

  • 查看 Vercel 部署日志（「Deployments」→ 点击对应部署 →「Logs」），定位错误原因。

4. 跨域错误（CORS 错误）

原因：Vercel 环境变量配置不当，导致前端访问跨域。

解决方案：进入 Vercel 环境变量设置，删除「VITE_API_URL」变量（或设为空），重新部署。

5. 域名访问提示“未授权”

原因：部署后未设置公开访问，仅登录 Vercel 账号可访问。

解决方案：在 Vercel 项目首页，点击「Domains」，确保域名状态为「Ready」，若未生效，等待 5-10 分钟（DNS 解析需要时间），或重新部署一次。

五、注意事项（避免踩坑）

  1. Vercel 免费计划的限制：每月函数执行时间 100 小时，个人自用完全足够（RSS 源访问频率低，不会超标）；若超出额度，会暂时停止服务，下月自动恢复。

  2. 不要滥用 RSSHub：避免频繁请求同一网站，否则可能被目标网站封禁 IP，也可能导致 Vercel 账号被限制。

  3. 定期更新源码：RSSHub 会持续更新路由和修复 bug，可在 GitHub 上同步官方仓库的更新，再重新部署 Vercel 项目。

  4. 敏感路由配置：部分路由（如微信公众号、微博）需要配置 Cookie 才能正常获取内容，可在环境变量中添加「COOKIE」字段，具体配置方法参考 RSSHub 官方文档。

六、总结

通过 Vercel 免费搭建 RSSHub，全程零成本、零代码，无需购买服务器，新手也能快速上手。核心是解决 Node.js 版本冲突（切换到 legacy 分支），再根据需求配置环境变量，就能拥有专属的 RSS 生成服务。

搭配一款好用的 RSS 阅读器，就能摆脱信息茧房，集中获取所有关注的内容，提高信息获取效率。如果在部署过程中遇到其他问题，可在评论区留言，或参考 RSSHub 官方文档、Vercel 帮助中心寻找解决方案。

最后，祝大家都能通过 RSS 高效获取信息，不被无效推送打扰～