V2EX › Planet › olivida.eth

Insider Build 及 Pinning 测试

展开 2675 字的全文

为了能够在正式发布功能之前进行更充分的测试，我们在 GitHub 上增加了一个新的 Release 类型：Insider Build

目前最新的 Insider Build 可以从这里下载：

https://github.com/Planetable/Planet/releases/tag/insider-20221013-1

这个版本中增加的新功能是借助 Filebase 提供的 Pinning 服务，来让 Planet 中发布的内容可以更快地分发。

Pinning 服务是什么？

在初始状态下，用 Planet 发布的内容，通过本地运行的 IPFS 节点对外提供服务。如果打个比方，这样的状态就像是在用 BitTorrent 下载时，一开始，最初的内容发布者，是整个网络里唯一的做种者（seeder）。

当其他人需要访问内容时，就需要在 P2P 网络上找到做种者。所以，如果没有能够找到，或者连接不顺畅，那么也就无法访问内容。

而 Pinning 服务，就是在发布内容时，使用 API 通知的方式，让 Pinning 服务也保存一份内容，这样网络上就会有更多的 seeder，内容也就会更容易被找到和下载。

Filebase

Filebase 是一家提供分布式存储的初创公司。他们在最近支持了 IPFS，并且提供了一个很可靠的 Pinning API。于是基于这个 API，我们为 Planet 添加了第一个 Pinning 服务集成。

开始使用 Filebase

以下是启用 Filebase 来为 Planet 提供 Pinning 的步骤。

首先需要注册一个免费的 Filebase 账号。目前，免费账号可以获得 5GB 的 IPFS 存储空间。
点击 Filebase 主界面左侧的 Buckets，然后按 Create Bucket 创建一个新的存储桶。需要输入一个名字，比如 planet，然后下面 Storage Network 就保持默认的 IPFS (Always public)

创建 bucket 完成之后，点击左侧的 Access Keys，然后在 IPFS Pinning Service API Endpoint 那里选中刚才创建的 bucket，然后按下面的 Copy 就可以获得 Pinning API 的 API Token，是一串很长的字符串，请当作一种密码保管。

回到想要启用 Pinning 的 My Planet，右键点击 Edit Planet，然后切换到 Pinning Tab，填入一个 Pin Name，比如 ENS 或者其他 URL 友好的名字。及刚才获得的 API Token。然后按下 OK 保存。

之后每次你的网站发布新内容时，就会通知 Filebase 也保存副本。目前 Filebase 会在 3 个不同的节点上保存内容。如果你 Edit Planet 然后切换到 Pinning Tab，还可以看到内容在 Filebase 上的状态：

Pinning - 内容正在被复制到 Filebase
Pinned - 内容已经完成复制
Queued - 正在排队等候
Unknown - 出错了，状态未知

如果出现 Unknown 状态，那么需要检查输入的 API Token 是否正确。可以从 Filebase 网站上重新复制之后重新在 Planet 里填入。

那个 Pinned 状态的按钮是可以按的，会打开 Pinned 内容在 Filebase 的 Gateway 上类似这样的地址：

https://ipfs.filebase.io/ipfs/bafybeihkepvteld5u7rmca6ud2cmi5pnpluwpvz6wtmnepmsmyner7xkq4/

内容成功 Pinned 之后，也可以在 Filebase 网站上看到状态：

Pinning 服务的集成，是一个很新也很复杂的功能，如果你在使用过程中遇到任何问题，欢迎加入 Planet 的 Telegram 群讨论或寻求开发者帮助：

https://t.me/+5bl7FIsxeChlOWIz

Planet Feature Update 3

展开 3246 字的全文

欢迎来到 Planet 在 2022 年 9 月 18 日发布的 Feature Update 3。在这次的功能更新中，我们为你带来了 2 个大的主要功能，及诸多细节问题上的修复。

下面的链接是从 0.8.1 到 0.9.2 版本之间的所有改动的更新日志：

https://github.com/Planetable/Planet/compare/release-0.8.1...release-0.9.2

Follow .bit

现在在 Follow Planet 时，可以支持 .bit 域名。

.bit 域名是另外一个基于区块链的域名系统，底层数据存储和计算用的链是 Nervos Network。

和 ENS 类似，.bit 也提供对 dWeb 的支持，你可以在给你的 .bit 域名绑定用 Planet 生成 IPNS 地址，这样你的 .bit 域名上就可以有用 Planet 构建的网站。.bit 的公共网关是 .bit.cc，比如 olivida.bit 上的 IPNS 可以用这个地址访问到：

