← Web3 / web3 / ipfs-gateway

Устранение неполадок

Если вы получите no link named "ipfs" under <<CID>> при попытке получить доступ к содержимому через IPFS шлюз Cloudflare, это значит, что вы создали шлюз без значения для DNSLink.

Так как Cloudflare сейчас поддерживает только ограниченные шлюзы, а не универсальные шлюзы - эти запросы будут завершаться ошибкой, пока вы не укажете значение DNSLink.

Стоит проверить недавние инциденты на панель состояния ↗ которые могли повлиять на наш шлюз, но лучшее место для получения актуальной информации о проблемах IPFS, это IPFS Discussion Forum ↗.

IPFS остаётся развивающимся протоколом, и контент нередко оказывается недоступен или загружается медленно по причинам, не зависящим от Cloudflare. Как правило, дело в одной из следующих причин.

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

Контент останется в сети IPFS только пока его раздает хотя бы один узел. Если все узлы, которые раздавали определенный контент, отключатся, он станет недоступен, пока один из них не вернется в сеть.

У тех, кто запускает узел IPFS в домашней сети Wi-Fi, часто наблюдаются долгое время ожидания или высокая доля неудачных запросов. Причина в том, что остальным узлам сети IPFS сложно подключиться к ним через NAT (домашний роутер). Решить эту проблему можно, настроив проброс портов на роутере, чтобы направлять внешние подключения на порт 4001 на хост с узлом IPFS, либо перенеся узел на выделенный сервер или виртуальную машину.

Если с момента загрузки файлов на узел IPFS прошло уже несколько минут, а другие шлюзы всё ещё их не находят, возможно, узел не может анонсировать файлы остальной сети. Убедиться, что узел закрепил (pinned) этот контент, можно с помощью команды:

ipfs pin -r <content id>

А запустить фактическое оповещение можно командой:

ipfs dht provide -rv <content id>

Вторая команда выполняется бесконечно и выдаёт довольно сложный вывод, поэтому её можно запустить в фоновом режиме и опустить -v флаг.

Время от времени IPFS выпускает обязательные обновления, вносящие критические изменения в протокол. Cloudflare старается идти в ногу с этими обновлениями и из-за этого иногда теряет связь со старыми узлами.