如何在本地安装和配置 FreshRSS 以管理您的订阅源

最后更新: 九月2, 2026
  • FreshRSS 是一个自托管的新闻聚合器,它消除了对外部算法的依赖,并保护了隐私。
  • 它通过与移动和桌面应用程序兼容的 API,实现各种设备之间的完全同步。
  • 它支持多种部署方式,从 Docker 容器到在 LAMP/LEMP 服务器上的手动安装。
  • 它提供诸如通过 XPath 进行网络抓取等高级工具,以跟踪没有原生 RSS 的网站。

木桌上摆放着咖啡、报纸和智能手机,象征着人们在社交媒体算法之外获取信息和新闻。

你可能已经注意到,你获取的大部分新闻都受到社交网络算法的筛选。然而,一种名为 RSS 的技术已经存在了几十年,它使我们能够摆脱算法的束缚,自主选择阅读内容。本质上,RSS 涉及订阅网站发布的通用 XML 源,以便及时收到更新通知。为了更好地管理这些源,使用像 FreshRSS 这样的聚合器是理想之选。

在家搭建自己的新闻源管理器,不仅关乎数字主权和隐私,还能让你拥有一个干净、无广告、井然有序且完全符合你个人喜好的信息流。无论你使用的是功能强大的迷你电脑还是简陋的树莓派,FreshRSS 都是一款轻量级的选择,它能适配任何硬件,让你在一个控制面板中集中管理博客、YouTube 频道和新闻媒体。

Homelab 开源安全
相关文章:
使用开源工具保障家庭实验室安全

FreshRSS究竟是什么?它有哪些优势?

树莓派电路板特写,非常适合用来展示本地 FreshRSS 服务器经济高效的硬件。

我们这里介绍的是一款开源的 RSS 和 Atom 信息聚合器(AGPLv3 许可),您可以将其部署在自己的基础设施上。与 Feedly 或 Inoreader 等云服务不同,FreshRSS完全免费,且对信息源和分类数量没有任何限制,而 Feedly 或 Inoreader 等云服务通常对基本功能设有付费墙。此外,FreshRSS 的资源利用率极高,即使处理数千篇文章也不会降低系统速度。

  Windows 任务管理器:完整实用指南

它最强大的功能包括多用户管理(非常适合与家人共享服务器)以及使用标准 OPML 格式导入和导出订阅的功能。此外,它还包含搜索功能、可根据关键词将文章标记为已读的高级筛选器,以及在您感兴趣的网站没有有效的 RSS 源时通过抓取生成订阅源的功能。

环境要求和准备

一台笔记本电脑在舒适的环境中显示着一行行代码,旁边放着一杯咖啡,这象征着使用 Docker Compose 进行技术安装阶段。

目前最常见的入门方法是使用 Linux 环境。如果选择容器化方案,则需要安装Docker、Docker Compose,以及可选的 Portainer(用于可视化管理)。至于硬件,256 MB 或 512 MB 的内存对于个人用户来说绰绰有余。

Linux 服务器优化
相关文章:
Linux 服务器优化完整指南

如果您倾向于在 Web 服务器上手动安装,则需要 LAMP 或 LEMP 架构(Linux、Nginx/Apache、MySQL/MariaDB 和 PHP 7.4+)。 curl、xml、mbstring 和 zip 等PHP 扩展对于程序的正常运行至关重要。如果您计划从家庭网络外部访问该程序,可以使用 Caddy 或 Nginx Proxy Manager 配置反向代理,或者使用 Tailscale 等工具来避免将服务器暴露在互联网上,而无需复杂的 SSL 证书。

使用 Docker Compose 的分步安装

连接到网络交换机的以太网电缆细节图,展示了本地服务器的网络配置和连接情况。

这是最快捷、最简洁的方法。你只需要创建一个文件。 docker-compose.yml 在您选择的文件夹中。有多种镜像可供选择,其中 Linuxserver 镜像最为简单。一个基本的配置示例包括定义镜像、时区 (TZ) 以及其他设置。 体积映射 这样,当容器重启时,您的数据就不会被删除。

  SparkyLinux Tiamat 及其滚动分支中的新特性

如果您希望在处理海量订阅源时获得卓越的性能,建议使用 PostgreSQL 数据库而不是 SQLite。在配置文件中,您需要添加一个单独的数据库服务,并配置环境变量,以便 FreshRSS 连接到数据库主机。文件准备就绪后,只需运行即可。 docker-compose up -d 该系统将是 在后台运行.

初始设置和微调

智能手机屏幕特写,显示新闻应用程序图标,代表 RSS 源与移动设备的双向同步。

首次使用服务器 IP 地址和配置的端口(例如 8080)访问系统时,您将看到一个 Web 向导。在这里,您可以选择语言、配置管理员帐户并选择数据库类型。对于大多数用户而言,SQLite 简单易用,完全足够;但对于专业部署,PostgreSQL 是更好的选择。

Linux 内核延迟优化
相关文章:
Linux 内核优化及延迟降低进阶指南

进入 FreshRSS 后,您可以通过粘贴网站 URL 来添加订阅源。FreshRSS 非常智能,即使您第一眼没看到 RSS 链接,它通常也能自动检测到订阅源。为了保持内容的条理清晰,创建类别(例如科技、科学、娱乐)并将每个订阅源分配到其中一个类别至关重要,这样可以避免界面变成各种新闻混杂的混乱局面。

与移动和桌面应用程序同步

网页界面功能齐全,但真正的亮点在于将 FreshRSS 与外部应用程序连接起来,例如 Linux 上的 Newsflash、iOS 上的 NetNewsWire 或 Android 上的 Capy Reader。要实现这一点,您需要进入个人资料设置并启用 API 访问权限,为此创建一个专用密码(与您的帐户密码不同)。

  Windows 11 23H2 全新安装:分步指南及从 24H2 降级

FreshRSS 与 Google Reader API 和 Fever API 兼容。配置应用时,您需要输入服务器 URL,包括端口和具体路径(例如, /api/greader.php这样,你就实现了 全双向同步如果您在移动设备上将文章标记为已读,则在您的电脑上也会显示为已读,反之亦然。

进阶技巧:刮擦和维护

当遇到不提供 RSS 源的网站时,您可以使用 HTML + XPath 方法。这种方法允许您使用页面的 HTML 代码提取内容。具体操作方法是:在浏览器中检查元素,复制文章标题和正文的 XPath,然后将其粘贴到 RSS 源设置中。请注意,这种方法不太稳定,如果网站更改其设计,RSS 源将停止工作。

为了确保一切顺利进行,请不要忘记这样做 定期备份 从数据文件夹和 SQLite 数据库中获取数据。此外,建议从维护菜单优化数据库,并通过运行以下命令来更新 Docker 镜像。 docker compose pull 偶尔。

拥有自己的新闻阅读器是通往思想独立的单程票,让您可以不受干扰地筛选信息。FreshRSS 的强大功能、Docker 的灵活性以及同步移动应用的便捷性相结合,为您打造了一个完全由您掌控的私密高效系统,彻底改变您的网络浏览方式。