Jak pobrać plik z IPFS znając tylko CID?

W skrócie

• Czego potrzebujesz: wyłącznie identyfikatora CID pobieranego pliku
• Najszybciej, bez instalacji: publiczna bramka IPFS otwarta w przeglądarce — wystarczy dokleić CID do adresu bramki (Metoda 1)
• Bez instalacji, ale bez pośrednika: przeglądarka Brave obsługuje adresy ipfs:// natywnie (Metoda 2)
• Do regularnej pracy: aplikacja IPFS Desktop z interfejsem graficznym, pozwalająca też przypinać i udostępniać pliki (Metoda 3)
• Do skryptów i automatyzacji: wiersz polecenia Kubo — ipfs get <CID> (Metoda 4)
• Weryfikacja: pobranie przez lokalny węzeł samo potwierdza, że plik jest nienaruszony; korzystając z bramki, ufasz pośrednikowi

Aby pobrać plik z sieci IPFS (InterPlanetary File System), znając jego identyfikator CID (Content Identifier), możesz skorzystać z kilku metod. Wybór zależy od częstotliwości korzystania z IPFS oraz preferencji dotyczących narzędzi – od prostych rozwiązań w przeglądarce po dedykowane oprogramowanie.

Poniżej znajduje się kompletny przewodnik opisujący dostępne opcje.

Metoda 1: Publiczne bramki IPFS (najszybsza, bez instalacji)

Najprostszym sposobem na pobranie pliku jest skorzystanie z publicznej bramki (public gateway). Bramka ta działa jako most między tradycyjnym internetem a siecią IPFS.

Instrukcja krok po kroku:

1. Skopiuj swój CID (np. bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi).
2. Dodaj go do adresu jednej z popularnych publicznych bramek:
   • https://ipfs.io/ipfs/<TWÓJ_CID>
   • https://dweb.link/ipfs/<TWÓJ_CID>
   • https://w3s.link/ipfs/<TWÓJ_CID>
3. Naciśnij Enter. Przeglądarka załaduje plik, który następnie zapiszesz na dysku (prawy przycisk myszy → Zapisz jako).

Wskazówka: Publiczne bramki bywają przeciążone, a bywa też, że przestają działać na dobre — tak stało się z bramką Cloudflare. Jeśli któraś działa zbyt wolno lub nie odpowiada, po prostu użyj innej: CID pozostaje ten sam niezależnie od bramki.

Metoda 2: Przeglądarka Brave (wbudowana obsługa IPFS)

Jeśli używasz przeglądarki Brave, proces jest jeszcze prostszy – Brave posiada natywną obsługę protokołu IPFS.

1. W pasku adresu wpisz: ipfs://<TWÓJ_CID>
2. Przy pierwszym użyciu Brave zapyta, czy chcesz uruchomić lokalny węzeł IPFS, czy korzystać z publicznej bramki. Możesz wybrać dowolną opcję – lokalny węzeł wymaga początkowo pobrania dodatkowych komponentów, ale oferuje lepszą prywatność.
3. Plik zostanie wyświetlony lub automatycznie pobrany.

Metoda 3: IPFS Desktop (dla regularnych użytkowników)

Jeśli planujesz częściej pracować z IPFS (zarówno pobierać, jak i udostępniać pliki), najlepiej zainstalować oficjalną aplikację z interfejsem graficznym – IPFS Desktop.

Kroki:

1. Instalacja: Pobierz instalator ze strony wydań projektu i zainstaluj program. Nazwy plików zawierają numer wersji, więc wybierz pozycję odpowiadającą swojemu systemowi:

   System	Końcówka nazwy pliku
   Windows	-win-x64.exe
   macOS	-mac.dmg
   Debian, Ubuntu	-linux-amd64.deb
   Fedora, RHEL	-linux-x86_64.rpm
   dowolny Linux	-linux-x86_64.AppImage
   Snap	-linux-amd64.snap

   Wszystkie pliki zaczynają się od ipfs-desktop- i zawierają numer wersji, na przykład ipfs-desktop-setup-0.50.0-win-x64.exe. Instalatory ważą od 140 do 300 MB. Pełną instrukcję, wraz z wariantami przez menedżery pakietów, znajdziesz w oficjalnej dokumentacji IPFS.

2. Uruchomienie węzła: Po uruchomieniu aplikacji program automatycznie połączy się z siecią P2P i zacznie działać jako Twój prywatny, lokalny węzeł IPFS.

3. Import pliku: W panelu bocznym przejdź do zakładki Files (Pliki), kliknij niebieski przycisk Import w prawym górnym rogu i wybierz From IPFS.

4. Pobieranie: Wklej swój CID. Aplikacja zlokalizuje plik w sieci, pobierze go i przypnie do Twojego węzła. Aby zapisać plik w standardowym folderze, kliknij ikonkę trzech kropek obok nazwy pliku i wybierz Download.

Metoda 4: Wiersz polecenia (Kubo / IPFS CLI)

Dla programistów i zaawansowanych użytkowników najlepszym rozwiązaniem jest oficjalna implementacja w języku Go, znana jako Kubo.

Instrukcja:

1. Zainstaluj Kubo zgodnie z oficjalną dokumentacją IPFS.

2. Zainicjuj i uruchom demona w terminalu:

   ipfs init
   ipfs daemon

   Demon musi działać w tle, więc kolejne polecenia wydawaj w drugim oknie terminala.

3. Pobierz plik, podając CID:

   ipfs get <TWÓJ_CID>

   Plik zapisze się w bieżącym katalogu pod nazwą odpowiadającą CID. Aby nadać mu własną nazwę, użyj opcji -o:

   ipfs get <TWÓJ_CID> -o nagranie.wav

   Jeśli wolisz przekierować zawartość wprost do pliku albo do potoku:

   ipfs cat <TWÓJ_CID> > nagranie.wav

4. Opcjonalnie przypnij plik, żeby węzeł zachował go trwale i udostępniał innym uczestnikom sieci:

   ipfs pin add <TWÓJ_CID>

Pobranie przez IPFS jest zarazem weryfikacją

CID nie jest zwykłym adresem — to skrót kryptograficzny zawartości. Węzeł IPFS sprawdza zgodność w trakcie pobierania i odrzuca dane, które CID nie odpowiadają. Jeśli ipfs get zakończy się powodzeniem, masz pewność, że otrzymany plik jest dokładnie tym, który opisuje identyfikator — nikt nie podmienił go po drodze.

Przy publicznej bramce (Metoda 1) weryfikację wykonuje za Ciebie bramka, a Ty ufasz jej połączeniu HTTPS. Metody 2–4, korzystające z lokalnego węzła, dają tę gwarancję bez pośrednika.