1、ipfs

用法

使用范例

选项

参数标识

参数类型

介绍

-c, --config

string

配置文件路径

-D, --debug

bool

以debug模式操作,缺省为false

--help

bool

展示完整的命令帮助文档,缺省为false

-h

bool

展示精简版的命令帮助文档,缺省为false

-L, --local

bool

在本地运行命令,缺省为false

--api

string

使用具体的API实例(缺省为/ip4/127.0.0.1/tcp/5001)

子命令

基本命令

命令

介绍

init

初始化IPFS本地配置

Add <path>

添加一个文件到IPFS

cat <ref>

展示IPFS对象数据

get <ref>

下载IPFS对象

ls <ref>

从一个对象中列出链接

Refs <ref>

从一个对象中列出链接哈希

数据结构命令

命令

介绍

block

与数据存储中的原始块交互

object

与原始DAG节点交互

files

将对象抽象为unix文件系统,并与对象交互

dag

与IPLD文件交互(实验中)

高级命令

命令

介绍

daemon

开启一个开始运行的后台进程

mount

挂载一个IPFS只读的挂载点

resolve

解析任何类型的名字

name

发布并解析IPNS名字

key

创建并列出IPNS名字密钥对

dns

解析DNS链接

pin

将对象锁定到本地存储

repo

操纵IPFS仓库

stats

各种操作状态

filestore

管理文件仓库(实验中)

网络命令

命令

介绍

id

展示IPFS节点信息

bootstrap

添加或删除引导节点

swarm

管理p2p网络连接

dht

请求有关值或节点的分布式哈希表

ping

测量一个连接的延迟

diag

打印诊断信息

工具命令

命令

介绍

config

管理配置

version

展示IPFS版本信息

update

下载并应用go-ipfs更新

commands

列出所有可用命令

使用“ipfs <命令> --help”来了解关于每个命令的详细信息。

IPFS在本地文件系统中一个仓库,其默认位置为~/.ipfs,可以通过设置环境变量IPFS_PATH改变仓库位置:

export IPFS_PATH=/path/to/ipfsrepo
EXIT STATUS

命令行将以下面的两者之一结束:

·0 成功执行

·1 失败

使用“ipfs <子命令> –help”获得关于每个命令的更多信息。

2、ipfs add

用法

使用范例

参数

参数标识

参数类型

介绍

-r, --recursive

bool

递归添加目录路径。缺省为false

-q, --quiet

bool

最少化打印输出

-Q, --quieter

bool

只打印最终哈希

--silent

bool

不打印任何输出

-p, --progress

bool

以数据流方式处理数据

-t, --trickle

bool

使用滴式DAG格式生成DAG

-n, --only-hash

bool

仅分块和哈希,不写入磁盘

-w, --wrap-with-directory

bool

用目录对象包裹文件

-H, --hidden

bool

包括隐藏的文件。只有递归添加时有效

-s, --chunker

string

指定分块算法

--pin

bool

添加时将对象绑定到本次存储,缺省开启

--raw-leaves

bool

使用原始块作为叶子节点。(实验中)

--nocopy

bool

通过文件仓库添加文件。(实验中)

--fscache

bool

在文件仓库中检查与现存在的区块。(实验中)

描述           将<path>中的内容添加到IPFS。使用-r添加目录。注意:目录是递归添加的,以便于形成IPFS默克尔有向无环图。

包裹的选项,“-w”,将文件包裹到一个目录里。这个目录只含有被添加的这些文件,这意味着文件保留其本身的文件名,例如。

>ipfs add example.jpg
added QmbFMke1KXqnYyBBWxB74N4c5SBnJMVAiMNRcGu6x1AwQH example.jpg
> ipfs add example.jpg -w
added QmbFMke1KXqnYyBBWxB74N4c5SBnJMVAiMNRcGu6x1AwQH example.jpg
added QmaG4FuMqEBnQNn3C8XJ5bpW8kLs7zq2ZXgHptJHbKDDVx

你现在可以通过目录的方式访问被添加的文件,比如:

/ipfs/QmaG4FuMqEBnQNn3C8XJ5bpW8kLs7zq2ZXgHptJHbKDDVx/example.jpg

3、ipfs bitswap

3.1、ipfs bitswap

用法

使用范例

子命令

参数标识

介绍

ipfs bitswap ledger  <peer>

向一个节点展示目前的账本

ipfs bitswap  stat

在bitswap代理商展示一些诊断信息

ipfs bitswap  unwant <key>...

从你的需求列表上移除一个给定的区块

ipfs bitswap  wantlist

展示目前在需求列表上的区块

使用“ipfs bitswap <子命令> –help”来查看关于每个命令的更多信息。

3.2、ipfs bitswap ledger

用法

使用范例

参数

描述

3.3、ipfs bitswap stat

用法

使用范例

3.4、ipfs bitswap unwant

用法

使用范例

参数

3.5、ipfs bitswap wantlist

用法

使用范例

选项

描述

4、ipfs block

4.1、ipfs block

用法

使用范例

参数

描述

子命令

命令

介绍

ipfs block get  <key>

获取一个原始IPFS区块

ipfs block put  <data>

将输入存储为IPFS区块

ipfs block rm  <hash> ...

移除IPFS区块

ipfs block stat  <key>

打印关于一个原始IPFS区块的信息

使用“ipfs block <子命令> –help”获取更多关于每个命令的信息。

4.2、ipfs block get

用法

使用范例

参数

描述

4.3、ipfs block put

用法

使用范例

参数

选项

参数标识

参数类型

介绍

-f, --format

string

要创建的区块的cid格式,缺省为v0

--mhtype

string

多重哈希函数,缺省为sha2-256

--mhlen

int

多重哈希长度,缺省为-1

描述

4.4、ipfs block rm

用法

使用范例

参数

选项

参数标识

参数介绍

-f, --force bool

忽视不存在的区块,缺省为false.

-q, --quiet bool

最少化的写输出,缺省为false

描述

4.5、ipfs block stat

用法

使用范例

参数

描述

·               Key - base58编码的多重哈希。

·               大小 - 区块的大小(以字节为单位)。

5、ipfs bootstrap

5.1、ipfs bootstrap

用法

使用范例

描述

子命令

命令

介绍

ipfs bootstrap  add [<peer>]...

向引导节点列表中添加节点

ipfs bootstrap  list

展示列表中引导节点

ipfs bootstrap  rm [<peer>]...

从引导节点列表中移除节点

使用“ipfs bootstrap <子命令> --help”来查看关于每条命令的详细信息。

5.2、ipfs bootstrap add

用法

使用范例

参数

选项

描述

安全警示:

引导命令操纵包含引导节点地址的“bootstrap list”。这些是可信节点,通过这些节点可以了解网络中其他节点的状态。如果你不了解修改本列表的风险,请不要修改本列表。

子命令

使用 “ipfs bootstrap add <子命令> --help”来查看关于每条命令的详细信息。

5.3、ipfs bootstrap add default

用法

概要

描述

5.4、ipfs bootstrap list

用法

概要

描述

5.5、ipfs bootstrap rm

用法

概要

参数

选项

描述

安全警示:

引导命令操纵包含引导节点地址的“bootstrap list”。这些是可信节点,通过这些节点可以了解网络中其他节点的状态。如果你不了解修改本列表的风险,请不要修改本列表。

子命令

使用“ipfs bootstrap rm <子命令> --help”来查看关于每条命令的详细信息。

5.6、ipfs bootstrap rm all

用法

概要

描述