{"id":13456331,"url":"https://github.com/easychen/rsspush","last_synced_at":"2025-04-08T01:39:51.645Z","repository":{"id":58574766,"uuid":"532179549","full_name":"easychen/rsspush","owner":"easychen","description":"监测RSS变动，并发送最新内容到微信、Webhook 和 Telegram, Discord, Slack, Amazon SNS, Gotify 等数十个消息通道。","archived":false,"fork":false,"pushed_at":"2024-10-02T09:10:14.000Z","size":2807,"stargazers_count":595,"open_issues_count":9,"forks_count":41,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-04-01T00:34:03.701Z","etag":null,"topics":["apprise","docker","docker-compose","rss","rsshub","serverchan"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/easychen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-09-03T06:42:24.000Z","updated_at":"2025-03-23T13:19:39.000Z","dependencies_parsed_at":"2024-01-13T17:48:13.912Z","dependency_job_id":"7bbc81d8-7272-4fba-b4ee-12efdc3b9792","html_url":"https://github.com/easychen/rsspush","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/easychen%2Frsspush","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/easychen%2Frsspush/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/easychen%2Frsspush/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/easychen%2Frsspush/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/easychen","download_url":"https://codeload.github.com/easychen/rsspush/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247761049,"owners_count":20991532,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apprise","docker","docker-compose","rss","rsshub","serverchan"],"created_at":"2024-07-31T08:01:20.012Z","updated_at":"2025-04-08T01:39:51.626Z","avatar_url":"https://github.com/easychen.png","language":null,"funding_links":[],"categories":["Others"],"sub_categories":[],"readme":"# RSSPush\n\nRSSPush 是一款 Web 应用，它可以监测RSS变动，并发送最新内容到微信、Webhook 和 Telegram, Discord, Slack, Amazon SNS, Gotify 等数十个消息通道。\n\n## 最近更新\n\n1. `2024.10.01.10.04`版本更新：添加Feed测试按钮，同时兼容Server酱Turbo和Server酱³的key\n1. `2023.09.03.14.30`版本更新：支持了HTTP代理、支持黑白名单关键词、支持自动翻译Feed为中文\n\n![](image/20220903172550.png)  \n\n## 界面截图\n\n### 登入\n![](image/20220903154531.png)  \n\n### 添加RSS源\n\n![](image/20230903201629.png)\n\n### 管理RSS源\n\n![](image/20220903154732.png)  \n\n### 通过RSSHub工具搜索和选择两千多个RSS源\n\n\u003e 此工具内置的源由全球化项目RSSHub的文档直接生成，使用时请遵守当地法律，RSSPush作者不对因此导致的任何后果负责\n\n![](image/20220903155010.png) \n\n## 视频教程\n\n[![](image/20220907113959.png)](https://www.bilibili.com/video/BV1SK411f7Hq)  \n\n[点击观看](https://www.bilibili.com/video/BV1SK411f7Hq)\n\n## 安装\n\nRSSPush 采用 Docker 方式部署应用，并提供一键安装命令生成界面。\n\n### 环境要求\n\nRSSPush 需要 x86/arm64 架构的 Docker环境，请预先安装好 Docker 和 Docker-compose。如果你使用[腾讯云的Ubuntu18.04/20.04](https://curl.qcloud.com/VPjlS4gj) 也可以通过一键安装命令来自动安装。\n\n### 生成安装命令\n\n点这里进入[命令生成界面](https://install.ftqq.com/config/rsspush)\n\n![](image/20220903151612.png)  \n\n在管理密码一栏，输入你想要设置的密码。然后：\n\n1. 点击「短安装命令」，会生成一个简版命令，此命令在服务器上创建一个`docker-compose.yml`文件，并通过`docker-compose`命令启动它\n1. 点击「生成安装命令·含Docker环境」，则除了「短安装命令」的内容，还会包含（在Ubuntu上）安装Docker和Docker-compose的命令\n\n如果你在其他系统上安装，可以通过「查看、下载、复制 docker-compose 文件」，然后再运行 `docker-compose` 命令来手工安装。\n\n### 运行安装命令\n\n进入云服务器的命令行（ [教程](https://www.bilibili.com/video/BV1kU4y1j73Q) ），粘贴上边复制的命令，按回车即可。\n\n## 配置\n\n你可以通过环境变量对镜像做进一步配置。\n\n```yml\nversion: '3'\nservices:\n  rsspush:\n    image: easychen/rsspush\n    volumes:\n      - \"./data:/rsspush/api/data\"\n    environment:\n      - ADMIN_KEY=admin\n      - RSS_BASE=http://rsshub:1200\n      - TZ=Asia/Chongqing\n      #- HTTP_PROXY=http://your-proxy-ip:1087\n      - OPENAI_KEY=fk...\n    ports:\n      - 8000:8000\n  rsshub:\n    image: diygod/rsshub\n    ports:\n      - 1200:1200\n```\n\n你可以通过环境变量对RSSPush进行调整：\n\n1. `ADMIN_KEY`：管理密码\n1. `RSS_BASE`：RSSHUB工具中默认的服务器地址\n1. `HTTP_PROXY`：fetch rss时可支持的HTTP代理，注意IP要容器内可以访问，不要用127.0.0.1这种环回地址\n1. `OPENAI_KEY`：OpenAI/API2D的Key，翻译会用到\n1. `OPENAI_API_BASE`：自定义OpenAI API的入口，不需要加 `/v1/...` 部分\n1. `TRANSLATE_MAX_LEN`：参与翻译的Markdown最大长度，默认为8000字符，超过部分截断\n\n默认情况下，docker-compose命令还部署了一个本地RSSHub（一个包含两千多个订阅源的RSS工具），以方便大家使用。\n\n你亦可以通过 RSSHub 的环境变量对实例进行调整，可参考[这个文档](https://docs.rsshub.app/install/#pei-zhi-wang-luo-pei-zhi)🪜。\n\n```yml\nversion: '3'\nservices:\n  rsspush:\n    image: easychen/rsspush\n    volumes:\n      - \"./data:/rsspush/api/data\"\n    environment:\n      - ADMIN_KEY=admin\n      - RSS_BASE=http://rsshub.app\n      - TZ=Asia/Chongqing\n      #- HTTP_PROXY=http://your-proxy-ip:1087\n      - OPENAI_KEY=fk...\n    ports:\n      - 8000:8000\n  rsshub:\n    image: diygod/rsshub\n    ports:\n      - 1200:1200\n    environment:\n      - CACHE_TYPE=memory\n```\n\n如果你不使用RSSHub或者使用RSSHub官方的服务器，可以注释掉rsshub部分的内容，这样将不会本地启用RSSHub。\n\n```yml\nversion: '3'\nservices:\n  rsspush:\n    image: easychen/rsspush\n    volumes:\n      - \"./data:/rsspush/api/data\"\n    environment:\n      - ADMIN_KEY=admin\n      - RSS_BASE=http://rsshub.app\n      - TZ=Asia/Chongqing\n      #- HTTP_PROXY=http://your-proxy-ip:1087\n      - OPENAI_KEY=fk...\n    ports:\n      - 8000:8000\n#   rsshub:\n#     image: diygod/rsshub\n#     ports:\n#       - 1200:1200\n#     environment:\n#       - CACHE_TYPE=memory\n```\n## 使用\n\n### 登入\n\n`docker-compose`命令正确启动以后，请访问 `${服务器公网IP}:8000` 进入管理界面。\n\n\u003e 如果访问不了，有两种情况 ① 服务启动需要时间，可多等几分钟再试 ② 服务器防火墙配置没有放开8000端口，请手工放开8000端口\n\n输入在 `docker-compose.yml` 中指定的管理密码( ADMIN_KEY )，即可进入。\n\n### 添加任务\n\n点击右上角导航菜单中的 `添加` 进入任务添加界面.\n\n![](image/20220903154905.png)  \n\n只有三个值需要我们确认：\n\n1. Feed URL：RSS地址，输入后可以点击后边的「测试」按钮，查看服务器能够抓取到Feed内容。有时候因为机房网络问题，在你电脑上可以获取到的Feed，在机房不一定能获取到。\n1. 监测间隔时间：每隔多久监测一次，默认是60分钟。如果希望每分钟都监测，可以填0。\n1. SendKey：RSSPush使用[Server酱](https://sct.ftqq.com?fr=rsshub)将监测到的内容推送到微信，因此我们需要申请一个Sendkey。\n\n#### 如何获得 SendKey\n\n登录[Server酱官网](https://sct.ftqq.com?fr=rsshub)，进入「[Key\u0026API](https://sct.ftqq.com/sendkey)」，点击「复制」按钮即可。\n\n![](image/20220903160103.png)  \n\n##### 如何推送到其他通道\n\n登录[Server酱官网](https://sct.ftqq.com?fr=rsshub)，进入「[通道配置](https://sct.ftqq.com/forward)」，选择要推送的通道，并按页面上的说明进行配置。可以将消息推送到「PushDeer」和各种群机器人。\n\n![](image/20220903160135.png)  \n\n如果以上通道不能满足你的需要，可以选择「自定义」通道，发送自定义的http请求。此方式可以兼容绝大部分通知接口。\n\n![](image/20220903160155.png) \n\n注意每一个微信账户可以绑定一个Sendkey。如果你想要把监测到的RSS更新推送给多人，那么可以让他们到[Server酱官网](https://sct.ftqq.com?fr=rsshub)生成Sendkey，然后交给你填入这里，多个Sendkey一行填一个。\n\n![](image/20220903160540.png) \n\n##### 如何推送到WebHook\n\n2022.09.04.09.28+ 以后的镜像支持推送到web hook。如果Sendkey以http开头，则被识别为一个webhook。\n\n```\n  SCT1U....\n  https://mywebhook.com\n```\n\nRSSPush 会将更新信息以 FORM-ENCODED 编码方式 POST 到这个地址，包含以下信息：\n\n  1. title/text: 最新文章的标题\n  1. desp: 文章的详细内容\n  1. link: 文章的链接\n  1. task_id: 任务ID\n  1. task_title: 任务标题\n  \n##### 通过 Apprise 推送更新\n\n2022.09.10.05.31+ 以后的镜像支持通过 [Apprise](https://github.com/caronc/apprise) 推送更新消息到上百个通道，包括Telegram, Discord, Slack, Amazon SNS, Gotify等。\n\n如果sendkey 以 `apprise `（注意后边有一个半角空格） 开头，则被识别为一个 Apprise 命令。\n\n以 Telegram bot 为例，如果想通过 Apprise 推送，可在其仓库页面搜索 telegram，然后可以看到其命令格式为：\n\n```\ntgram://bottoken/ChatID\ntgram://bottoken/ChatID1/ChatID2/ChatIDN\n```\n\n点击同一行的 Telegram 链接，可以进入详细的配置页面，会告知如何获取`bottoken`和`ChatID`。得到对应的实际值后，可在Sendkey输入框加入一行\n\n```\napprise -i markdown tgram://bottoken/ChatID\n```\n\nRSSPush 会自动添加后边的 -t 和 -d 参数，因此不用再添加。其他参数可以查询 apprise 命令行获知。\n\n其中 `-i` 参数指定了原始内容格式，如果你希望最终通知呈现想要的结果，请按 RSS 中的类型指定。默认为 `text`，可指定为 `html` 或者 `markdown` \n\n默认情况下，RSSPush 向 Apprise 推送的 RSS 内容为转义后的 Markdown 格式。如需推送原始的内容（多为HTML），可使用 `apprise:raw` 命令（ 镜像 2022.09.15.13.30+ 支持），如：\n\n```\napprise:raw -i html tgram://bottoken/ChatID\n```\n\n这里依然需要按照 RSS 中原始内容格式来进行指定，因此使用 `-i html`。\n\n### 使用RSSHub Feed生成助手\n\nRSSHub是一个包含了两千多个订阅源的RSS工具，为了方便大家添加有用的RSS源，我们整理了它的文档，并制作了一个可以搜索和选择，按提示填写参数后可以自动生成最终Feed的小工具。\n\n默认情况下，这个工具是关闭的，可以点击「展开RSSHub工具」按钮启用。\n\n![](image/20220903154905.png)  \n\n然后我们就可以看到小工具的界面了。\n\n![](image/20220903155010.png) \n\n点击「请选择」下拉框，向下滚动鼠标，可以浏览两千多个信息源；同时，你也可以直接输入关键字，比如「漫画」、「图片」等，下拉菜单会自动只显示匹配的选项。\n\n选中你需要的RSS源以后，一些支持参数的源会显示参数和提示，可以按提示填入参数。\n\n![](image/20220903161516.png)  \n\n比如图中如果我们关心的是`手办`分类，那么就在有`type`字样开头的输入框中输入hobby，然后点击「生成RSS Feed地址」。工具会帮我们自动生成Feed地址，并填入下边的RSS Feed URL输入框中。\n\n#### RSSHub 服务器地址\n\n如果你在 `docker-compose.yml` 中启动了本地RSSHub服务，那么「RSSHub服务器地址」无需修改（ http://rsshub:1200 ）；如果你没有启动本地服务，那么可以填入其他RSSHub服务器的地址，比如官方的`https://rsshub.app`🪜。\n\n### 管理任务\n\n点击右上角导航中的「列表」，可以对已经添加的RSS源进行管理：\n\n![](image/20220903154732.png) \n\n\n## 运行数据\n\n在运行 `docker-compose` 命令的同级目录，会创建一个 `data` 子目录，其中包含任务清单 `tasks.json` 和定时任务日志 `cron.txt`，可用于数据导入导出和任务状态确认。\n\n\n\n\n\n \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feasychen%2Frsspush","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feasychen%2Frsspush","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feasychen%2Frsspush/lists"}