先说清楚:RSS 过时了吗
算法推荐流解决的是「平台想让你看什么」,RSS 解决的是「你自己想看什么」。博客、播客、新闻站、GitHub 项目动态、视频站更新——凡是支持 RSS 输出的源,订阅之后按时间顺序全部汇到一个页面,没有广告、没有信息茧房、没有「猜你喜欢」。
自建 RSS 阅读器的意义在于:订阅列表和阅读记录是你自己的数据,不怕哪天某个阅读器服务关停或收费。FreshRSS 是目前最活跃的开源自建阅读器:界面清爽、支持多用户、扩展丰富,还提供 Google Reader 兼容 API,能喂饱几乎所有移动端阅读 App。一次部署,所有设备共用同一份订阅和已读状态。
主线:Compose 部署 → 走完安装向导 → 导入订阅并分类 → 设定时刷新 → 开 API 接手机客户端 → 日常排障。
Compose 部署与数据库选型
services: freshrss: image: freshrss/freshrss:latest container_name: freshrss restart: unless-stopped environment: TZ: Asia/Shanghai volumes: - ./data:/var/www/FreshRSS/data - ./extensions:/var/www/FreshRSS/extensions ports: - "127.0.0.1:8081:80"启动后在 Nginx Proxy Manager 里给它配一个域名和 HTTPS,方法与系列其他服务一致,见 Nginx Proxy Manager:所有自建服务的统一入口。
FreshRSS 支持三种数据库,安装向导里选:
| 数据库 | 适合场景 | 说明 |
|---|---|---|
| SQLite | 个人使用(默认推荐) | 零配置,数据就在 data 目录里 |
| MySQL / MariaDB | 多用户、订阅量大 | 需要额外数据库容器 |
| PostgreSQL | 已经有 PG 在跑时顺手用 | 性能好,配置略多 |
个人使用直接选 SQLite 就够了,几千个订阅毫无压力,而且备份时整个 data 目录打包带走就行,不用单独导数据库。
mkdir -p ~/freshrss && cd ~/freshrssdocker compose up -d安装向导与初始设置
打开域名,进入安装向导:选语言(简体中文)→ 检查环境(全绿才继续)→ 选数据库(SQLite)→ 创建管理员账号。装完登录进去,先到「设置 → 系统」里确认两件事:
- 站点标题和时区:时区不对会导致文章时间显示错乱;
- 是否开放注册:默认只留自己用的话,到「设置 → 用户」确认不允许公开注册,道理和系列里反复强调的一样,见 自建服务安全加固:最小暴露与访问控制。
界面可以在「设置 → 显示」里换主题,深色主题晚上看长文舒服很多;每页文章数、阅读模式(标题列表/展开全文)按个人习惯调。
订阅管理:分类、导入与整理
点左上角「订阅管理 → 添加订阅源」,粘贴站点地址或 RSS 地址,FreshRSS 会自动探测源。整理订阅的关键是分类,建议按「每天必看 / 资讯 / 技术 / 更新提醒」粗分四到六个,不要一上来建二十个分类,最后自己都不想点开。
已有阅读器迁移过来:旧服务导出 OPML 文件,在「导入/导出」里一键导入,订阅和分类结构完整保留。反过来,FreshRSS 也能随时导出 OPML,保证你永远可以带着订阅列表走人,这是自建的核心价值之一。
几个让阅读体验质变的小设置:
- 对更新太频繁的源,在订阅设置里开启「标记为已读策略」:比如打开页面即标记、或超过 N 天自动标记;
- 对只给摘要的源,可以试「抓取原文」功能(订阅设置里的 XPath 抓取),把全文拉回本地读;
- 星标和标签用来攒长文,周末统一清。
定时刷新:最容易漏的一步
FreshRSS 本身不会在后台自动拉取,必须配一个定时任务周期性地执行刷新脚本,否则你打开页面看到的永远是上次手动刷新时的内容。漏配这一步是新手最常见的「为什么订阅不更新」。
在宿主机上加一条 crontab:
crontab -e写入(每 15 分钟刷新一次):
*/15 * * * * docker exec freshrss php /var/www/FreshRSS/app/actualize_script.php > /dev/null 2>&1WARNING注意:刷新脚本要以容器内 Web 服务相同的用户身份执行才不会把数据文件属主弄乱。用宿主机 cron 通过
docker exec调用时,如果刷新后出现「数据库不可写」之类报错,多半是属主问题——进容器看data目录属主是否为www-data,不一致就docker exec freshrss chown -R www-data:www-data /var/www/FreshRSS/data修回来。不要图省事长期用 root 在宿主机上直接改容器数据目录里的文件。
也可以把每个订阅源的刷新间隔单独调:重磅源保持默认,低频博客在订阅设置里改成每天拉一次,减轻服务器和对方站点的压力。
开启 API:接入手机客户端
FreshRSS 的杀手锏是 API。到「设置 → 账户 → API 管理」:
- 给 API 单独设一个API 密码(和登录密码相互独立);
- 勾选允许 API 访问;
- 你的 API 地址就是
https://你的域名/api/greader.php。
之后在手机阅读 App(Reeder、NetNewsWire、FeedMe 等支持 Google Reader API 的客户端)里选择「FreshRSS / Google Reader」类型,填服务器地址、账号和 API 密码,就能同步全部订阅和已读状态。通勤路上用手机刷掉资讯类,回家电脑上打开只剩长文,这个工作流非常顺手。
如果以后想在 FreshRSS 里聚合其他类型的信息流,社区还有各种扩展,装到 extensions 目录后在「设置 → 扩展」启用即可。
订阅源从哪来:把日常信息入口都收进来
装好阅读器之后,最大的问题往往是「不知道订什么」。几个实用的来源思路:
- 常看的博客和独立站:绝大多数个人博客都自带 RSS,在网址后试
/feed、/rss.xml、/atom.xml,或者把网址直接粘进 FreshRSS 让它自动探测; - GitHub 动态:项目 Releases、某个仓库的 commits 都有 Atom 输出,关注的开源项目发新版第一时间知道,格式形如
https://github.com/作者/仓库/releases.atom; - 播客:播客本质就是带音频附件的 RSS,在 FreshRSS 里订阅后能看到更新列表,点开跳转收听;
- 视频站与公众号类:这类平台官方 RSS 支持较弱,社区有 RSSHub 这类开源的「RSS 生成器」项目,可以自建一个把各类站点转成 RSS 再喂给 FreshRSS,自建 RSSHub 本身也是一个简单的 Docker 容器,和 FreshRSS 放在同一台机器上正好配套;
- 别人的 OPML 分享:技术圈经常有人分享自己的订阅清单 OPML 文件,导入后挑感兴趣的留,其余删掉,是冷启动最快的方式。
订阅数量的经验值:总数控制在 100 个以内、每天新增文章不超过 200 篇,阅读压力就不会失控。RSS 的目的是「不错过」,不是「全看完」,已读焦虑大可不必——一周没看的资讯类文章,一键全部标记已读,世界不会塌。
阅读工作流与多用户
键盘快捷键值得花五分钟熟悉:j/k 上下篇、空格展开、m 标记已读、s 星标。资讯类文章用这个流速每分钟能过几十篇标题,只把真正感兴趣的点开。
星标即稍后读:把星标当成唯一的「待读清单」,并坚持每天清掉一部分。FreshRSS 还能为星标列表生成一个专属 RSS 输出地址,可以再喂给其他工具做二次处理。
多用户:FreshRSS 支持多账号,每个用户的订阅和已读完全隔离。在「设置 → 用户」里建号即可。给家人各开一个号共用同一套服务,比每人各装一个阅读器省心得多。注意管理员能看到所有用户的订阅清单,介意隐私的场景就不要共用——不过家庭场景一般无所谓。
移动端离线:通过 API 接入的手机客户端大多支持离线缓存,出门前在 Wi-Fi 下刷新一次,地铁里慢慢看,回公司自动同步已读状态,这是自建 RSS 相比网页阅读器最舒服的体验之一。
常见问题与排障
1. 订阅源添加失败或拉取为空
先在浏览器直接打开那个 RSS 地址确认源本身活着;再在服务器上 curl 同一地址看是否被对方拦截(有些站点对机房 IP 不友好)。个别源需要自定义 User-Agent,在订阅设置的高级选项里可以单独指定。
2. 文章时间不对、排序混乱
检查三处时区:宿主机、容器 TZ 环境变量、FreshRSS 系统设置,三者统一为 Asia/Shanghai。源本身时间戳写错的没法救,只能靠自动已读策略兜底。
3. 页面打开慢、文章列表卡 多半是未读数攒了几万条。在「设置 → 归档」里设置自动清理:已读文章保留 1–3 个月,未读保留更久;再手动跑一次「清理数据库」压缩 SQLite。
4. 全文抓取失败 XPath 规则随目标站点改版失效是常态,重新按新版页面结构写规则即可;也可以退一步只读摘要、点原文跳转,不必强求每个源都全文。
5. 订阅几百个之后刷新变慢、容器内存涨 先分清瓶颈在哪:刷新慢多半是少数几个源响应慢拖住整批,在订阅管理里看每个源的刷新耗时,把长期超时的源删掉或降频;内存涨则多半是文章攒太多,按前面说的归档策略定期清理。另外 SQLite 在高频写入时是单写者模型,个人使用无感,真到了多用户重度使用阶段,再迁到 MySQL 不迟,官方文档有现成的迁移路径。
6. 页面样式错乱、图片不显示 如果只在 HTTPS 下出现,基本是混合内容:源站文章里的图片还是 http 地址,被浏览器拦了。可以给 FreshRSS 前面的反代加图片代理,或者接受点开原文看图。样式整体错乱则多半是反代把路径改错了,FreshRSS 对子路径部署比较敏感,强烈建议用独立子域名部署,不要挂在某个域名的子目录下,能省掉一整类问题。
7. 换服务器后 API 客户端全部掉线 API 地址绑定域名,迁移时保持域名不变、数据目录整体搬过去(方法见 自建服务备份与迁移实战),客户端无感;域名变了就得逐个客户端改地址。
8. 搜索不到很久以前的文章
先确认文章是不是被归档策略清掉了:清理规则按保留时长删旧文,清掉的搜不到是正常现象,长文请及时星标,星标文章默认不参与自动清理。再确认搜索范围:FreshRSS 的搜索框默认只搜当前视图(比如当前分类),找全文时要切到「全部订阅」视图再搜。另外搜索支持一些实用语法,比如 intitle:关键词 只搜标题、author:名字 按作者过滤、#标签 按标签过滤,善用这些比一页页翻快得多。实在要做深度全文检索,可以把星标文章的专属 RSS 输出接到外部工具里,不必强求阅读器本身样样都行。
小结
FreshRSS 是典型的「小而美」自建服务:部署十分钟,价值在长期——订阅列表归你、已读状态全端同步、没有算法插队。记住三个关键动作:装完先关公开注册、务必设定时刷新脚本、给 API 设独立密码。配好这三样,它就能安安静静地替你守着整个信息入口好几年。