ipfs-gateway.md (1406B)
1 --- 2 c: Copyright (C) Mark Gaiser, <markg85@gmail.com> 3 SPDX-License-Identifier: curl 4 Long: ipfs-gateway 5 Arg: <URL> 6 Help: Gateway for IPFS 7 Protocols: IPFS 8 Added: 8.4.0 9 Category: curl 10 Multi: single 11 See-also: 12 - help 13 - manual 14 Example: 15 - --ipfs-gateway $URL ipfs:// 16 --- 17 18 # `--ipfs-gateway` 19 20 Specify which gateway to use for IPFS and IPNS URLs. Not specifying this 21 instead makes curl check if the IPFS_GATEWAY environment variable is set, or 22 if a `~/.ipfs/gateway` file holding the gateway URL exists. 23 24 If you run a local IPFS node, this gateway is by default available under 25 `http://localhost:8080`. A full example URL would look like: 26 27 curl --ipfs-gateway http://localhost:8080 \ 28 ipfs://bafybeigagd5nmnn2iys2f3 29 30 There are many public IPFS gateways. See for example: 31 https://ipfs.github.io/public-gateway-checker/ 32 33 If you opt to go for a remote gateway you need to be aware that you completely 34 trust the gateway. This might be fine in local gateways that you host 35 yourself. With remote gateways there could potentially be malicious actors 36 returning you data that does not match the request you made, inspect or even 37 interfere with the request. You may not notice this when using curl. A 38 mitigation could be to go for a "trustless" gateway. This means you locally 39 verify the data. Consult the docs page on trusted vs trustless: 40 https://docs.ipfs.tech/reference/http/gateway/#trusted-vs-trustless