WEB3DEV

Cover image for Como Salvar um Arquivo em IPFS — Um Guia de 7 Passos
Fatima Lima
Fatima Lima

Posted on • Atualizado em

Como Salvar um Arquivo em IPFS — Um Guia de 7 Passos

Armazene arquivos permanentemente no Sistema de Arquivos Inter-Planetário ("IPFS"), e aprenda como fazê-lo rápida e facilmente neste guia.

O Sistema de Arquivo Inter-Planetário, ou "IPFS", é uma das tecnologias mais incríveis que eu já vi.

Encontre o protocolo de código aberto aqui: https://github.com/ipfs/ipfs

O IPFS permite que você armazene seus arquivos permanentemente, fazendo backup deles em computadores ao redor do mundo. E permite que você faça o download de seus arquivos mais rapidamente. Deixe-me explicar.

Digamos que sua empresa crie diariamente um vídeo clipe relevante de 1 hora, que milhões de consumidores assistam diariamente e retroativamente. Este seria um empreendimento caro! Você precisaria comprar muita largura de banda e espaço de armazenamento.

E se seus vídeos são realmente importantes, então eles devem ser acessíveis, não importa o que aconteça. Entretanto, com o protocolo HTTP de hoje, os vídeos são acessíveis apenas enquanto seus servidores estiverem em funcionamento e os consumidores puderem recuperar os dados em meio a um tráfego intenso.

Mas e se os arquivos de vídeo fossem distribuídos em todo o mundo para que nunca pudessem ser perdidos? E se você pudesse recuperar rapidamente pedaços dos arquivos de vídeo dos computadores de seus vizinhos, em vez de viajar para um servidor do outro lado do mundo? E se você também pudesse atualizar, renomear e ajustar as permissões desses arquivos enquanto eles ficam espalhados, armazenados em todo o universo?

Bem, então você teria uma internet descentralizada, mais permanente. Uma onde os links nunca retornem o erro 404 e uma em que não dependamos dos servidores da Amazon, Google, Facebook e Apple. É como o HTTP web + Git + BitTorrent.

Esse é o futuro prometido pelo Sistema de Arquivo Interplanetário

Como você vai acessar este vídeo se o YouTube o remover ou alterar o link?

Como salvar um arquivo para IPFS?

O modo como você interage com o IPFS hoje é por meio de uma interface de linha de comando. Esta pode ser uma nova experiência para não programadores, por isso escrevi este guia passo a passo para carregar seu primeiro arquivo para o IPFS¹.

Passo 1: Baixar e Instalar o IPFS para sua Plataforma

Este aqui é fácil, basta seguir este link para o site do IPFS e fazer o download.

Passo 2: Mover o Arquivo Executável para sua Localização Adequada

Você acabou de baixar uma pasta compactada. Agora devemos extrair o conteúdo, e colocar o arquivo ipfs no $PATH / %PATH% (Leia isto no PATH se estiver confuso). As instruções começam a diferir entre os sistemas operacionais Mac/Linux e Windows:

Para Mac/Linx:

Após o download, descompacte a pasta arquivada e mova o arquivo ipfs para algum lugar no seu $PATH. Para fazer isso via Terminal:

sudo mv ipfs /usr/local/bin/ipfs
Enter fullscreen mode Exit fullscreen mode

Para Windows:

Após o download, descompacte o arquivo e, então, recorte o ipfs.exe e cole em algum lugar em seu %PATH%. Você também pode realizar isto através do Prompt de Comando:

[Win + "cmd" -> right-click -> Run as Administrator]
C:\Users\yourName\Downloads>move .\go-ipfs\ipfs.exe C:\Windows
Enter fullscreen mode Exit fullscreen mode

Passo 3: Inicializar o IPFS

Ótimo trabalho até agora! Neste ponto, você deve abrir sua interface de linha de comando para continuar. Em um Mac, procure por terminal, para Windows, procure por cmd.

Agora, confirme que você moveu corretamente o arquivo executável digitando ipfse pressionando Return. Você deve ver o seguinte:

USAGE
 ipfs - Global p2p merkle-dag filesystem.
 ...
Enter fullscreen mode Exit fullscreen mode

Tudo está instalado corretamente, portanto, é o momento de init seu repositório² IPFS. Digite: ipfs init e clique em Return. Você verá algo semelhante a isso:

$ ipfs init
initializing ipfs node at /Users/yourName/.ipfs
generating 2048-bit RSA keypair...done
peer identity: Qmcpo2iLBikrdf1d6QU6vXuNb6P7hwrbNPW9kLAH8eG67z
to get started, enter:

 ipfs cat /ipfs/QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG/readme
Enter fullscreen mode Exit fullscreen mode

Vá em frente e siga as instruções: copie e cole ipfs cat /ipfs/QmY...bdG/readme e você deve ver algo como o seguinte³.


Hello and Welcome to IPFS!

██╗██████╗ ███████╗███████╗
██║██╔══██╗██╔════╝██╔════╝
██║██████╔╝█████╗  ███████╗
██║██╔═══╝ ██╔══╝  ╚════██║
██║██║     ██║     ███████║
╚═╝╚═╝     ╚═╝     ╚══════╝

