RSSHub 是个很赞的项目,它聚集了众多 RSS 爱好者来为现代的网站构建 RSS 订阅源。众所周知,网站提供 RSS 并不能为他的站点带来更高的收入,反而会减少主站的访客数因此可以借助 RSSHub 可以方便地通过 RSS 订阅知乎、豆瓣、Facebook 等现代媒体社交平台。
部署前置环境::
部署 RSSHub 最直接的方式就是手动部署,可以按照以下步骤将 RSSHub 部署在您的电脑、服务器或者其他任何地方。
首先是下载 RSSHub 的源码:
$ git clone https://github.com/DIYgod/RSSHub.git
$ cd RSSHub
下载完成后,需要安装依赖(开发不用加 --production 参数)。
使用 npm:
$ npm ci --production
或 yarn:
$ yarn install --production
由于众所周知的原因,在国内使用 npm 下载依赖十分缓慢,建议挂一个代理或者考虑使用 NPM 镜像。
然后在 RSSHub 文件夹中运行下面的命令就可以启动:
$ npm start
或
$ yarn start
在浏览器中打开 http://127.0.0.1:1200/。
详细使用说明参照 指南 (opens new window),替换所有路由例子中的 https://rsshub.app/ 为 http://localhost:1200 即可正常使用。
可以通过设置环境变量来配置 RSSHub:
在项目根目录新建一个 .env 文件,每行以 NAME=VALUE 格式添加环境变量,例如:
CACHE_TYPE=redis
CACHE_EXPIRE=600
注意它不会覆盖已有的环境变量,更多配置项请看 配置
手动部署方式不包括 puppeteer 和 redis 依赖,如有需要请改用 Docker Compose 部署方式或自行部署外部依赖。
在 RSSHub 文件夹中运行下面的命令就从 github 仓库拉取最新版本即可:
$ git pull
部署前置环境:
默认推荐使用diygod/rsshub即diygod/rsshub:latest最新版镜像以获取最新路由。 当diygod/rsshub:latest存在问题时,可以使用以日期为标签的近期镜像临时使用,例如:
$ docker pull diygod/rsshub:2021-06-18/diygod/rsshub:latest
待最新镜像更新后在切换回diygod/rsshub:latest最新版镜像。
运行下面的命令下载 RSSHub 镜像:
$ docker pull diygod/rsshub
然后运行 RSSHub 容器即可:
$ docker run -d --name rsshub -p 1200:1200 diygod/rsshub
在浏览器中打开 http://127.0.0.1:1200/。
docker删除旧容器,然后拉取新镜像再生成容器:
$ docker stop rsshub
$ docker rm rsshub
或者进入容器对RSSHub版本进行升级。
配置运行在 docker 中的 RSSHub,最便利的方法是使用 docker 环境变量。
以设置缓存时间为 1 小时举例,只需要在运行时增加参数:-e CACHE_EXPIRE=3600:
$ docker run -d --name rsshub -p 1200:1200 -e CACHE_EXPIRE=3600 -e GITHUB_ACCESS_TOKEN=example diygod/rsshub
该部署方式不包括 puppeteer 和 redis 依赖,如有需要请改用 Docker Compose 部署方式或自行部署外部依赖。
部署前置环境:
赋予 Docker Compose 目录相应权限,在特定目录新建 Docker Compose 配置文件,并编辑。
sudo chmod +x /usr/local/bin/docker-compose
创建docker-compose文件:
touch docker-compose.yml
编辑docker-compose配置文件:
version: '3'
services:
rsshub:
image: diygod/rsshub
restart: unless-stopped
ports:
- '1200:1200'
environment:
NODE_ENV: production
CACHE_TYPE: redis
REDIS_URL: 'redis://redis:6379/'
PUPPETEER_WS_ENDPOINT: 'ws://browserless:3000'
depends_on:
- redis
- browserless
browserless:
image: browserless/chrome:1.43-chrome-stable
restart: unless-stopped
redis:
image: redis:alpine
restart: unless-stopped
volumes:
- redis-data:/data
volumes:
redis-data:
保存退出后,可先前台执行观察输出,若确认无误后便可置于后台持续运行。
先前台执行观察输出:
docker-compose up
确认无误后后台持续运行:
docker-compose up -d
删除旧容器:
$ docker-compose down
如果之前已经下载 / 使用过镜像,下方命令可以帮助你获取最新版本:这可能可以解决一些问题。
$ docker pull diygod/rsshub
然后重复安装步骤。
修改 docker-compose.yml (opens new window)中的 environment 进行配置。
通过上面三种部署,我们就已经安装好了服务使用方式如下:
在上文中我们通过三种不同的方式部署了RssHub服务,这里有个前提,就是自建 RSS 阅读器与自建 RSSHub 需要在同一内网内,这样才可以本地调用。如果要再外网使用需要将服务部署到云端并配置好域名。
如果不想去费时间搭建RSSHub,那么可以直接使用别人搭建好的。
https://rss.shab.fun/
https://rss.injahow.cn/
http://i.scnu.edu.cn/sub
http://rsshub.sksren.com/
https://rsshub-7x3pyolbs.vercel.app/
如果侵权请联系笔者删除。
参考资料:
私有化部署 RSSHub 服务