WMW

title: "手把手教你用Docker部署FreshRSS：自建RSS阅读器图文指南，轻松掌控信息流"
date: "2025-12-06"

FreshRSS 是一款开源且免费的自托管 RSS 聚合器，它能够帮助你将来自不同网站和平台的更新内容集中到一个界面中进行阅读和管理。

Docker Compose 安装与配置

推荐使用 Docker Compose 来快速部署 FreshRSS，这种方式能通过一个配置文件定义所有服务参数，管理起来非常方便。你只需创建一个名为 docker-compose.yml 的文件，并填入以下内容：

services:
  freshrss:
    image: linuxserver/freshrss:latest
    container_name: freshrss
    ports:
      - 8080:80
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    volumes:
      - ./config:/config
    restart: unless-stopped

配置文件中的关键参数说明如下（更多高级选项建议查阅官方文档）：

PUID (环境变量，可选)：用于设置容器内运行进程的用户 ID，关系到文件权限。
PGID (环境变量，可选)：用于设置容器内运行进程的用户组 ID。
TZ (环境变量)：设定容器内的时区，这里设置为 Asia/Shanghai 即中国标准时间。
volumes：将宿主机当前目录下的 ./config 文件夹映射到容器内的 /config 路径，用于持久化保存 FreshRSS 的配置和数据。

FreshRSS 配置与订阅管理指南

完成 Docker Compose 配置后，在终端中运行 docker-compose up -d 命令即可启动服务。接下来，我们通过浏览器完成 FreshRSS 的初始化设置并开始添加订阅。

访问管理界面：在浏览器地址栏输入 http://你的服务器IP地址:8080，即可看到 FreshRSS 的初始设置界面。
选择界面语言：在语言下拉菜单中，选择“中文（简体）”以便于后续操作。
检查环境状态：系统会自动进行环境检查。请确保所有项目前均为绿色的对勾，没有任何错误提示。如果出现权限错误，可能需要调整 Docker 卷的挂载目录权限或 PUID/PGID 设置。
选择数据库类型：对于个人或轻量级使用，直接选择默认的 SQLite 数据库即可，无需额外配置。
创建管理员账户：设置你的管理员用户名和密码，这是后续登录管理后台的凭证。
登录系统：使用刚刚设置的用户名和密码进行登录，进入 FreshRSS 的主界面。
进入订阅管理：点击界面左上角的“订阅管理”按钮，开始添加和管理你的 RSS 源。
创建分类（可选）：如果你的订阅源较多，建议先创建分类（如“科技”、“新闻”、“博客”等），便于后期归类管理。
添加订阅源：在“添加订阅”处，输入有效的 RSS 源地址。很多网站的 RSS 源可能需要特定的网络环境才能访问，此时可以配合自建的 RSSHub 服务来生成订阅源。
示例订阅：例如，这里添加了一个由本地 RSSHub 实例生成的 500px 摄影部落订阅源地址：http://192.168.31.90:1200/500px/tribe/set/f5de0b8aa6d54ec486f5e79616418001。
验证并提交：输入地址后点击“加载”，如果源地址有效，下方会显示该订阅源的标题、描述等信息。确认无误后，点击“提交”按钮完成添加。
管理订阅列表：添加成功后，你可以在订阅列表中看到新加入的源。可以在这里对其进行编辑、启用/禁用或删除操作。
阅读订阅内容：返回 FreshRSS 首页，所有订阅源的最新文章会以流的形式展现出来，你可以在此集中阅读。
查看文章详情：点击任意文章标题，即可在侧边栏或新页面中阅读完整内容。例如，订阅的摄影部落会直接展示图片。
探索更多功能：FreshRSS 还提供了丰富的功能，如文章标记（已读/未读/收藏）、全局搜索、键盘快捷键、扩展插件支持等，等待你去探索和配置。

总结

FreshRSS 作为一款轻量、开源的自托管 RSS 聚合器，是希望高效获取信息、避免被多个平台分散注意力的用户的理想选择。其界面简洁直观，原生支持中文，核心功能涵盖了订阅源的增删改查、分类归档、自动更新抓取以及文章的状态管理，足以满足日常的信息流阅读需求。尤其值得一提的是，它与 RSSHub 这类服务结合使用时，能够将众多不支持原生 RSS 的网站（如社交媒体、视频平台、商品页面等）转化为标准的订阅源，从而极大地拓展了信息的获取边界。

综合推荐指数：⭐⭐⭐（功能实用，但在大众中仍属小众工具） 日常使用体验：⭐⭐⭐（运行稳定，核心功能完备） 部署配置难度：⭐⭐（利用 Docker 后步骤非常简单）