Se você estiver vendo isso, você instalou o IPFS com sucesso e agora está fazendo a interface com o merkledag ipfs!

Enter fullscreen mode Exit fullscreen mode

Passo 4: Acrescentar um Artigo ao IPFS

Agora estamos prontos para adicionar nosso primeiro arquivo ao IPFS! 🎉

Image description

Certamente eles merecem!

Primeiro, no terminal, você pretende "mudar os diretórios" para chegar à pasta onde seus arquivos se encontram. Para mudar os diretórios, digite cd c:/yourPathHere (vídeo com tutorial aqui). Vou pegar uma pasta chamada rare em minha pasta Pictures.

Vou adicionar ao IPFS a pasta armazenando a foto à esquerda (rare.jpg) e uma outra amostra.

Veja abaixo como é fácil:

$ ipfs add rare -r
added QmUbTW9iDRz4XgbHc62viUDSM76i1n52frG8HqqyarfMQk rare/XXX.jpg
added QmRuzPpc1tjJ5TbhG7B2Ato8LtaY2DK2Y5DMWWb29cqFF5 rare/rare.jpg
added QmdNMBVqQJ9baQDAJMUwci8LzVK2a52cTLEHoinaKFEdFY rare
Enter fullscreen mode Exit fullscreen mode

O que você vê acima é um caminho (ou seja, um link) para a pasta “pai” rare, e links diretos aos objetos “filhos”.

Passo 5: Fixar seu Arquivo ao IPFS

Agora, vamos pin os arquivos que acrescentamos ao IPFS para nosso armazenamento local. Presumivelmente, estes arquivos já existem em nossa máquina e, ao fixar o arquivo, outros nós da rede IPFS sabem que podem acessar o arquivo a partir de nossa máquina. Abaixo, eu fixo o diretório rare:

$ ipfs pin add QmdNMBVqQJ9baQDAJMUwci8LzVK2a52cTLEHoinaKFEdFY
pinned QmdNMBVqQJ9baQDAJMUwci8LzVK2a52cTLEHoinaKFEdFY recursively

Enter fullscreen mode Exit fullscreen mode

Passo 6: Conectar sua Máquina IPFS à Rede

Nesta próxima etapa, introduziremos sua máquina na rede IPFS. Isto permite que outros participantes da rede acessem sua máquina, recuperem arquivos de sua máquina, e que você acesse arquivos de outras máquinas⁴.

Digite o seguinte para se conectar à rede:

$ ipfs daemon
Initializing daemon...
Enter fullscreen mode Exit fullscreen mode

Abra um outro terminal (ou Prompt de Comando), e dê uma olhada em quem está conectado à sua máquina:

$ ipfs swarm peers
Enter fullscreen mode Exit fullscreen mode

A Protocol Labs, a empresa que mantém o IPFS, tem uma série de nós de bootstrapping que estão ativamente à procura de novos conteúdos colocados na rede.

Além disso, a Protocol Labs mantém um porta HTTP -> IPFS, em que você pode acessar qualquer um de seus arquivos a partir de seu website, onde montaram o sistema IPFS em sua URL HTTP: https://ipfs.io/ipfs/[yourHash].

Confira meu arquivo acima, totalmente carregado no IPFS: https://ipfs.io/ipfs/QmRuzPpc1tjJ5TbhG7B2Ato8LtaY2DK2Y5DMWWb29cqFF5

Passo 7: Não se Esqueça de Fechar o Daemon

Por último, mas não menos importante, certifique-se de desconectar-se da rede quando estiver pronto. Volte para o terminal onde o daemon está sendo executado, e clique: CTRL + C a fim de parar o processo.

Espero que tenha gostado deste guia de 7 passos para adicionar um arquivo ao IPFS!

Por favor, certifique-se de 👏 se você gostou desse post. Sinta-se à vontade para me contactar no Twitter ou no GitHub @JohnZettler ou saiba mais sobre minha formação aqui: johnzettler.com.

Agradecimentos editoriais a:

Tommy Nicholas, Kevin Trinh e Matthew Russo

[1] Note que minha máquina é um sistema operacional Windows 10, x64, e eu uso Cygwin para simular um ambiente do tipo Unix em minha máquina. Para os usuários do Windows - sintam-se à vontade para usar o cmd.exe - isto também funciona.

[2] Este é provavelmente um novo conceito para aqueles que são novos em Git. Pense nisto como uma pasta de armazenamento virtual que pode rastrear tanto os arquivos em sua máquina quanto o histórico de suas versões.

[3] Note que o hash (ou seja, o endereço) na saída do seu terminal será diferente do que o no exemplo acima. Use aquele que seu terminal retornar.

[4] Lembre-se de que acessar qualquer rede envolve riscos de segurança, e que o IPFS está em Alfa. Acesse o IPFS por sua própria conta e risco, por sua própria vontade.

Este artigo foi escrito por John Zettler, traduzido por Fátima Lima e seu original pode ser lido aqui.

Top comments (0)