https://olivida.bit.cc

和 ENS 不同的是，.bit 在更新 dWeb 纪录的时候，不需要付出额外的 gas 费，因为 .bit 在注册时，注册费中就已经包括了一定数量的数据更新所需要的费用。

dWebServices.xyz

dWebServices.xyz 提供托管的 IPNS 纪录。你可以在 Planet 的设置窗口中填入 dWebServices.xyz 的 API Key 和域名，之后每次你的 Planet 更新时，最后的 CID 就会被设置到 dWebServices.xyz 上的 IPNS 记录。这样，除了 Planet 自带的 IPNS 记录，你会获得一个额外的位于 dWebServices.xyz 上的 IPNS 记录。这对于笔记本电脑用户可能会更方便，因为这样你不需要一直开机来保证你的 IPNS 记录存活。但在 Pinning 服务被引入之前，依然需要确保网络上至少有一个节点保存了你的内容，这样其他人才能访问和 Follow 你的网站。

我们会在未来的功能更新中提供 Pinning 服务的集成，这样使用笔记本电脑运行 Planet 的用户，在每次内容更新后，只需要再稍微等一下，等远程的 Pinning 服务获得内容之后，就可以彻底把本子合上了。

或是通过一个 Pinning DAO 来实现这样的效果。

功能细节改进

现在 Planet 应用的主窗口可以记住位置和尺寸，不会在每次关闭又重开的时候回到一个默认尺寸。
全局设置中增加了选择公共网关的选项。

更新了和 Cloudflare 的 peering 设置，现在内容可以更顺畅地被 Cloudflare 的公共网关找到。
本地 IPFS 设置中增加了对 webui.ipfs.io 的 CORS 允许，这样你可以通过 webui.ipfs.io 查看本地 IPFS 节点的一些状态。
增加了对 Planet 内部链接的支持，如果现在你相对链接同一个 Planet 中的其他文章，那么应用将可以正确跳转和设置焦点。
初步支持了链接到另外一个 Planet，比如。如果你已经 Follow，那么会跳转到这个 Planet。如果你还没有 Follow，那么会尝试 Follow 这个地址。
修复了文章列表中未读数更新不实时的问题。
顶部工具栏增加了单篇文章的分享按钮。
降低了 IPFS 进程保持的连接数，可以一定程度降低 IPFS 对资源的消耗。我们会在后续的更新中提供更细致的调整选项。
修复了 Mark All as Read 没有正常工作的问题。
修复了内容检查更新时可能导致风火轮的一个性能问题。
在 Planet 的信息面板中，增加对了 ENS 类型 Planet 的标识。
在 Planet 的信息面板中，可以正确显示其中的 Markdown 语法。也就是说，你可以在 Planet 的 about 信息中使用 Markdown。比如这样的链接：

在 Unfollow Planet 操作上增加了一个确认框防止误操作。
Planet 的信息设置窗口现在使用 TabView 来更好地组织更多信息。
Planet 信息中可以填入 GitHub / Twitter 用户名，在模版渲染时会用上这些信息。
修复了打开 Plausible.io Dashboard URL 时的一个编码问题。（感谢来自 @Fatpandac 的 PR）
修复了一个编辑器预览区域没有同步滚动的 regression 问题。
编辑器窗口会按照所属的 Planet 记住尺寸和位置。
支持自建版本的 Plausible.io 流量统计服务。
首页模版渲染时新增变量 hasAvatar，模版设计者可以根据这个变量定制是否显示 Planet 的图标。
如果为 Planet 设置了图标，那么图标也会被保存为 32x32 的位于根目录的 favicon.ico。
支持通过 The Iconfactory 的 WorldWideWeb 应用来预览本地构建的网站。

以上是本次 0.9 更新里的主要新功能和改进。如果你在使用中遇到问题，可以从以下社区渠道向开发者反馈或者寻求社区协助：

V2EX 上的 Planet 节点
Telegram 上的 Planet 中文用户群

如果你十分确定遇到了软件实现上的 bug，那么可以通过 GitHub Issues 向我们描述如何复现 bug，我们会尽快调查和解决。

GitHub 上的 Planet 项目

💡为什么我们会需要一个甚至多个 Pinning DAO

展开 1787 字的全文

