教程:下载 Filecoin 上的 IPFS 文件

本文提及的 FileCoin 均指 2025 年 12 月发布的 Filecoin 新版本,而非旧版本。

所需的 Kubo 版本为 0.43.1。低于 0.40.0 的版本无法下载。

PS:其实也可以下载,但需要中间人协助。

第一步:设置 IPFS 环境变量

使用 set 命令进行临时设置:

set IPFS_PATH=D:/tools/.ipfs

这样做是为了防止 IPFS 将数据存储到 C 盘的 %USERPROFILE%/.ipfs 目录下。

第二步:初始化 IPFS

ipfs init --profile server,unixfs-v1-2025,autoconf-off,announce-off

第三步:移除 Bootstrap、配置 DelegatedRouters 以及远程遥测

移除 Bootstrap

IPFS 在进行网络对等交换时,普通家庭网络通常会有 1000 或 3000 的连接数限制。过高的连接数可能导致网络不稳定,可以移除 Bootstrap 或者配置 libp2p-resource-limit-overrides.json 文件。

该命令的作用是移除 Bootstrap 引导节点:

ipfs bootstrap rm all

配置 DelegatedRouters

ipfs config --json Routing.DelegatedRouters "["""https://cid.contact"""]"

上述命令使用 cid.contact 作为内容寻址服务,也可以自建服务,现在 Kubo 版本已支持自建。

对于部分并非完全基于 FileCoin 部署的 IPFS,可以使用以下命令:

ipfs config --json Routing.DelegatedRouters "["""https://delegated-ipfs.speedtest.rr.kg"""]"
ipfs config Routing.Type autoclient

配置后需要重启 Kubo。

移除远程遥测

ipfs config Plugins.Plugins.telemetry.Config.Mode off

此命令可以将其关闭。

第三步:启动 IPFS

ipfs daemon

启动后,打开 http://127.0.0.1:5001/webui,会发现没有任何节点。
这并非出现了问题。确实没有任何节点,新用户将无法连接到任何节点,但这并不妨碍我们访问 FileCoin。

然后打开:
[http://127.0.0.1:8080/ipfs/bafyb4ig76jujcywxyofuhzxby2pih6zsz2xyo25uukpphpq5wadmqxvrfy/]
或
[http://127.0.0.1:8080/ipfs/bafyb4ig76jujcywxyofuhzxby2pih6zsz2xyo25uukpphpq5wadmqxvrfy/openlist/]

会发现,尽管我们没有任何节点,但仍然可以打开页面,因为数据是通过 HTTPS 通道传输的。

其他

也可以使用 Lassie。
下载时可以使用 ipfs pin 或 openlist + aria2 或者在链接后面加上 ?format=tar
。
可以不使用 ipfs repo gc 删除文件,而是直接删除 D:/tools/.ipfs 目录,然后按照步骤重新操作即可。
使用 ipfs config profile 可以查看可用的 profile。
一些细节:IPFS 初始化时,可使用 ipfs init --profile server,unixfs-v1-2025,autoconf-off,announce-off。
然后分别执行以下命令:

ipfs config Import.UnixFSFileMaxLinks 1024
ipfs config Import.HashFunction blake3
ipfs config Import.UnixFSHAMTDirectorySizeThreshold 1MiB
# MaxFanout 可不配置
ipfs config Import.UnixFSHAMTDirectoryMaxFanout 1024

KUBO 下载地址