Przypinanie

Jak pliki trwają w sieci IPFS i dlaczego przypinanie jest ważne.

Problem zbierania śmieci

Węzły IPFS mają ograniczoną pamięć. Aby zarządzać przestrzenią dyskową, okresowo uruchamiają zbieranie śmieci — proces usuwający buforowane dane, które nie zostały wyraźnie oznaczone jako ważne. Bez interwencji plik, który przesłałeś, może zostać usunięty z sieci w ciągu kilku godzin.

Przypinanie mówi węzłowi IPFS: "zachowaj ten plik na stałe — nie zbieraj go jako śmieci." Przypięty plik pozostaje w pamięci węzła na czas nieokreślony, zapewniając jego dostępność w sieci.

Przypinanie lokalne vs. zdalne

Przypinanie lokalne oznacza uruchomienie własnego węzła IPFS i przypinanie plików do niego. Jesteś odpowiedzialny za czas pracy, pamięć i łączność sieciową. Jeśli twój węzeł przejdzie w tryb offline, twoje pliki staną się niedostępne.

Przypinanie zdalne (to, co zapewnia IPFS.NINJA) oznacza, że zarządzana usługa przypina twoje pliki na infrastrukturze, która jest zawsze online. Otrzymujesz trwałość przypinania bez uruchamiania własnego węzła.

TIP

Każdy plik przesłany przez IPFS.NINJA jest automatycznie przypinany do naszego klastra IPFS. Nie są potrzebne dodatkowe kroki — twoje pliki są trwałe od momentu przesłania.

Co się dzieje po odpięciu

Jeśli usuniesz plik z konta IPFS.NINJA, odpinamy go z naszych węzłów. Plik może nadal być dostępny, jeśli:

• Inne węzły IPFS buforują lub przypięły ten sam CID
• Bramka IPFS ma plik w pamięci podręcznej
• Inny użytkownik przesłał tę samą treść (ten sam CID = ten sam plik)

Z czasem, bez żadnego węzła przypinającego CID, plik zostanie całkowicie usunięty z sieci przez zbieranie śmieci.

Najlepsze praktyki przypinania

• Przypinaj wcześnie — Prześlij i przypnij treść przed odwoływaniem się do CID w smart kontraktach, metadanych NFT lub systemach zewnętrznych.
• Nie polegaj na pamięci podręcznej — Pamięć podręczna bramek IPFS jest tymczasowa. Tylko przypięta treść ma gwarancję trwałości.
• Utrzymuj aktywne konto — Pliki pozostają przypięte, dopóki twoje konto IPFS.NINJA jest aktywne, nawet na darmowym poziomie.

Przypinanie istniejącej treści

Nie musisz przesyłać pliku przez IPFS.NINJA, aby go przypiąć. Jeśli treść już istnieje w sieci IPFS — przesłana przez kogoś innego lub przez ciebie za pośrednictwem innej usługi — możesz ją przypiąć do konta, podając jej CID.

Gdy przypinasz istniejący CID, nasz klaster:

1. Przeszukuje sieć IPFS w poszukiwaniu węzłów z treścią
2. Pobiera treść z najbliższego dostępnego węzła
3. Przypina ją lokalnie na naszej infrastrukturze
4. Udostępnia ją przez twoje konto i bramkę

To jest przydatne do:

• Zachowania zasobów NFT — przypnij metadane i obrazy z istniejących kolekcji
• Tworzenia kopii zapasowych treści — zapewnij, że ważne CID pozostaną dostępne, nawet jeśli oryginalny przypinacz przejdzie offline
• Migracji z innej usługi — przypnij istniejące CID bez ponownego przesyłania plików

Zobacz dokumentację API Przypinania po szczegóły endpointów.