通过 Planet 发布内容，是一种完全去中心化的 local-first 模式。所有的内容不仅存储是在本地，提供对外服务的 IPFS 节点，也是运行在本地机器上。这样的好处是，整个内容的发布和订阅流程，不会受制于外部的大公司的基础架构。

但这样的完全去中心化的做法，也会带来一些挑战：

因为提供对外服务的 IPFS 节点也在本地，因此需要程序一直运行。这对于 Mac mini 或者 Mac Studio 这样的桌面设备可能不是太大的问题，但是对于笔记本电脑的用户就会是一个问题。

对于笔记本电脑的用户，因为不可能让设备保持 24x7 开机及联网，那么最简单的解决方案还是引入服务器来帮助分发。如果你有自己的 Linux 服务器，那么下面是在自己的服务器上启用 IPFS 来帮助 Planet 内容分发的操作步骤和原理。

安装 IPFS for Linux Server

从这里 https://github.com/ipfs/kubo/releases 下载 Linux 版本的 IPFS 服务器端。就是一个可执行文件，我通常的做法就是把这个文件 ipfs 复制到 /usr/local/bin/ipfs，这样就可以随时运行 ipfs 指令。
启动 IPFS 进程 ipfs daemon，可以使用 screen、tmux 或者 supervisord。

IPFS 进程启动之后，就可以通过下面这样的指令来 pin 内容了。

ipfs pin add /ipns/olivida.eth

所谓 pin 内容这个操作，其实很类似 BitTorrent 下载中的「做种」这个概念。就是，如果一份内容被 pin 了，意味着本地保存了一份经过完整性校验的拷贝，如果网络上的其他节点也要请求这份内容，那么就是所有有拷贝的机器来一起提供，就像 BitTorrent 下载时，是所有 seeder 来一起服务下载请求。

你可以在 pin add 使用 IPNS 地址，无论是 k 开头的原生 IPNS 地址，或者是 ENS 地址，都可以支持：

ipfs pin add /ipns/planetable.eth

ipfs pin add /ipns/k51qzi5uqu5dgv8kzl1anc0m74n6t9ffdjnypdh846ct5wgpljc7rulynxa74a

如果你把这样的指令放到 crontab 中，那么就可以实现追踪 IPNS 背后的 CID 的变化，然后一直 pin 最新内容。

Pinning DAO

上面的这个操作过程，对于没有 Linux 服务器的用户来说，还是太麻烦了。我们需要更简单的方式，而这件事情非常适合做成一个 DAO。

DAO 存在的意义，就是服务成员的共同需求。

Pinning DAO 里，这个共同需求就是：成员需要全世界各地的服务器，来保证发布在 IPFS 上的内容，是永远可用的。为了持续实现这一点，于是需要一个或者多个这样的去中心化自治组织。

我希望接下来能够看到这样的组织的出现。

为了完整实现这个愿景，将会需要构建很多新的开源软件。

比如一个用 RainbowKit 或者 ConnectKit 实现登录的网站，ENS holder 登录并且通过 Juicebox 付款成为 DAO Member 之后，就可以通过这个 DAO 部署在全球各地的基础架构来 pin 自己发布在 ENS 上的网站。

而除了提供 pin 服务之外，DAO 也可以为成员提供自建的 Plausible 流量统计之类的服务。

虽然内容通过 DAO 进行了分发，但是权威版本依然是完全控制在用户本地。而不是像之前，因为使用了 Web 2.0 大公司的平台来存储和分发内容，内容的实际存活就完全被大公司所控制了。如果一个 DAO 提供的服务成员不满意，那完全可以发起另外一个，充分的竞争会带来最好的产品和服务。

.bit

展开 1029 字的全文

ETH.LIMO

展开 1243 字的全文

关于优化 IPFS 的资源占用

展开 616 字的全文

Planet 的模版系统

展开 1737 字的全文

Planet 的核心功能之一，是一个静态网站生成器。所以，用 Planet 做网站，是可以支持全站模版替换的。在这篇文章里，我们会向你介绍目前系统的内置模版，及如何制作自己的新模版。

内置模版

在目前的版本中，Planet 有两个内置模版：

Plain

外观简洁，尽量贴近操作系统原生 look-n-feel 的模版，支持自动切换 Light/Dark 模式。Planet 如果有新的媒体格式支持，那么 Plain 模版会最先更新，提供对新的媒体格式的支持。比如之前的更新中，对视频和音频，及附件下载的支持。

