In, Docker and a projects have redefined we server applications. In the future, we might be running ized apps in our personal devices. At its core, this fast-paced improvement is a combination of good interfaces to standardize how to do things, and great tooling to make using containers easy.
TheProject has many things planned for the world of containers. The most interesting is using IPFS to distribute containers hyper efficiently across data-centers and the internet. We will be discussing many of these things in upcoming posts, but first things first. This post is a quick guide for running an IPFS node directly within Docker.
> mkdir /tmp/ipfs-docker-staging > mkdir /tmp/ipfs-docker-data > docker run -d --name ipfs-node / -v /tmp/ipfs-docker-staging:/export -v /tmp/ipfs-docker-data:/data/ipfs / -p 8080:8080 -p 4001:4001 -p 127.0.0.1:5001:5001 / jbenet/go-ipfs:latest faa8f714398c7a1a5a29adc2aed01857b41444ed53ec11863a3136ad37c8064c
8080 is the HTTP Gateway, which allows you to query data with your browser (see this example), port
4001 is what swarm port IPFS uses to communicate with other nodes, and port
5001 is used for the local API. We bind
5001 only on
127.0.0.1 because it should not be exposed to the outside world. The
faa8f7143... is the container id.
We’ve mounted a data and staging volume. The
data volume is used to store the IPFS local repo (config and database), and
staging is a directory you can use for staging files for command line usage (such as
ipfs add). If you’re only using the API, you can omit the staging directory volume. And of course, feel free to put those directories somewhere other than
Now what? Your node is running. You can issue commands directly to the containerized ipfs with
docker exec <container-id> <ipfs-cmd>. For example, you can try
ipfs swarm peers to see who you are connected to:
# let's set $cid = <container-id> for easy access > cid=faa8f714398c7a1a5a29adc2aed01857b41444ed53ec11863a3136ad37c8064c > docker exec $cid ipfs swarm peers /ip4/22.214.171.124/tcp/4001/ipfs/QmSoLpPVmHKQ4XTPdz8tjDFgdeRFkpV8JgYq8JVJ69RrZm /ip4/126.96.36.199/tcp/4001/ipfs/QmSoLSafTMBsPKadTEgaXctDQVcqN88CNLHXMkTNwMKPnu /ip4/188.8.131.52/tcp/4001/ipfs/QmSoLueR4xBeUbY9WZ9xGUUxunbKWcrNFTDAadQJmocnWm /ip4/184.108.40.206/tcp/4001/ipfs/QmSoLMeWqB7YGVLJN3pNLQpmmEk35v6wYtsMGLzSr5QBU3
And of course, you can
cat content as usual:
> echo "hello from dockerized ipfs" >/tmp/ipfs-docker-staging/hello > docker exec $cid ipfs add /export/hello added QmcDge1SrsTBU8b9PBGTGYguNRnm84Kvg8axfGURxqZpR1 /export/hello > docker exec $cid ipfs cat /ipfs/QmSvCqazpuuib8qyRyddyFemLc2qmRukLLy8YfkdRPEXoQ hello there!
Your dockerized IPFS is now also running a Gateway at
http://<ip-address-of-the-computer>:8080. You can try it out with
curl, or with your browser:
> curl http://localhost:8080/ipfs/QmcDge1SrsTBU8b9PBGTGYguNRnm84Kvg8axfGURxqZpR1 hello from dockerized ipfs
Kubernetes 1.0 comes out next week, so after that, we’ll try using it to build a cluster of IPFS nodes that can store any kind of data and be able to retreive it from any other IPFS node. Not just with IPFS nodes in your cluster, but with everyone!
asciicast powered by asciinema
点对点科技深耘IPFS与Filecoin技术，坚持区块链技术改变未来的信念。点对点 IPFS 数据中心是目前国内技术领先，性价比高、保障优的投资标的。自建杭州数据中心，合作数据中心分布于上海、宁波、河北、香港、斯德哥尔摩（瑞典）等地。点对点数据中心具有优秀的硬件配置与目前国内优质的网络节点资源。点对点科技力求将IPFS爱好者升级为IPFS领军者与受益者，让IPFS颠覆传统互联网，共同开启 WEB 3.0时代。