selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
rsspush logo

Self-host rsspush

2024.10.01.10.04

Watch RSS feeds and push updates to WeChat or messengers

BetaOpen Source
Updated2 years ago
Setup difficultyEasy
Stars
621
CPU
x86/arm64 架构的 Docker环境
Port
8000 (RSSPush 管理界面(Web UI)监听端口)
Docker
easychen/rsspush
Install with Docker Compose
登录界面添加 RSS 监测任务的界面RSS 任务列表管理界面内置的 RSSHub 源搜索与 Feed 生成工具任务添加界面(Feed 测试按钮等)

What is rsspush?

RSSPush 是一个自托管的 Web 应用,用于监测 RSS 订阅源的更新并把最新文章推送给你常用的通知渠道。它通过 Server酱 把内容发到微信,也支持把 Sendkey 写成 http 开头的地址来接收 form-encoded 的自定义 webhook,或以 apprise 前缀调用 Apprise,从而送达 Telegram、Discord、Slack 等上百个消息渠道(含 Amazon SNS 与 Gotify)。功能上支持定时监测(默认 60 分钟间隔,填 0 可每分钟检查)、Feed 连通性测试、黑白名单关键词过滤、HTTP 代理抓取,以及借助 OpenAI Key 自动把 Feed 翻译成中文;内置一个基于 RSSHub 文档的源搜索工具,可浏览两千多个订阅源并自动生成 Feed 地址。部署上以 Docker Compose 镜像 easychen/rsspush 运行,通过环境变量配置,Web 界面默认在 8000 端口并用 ADMIN_KEY 密码登录,compose 默认还会附带一个本地 RSSHub(可注释掉改用官方实例),任务数据保存在挂载的 data 目录(tasks.json、cron.txt)。仓库未声明许可证,最后更新为 2024 年 10 月。

Should you self-host rsspush?

rsspush scores 42/100 on selfhost.directory (how scoring works) and ranks #4 of 4 in RSS. It has 621 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. An official Docker image is available.

Its closest alternative on selfhost.directory is RSS-Bridge (74/100, 9 322 stars). It scores higher overall, so compare the two before you pick. See rsspush vs RSS-Bridge side by side.

Features

  • Apprise notification channels
  • Automatic feed translation
  • Custom webhook delivery
  • Feed reachability test
  • HTTP proxy support
  • Keyword Filtering
  • Multiple Recipients
  • RSS Feed Monitoring
  • Task management UI
  • WeChat push notifications

rsspush README

How to install rsspush

Install rsspush with Docker Compose

Environment variables
ADMIN_KEY, RSS_BASE, HTTP_PROXY, OPENAI_KEY, OPENAI_API_BASE, TRANSLATE_MAX_LEN
version: '3'
services:
  rsspush:
    image: easychen/rsspush
    volumes:
      - "./data:/rsspush/api/data"
    environment:
      - ADMIN_KEY=admin
      - RSS_BASE=http://rsshub:1200
      - TZ=Asia/Chongqing
      #- HTTP_PROXY=http://your-proxy-ip:1087
      - OPENAI_KEY=fk...
    ports:
      - 8000:8000
  rsshub:
    image: diygod/rsshub
    ports:
      - 1200:1200

x86/arm64 的 Docker 环境,需预先安装 Docker 与 docker-compose;管理界面为 ${服务器公网IP}:8000

How to configure rsspush

  • ADMIN_KEY管理密码(admin password for the web UI)

    管理密码(admin password for the web UI)

  • HTTP_PROXY抓取 RSS 时可用的 HTTP 代理(IP 需容器内可访问,勿用 127.0.0.1)

    抓取 RSS 时可用的 HTTP 代理(IP 需容器内可访问,勿用 127.0.0.1)

  • OPENAI_API_BASE自定义 OpenAI API 的入口,不需要加 /v1/... 部分

    自定义 OpenAI API 的入口,不需要加 /v1/... 部分

  • OPENAI_KEYOpenAI/API2D 的 Key,Feed 翻译功能会用到

    OpenAI/API2D 的 Key,Feed 翻译功能会用到

  • RSS_BASERSSHub 工具中默认的 RSSHub 服务器地址

    RSSHub 工具中默认的 RSSHub 服务器地址

  • TRANSLATE_MAX_LEN8000参与翻译的 Markdown 最大长度,超出部分截断

    参与翻译的 Markdown 最大长度,超出部分截断

More in RSS

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…