GitHub https://github.com/Planetable/SiteTemplatePlain
Demo Site https://olivida.eth.limo/

8-bit GameDB

一个 8-bit 风格的模版。一些新的前端技术会在这个实验性的模版中使用。比如目前这个模版中的很多组件，就是用 Vanilla JS Web Component 实现的。GameDB 模版在获得新的媒体格式支持方面会比 Plain 模版稍微慢一周。

GitHub https://github.com/Planetable/SiteTemplate8bit
Demo Site https://zh.gamedb.eth.limo/

制作自己的模版

如果你希望制作自己的新模版，那么目前我们推荐的步骤是：

打开 Planet 的数据目录：~/Library/Containers/xyz.planetable.Planet/Data/Documents/Planet/Templates
复制其中的 Plain 模版的目录到一个新的目录
打开新目录中的 template.json 文件，编辑其中的 name 字段，给你的新模版一个新名字
然后在下次启动 Planet 之后，就可以看到和选择这个新模版了。

编辑和预览模版

如果你改动了自己的新模版的 HTML / JS / CSS，想要快速预览的话，我们推荐的做法是：

安装来自 The Iconfactory 的 WorldWideWeb，这是一款非常简单好用的静态网站 HTTP 服务器。它可以快速将任意目录的内容以 HTTP 方式提供服务。

在安装完 WorldWideWeb 之后，你会在右键点击 My Planet 时在 Develop 菜单下看到新选项：Open in WorldWideWeb

然后 WorldWideWeb 就可以在 localhost 上预览你的 Planet 的新模版构建的网站。每次你做了修改时，只需要在 Develop 菜单下 Rebuild，然后就可以通过 WorldWideWeb 提供的 localhost 上的服务预览更改。

此外，你可以通过 Planet 的 Tools 菜单下的 Template Browser 看到目前你本地的 Planet 所安装的所有模版：

这个关于 Planet 的 Template Engine 模版引擎的文档会在未来持续更新。

Planet and WorldWideWeb

展开 1477 字的全文

Planet Feature Update 2

展开 4231 字的全文

这是 Planet 的第二个功能更新，版本号 0.8.0，发布于 2022 年 8 月 13 日。这次的更新的代码来自于以下贡献者：

下面的链接是从 0.7.0 到 0.8.0 版本之间的所有改动的更新日志：

https://github.com/Planetable/Planet/compare/release-0.7.0...release-0.8.0

下面是这个版本里带来的新功能和改进。

Plausible.io 数据统计

Plausible.io 是一个开源的数据统计平台，创始团来自欧洲。现在 Planet 支持在 Info 面板中填入 Plausible 的 domain 和 API token，这样就可以通过 Plausible.io 看到有多少人访问过你的 Planet。

比如下面的链接是 olivida.eth 的访问数据例子：

https://plausible.io/olivida.eth.limo

另外一个例子，Plausible.io 官方网站的流量：

https://plausible.io/plausible.io

Plausible.io 的实现方式是尊重隐私的。这个平台不会收集个人信息，甚至都没有使用 cookie。因此不需要在使用 Plausible.io 的页面上弹出 cookie banner。

我们会在未来的版本更新中加入对 self-hosted 版本的 Plausible 的支持。

博客 Podcast 和附件支持

现在你可以在撰写内容时，选择附加一个音频文件，或者是直接将音频文件拖拽到写作窗口中。之后在发布时，页面上就会出现一个音频播放器。

在本篇博客的内容中，就附加了一段音频内容。这是我在 5 月份 Planet 上线之前，和枫言枫语播客录制的。里面分享了关于 Planet 在制作过程中的一些思考。

如果是在 0.8.0 之后版本的 Planet 客户端中访问这样的带有音频的内容，那么在工具栏中会看到一个耳机按钮，点击之后就会启动一个全局的音频播放器去播放内容中所携带的音频内容。得益于这个全局播放器的存在，播放时切换查看的文章内容，播放不会被打断。

我们会在未来的版本中继续优化这个全局音频播放器的使用体验。

如果你将其他格式的文件，比如 PDF 或者 DMG 之类拖拽进入写作窗口，那么这样的内容在发布之后，会在 0.8.0 的客户端中显示为附件。访客可以点击工具栏中的附件图标就可以下载。

内置模版的细节改进

