从今天开始我的博客会使用 IPFS 来分发文中涉及到的所有附件，目前已经上线了 Paper Reading 系列中的所有论文，访问方式如下：

此外，之前的文章均已追加对应的下载链接，直接使用即可。

How It Works?

User Side

From ipns://paper.xuanwo.io

ipns 是 IPFS 自行声明的一个协议号，IPFS Companion 会识别这个地址并使用本地节点或 Public Gateway 以提供服务：

  • ipns://paper.xuanwo.io => https://ipfs.io/ipns/paper.xuanwo.io
  • ipfs://abcdef => https://ipfs.io/ipfs/abcdef

From paper.xuanwo.io

当 IPFS Gateway 收到形如 /ipns/paper.xuanwo.io 这样的请求时，它会通过 DNSLink 机制来寻找对应的内容：

:) dog _dnslink.paper.xuanwo.io TXT
TXT _dnslink.paper.xuanwo.io. 59s   "dnslink=/ipns/k51qzi5uqu5dg8jr2lu573gsljj5orng0nexbs093zbwy3dwbbgdk8sk3js591"

于是 IPFS Gateway 会将该请求转换为对应的实际请求： /ipns/k51qzi5uqu5dg8jr2lu573gsljj5orng0nexbs093zbwy3dwbbgdk8sk3js591。

From /ipns/k51...

IPNS，全称 InterPlanetary Name System， 是 IPFS 引入的域名机制，能够将特定的内容与一个 IPNS ID 绑定，使得用户能够动态的 修改 内容：修改 IPNS ID 绑定的内容而不是内容本身。

通过 go-ipfs 命令行工具能够查看 IPNS ID 对应的内容 ID：

:) ipfs name resolve /ipns/k51qzi5uqu5dg8jr2lu573gsljj5orng0nexbs093zbwy3dwbbgdk8sk3js591
/ipfs/QmQ9nkebfvHjGYq3xQiuyV1LxZbPkTUVmXPSEcoDDX2QfD

IPFS Gateway 同样也会执行类似的 resolve 操作，因此 Gateway 最终会去访问 /ipfs/QmQ9nkebfvHjGYq3xQiuyV1LxZbPkTUVmXPSEcoDDX2QfD。

当然后续还涉及到其他的细节就不展开了，可以参考 https://docs.ipfs.io/。

Provider Side

From files to CID

当在本地执行 ipfs add xxx 时，ipfs 会使用特定的算法计算出一个基于内容的 CID (Content IDentifier)。CID 本身是自描述的，具体的 Specs 可以参考 CID (Content IDentifier) Specification。在 IPFS 的网络上，CID 就唯一标识了一个文件，如果文件的内容发生了任何变动，CID 都会因此发生变化。

以 Andrew: a distributed personal computing environment.pdf 为例，它的 CID 是： QmQ9nkebfvHjGYq3xQiuyV1LxZbPkTUVmXPSEcoDDX2QfD，那就可以通过 https://ipfs.io/ipfs/QmQ9nkebfvHjGYq3xQiuyV1LxZbPkTUVmXPSEcoDDX2QfD 访问该文件，提供该文件的节点是任何拥有相同 CID 的节点。

From CID to IPNS

为了能够让用户以相同的 ID 访问不断在更新的文件，维护者需要将 CID 绑定到 IPNS ID 上。IPNS 是一个基于非对称加密的系统，一对公私密钥对应一个唯一的 IPNS ID，只有持有私钥的节点能够更新该 IPNS ID 对应的 CID。

ipfs name publish --key=<key-id> <CID>

后面的流程就能跟用户侧连起来啦。