Skip to content

非公式 / UnofficialCloudflare, Inc. 非提携。アカウント情報は入力しないでください。Not affiliated with Cloudflare, Inc. Do not enter Cloudflare credentials here.Official docsこのサイトについてプライバシー

ゲートウェイを管理する

最終更新 Markdown で表示Agent セットアップ

Cloudflare Web3 ゲートウェイは、さまざまな Web3 ネットワークへの HTTP アクセス可能なインターフェースを提供します。ゲートウェイとは、いくつかの方法でやり取りできます。

ゲートウェイを作成する

ダッシュボードでゲートウェイを作成するには、次の手順を行います。

  1. Cloudflare ダッシュボードで Web3 ページを開きます。

    公式ダッシュボードで Web3 を開く ↗
  2. Create Gateway を選びます。

  3. 次の情報を入力します。

  • Hostname: ゲートウェイとして使うホスト名を入力します。現在の Cloudflare ゾーンのサブドメインである必要があります。
  • Gateway Description: ゲートウェイを区別するための説明を入力します。
  • Gateway Type: ゲートウェイの対象として IPFS DNSLink、IPFS Universal Path、または Ethereum を選びます。
  • DNSLink: IPFS ゲートウェイにのみ適用されます。詳細は DNSLink を参照してください。
  1. Deploy を選びます。

API でゲートウェイを作成するには、次のパラメーターを含む POST リクエストを送ります。

  • name: CNAME レコードで対象ゲートウェイを指すホスト名です。
  • target: ホスト名のゲートウェイターゲットです(ethereum、ipfs、ipfs_universal_path)。

API 認証について不明な点がある場合は、Cloudflare API のドキュメント を参照してください。

リクエストbash
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"
}'

レスポンスには、新しいゲートウェイの完全な定義が含まれます。

レスポンスjson
{
  "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 証明書を発行します。

ゲートウェイを編集する

ゲートウェイを作成 したあと、編集できるのは Gateway Description だけです。IPFS ゲートウェイの場合は、DNSLink フィールドの値も編集できます。

ほかのフィールドを編集する必要がある場合は、ゲートウェイを削除 して新しいものを作成します。

ダッシュボードでゲートウェイを編集する手順は次のとおりです。

  1. Cloudflare ダッシュボードで、Web3 ページを開きます。

    公式ダッシュボードで Web3 を開く ↗
  2. 対象のゲートウェイで Edit を選びます。

  3. Gateway Description を更新します。IPFS ゲートウェイを編集している場合は、DNSLink の値も更新します。

  4. Reapply を選びます。

ゲートウェイの特定の設定を編集するには、PATCH リクエストを使います。


ゲートウェイをリフレッシュする

ゲートウェイが Error ステータス のまま止まっている場合は、ゲートウェイのリフレッシュを試してください。ホスト名に関連する DNS レコードの再作成を試みます。

ダッシュボードでゲートウェイをリフレッシュする手順は次のとおりです。

  1. Cloudflare ダッシュボードで、Web3 ページを開きます。

    公式ダッシュボードで Web3 を開く ↗
  2. ゲートウェイのドロップダウンを開き、Refresh を選びます。

API でゲートウェイをリフレッシュするには、空のリクエストボディで PATCH リクエストを送ります。


ブロックリストを更新する

IPFS Universal Path ゲートウェイ を設定したときは、ゲートウェイのブロックリストに項目を追加して、特定のコンテンツへのアクセスをブロックできます。

次の 1 つ以上へのアクセスをブロックできます。

  • CID(QmPZ9gcCEpqKTo6aq61g2nXGUhM4iCL3ewB6LDXZCtioEB)
  • IPFS コンテンツパス(/ipfs/QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG/readme)
  • IPNS コンテンツパス(/ipns/example.com)

ダッシュボードでブロックリストに項目を追加する手順は次のとおりです。

  1. Cloudflare ダッシュボードで、Web3 ページを開きます。

    公式ダッシュボードで Web3 を開く ↗
  2. 対象のゲートウェイのドロップダウンを開き、Blocklist を選びます。

  3. Add entry を選びます。

  4. 次の情報を入力します。

    • Blocklist entry type: CID または Content path を選びます。
    • Blocklist entry content: ブロックする CID またはコンテンツパスを追加します。有効な CIDv0 または CIDv1 文字列(CID)、あるいは /ipfs/ または /ipns/ で始まるエントリ(コンテンツパス)です。
    • Blocklist entry description: ブロックリストエントリを識別しやすい説明を追加します。
  5. Add を選びます。

API でブロックリスト項目を追加するには、POST リクエストを送ります。


ゲートウェイを削除する

ゲートウェイを削除すると、Cloudflare は関連するホスト名の DNS レコードを自動的に削除します。この操作はトラフィックに影響し、元に戻せません。

ダッシュボードでゲートウェイを削除する手順は次のとおりです。

  1. Cloudflare ダッシュボードで、Web3 ページを開きます。

    公式ダッシュボードで Web3 を開く ↗
  2. 対象のゲートウェイのドロップダウンを開き、Remove を選びます。

  3. Delete hostname を選びます。

API でゲートウェイを削除するには、DELETE リクエストを送ります。

役に立ちましたか?