Planet 目前内置了两个网站模版用于切换样式。

在这次的更新中，我们为这两个模版加入了众多的细节改进：

对音频内容的支持
针对视频和图片内容的 CSS 样式优化
在顶部区域，从内容页面返回到首页的链接
在 iOS 移动设备上访问时的 safe-area 问题
Plain 主题首页对 Dark Mode 的支持

模版的功能完备是 Planet 的重要部分。所有的内置模版和 Planet App 一样，也都是开源软件，所以如果你发现任何模版相关的问题，也可以通过 GitHub Issues 甚至 PR 的方式反馈给我们：

接下来，我们会在 2022 年 8 月发布关于如何自己构建新模版的详细文档。

下面这个项目是来自开发者 Fledge Shiu 的一个有意思的模版，实现了中文竖排的效果：

https://github.com/FledgeXu/Vertical

然后这里是一个用 8-bit 模版的关于经典老游戏的博客：

https://zh.gamedb.eth.limo/

内置 go-ipfs 版本升级

Planet 内置的 go-ipfs 版本从 0.12 升级到了 0.14。从 0.13 版本开始，上游 Protocol Labs 将 go-ipfs 项目更名为了 kubo，所以之后我们如果需要在文档中提到 go-ipfs，我们会使用它的新名字 kubo。

由于 kubo 的版本升级，会在 Planet 启动时有一个迁移仓库的操作。如果你的本地 IPFS repo 的文件数量较大，那么这个迁移可能会需要一些时间，让它跑一会就好。

我们会在未来的版本中提供更多针对本地 IPFS repo 的图形界面管理功能。

RSS 订阅器相关的细节改进

其实从 Planet 的第一个发布版本开始，这个软件就是带有 RSS 订阅功能的。但是因为一些细节还不够好用，所以我们之前没有公开宣布过这个功能的存在。

在这次的 0.8.0 更新中，我们针对 RSS 订阅的很多细节功能做了改进和测试，所以现在我们可以有一些信心来邀请你试用一下。

这里有一些有趣的 RSS 订阅源：

Low Tech Magazine: 一个完全靠太阳能驱动的网站，所以阴天的时候可能会断线。
YouTube 上的 Deep Look 频道：各种有趣动物的 4K 科普视频

YouTube Channel: Deep Look

很多会持续更新内容的网站，很可能都带有 RSS 订阅地址，一个例子就是 YouTube 上的各类 Channel 的首页。你可以尝试直接把网址填入到 Follow Planet 那里，如果内容源上确实存在 RSS 地址，那么就可以用 Planet 订阅。

如果你在使用 RSS 订阅功能的过程中遇到问题，欢迎反馈到下面这些社区渠道：

Telegram 上的 Planet 中文用户群

提醒相关的细节改进

我们在这次更新中进一步改进了 Local Notification 的工作方式。现在如果你收到了订阅的 Planet 的内容更新提醒，那么点击 Notification 就可以直接跳转到这篇文章。

其他细节改进

更换了 Markdown 渲染引擎，现在 Planet 可以输出和 GitHub Flavored Markdown 完全一致的结果，同时也解决了之前由于使用 Ink 渲染所带来的一些 crash 问题。
现在在查看文章时，如果执行了任何的下载相关的操作，那么这些操作可以正常工作了，并且可以从一个新的 Download Manager 窗口中看到下载进度。之前的版本中由于缺乏对 WKDownloadDelegate 的实现而导致了下载相关的操作没有反应。
改进了对 DNSLink 加载内容的支持。值得注意的是，如果你希望以 DNSLink 方式订阅一个 IPFS 上的网站，那么需要在 Follow Planet 窗口使用 planet 协议，比如这样去输入域名 planet://zu1k.com。
从 Planet 发布的 IPNS 记录的 TTL 时间从 1 周调整到了 1 年。但 IPNS 记录在节点上的存在时间，依然取决于很多其他因素。所以，如果你希望保持你的 IPNS 记录有效，那么至少每周打开 Planet 运行一段时间，就肯定没有问题的。关于 IPNS 及 Pinning 这几个复杂而又重要的技术细节，我们会在接下来的一篇博客里详细介绍。

以上是本次 0.8.0 更新里的主要新功能和改进。如果你在使用中遇到问题，可以从以下社区渠道向开发者反馈或者寻求社区协助：

V2EX 上的 Planet 节点
Telegram 上的 Planet 中文用户群