Salut les copains, Aujourd'hui, petit tutoriel **IPFS**. Je vais vous montrer comment installer un démon IPFS et vous donnez quelques commandes utiles pour débuter. Mais tout d'abord un petit rappel de ce qu'est IPFS... IPFS signifie ***InterPlanetary File System***. C'est un nouveau protocole permettant d'échanger du contenu multimédia entre pairs (peer-to-peer). La différence avec les autres protocoles existants (comme Torrent par exemple) c'est que chaque fichier, et même chaque morceau de fichier, se voit attribué un **hash**. Un hash est une suite unique de lettres. Si deux fichiers ont le *même* *hash*, c'est que les fichiers sont *identiques* * ! Pour une explication plus imagée, je vous renvoie à ma dernière vidéo (vers 1:15). ![ipfs_logo.jpg](https://res.cloudinary.com/hpiynhbhq/image/upload/v1520201519/bwyljpu4zxahmv5x0hvc.jpg) # Installation IPFS n'est pour le moment pas un standard reconnu par les éditeurs d'OS et de logiciels (même si certains projet y travaillent : js-ipfs, Brave, Firefox, ArchLinux ). Il vous faudra donc installer un démon localement. Rendez-vous sur la page de distribution et téléchargez la version go-ipfs correspondant à votre config pc. ![dist.png](https://res.cloudinary.com/hpiynhbhq/image/upload/v1520200773/wmrfi5jzwvlu5hti1b4c.png) Dézippez l'archive téléchargée et mettez le dossier dans un endroit "propre" (un dossier caché à la racine de votre home ou dans %appdata%). Ce dossier contient l'exécutable ipfs écrit en Go. Pour une utilisation simple, je vous conseille d'ajouter ce dossier à votre path ( how to : Windows / Linux ) Une fois que vous êtes prêt, vous allez pouvoir créer votre identifiant IPFS. Pour cela, rien de plus simple : ouvrez un terminal et tapez la commande `ipfs init`. Si l'exécutable IPFS n'est pas dans votre path, il faudra fournir le chemin complet : ```/chemin/du/dossier/ipfs init``` *(pour Linux)* ```C:\chemin\du\dosier\ipfs.exe init``` *(pour Windows)* Vous devriez voir quelque chose comme ça : ![ipfsinit.PNG](https://res.cloudinary.com/hpiynhbhq/image/upload/v1520200880/rlaeaap3dfxkjm1rl5fe.png) Un dossier `.ipfs` vient d'être créé à la racine de votre home (`C:\Users\votre_nom\.ipfs` ou `/home/votre_nom/.ipfs`) Il contient notamment un fichier "config" avec votre id IPFS et tout un tas de paramètres. C'est aussi dans ce dossier (sous datastore) que seront téléchargés les fichiers IPFS. Vous pouvez maintenant **démarrer votre démon** IPFS. Dans votre terminal tapez `ipfs daemon`. Voilà vous êtes maintenant un nœud du réseau IPFS et vous pouvez redistribuer les vidéos de DTube que vous regardez ! ;) ![daemon.PNG](https://res.cloudinary.com/hpiynhbhq/image/upload/v1520200954/hkd2ng25erck0msqtcar.png) # Aller plus loin Si vous ne voulez plus remettre les doigts dans un terminal, il existe un petit programme pour Windows : IPFS-Gui, qui vous permettra de lancer le démon en un clic depuis la bar de widget. ![gui.PNG](https://res.cloudinary.com/hpiynhbhq/image/upload/v1520200941/vbohpqa1sobicayx9gti.png) Il existe aussi des add-ons pour Chrome et Firefox, qui vous permettent : - d'ouvrir la page d'administration d'IPFS - d'uploader facilement des fichiers - de voir rapidement le nombre de pairs auxquels vous êtes connecté - de rediriger les adresses des passerelles (comme ipfs.io) vers votre démon local - d'avoir une notification lorsque IPFS-Gui démarre bien le démon (sinon c'est silencieux et pas très intuitif) Je vous les recommande fortement :) ## Quelques commandes utiles On peut se passer du terminal pour naviguer sur IPFS mais si vous voulez maintenir un nœud IPFS propre, il va falloir rouvrir la boite noir... Si vous redistribuez des fichiers vous allez les télécharger une première fois. Ils vont se stocker dans le dossier *.ipfs/* jusqu'à ce que vous éteigniez votre démon. Autrement dit, IPFS les mets dans son cache. Mais si vous voulez continuer à seeder des fichiers même après un redémarrage de votre démon, il va falloir épingler (*to pin* - en anglais) ce dit fichier. - Voici la commande pour épingler un fichier : ``` ipfs pin add --progress ``` Par exemple je vous conseille d'épingler la page d'administration IPFS pour éviter de la télécharger à chaque fois : ``` ipfs pin add --progress QmPhnvn747LqwPYMJmQVorMaGbMSgA7mRRoyyZYz3DoZRQ ``` - Pour ajouter un fichier à IPFS et générer son hash : ``` ipfs add -rp ``` `-r` permet d'ajouter *récursivement* un dossier et tous ses sous-dossiers/fichiers. `-p` permet d'afficher une bar de *progression*. \* **!** Suivant les options que vous passez, le hash peut varier **!** Par exemple, `ipfs add --nocopy` permet de ne pas dupliquer le fichier dans votre dossier local .ipfs. Ce qui est pratique pour réduire la taille sur le disque mais le hash sera différent avec cette option. Autre exemple, pour obtenir le même hash que sur DTube, il faudra ajouter l'option -t (trickle dag), qui optimise le streaming des medias. ``` ipfs add -rpt ``` - La commande pour unpin un fichier : ``` ipfs pin rm ``` - Et si vous voulez nettoyer le cache IPFS sans redémarrer votre démon : ``` ipfs repo gc ``` qui lancera le Garbage Collector. Vous arrêterez alors de seeder tous les fichiers non épinglés. - Pour voir la liste des hashes pin de votre nœud : ``` ipfs pin ls ``` Vous verrez alors des hashes avec la mention **indirect** ou **recursive**. Les premiers sont des fragments des deuxièmes. Si vous recherchez le hash d'un fichier, recherchez parmi les "recursive". ----------------------------------------------------------------------------------------------------------------- Je m'arrête ici pour ce tuto. Vous avez les bases pour utiliser IPFS, via DTube notamment et aider le réseau à prospérer. Pour les plus féru, je vous renvoie vers la documentation IPFS et sa communauté. Vous pouvez aussi venir en discuter en Anglais dans le chat Riot. N'hésitez pas à mettre ce tuto en application, ce n'est pas très compliqué et vous comprendrez surement mieux comment fonctionne IPFS et les plateformes comme DTube ou DSound :) ---------------------------------------------------------------------- Pensez aussi à partager ce tuto pour construire ensemble l'internet décentralisé de demain. Et upvotez si vous avez trouvé ça intéressant :) https://steemitimages.com/DQmY7NSmHE1GRy3XoyX1KyyaTUSEaBUiDhEGbMZmGLye7AA/nouts%20logo%20blanc%20cass%C3%A9-01-XXsmall.png [Édité] - Ajout de la commande ipfs add et option -t trickle dag.