Lesson: Access IPFS content through any IPFS gateway
This lesson covers using any IPFS gateway to access IPFS content. It's a condensed review of the Lesson on Using an HTTP browser to retrieve files from a local IPFS gateway
After doing this Lesson you will be able to
- Use the HTTP address of any IPFS gateway to access IPFS content
Step 1: Get the address of a gateway
As we covered in Tutorial: Going Online - Joining the Distributed Web, when you run an IPFS daemon, it exposes an HTTP endpoint that acts as a gateway between HTTP and the IPFS network. This means that you can, in theory, point your web browser at any IPFS node's HTTP endpoint and use it as a gateway. In reality, the person operating that node usually needs to take extra steps to make their gateway available over HTTP (NAT traversal, etc).
For these examples we will use the gateway at
Step 2: Build the Path to your Content
As described in the Lesson on Using an HTTP browser to retrieve files from local IPFS gateway, you must tell the gateway whether you're requesting content with an IPFS hash or an IPNS hash. If you're using the hash of a specific snapshot of content -- for example a file that someone added to IPFS, use the path
/ipfs/<your-ipfs-hash>. If you're using an IPNS hash to get the latest version of some content that gets updated over time, for example a website that gets fresh content every day, use the path
Step 3: Request the content from the gateway
Combine the gateway's address (ie.
https://dweb.link) with the path to your content (ie.
/ipfs/<your-ipfs-hash>). Use that to request the content.
To view the wikipedia page we're using as an example in all of the lessons in the Tutorial on Avenues for Access, use these links:
- 2017-04-30 snapshot: http://dweb.link/ipfs/Qme2sLfe9ZMdiuWsEtajWMDzx6B7VbjzpSC2VWhtB6GoB1/wiki/Anasayfa.html
- latest (IPNS): http://dweb.link/ipns/QmQP99yW82xNKPxXLroxj1rMYMGF6Grwjj2o4svsdmGh7S/wiki/Anasayfa.html
- latest (DNS): http://dweb.link/ipns/wikipedia-on-ipfs.io
This explanation has not been written yet. If you want to help work on it, or if you want to encourage us to give it attention, open an issue at https://github.com/flyingzumwalt/decentralized-web-primer/issues
- Restricting the content that your gateway will serve
- Security concerns -- the gateway can see all the things that an HTTP server can see.
If you want to learn about the many other ways you can use IPFS to access the same content using the same content-addressed link, go to the Tutorial on Avenues for Access.
Otherwise return to the tutorial on Interacting with the Classical (HTTP) web