このチュートリアルでは、Cloudflare Web3 ゲートウェイを設定します。自前のノードを動かさずに、アプリケーションから IPFS または Ethereum ネットワークへ HTTP でアクセスできます。
始める前に、アカウントを設定 し、ウェブサイトを Cloudflare に追加 しておきます。
Web3 ゲートウェイは有料アドオンです。利用するには、ゲートウェイを契約 します。
ゲートウェイのサブスクリプションを購入したら、ゲートウェイを作成します。
ダッシュボードで作成する
ダッシュボードでゲートウェイを作成するには、次の手順を行います。
-
Cloudflare ダッシュボードで Web3 ページを開きます。
Web3 を開く ↗ -
Create Gateway を選びます。
-
次の情報を入力します。
- Hostname: ゲートウェイとして使うホスト名を入力します。現在の Cloudflare ゾーンのサブドメインである必要があります。
- Gateway Description: ゲートウェイを区別するための説明を入力します。
- Gateway Type: ゲートウェイの対象として IPFS DNSLink、IPFS Universal Path、または Ethereum を選びます。
- DNSLink: IPFS ゲートウェイにのみ適用されます。詳細は DNSLink を参照してください。
- Deploy を選びます。
API で作成する
API でゲートウェイを作成するには、次のパラメーターを含む POST リクエストを送ります。
name:CNAMEレコードで対象ゲートウェイを指すホスト名です。target: ホスト名のゲートウェイターゲットです(ethereum、ipfs、ipfs_universal_path)。
API 認証について不明な点がある場合は、Cloudflare API のドキュメント を参照してください。
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 証明書を発行します。
ゲートウェイが active になると、ホスト名に関連する Cloudflare 設定をカスタマイズできます。
トラフィックは自動的に Cloudflare 経由でプロキシされるため、さまざまな セキュリティ、パフォーマンス、信頼性 のメリットを活かせるよう、ウェブサイトの設定をカスタマイズします。
ゲートウェイをバックエンドサービスに使う場合は、Cloudflare Zero Trust で ゲートウェイへのアクセスを制限 できます。
このサービスは 使用量ベースの課金 です。想定外の請求を避けるため、使用量ベースの課金通知の設定を推奨します。
通知を設定する手順は次のとおりです。
-
Cloudflare ダッシュボードで Notifications ページを開きます。
Notifications を開く ↗ -
Alert Type が Usage Based Billing の項目で Select を選びます。
-
次の情報を入力します。
- Name
- Product
- Notification limit(正確な指標は製品によって異なります)
- Notification email
-
Save を選びます。
ゲートウェイを作成し、Cloudflare の設定を更新したら、IPFS または Ethereum の利用を始められます。