先来看看效果：友情链接 - PRIN BLOG。

自我感觉还是不错的，友链的博客们有什么更新都可以实时展示在页面上，一目了然。作为博主，不用打开 RSS 阅读器就可以查看新文章；作为访客，也可以快速找到更多自己感兴趣的内容，比起原来全是链接的页面，看起来也让人更有点击欲望了。

从临时起意到开发完成总共两个晚上，最速传说就是我！（误）

缘起

前段时间看到有个博客用了这样的一个东西：

• Rock-Candy-Tea/hexo-circle-of-friends: 友链朋友圈
• 朋友圈 | Black Flies

当时就感觉卧槽好高端，很有想法。

这种聚合订阅的形式有个名字，叫做 Planet（社区星球）。Planet 通常用于聚合某个领域的博客，然后展示在一个页面上，方便用户一站式阅读，比如：

• Planet Python
• Planet MySQL
• Arch Linux 中文星球

这种形式在开源社区里比较常见，不过用在博客的友链上我倒还是第一次看到。

就像我在本站友链页里说的一样，独立博客之间的联系基本上就是靠的链接交换和评论互访。一个博客的访客看到了其他博客的链接，点过去看了，然后从对面的友链中，又导航到新的博客……如此往复，我们就依靠着这种从现在看来显得十分古老的方式，维系着这些信息孤岛之间的纽带。原始又浪漫。

不过这里就会涉及到一个用户点击率的问题。我自己之前在维护友链页面的时候，总感觉只放标题和链接看起来效果不怎么好。就算加上描述、头像这些元素，也总觉得差点意思。因为一个博客最重要的其实还是它的内容，仅靠一个网站标题，可能很难吸引到其他用户去点击。

而「友链朋友圈」的这种形式，就像微信朋友圈一样，作为一个聚合的订阅流，展示了列表中每个博客的最新文章。

比起干巴巴的链接，这显然会更加吸引人。虽然我写博客到现在也已经 9 年了，早就佛系了，主打一个爱看不看。不过对于和我交换了友链的博主们，还是希望他们能够获得更多的曝光和点击（虽然我这破地方也没多少流量就是啦……），也希望我的访客们也可以遇到更多有价值的博客。

然而在准备接入的时候，我发现这玩意儿不就是一个小型的 RSS 阅读器么……其实等于是自己又实现了一套订阅管理、文章爬取、数据保存之类的功能。

于是我就寻思，可能直接复用已有 RSS 阅读器 API 的思路会更好，让专业的软件做专业的事。友链的管理也可以直接复用 RSS 阅读器的订阅管理功能，这样增删改也不需要了，我们就只需要封装一下查询的 API，提供一个精简的展示界面就 OK。

技术栈选择

作为行动力的化身，咱们自然是说干就干，下班回家马上开工！

首先是 RSS 后端的选择。

市面上的 RSS 阅读器有很多，我自己主要用的是 Inoreader。然而我看了下，Inoreader API 只面向 $9.99 一个月的 Pro Plan 开放，而且限制每天 100 个请求……这还玩个屁。Feedly 也是差不多一个尿性，可以全部 PASS 了。我也不知道该说他们什么好，也许做 RSS 真的不挣钱，只能这样扣扣搜搜了吧。

另外一个选择就是各种支持 self-host 的 RSS 阅读器，比如 Tiny Tiny RSS 和 Miniflux。我之前部署过 TTRSS，说实话感觉还是太重了。Miniflux 则是使用 Go 编写的，该有的功能都有，非常轻量级，部署也很方便。就决定是它了！

技术栈方面选择了之前一直比较心水的 Hono，部署在 Cloudflare Workers 上。前端方面没有使用任何框架，连客户端 JS 都没几行，基本上是纯服务端渲染。有时候不得不感叹技术的趋势就是个圈，以前那么流行 SPA，现在又都在搞静态生成了。

页面渲染使用了 Hono 提供的 JSX 方案，可以在服务端用类似 React 的语法返回 HTML，挺好用的。不过 CSS 没有用 Hono 的那一套 CSS-in-JS，因为要允许用户覆盖样式，所以要用语义化的类名。最后选了 Less，还是熟悉的味道。

前端文件的构建使用了 tsup，配置文件就几行，爽。

实现

实现思路很简单，就是做一个 Proxy 层，把：

• GET /v1/categories/22/entries - Get Category Entries
• GET /v1/categories/22/feeds - Get Category Feeds

这两个 Miniflux 的 API 包一下。这里要注意不能暴露实际的 API Endpoint，避免可能的恶意攻击。API 缓存也要在我们这一层做好，防止频繁刷新把服务打爆。

缓存策略上使用了 SWR (Stale-While-Revalidate)：

1. 拿到 API 响应后，放到 KV 中，同时把时间戳放入 metadata；
2. 后续从 KV 读取缓存时，对比当前时间和 metadata 中的时间戳；
3. 如果经过的时间没有超过设置的 TTL，说明缓存有效，直接返回前端；
4. 如果经过的时间超过了 TTL，则标记缓存为 stale 状态，依然返回前端；
5. 此时，后端在后台重新请求 API，并将最新的响应写入 KV 中；
6. 下一次再从 KV 读取时，拿到的缓存就是最新的了。

