黑海洋 黑海洋 WIKI

RSSHub 公共实例整理与自建教程

资源 · 约 8 分钟 · 黑海洋 · 872

简介

RSSHub 是一个开源的 RSS 生成器,能给本身没有 RSS 的网站(B 站、微博、GitHub Trending、Telegram 频道等)生成订阅源。不想自己搭服务时,可以直接用别人公开的实例;但公共实例共享资源、随时可能失效,长期使用最好自建。

本文记录 4 个实测可用的公共实例,以及一份从零开始的自建教程,方便日后查阅。

可用的公共实例

以下 4 个实例在 2026-10-31 实测可以使用,均来自 RSSHub 官方公共实例列表。

实例地址

服务器位置

维护者

https://rsshub.rssforever.com

阿联酋

Stille

https://hub.slarker.me

美国

Slarker

https://rsshub.ktachibana.party

美国

KTachibanaM

https://rsshub.isrss.com

美国

isRSS

位置与维护者信息取自官方列表,该列表本身更新不频繁,仅供参考。

怎么用

把官方文档里的 https://rsshub.app 换成上表任意一个地址即可,路由部分不变。例如订阅 GitHub 每日 Trending:

https://rsshub.rssforever.com/github/trending/daily

路由大全见 RSSHub 路由文档。

使用技巧与注意事项

公共实例是志愿者提供的,稳定性没有保证,订阅前先做好这几件事:

  • 先测再订:打开实例首页,再请求一条简单路由(如 /github/trending/daily),确认能返回内容。
  • 别只靠一个:多个实例轮换使用,某个挂了就换。社区反馈公共实例经常出问题,域名过期后还可能被他人接管,地址要定期复查。
  • 反爬严格的站点基本不行:微博、Twitter/X、知乎等通常需要自己的 cookie,只能自建后配置。
  • 隐私:公共实例的运营者能看到你的请求,不要往 URL 里放私人 token。
  • 自动容错:可以部署 rsshub-never-die,它在多个实例之间做负载均衡和故障切换,订阅里只写一个地址。

rsshub-never-die 的实例配置示例(权重越大,被选中概率越高):

RSSHUB_NODE_URLS='https://rsshub.rssforever.com|weight=2, https://hub.slarker.me|weight=3, https://rsshub.ktachibana.party, https://rsshub.isrss.com'

自建 RSSHub 教程

推荐用 Docker 自建,最快 1 分钟跑起来。下面三步从简到全,配置细节以官方部署文档为准。

前提

  • 一台能跑 Docker 的机器(VPS、NAS、家里的小主机均可;放在家宽网络对反爬更友好)
  • 已安装 Docker 与 Docker Compose
  • 想对外访问时,准备一个域名

方式一:一行命令

docker run -d --name rsshub -p 1200:1200 diygod/rsshub

浏览器打开 http://服务器IP:1200,看到 RSSHub 首页即成功。再访问 http://服务器IP:1200/github/trending/daily 验证路由。

需要用到 Puppeteer 的路由(要无头浏览器渲染的站点),换成内置 Chromium 的镜像:

docker run -d --name rsshub -p 1200:1200 diygod/rsshub:chromium-bundled

方式二:Docker Compose(推荐)

加上 Redis 缓存,重复请求更快,也更不容易被目标网站限流。新建 docker-compose.yml:

services:
  rsshub:
    image: diygod/rsshub
    container_name: rsshub
    restart: always
    ports:
      - "1200:1200"
    environment:
      NODE_ENV: production
      CACHE_TYPE: redis
      REDIS_URL: "redis://redis:6379/"
      CACHE_EXPIRE: 600
    depends_on:
      - redis

  redis:
    image: redis:alpine
    container_name: rsshub-redis
    restart: always
    volumes:
      - redis-data:/data

volumes:
  redis-data:

启动与日常维护:

docker compose up -d          # 启动
docker compose logs -f rsshub # 看日志
docker compose pull && docker compose up -d   # 更新到最新版

要支持 Puppeteer 路由,可以改用 diygod/rsshub:chromium-bundled 镜像,或另加一个浏览器服务并设置 PUPPETEER_WS_ENDPOINT,具体写法参考官方 Compose 示例。

常用环境变量

在 environment 下添加。完整列表见官方配置文档。

变量

作用

PORT

监听端口,默认 1200

CACHE_TYPE / REDIS_URL

缓存类型与 Redis 地址

CACHE_EXPIRE

缓存时间(秒),调大可减少对目标站的请求

ACCESS_KEY

访问密钥,设置后请求需带 ?key=密钥

GITHUB_ACCESS_TOKEN

提高 GitHub 相关路由的 API 额度

PROXY_URI

给被墙或限制地区的站点配置代理

微博、知乎、B 站等站点需要登录态的路由,还要按各路由文档配置对应的 cookie 变量,这是自建最大的好处。

对外访问:域名与反向代理

不建议直接暴露 1200 端口。用 Caddy 可以自动签发 HTTPS 证书,配置只要两行:

rss.example.com {
    reverse_proxy 127.0.0.1:1200
}

用 Nginx 的话:

server {
    listen 80;
    server_name rss.example.com;

    location / {
        proxy_pass http://127.0.0.1:1200;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Nginx 方案再用 certbot 申请证书即可。

其他部署方式

没有服务器时,也可以部署到 Vercel、Railway、Zeabur 等平台,步骤见官方部署文档。免费额度和稳定性各有限制,Puppeteer 路由通常不支持。

公开前的安全检查

  • 设置 ACCESS_KEY,避免实例被陌生人当免费代理刷
  • 只用 HTTPS 对外提供服务
  • cookie、token 只放环境变量,别写进公开仓库
  • 定期 docker compose pull 更新,路由经常随目标网站变化而修复

备忘清单与参考

常见问题

现象

可能原因与处理

订阅突然没更新

公共实例挂了或限流,换一个实例地址再试

返回 403 / 反爬提示

目标站拦截了机房 IP,需自建并配置 cookie 或代理

路由 404

路由已变更或下线,查最新路由文档

自建后页面打不开

检查防火墙是否放行端口,docker compose logs rsshub 看报错

备忘

  • 订阅前用浏览器测试路由能否返回内容
  • 每个订阅至少备一个备用实例
  • 有条件就自建,并设置 ACCESS_KEY
  • 定期复查实例是否仍可用

参考链接

相关文档

评论与补充0

有问题或想补充的,写在下面 · 选中正文文字再点「报告错误」会自动引用

还没有评论。有疑问、补充,或者发现错字,都可以写在下面。

就事论事,别发广告 · 正常评论