{"id":20894866,"url":"https://github.com/stilleshan/rssforever","last_synced_at":"2025-10-08T05:18:43.714Z","repository":{"id":50568766,"uuid":"370574703","full_name":"stilleshan/rssforever","owner":"stilleshan","description":"Nginx + TTRSS / FreshRSS + RSSHub 整合 docker 容器化一键部署方案.","archived":false,"fork":false,"pushed_at":"2024-04-18T10:56:19.000Z","size":1085,"stargazers_count":210,"open_issues_count":0,"forks_count":42,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-10T01:12:01.342Z","etag":null,"topics":["rsshub","ttrss"],"latest_commit_sha":null,"homepage":"https://rssforever.com","language":"Shell","has_issues":true,"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/stilleshan.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":"2021-05-25T05:27:53.000Z","updated_at":"2025-03-25T03:28:04.000Z","dependencies_parsed_at":"2024-11-19T03:52:20.454Z","dependency_job_id":null,"html_url":"https://github.com/stilleshan/rssforever","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/stilleshan/rssforever","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stilleshan%2Frssforever","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stilleshan%2Frssforever/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stilleshan%2Frssforever/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stilleshan%2Frssforever/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stilleshan","download_url":"https://codeload.github.com/stilleshan/rssforever/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stilleshan%2Frssforever/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276678838,"owners_count":25684803,"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","status":"online","status_checked_at":"2025-09-23T02:00:09.130Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["rsshub","ttrss"],"created_at":"2024-11-18T10:23:18.063Z","updated_at":"2025-09-24T01:42:11.750Z","avatar_url":"https://github.com/stilleshan.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# rssforever\n## 简介\n本项目为 Nginx + TTRSS / FreshRSS + RSSHub + Watchtower + ACME 整合 docker 容器化快速一键部署方案,支持一键脚本快速安装部署.\n\u003e *一键安装脚本已同时支持 X86 和 ARM 架构*\n\n### 前言\n[rssforever.com](https://rssforever.com) 为网友提供免费的 RSS 和 RSSHub 服务,由于个人精力,服务器压力等因素,无法保证服务的稳定性,所以尽我所能开启这个项目来为新手用户提供一键部署技术支持,特将 Nginx + TTRSS / FreshRSS + RSSHub + Watchtower + ACME 整合到 docker compose 中,并编写脚本,实现一键部署使用.\n\n### 特点\n1. 本项目针对新手用户,提供整合配置,无需繁琐的设置,即使是新手用户最快也只需要几步操作,几分钟即可部署使用.\n2. 使用 docker compose 编排配置,所有命令,配置及环境变量集中管理,方便维护和迁移.\n3. 更换服务器也仅需打包备份一个文件夹,迁移解压后一条命令即可恢复使用.\n\n**一键安装脚本支持以下八种模式,请根据自身情况选择:**\n1. Nginx + TTRSS + RSSHub + Watchtower + ACME 自动申请和续签证书并开启 HTTPS 模式\n2. Nginx + TTRSS + RSSHub + Watchtower + 无证书 HTTP 模式\n3. Nginx + TTRSS + ACME 自动申请和续签证书并开启 HTTPS 模式\n4. Nginx + TTRSS + 无证书 HTTP 模式\n5. Nginx + FreshRSS + RSSHub + Watchtower + ACME 自动申请和续签证书并开启 HTTPS 模式\n6. Nginx + FreshRSS + RSSHub + Watchtower + 无证书 HTTP 模式\n7. Nginx + FreshRSS + ACME 自动申请和续签证书并开启 HTTPS 模式\n8. Nginx + FreshRSS + 无证书 HTTP 模式\n\n### 环境需求\n- 境外 VPS 服务器 ( 国内服务器网络不佳,可能导致无法下载脚本, clone 仓库, docker 拉取等问题 )\n- 拥有自己的域名 ( 托管与 腾讯云 / 阿里云 / Cloudflare 方便申请证书 )\n- 服务器未占用 80/443 端口\n- 服务器已安装 docker 和 docker compose 环境 ( 未安装可参考下文简易安装指南 )\n\n\u003e 本项目不支持已被其他服务占用 80/443 端口的服务器.请停止相关服务或更换新服务器部署使用.  \n\u003e 此项目最多一共会启动 10 个容器,建议 2C2G 及以上配置.  \n\u003e 如果服务器上已有 nginx 等占用 80/443 端口的服务,同时又有部署的需求,请联系我进行付费技术支持.\n\n\n## 安装\n### 更新\n- **2024-04-18** 更新至最新版本.\n- **2022-01-06** 更新脚本支持 FreshRSS, 老版本已转移至`ttrss-rsshub`分支,同样也可以继续使用.\n- **2021-07-01** 更新一键安装脚本同时支持 X86 和 ARM 架构.\n- **2021-06-18** 更新一键安装脚本.\n\n### 前期准备\n- 准备 RSS 和 RSSHub 域名并解析至服务器\n- 参考 [Wiki 页面](https://github.com/stilleshan/rssforever/wiki/dnsapi) 获取域名 DNSAPI 以便脚本申请证书\n\n### 执行脚本\n```shell\nwget https://raw.githubusercontent.com/stilleshan/rssforever/main/install.sh \u0026\u0026 chmod +x install.sh \u0026\u0026 ./install.sh\n```\n\n## 使用\n### TTRSS\n默认账户: admin  \n默认密码: password\n\n### FreshRSS\nFreshRSS 首次访问需要设置数据库类型,选择`PostgreSQL`:\n- 数据库类型：`PostgreSQL`\n- 主机：`db`（不要随意修改，这里的主机名 db 已在 docker-compose.yml 中定义为服务名）\n- 数据库用户名：`freshrss`（不要随意修改，这里的用户名已在 docker-compose.yml 中定义）\n- 数据库密码：脚本随机生成在`rssforever`目录下的`.env`中`POSTGRES_PASSWORD`变量的值`rssforever.com-xxxxx`为数据库密码\n- 数据库：`freshrss`（不要随意修改，这里的数据库名已在 docker-compose.yml 中定义）\n- 表前缀：可留空或填写`freshrss_`\n\n![snapshot01.jpg](images/snapshot01.jpg)\n\n### 更新镜像\n本项目配置有`Watchtower`来监控部分容器的镜像更新.  \nNginx / TTRSS / FreshRSS 的版本在`.env`文件中定义,请谨慎修改更新.  \n如需更新,建议先行备份`rssforever`目录,再执行`docker-compose down`停止服务,修改版本号后再次执行`docker-compose up -d`启动服务.\n\n### 更新证书\n证书每月`1`日自动更新,请执行以下命令来定时每月重启`nginx`服务刷新证书.也可每月手动执行`docker-compose restart`来重启服务.\n```shell\ncrontab -e\n# 添加以下计划任务\n0 0 2 * * docker restart rssforever-nginx-1\n# 为避免时区问题,将在每月 2 号 0 点执行\n```\n\n### 备份恢复\n#### 备份\n本项目采用 docker compose 部署,所有配置及数据都在`rssforever`目录中,方便备份和迁移.\n**rssforever 目录下的文件如不清楚请不要随意修改和删除,否则会导致服务无法启动.**\n```shell\ncd rssforever\n# 进入目录\ndocker-compose down\n# 停止所有服务\n# 手动将整个 rssforever 目录迁移至新服务\n```\n#### 恢复\n将域名重新指向新服务器,将备份的`rssforever`目录解压进入启动即可.\n```shell\ncd rssforever\n# 进入目录\ndocker-compose up -d\n# 启动\n```\n\n## 其他\n### 感谢\n感谢以下大神提供的项目:\n- [Awesome TTRSS 官方文档](https://ttrss.henry.wang/)\n- [Awesome TTRSS GitHub](https://github.com/HenryQW/Awesome-TTRSS)\n- [RSSHub 官方文档](https://docs.rsshub.app/)\n- [DIYgod/RSSHub GitHub](https://github.com/DIYgod/RSSHub)\n\n### 链接\n- [rssforever.com](https://rssforever.com)  \n- [RSSHub 公共服务](https://rsshub.rssforever.com)  \n- [泛域名证书申请相关文章](https://www.ioiox.com/tag/SSL/)\n- [新手教程 Nginx + TTRSS + RSSHub 整合 docker 容器化快速一键部署方案](https://www.ioiox.com/archives/133.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstilleshan%2Frssforever","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstilleshan%2Frssforever","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstilleshan%2Frssforever/lists"}