这样可以保证最快的响应速度，以及相对及时的更新速度，比较适合这种场景。

最后的交付形式其实就是两个 HTML 页面，通过 <iframe> 的形式嵌入到网页中。另外参考 giscus 提供了一个脚本，可以设置参数并自动完成 iframe 的初始化，用户只需要引入一个 <script> 标签即可，非常方便：

<script  async  data-category-id="28810"  src="https://blog-friend-circle.prin.studio/app.js"></script>

当然也可以作为独立页面打开，有做双栏布局适配：

blog-friend-circle.prin.studio/category/2/entries

开源

新版博客友链朋友圈的所有代码都开源在 GitHub 上，欢迎使用：

👉 prinsss/blog-friend-circle

这个方案和 hexo-circle-of-friends 并没有孰优孰劣之分，只是侧重点和实现方式不同。不过我这个的一个好处是，如果你已经在用 Miniflux 了，那么可以直接复用已有的大部分能力，不需要再起一个 Python 服务和数据库去抓取、保存 RSS，相对来说会更轻量、稳定一些。

如果你选择使用 Miniflux 官方提供的 RSS 服务，甚至可以无需服务器，部署一下 CF Workers 就行了，像我这样的懒人最爱。

虽然大家写 blog 的频率都没那么勤了，但是，RSS 还是有其它可以玩的方式的！

很多人都有用各种 read it later、或者书签类工具，把有意思的网页保存下来。在这些工具里，可以通过某些手法，把一些想要分享的网页，生成 rss。其他好友订阅这个 rss 地址，就可以自动刷新，看到你推荐的文章啦！

下面介绍一些，常见的书签网站，生成 rss 的方式。但首先——

• 这些生成的 rss 地址里，大多都内嵌着网站的验证码，容易泄密，也冗长而不简洁。强烈建议：得到 rss 后，先用 Feedburner 之类的网站，转成新的 rss，再分享出来，可以去掉原先网址里的隐私信息。
• 很多网站，并没有专门用来 share 的分类，只能通过曲线手段，把已经 archive 或者 star 的类别分享出来。这可能会影响你原本的使用习惯。
• 一些网站生成的 rss，并没有全文，甚至只有标题和链接地址。没关系，能看到大家的推荐，就已经很好了，自己点开就可以啦。
• 大多数 rss 订阅工具里，也都有发送给 read it later 的功能，可以辗转着，把自己订阅的文章分享给他人。

我的 RSS 分享地址是：

https://feed.fivest.one/readings
或者
https://feeds.feedburner.com/fivestone/readings

有兴趣和我分享的，欢迎留言或私信交换！！

Instapaper 免费版

感觉 Instapaper 生成 RSS 的功能是最好用的，可以把特定的文件夹设为公开，直接得到它的 rss，形如：

https://instapaper.com/folder/1234567/rss/123456/Vciysdfsd7mod9B

• 在左边栏创建新的 Folder，存放想要分享的文章；
• 进入这个 Folder，在页面上方选择 Edit，设置成 Public；
• 点击页面右上角的下拉菜单，选择 Download；
• 下载为 RSS Feed，就得到 RSS 地址了。

Pocket 免费版

好像 Pocket 的免费用户，内容都只能是公开的（无语…），只要知道了用户名，就可以通过 RSS 查看全部的内容（所以生成的 rss 需要转录才安全）。而且不能自定义分类，只有默认的：

https://getpocket.com/users/USERNAME/feed/all
https://getpocket.com/users/USERNAME/feed/unread
https://getpocket.com/users/USERNAME/feed/read

最后一条 …/read 会返回所有 Archived 了的文章，可以勉强用它作为分类的手段。

Readwise

这个只有收费版，我就不去试了。有它家的用户，可以帮忙把生成 rss 的方法分享一下？

Wallabag

我在用 Wallabag，可以自建，也有收费的服务可用。生成的 rss 是全文输出，效果很好。在 Config – Feed 里，生成一个 token，然后点开任何一个 tag，点击列表上方的 rss 图标，就可以得到这个 tag 的 rss 订阅（生成的地址里带着统一的 token，所以需要转录才安全）：

https://wallabag.your.domain/feed/USERNAME/asdfghjkl/tags/t:share

基本上算作官网文档的补充，官网很多东西散落在各个角落，不太好找，本文稍微归纳了一下。

技术发展日新月异，随着时间的流逝文中的一些东西可能会过时，请注意更新时间。

最后修改：2019–08–08。

目前 shadowsocks 中还在不断更新的只有 shadowsocks-libev，本文主要介绍这个。

首先你要有台用于搭建 ss 的服务器。另外本教程适合用户个人使用，如果想建站，请自行查阅其他资料。

shadowsocks-libev

ubuntu 的安装很简单，一条命令即可，不过貌似对 Ubuntu 版本有要求
sudo apt install shadowsocks-libev
安装的可能不是最新版，最新版请手动编译

Centos 7安装

按官网说明安装软件，建议采用手动方法，原因一是能保证用的是最新版，二是出了问题容易上网搜索解决。
Installation

