核心用法
FreshRSS 技能通过 Google Reader 兼容 API 查询自建 RSS 阅读器中的订阅内容。用户需预先配置 FRESHRSS_URL、FRESHRSS_USER 及 FRESHRSS_API_PASSWORD 三个环境变量完成认证。主要功能包括:
- 获取头条:
headlines命令支持--count指定数量(默认20)、--hours限定最近N小时、--category按分类过滤、--unread仅显示未读 - 浏览结构:
categories和feeds命令分别列出订阅分类与全部源地址 - 组合筛选:多重条件可叠加使用,如同时限定分类、时间窗口与阅读状态
输出格式清晰,包含日期、来源、标题、链接及分类标签,便于快速扫读。
显著优点
- 数据主权完全自主:RSS 内容存储于用户自有服务器,无第三方平台依赖
- 信息过滤精准:时间窗口+分类+已读状态三维筛选,避免信息过载
- 轻量高效:命令行交互,适合开发者与效率用户快速获取资讯
- 开放标准兼容:基于成熟的 Google Reader API 规范,扩展性良好
局限与风险
- 前置成本较高:需自行部署 FreshRSS 实例并完成 SSL、域名等配置
- 认证信息暴露:API 密码以环境变量形式存储,多用户系统存在泄露风险
- 功能边界明确:仅限读取操作,不支持标星、分享、全文抓取等高级功能
- 无内容缓存机制:依赖 FreshRSS 实例在线状态,网络中断时完全不可用
适合人群
自建 RSS 服务的技术用户、隐私敏感型资讯消费者、需要将阅读器与工作流(如终端、脚本)集成的开发者。
常规风险
API 密码泄露可导致订阅数据被爬取;自建服务若暴露公网且未加固,存在被扫描攻击的可能。建议配合 VPN/内网访问,定期轮换 API 密钥。