Закрепление

Как файлы сохраняются в сети IPFS и почему закрепление важно.

Проблема сборки мусора

Узлы IPFS имеют ограниченное хранилище. Для управления дисковым пространством они периодически запускают сборку мусора — процесс, удаляющий кэшированные данные, которые не были явно помечены как важные. Без вмешательства загруженный вами файл может быть удалён из сети в течение нескольких часов.

Закрепление сообщает узлу IPFS: «храни этот файл постоянно — не удаляй его при сборке мусора». Закреплённый файл остаётся в хранилище узла бессрочно, обеспечивая его доступность в сети.

Локальное и удалённое закрепление

Локальное закрепление означает запуск собственного узла IPFS и закрепление файлов на нём. Вы отвечаете за время работы, хранилище и сетевое подключение. Если ваш узел уходит в офлайн, файлы становятся недоступными.

Удалённое закрепление (то, что предоставляет IPFS.NINJA) означает, что управляемый сервис закрепляет ваши файлы на инфраструктуре, которая всегда в сети. Вы получаете постоянство закрепления без необходимости запускать собственный узел.

TIP

Каждый файл, загруженный через IPFS.NINJA, автоматически закрепляется в нашем кластере IPFS. Дополнительных шагов не требуется — ваши файлы сохраняются с момента загрузки.

Что происходит при снятии закрепления

Если вы удаляете файл из аккаунта IPFS.NINJA, мы снимаем его закрепление с наших узлов. Файл может оставаться доступным, если:

• Другие узлы IPFS кэшировали или закрепили тот же CID
• Шлюз IPFS имеет файл в своём кэше
• Другой пользователь загрузил тот же контент (тот же CID = тот же файл)

Со временем, без закрепления ни на одном узле, файл будет полностью удалён из сети сборщиком мусора.

Лучшие практики закрепления

• Закрепляйте заранее — Загрузите и закрепите контент до того, как ссылаться на CID в смарт-контрактах, метаданных NFT или внешних системах.
• Не полагайтесь на кэширование — Кэши шлюзов IPFS временны. Только закреплённый контент гарантированно сохраняется.
• Поддерживайте аккаунт активным — Файлы остаются закреплёнными, пока ваш аккаунт IPFS.NINJA активен, даже на бесплатном тарифе.

Закрепление существующего контента

Не обязательно загружать файл через IPFS.NINJA, чтобы его закрепить. Если контент уже существует в сети IPFS — загруженный кем-то другим или вами через другой сервис — вы можете закрепить его в своём аккаунте, указав CID.

При закреплении существующего CID наш кластер:

1. Ищет в сети IPFS узлы, имеющие контент
2. Скачивает контент с ближайшего доступного узла
3. Закрепляет его локально на нашей инфраструктуре
4. Делает его доступным через ваш аккаунт и шлюз

Это полезно для:

• Сохранения ресурсов NFT — закрепление метаданных и изображений существующих коллекций
• Резервного копирования контента — обеспечение доступности важных CID, даже если исходный закрепитель уходит в офлайн
• Миграции с другого сервиса — закрепление существующих CID без повторной загрузки файлов

Подробности конечных точек см. в документации Pinning API.