Доступ к сайтам Unstoppable Domains в браузере

О чём этот материал

Коротко: Unstoppable Domains позволяют регистрировать домены в Web3 (например, .crypto, .zil), а сами сайты обычно хранятся в IPFS. Стандартный браузер не всегда «понимает» такие адреса из коробки — нужно либо включить Web3-функции, либо настроить DNS-резолвер и установить расширение. Ниже — подробные инструкции и практические советы для пользователей и администраторов.

Ключевые термины — одно предложение:

• IPFS: децентрализованная файловая система для хранения и доставки контента.
• DNS-резолвер Unstoppable: HTTP-интерфейс для преобразования Web3-домена в адрес контента.

Кому это важно

• Обычные пользователи, которые хотят открывать .crypto и другие Web3-сайты.
• Разработчики и владельцы Web3-сайтов, которые хотят проверить доступность контента в популярных браузерах.
• Сисадмины и службы поддержки, которые будут устранять проблемы доступа.

Как это работает (коротко)

Unstoppable Domains публикуют указатели на контент (CID) в блокчейне и/или в DNS через резолвер. Контент сам по себе может располагаться в IPFS. Когда браузер видит Web3-домен, он должен:

1. Узнать CID или URL через резолвер (DNS-over-HTTPS или API).
2. Запросить контент из IPFS (через локальный IPFS-узел или публичный gateway).

Если браузер не настроен — он либо отправит запрос в обычный DNS (и не найдёт запись), либо воспримет строку как поисковый запрос.

Быстрая проверка перед настройкой

1. Наберите домен с завершающим слэшем: example.crypto/ — это заставит браузер трактовать ввод как URL.
2. Попробуйте открыть сайт в Brave (обычно работает из коробки после включения Web3).
3. Если видите ошибку DNS (например, Error 1001), проверьте настройки DNS и очистите кеш DNS.

Настройка Brave (пошагово)

Brave — самый «Web3-дружелюбный» из популярных браузеров: в нём есть встроенные параметры для IPFS и Unstoppable Domains.

1. Откройте браузер Brave.
2. В адресной строке введите brave://settings и нажмите Enter.
3. В боковой панели выберите раздел Web3.

4. Прокрутите до секции IPFS и установите:
   • Метод разрешения IPFS-ресурсов: Brave Local IPFS Node
   • Включите IPFS public gateway fallback

5. В разделе Web3 Domains включите Resolve Unstoppable Domains domain names.

6. Проверьте: в адресной строке введите hashoshi.crypto/ и нажмите Enter.

Совет: если вы используете локальный IPFS-узел, убедитесь, что он запущен и синхронизирован.

Настройка Chrome (пошагово)

Chrome не имеет встроенной поддержки Unstoppable, но можно подключить DNS-резолвер и расширение.

1. Откройте Chrome.
2. В адресной строке введите chrome://settings/security и нажмите Enter.

3. Прокрутите до секции Дополнительно. В блоке «Использовать безопасный DNS» выберите Пользовательский и вставьте адрес:

   https://resolver.unstoppable.io/dns-query

4. Откройте Интернет-магазин Chrome, найдите расширение Unstoppable Extension и нажмите Add to Chrome.

5. После установки введите домен с завершающим слэшем и проверьте загрузку.

Примечание: использование публичного DNS-резолвера переопределит системные DNS — учитывайте корпоративные политики.

Настройка Firefox (пошагово)

Firefox тоже требует настройки DNS-over-HTTPS и установки расширения.

1. Откройте Firefox.
2. В адресной строке введите about:preferences#privacy и нажмите Enter.

3. В секции DNS over HTTPS выберите Повышенная защита, затем Пользовательский провайдер и вставьте:

   https://resolver.unstoppable.io/dns-query

4. Откройте раздел Extensions and Themes, найдите Unstoppable Extension и установите его.

5. Проверьте доступ к домену с завершающим слэшем.

Типичные ошибки и как их исправить

Ошибка 1001 или похожие DNS-ошибки означают, что браузер не получил корректное DNS-ответное значение. Возможные причины и действия:

• Неправильный DNS-резолвер: проверьте, что в настройках указан https://resolver.unstoppable.io/dns-query.
• Кеш DNS: очистите локальный DNS-кеш (Windows: ipconfig /flushdns, macOS: sudo killall -HUP mDNSResponder).
• Сетевые фильтры и брандмауэр: проверьте, не блокирует ли сеть HTTPS-запросы к резолверу.
• Расширение не установлено/отключено: убедитесь, что Unstoppable Extension активно.
• Браузер трактует ввод как поисковый запрос: добавьте “/“ в конец домена и нажмите Enter.

Короткий чек-лист устранения неполадок:

1. Добавьте слэш в конец домена и попробуйте снова.
2. Проверьте настройки DNS-браузера.
3. Очистите DNS-кеш и перезапустите браузер.
4. Отключите VPN или проверьте его настройки (VPN может менять DNS).
5. Попробуйте другой браузер (Brave часто помогает выявить проблему).