不过官网上写得有些混乱，如果看不懂的话直接无脑进行如下操作即可：

yum install epel-release -y
yum install gcc gettext autoconf libtool automake make pcre-devel asciidoc xmlto c-ares-devel libev-devel libsodium-devel mbedtls-devel -y

git clone https://github.com/shadowsocks/shadowsocks-libev.git
cd shadowsocks-libev
git submodule update --init --recursive

./autogen.sh && ./configure && make
sudo make install

接下来需要将配置文件拷贝到常用路径
添加配置文件：

cp ./rpm/SOURCES/etc/init.d/shadowsocks-libev /etc/init.d/shadowsocks-libev
cp ./debian/config.json /etc/shadowsocks-libev/config.json
chmod +x /etc/init.d/shadowsocks-libev

单用户配置

编辑配置文件

vim /etc/shadowsocks-libev/config.json

修改里面的配置，这里给个 demo，具体每个参数什么意思在官网了解吧：

{
    "server":["[::0]","0.0.0.0"],
    "server_port":8388,
    "local_port":1080,
    "password":"barfoo!",
    "timeout":60,
    "method":"chacha20-ietf-poly1305"
}

该配置同时支持 Ipv6 和 Ipv4，并采用 ss3.0 支持的 AEAD 加密方式。
接下来我们要修改 /etc/init.d/shadowsocks-libev，由于历史原因这里面有点问题。
把文件中的DAEMON=/usr/bin/ss-server改成DAEMON=/usr/local/bin/ss-server
修改完成后修改文件权限

chmod 755 /etc/init.d/shadowsocks-libev

启动 shadowsocks-libev

/etc/init.d/shadowsocks-libev start

多用户配置

多用户配置有多种方法，官方推荐通过给每个用户一个配置文件，启动多个ss-server实现。
还有种方法如下，通过启动ss-manager实现
多用户配置文件与单用户不同，我们配置文件目录创建一个ss_manager.json

{
    "server": ["[::0]","0.0.0.0"],
    "local_port": 1080, # 本地端口，自行设定
    "timeout": 600, # 超时毫秒数
    "method": "chacha20-ietf-poly1305",
    "port_password": {
        "8388": "barfoo1", # 端口号与密码
        "8389": "barfoo2" 
    }
}

设置开机启动

单用户很简单

chkconfig --add shadowsocks 
service shadowsocks start

若是针对多用户情况，需要手写开机启动脚本，方法如下：
应在/usr/lib/systemd/system下新建一个.service文件，例如ssmanager.service

[Unit]
Description=shadowsocks manager # 服务的描述
After=network.target # 该服务跟在哪个服务后启动

[Service]
Type=forking # 启动时的进程行为，forking是以fork形式从父进程创建子进程，子进程创建后父进程退出
ExecStart=/usr/local/bin/ss-manager --manager-address /var/run/shadowsocks-manager.sock -c /etc/shadowsocks/ss_manager.json # 启动服务时执行的命令
PrivateTmp=true # 使用私有临时文件目录

[Install]
WantedBy=multi-user.target # 附挂在multi-user.target下

所有配置文件与脚本都设置完毕，使用systemctl开启服务。

# 更改.service文件后，都要重载守护进程更新systemctl
systemctl daemon-reload
# 启动服务
systemctl start ssmanager.service
# 查看服务状态，若为绿色active(running)则说明服务成功启动
systemctl status ssmanager.service
# 设置服务开机自启动
systemctl enable ssmanager.service
# 还可使用systemctl restart ssmanager.service重启服务，使用systemctl stop ssmanager.service停止服务

开启防火墙白名单

很多人按照教程的配置完后，发现并不能使用，原因是端口被防火墙关闭了。
输入如下代码开启防火墙端口白名单：

vim /etc/firewalld/zones/public.xml

在文件中适当位置添加下面代码：

<port protocol="tcp" port="[server port]"/>
<port protocol="udp" port="[server port]"/>

[server port] 填你的端口号。

重启防火墙

firewall-cmd --complete-reload

客户端

在这里面找适合自己版本的吧
GitHub

开启多进程

shadowsocks-libev 一个进程只能开启一个端口，因此我们要开启多个进程，对应每个进程使用一份相应的配置文件，从而达到多用户使用的目的
配置完多份配置文件后w在 /etc/init.d/shadowsocks 相应位置添加如下代码，一下代码仅供参考，读者可根据实际需求修改，这些代码的意思都很简单。

# 配置文件位置
CONF1=/etc/shadowsocks-libev/config1.json

# 检测配置文件是否存在
if [ ! -f $CONF1 ] ; then
    echo "The configuration file1 cannot be found!"
    exit 0
fi

# 定位到 pid 文件
PID1=/var/run/$NAME/pid1

# 开启进程
daemon $DAEMON -c $CONF1 -f $PID1

# 杀死进程
killproc -p ${PID1}

# 移除 pid 文件
rm -f ${PID1}

在原来的脚本里有跟上面代码极其相似的地方（数字1没有），把上面的6段代码插入到原来脚本中对应相似的代码后面即可。