配置完 FreshRSS 后，第三方手机和桌面客户端如何接入？

如果你刚刚搭建好 FreshRSS，你可能会发现只能在网页上看订阅内容。

想用手机或者电脑上的 RSS 阅读器同步阅读？其实很简单，只要把 FreshRSS 当作数据源接入就行了。

本文就来讲讲如何实现第三方 App 接入 FreshRSS。

启用 API

在开始接入客户端之前，先确保 FreshRSS 的 API 已启用，操作如下：

1. 登录 FreshRSS 的网页端。
2. 在右上角点一下齿轮图标，进入管理菜单。
3. 找到“认证”选项，勾选“允许 API 访问”。

接下来需要跳转到另一个页面。

1. 左边菜单里找到“账户”并点击。
2. 在下方的“API 管理”中，设置一个专用的 API 密码（这个密码和登录密码是分开的）。
3. 提交后，你会看到一个 API 地址（比如 https://freshrss.example.net/api/greader.php 或 https://freshrss.example.net/api/fever.php）。

设置完成后，点击下方的 /api/ 地址，应该可以看到如下页面。

记下这个 API 地址和你设置的密码，后面配置客户端的时候会用到。

选择兼容客户端

现在来选个合适的客户端，以下是一些支持 Google Reader API 或 Fever API 的选项：

在 FreshRSS 的官方文档和 Github 介绍中，提到了不同平台的许多客户端。

我把 Github 中提到的阅读器摘录过来，大家可以结合表格和自身需求进行选择。

表 1: Android 阅读器

表 2: 桌面平台阅读器

表 3: iOS 和 macOS 阅读器

更多客户端信息可以参考下面两篇。

• FreshRSS 客户端表格 - Github
• 与 Google Reader 兼容的 API 客户端 - FreshRSS 文档

客户端配置

以免费的 iOS RSS 阅读器 Netnewswire 为例，配置方法如下：

1. 打开 Netnewswire，找到设置中的“Add Account”。
2. 选择服务类型为 FreshRSS。（某些阅读器中可能是 Google Reader 或 Fever）。
3. 根据提示，填入你的 API 地址（比如 https://freshrss.example.net/api/greader.php）。
4. 输入你的 FreshRSS 用户名和刚刚设置的 API 密码。（此处的密码一定是 API 密码，而不是 FreshRSS 中的用户密码）
5. 保存后同步订阅内容。

其他阅读器也大同小异，部分阅读器可能对 API 支持不全，比如不支持分组、不支持远程刷新等。这个要具体看阅读器本身的限制和文档。

如果连接不上

• 首先要确保 API 正常，在 /api/ 页面可能会显示原因。
• 如果客户端连不上，先检查 FreshRSS 的 API 设置是否启用了，地址和密码是否填对。
• 有些客户端可能对 Fever API 的支持不够完善。如果遇到问题，可以换个支持 Google Reader API 的客户端试试。

定时刷新订阅

第三方客户端实现的方法各异，这导致远程刷新、文章排列顺序等可能与 FreshRSS 网页端不同，这是正常现象。

目前推荐的做法是，让 FreshRSS 自己实现定时刷新，客户端仅从 FreshRSS 拉取最新文章。可以参考 《FreshRSS 如何实现可靠的定时自动刷新？》

总结

搞定以上步骤后，你就可以愉快地用第三方客户端同步和阅读 RSS 了。相信 RSS 阅读体验会更上一层楼。