Роли и чек-листы (кто что делает)

• Обычный пользователь:

  • Убедиться, что браузер обновлён.
  • Добавить слэш в конец Web3-домена.
  • В Brave включить Web3 → IPFS и Resolve Unstoppable Domains.
  • В Chrome/Firefox настроить пользовательский DNS и установить расширение.

• Разработчик сайта на IPFS:

  • Проверить CID и IPFS-публикацию (pinning).
  • Убедиться, что резолвер возвращает корректный адрес/redirect.
  • Предоставлять fallback через публичные gateway.

• Системный администратор / Служба поддержки:

  • Проверить корпоративные политики DNS и прокси.
  • Разрешить трафик к resolver.unstoppable.io.
  • Документировать стандартную инструкцию для сотрудников.

SOP: Быстрая инструкция для команды поддержки

1. Спросите у пользователя: какой браузер и показывает ли сайт при добавлении “/“.
2. Проверьте системное подключение и DNS (nslookup/ dig для resolver.unstoppable.io).
3. Попросите временно отключить VPN/Proxy.
4. Если Chrome/Firefox — проверьте пользовательский DNS и расширение Unstoppable.
5. Если Brave — проверьте настройки Web3 → IPFS и локальный IPFS-узел (если используется).
6. Завершите: объясните пользователю, как добавить слэш и где включить параметры.

Безопасность и приватность

• Расширение Unstoppable получает доступ к доменам Web3 — устанавливайте только из официальных источников (официальные магазины расширений).
• Использование публичного резолвера означает, что запросы к нему видны третьей стороне — если это критично, используйте корпоративный или приватный резолвер.
• IPFS-контент может быть неизменяемым — проверьте подписи и доверенные публикации, особенно для финансовых или приватных приложений.
• При работе с приватными данными избегайте публикации в публичный IPFS без шифрования.

Таблица совместимости (сравнение браузеров)

Ментальные модели и когда это может не подойти

Ментальная модель: рассматривайте Web3-домен как указатель на контент, а IPFS — как транспорт. Если «указатель» или транспорт недоступен (резолвер или IPFS), доступ невозможен.

Когда это не сработает:

• Если контент не опубликован в IPFS или удалён.
• Если ваш провайдер или корпоративная сеть блокирует доступ к резолверу или публичным gateway.
• Если браузер старой версии без поддержки расширений/DOH.

Диагностика — flowchart

flowchart TD
  A[Пользователь не может открыть домен] --> B{Добавлен слэш в конце домена?}
  B -- Нет --> C[Добавить '/' и повторить]
  B -- Да --> D{Браузер Brave?}
  D -- Да --> E[Проверить Web3 → IPFS и Resolve Unstoppable]
  D -- Нет --> F{Chrome или Firefox?}
  F -- Chrome --> G[Проверить Custom DNS: https://resolver.unstoppable.io/dns-query и расширение]
  F -- Firefox --> H[Проверить DOH: https://resolver.unstoppable.io/dns-query и расширение]
  E --> I{Проблема решена?}
  G --> I
  H --> I
  I -- Да --> J[Готово]
  I -- Нет --> K[Проверить DNS-кеш, VPN, брандмауэр, попробовать другой браузер]

Критерии приёмки

• Сайт открывается при вводе домена с завершающим “/“ в адресной строке.
• В Brave: Web3 → IPFS включены, сайт загружается через локальный или публичный gateway.
• В Chrome/Firefox: пользовательский DNS настроен на https://resolver.unstoppable.io/dns-query и расширение установлено.
• После выполнения шагов служба поддержки подтверждает, что проблема воспроизводится у тестового пользователя.

Короткая памятка (чек-лист для печати)

• Добавить “/“ в конец домена при вводе
• Brave: brave://settings → Web3 → включить IPFS и Resolve Unstoppable
• [ ] Chrome: chrome://settings/security → Custom DNS → https://resolver.unstoppable.io/dns-query; установить расширение
• [ ] Firefox: about:preferences#privacy → DOH → https://resolver.unstoppable.io/dns-query; установить расширение
• Очистить DNS-кеш и перезапустить браузер
• Проверить VPN/Firewall/Proxy

Итог

Unstoppable Domains предлагают простой вход в Web3, но для корректной работы нужно либо использовать браузер с встроенной поддержкой (Brave), либо настроить DNS-резолвер и установить официальное расширение в Chrome и Firefox. Основные шаги — убедиться в правильной настройке IPFS/резолвера, установить расширение и следовать чек-листу устранения неполадок.

Важно: при работе с приватными данными учитывайте риски публикации в IPFS и политику приватности резолвера.

Дополнительные ресурсы и ссылки:

• Официальный сайт Unstoppable Domains — для загрузки расширений и документации.
• Документы по IPFS — базовые руководства по запуску локального узла и pinning.