カスタムリストは、同じ種類の項目（IP アドレス、ホスト名、ASN など）を 1 つ以上含み、ルール式で名前を指定してまとめて参照できます。
Cloudflare が対応するカスタムリストの種類は次のとおりです。
- IP アドレスのリスト（IP lists とも呼びます）
- ホスト名のリスト
- ASN のリスト（自律システム ↗ 番号）
種類ごとにプロパティと CSV ファイル形式が異なります。詳細は次の各セクションを参照してください。
Managed IP Lists など、Cloudflare が管理するリストについては、Managed Lists を参照してください。
ダッシュボードでリストを作成する または Lists API を参照してください。
カスタムリストは、ルールの 式 で in 演算子と、カスタムリストが対応するフィールドを組み合わせて使います。
<FIELD> in $<LIST_NAME>使えるフィールドは、リスト項目の種類によって異なります。
| リスト項目の種類 | 使えるフィールド |
|---|---|
| IP アドレス | Fields reference に掲載されている型が IP address のフィールド |
| ホスト名 | http.host |
| ASN | ip.src.asnum |
詳細と例は、式でリストを使う を参照してください。
IP アドレスのカスタムリストの項目は、次のいずれかの形式である必要があります。
- 個別の IPv4 アドレス
- 個別の IPv6 アドレス
- プレフィックスが
/8から/32の IPv4 CIDR 範囲 - プレフィックスが
/12から/128の IPv6 CIDR 範囲
同じリストに、個別アドレスと CIDR 範囲を混在できます。
リスト内の IPv6 アドレスには、大文字と小文字のどちらも使えます。ただし、リストを保存すると、大文字は小文字に変換されます。
CSV ファイル形式
CSV ファイルで IP アドレスのカスタムリストに項目をアップロードするときは、次のファイル形式を使います（1 行に 1 項目）。
<IP_ADDRESS_1>,<DESCRIPTION>
<IP_ADDRESS_2><DESCRIPTION> フィールドは任意です。
ホスト名のカスタムリストの項目は、Fully Qualified Domain Name（FQDN）である必要があります。項目には * のプレフィックス / サブドメインワイルドカードを含められます。その場合、直後に .（ピリオド）が必要です。スキーム（https:// など）や URL パスは含められません。
たとえば、ホスト名のカスタムリストでは次のエントリが有効です。
example.comapi.example.com*.example.com
一方、example.com/path/subfolder は無効です。
ホスト名のカスタムリストには、有効なホスト名（有効な FQDN）を追加できます。ホスト名は、現在の Cloudflare アカウントに属している必要はありません。
CSV ファイル形式
CSV ファイルでホスト名のカスタムリストに項目をアップロードするときは、次のファイル形式を使います。
<HOSTNAME_1>,<DESCRIPTION>
<HOSTNAME_2><DESCRIPTION> フィールドは任意です。
自律システム番号（ASN）のカスタムリストの項目は、整数値である必要があります。
たとえば、ASN のリストでは次のエントリが有効です。
11333564512
CSV ファイル形式
CSV ファイルで ASN のカスタムリストに項目をアップロードするときは、次のファイル形式を使います。
<ASN_1>,<DESCRIPTION>
<ASN_2><DESCRIPTION> フィールドは任意です。