入门指南
如果你已经完成本章节,可直接阅读 安装IPFS
开始安装IPFS
在阅读本教程的过程中,如果有任何的疑问,可以访问 https://discuss.ipfs.io/ 或者在 chat.freenode.net 上联系 #ipfs
初始化库
ipfs使用一个全局本地对象库, 添加到~/.ipfs:
> ipfs init
initializing ipfs node at /Users/jbenet/.go-ipfs
generating 2048-bit RSA keypair...done
peer identity: Qmcpo2iLBikrdf1d6QU6vXuNb6P7hwrbNPW9kLAH8eG67z
to get started, enter:
ipfs cat /ipfs/QmS4ustL54uo8FzR9455qaxZwuMiUhyvMcX9Ba8nUH4uVv/readme
注意这里的哈希值和你得到的是不同的,你需要使用你初始化时得到的哈希值.
现在运行如下命令:
ipfs cat /ipfs/QmS4ustL54uo8FzR9455qaxZwuMiUhyvMcX9Ba8nUH4uVv/readme
你会看到类似这样的输出:
Hello and Welcome to IPFS!
██╗██████╗ ███████╗███████╗
██║██╔══██╗██╔════╝██╔════╝
██║██████╔╝█████╗ ███████╗
██║██╔═══╝ ██╔══╝ ╚════██║
██║██║ ██║ ███████║
╚═╝╚═╝ ╚═╝ ╚══════╝
如果你能看到这样的输出,那么你已经成功的安装了IPFS, 并且现在通过接口方式访问Merkle DAG!
-------------------------------------------------------
| 警告: |
| 这是一个alpha版本软件. 自行决定是否使用|
| 还存在很多遗漏和不完善. 也存在缺陷. |
| 还不够安全.阅读安全说明了解更多信息. |
-------------------------------------------------------
查看目录中的其他文件:
./about
./help
./quick-start <-- 使用实例
./readme <-- 本文件
./security-notes
你可以查看其他的内容. 试试快速启动（quick-start):
ipfs cat /ipfs/QmS4ustL54uo8FzR9455qaxZwuMiUhyvMcX9Ba8nUH4uVv/quick-start
您将会看到一些有趣的例子.
上线
一旦你已经准备好上线, 在另外一终端上运行ipfs的后台进程:
> ipfs daemon
Initializing daemon...
API server listening on /ip4/127.0.0.1/tcp/5001
Gateway server listening on /ip4/127.0.0.1/tcp/8080
Wait for all three lines to appear.
记下你得到的tcp端口信息。 如果它们和这里的不同，请在以下命令中使用你自己得到的端口信息。
现在，切换回原来的终端界面。 如果计算机连接了网络，你应该能够看到对等方的ipfs地址：
> ipfs swarm peers
/ip4/104.131.131.82/tcp/4001/ipfs/QmaCpDMGvV2BGHeYERUEnRQAwe3N8SzbUtfsmvsqQLuvuJ
/ip4/104.236.151.122/tcp/4001/ipfs/QmSoLju6m7xTh3DuokvT3886QRYqxAzb1kShaanJgW36yx
/ip4/134.121.64.93/tcp/1035/ipfs/QmWHyrPWQnsz1wxHR219ooJDYTvxJPyZuDUPSDpdsAovN5
/ip4/178.62.8.190/tcp/4002/ipfs/QmdXzZ25cyzSF99csCQmmPZ1NTbWTe8qtKFaZKpZQPdTFB
是一个<传输地址>/ipfs/<哈希公钥>的组合.
现在你应该能够从网络获取到对象. 输入如下命令:
ipfs cat /ipfs/QmW2WQi7j6c7UgJTarActp7tDNikE4B2qXtFCfLPdsgaTQ/cat.jpg >cat.jpg
open cat.jpg
还有,你也应该能够提供网络对象. 尝试增加一个, 然后从你的浏览器里查看它.在此示例中，我们使用curl的方式浏览，当然您也可以在其他浏览器中打开IPFS URL地址：
> hash=`echo "I <3 IPFS -$(whoami)" | ipfs add -q`
> curl "https://ipfs.io/ipfs/$hash"
I <3 IPFS -
是不是很炫酷? 在计算机上,网关提供一个文件。 网关查询DHT，找到您的机器，请求文件，机器将这个文件发送给网关，网关将其发送到浏览器
注意: 依赖于网络环境的不同, curl请求可能会花一点时间.公共网关可能会过载,或者是请求会耗时比较久才能到达. 你也可以通过本地的网关来检查:
> curl "http://127.0.0.1:8080/ipfs/$hash"
I <3 IPFS -
默认情况下, 你的网关是不会暴露的,仅仅是本地开放.
超炫的网页控制台
我们有一网页控制台用于检查节点的状态.使用浏览器打开地址:
http://localhost:5001/webui
网页控制台的界面:
现在,你已经准备好了,可以查看:
更多的例子
Tip 打赏
译者 qaeasy
ETH: 0x7CdaF81D544E2a3bd993e639D1a4d6785067cB24
