← Web3 / web3
Начало работы
С помощью этого руководства вы настроите шлюз Cloudflare Web3, который даст вашему приложению HTTP-доступ к сети IPFS или Ethereum без необходимости запускать собственный узел.
Перед началом работы
Прежде чем начать, убедитесь, что у вас есть создать учётную запись и добавили свой веб-сайт в Cloudflare.
Шаг 1. Подписка на шлюз
Шлюзы Web3 доступны как платное дополнение. Чтобы получить доступ, подписаться на шлюз.
Шаг 2. Создание шлюза
После покупки подписки на шлюз создайте шлюз.
Создание через панель управления
Чтобы создать шлюз через панель управления:
-
На панели управления Cloudflare перейдите к разделу Web3 страницу.
Перейдите в Web3 ↗ -
Нажмите Create Gateway.
-
Введите следующие данные:
- Имя хоста: укажите имя хоста для использования в качестве шлюза, оно должно быть поддоменом текущей зоны Cloudflare.
- Описание шлюза: укажите описание, которое поможет различать шлюзы между собой.
- Тип Gateway: выберите целевой тип шлюза IPFS DNSLink, IPFS Universal Path, или Ethereum.
- DNSLink: применимо только к шлюзам IPFS, подробнее на DNSLink.
- Нажмите Развернуть.
Создание через API
Чтобы создать шлюз через API, отправьте POST запрос, включающий следующие параметры:
name: имя хоста, которое будет указывать на целевой шлюз черезCNAMEзапись.target: целевой шлюз для имени хоста (ethereum,ipfs,ipfs_universal_path).
Если вам нужна помощь с аутентификацией API, см. Документация по API Cloudflare.
curl "https://api.cloudflare.com/client/v4/zones/{zone_id}/web3/hostnames" \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>" \
--header "Content-Type: application/json" \
--data '{
"name": "gateway.example.com",
"description": "This is my IPFS gateway.",
"target": "ipfs",
"dnslink": "/ipns/onboarding.ipfs.cloudflare.com"
}'Ответ содержит полное описание нового шлюза.
{
"success": true,
"errors": [],
"messages": [],
"result": {
"id": "<WEB3_GATEWAY_ID>",
"name": "gateway.example.com",
"description": "This is my IPFS gateway.",
"status": "active",
"target": "ipfs",
"dnslink": "/ipns/onboarding.ipfs.cloudflare.com",
"created_on": "<CREATED_ON_DATE>",
"modified_on": "<MODIFIED_ON_DATE>"
}
}При создании шлюза Cloudflare автоматически:
- Создает и добавляет записи в ваш Cloudflare DNS чтобы ваш шлюз мог получать и направлять трафик надлежащим образом.
- Проксирует трафик к этому имени хоста.
- Выпускает сертификат SSL/TLS для указанного имени хоста.
Шаг 3. Настройка параметров Cloudflare
После того как ваш шлюз станет активен, вы можете настроить параметры Cloudflare, связанные с вашим именем хоста.
Поскольку ваш трафик автоматически проходит через прокси Cloudflare, вы настраиваете параметры сайта, чтобы воспользоваться различными безопасность, производительность и надёжность преимущества.
Шаг 4. Ограничение доступа к шлюзу (необязательно)
Если вы используете шлюз для бэкенд-сервисов, вам может понадобиться Cloudflare Zero Trust, чтобы ограничение доступа к шлюзу.
Шаг 5. Настройка уведомлений об использовании
Поскольку это служба с оплата по факту использования, Cloudflare рекомендует настроить уведомления о выставлении счетов на основе использования, чтобы избежать неожиданных счетов.
Чтобы настроить эти уведомления:
-
На панели управления Cloudflare перейдите к разделу Уведомления страницу.
Перейдите в Уведомления ↗ -
На Тип оповещения Оплата по фактическому использованию, нажмите Выбрать.
-
Заполните следующую информацию:
- Название
- Продукт
- Лимит уведомлений (точная метрика зависит от продукта)
- Электронная почта для уведомлений
-
Выберите Save.
Шаг 6. Использование шлюза
После того как вы создали шлюз и обновили настройки Cloudflare, можно начать использовать IPFS или Ethereum.