projectdiscovery /cdncheck

A utility to detect various technology for a given IP address.

★ 1,000⑂ 141👁 17⑃ 474● 62▤ 110
GoMITCreated 2020-07-04projectdiscovery.io
Download: v1.4.0v1.4.0 ↓1.4.02026-11-01
+0
Daily
1,000
stars
141
forks
17
watchers
474
prs
62
issues
110
releases

README

cdncheck














  Features •
  Installation •
  Usage •
  Join Discord





cdncheck is a tool for identifying the technology associated with dns / ip network addresses.



!image

 Features

- CDN, CLOUD and WAF Detection
- Easy to use as library
- Easily extendable providers
- IP, DNS input support
- Text, JSONL output
- Filters on output

 Installation

cdncheck requires go1.26.10 to install successfully. Run the following command to install the latest version:

sh
go install -v github.com/projectdiscovery/cdncheck/cmd/cdncheck@latest


 Usage

sh
cdncheck -h


This will display help for the tool. Here are all the switches it supports.

yaml
Usage:
  ./cdncheck [flags]

Flags:
INPUT:
   -i, -input string[]  list of ip / dns to process

DETECTION:
   -cdn    display only cdn in cli output
   -cloud  display only cloud in cli output
   -waf    display only waf in cli output

MATCHER:
   -mcdn, -match-cdn string[]      match host with specified cdn provider (cloudfront, fastly, google, leaseweb)
   -mcloud, -match-cloud string[]  match host with specified cloud provider (aws, google, oracle)
   -mwaf, -match-waf string[]      match host with specified waf provider (cloudflare, incapsula, sucuri, akamai)

FILTER:
   -fcdn, -filter-cdn string[]      filter host with specified cdn provider (cloudfront, fastly, google, leaseweb)
   -fcloud, -filter-cloud string[]  filter host with specified cloud provider (aws, google, oracle)
   -fwaf, -filter-waf string[]      filter host with specified waf provider (cloudflare, incapsula, sucuri, akamai)

OUTPUT:
   -resp               display technology name in cli output
   -o, -output string  write output in plain format to file
   -v, -verbose        display verbose output
   -j, -jsonl          write output in json(line) format
   -nc, -no-color      disable colors in cli output
   -version            display version of the project
   -silent             only display results in output

CONFIG:
   -r, -resolver string[]  list of resolvers to use (file or comma separated)
   -e, -exclude            exclude detected ip from output
   -retry int              maximum number of retries for dns resolution (must be at least 1) (default 2)

UPDATE:
   -up, -update                 update cdncheck to latest version
   -duc, -disable-update-check  disable automatic cdncheck update check


 How to add new providers?

provider.yaml file contains list of CDN, WAF and Cloud providers. The list contains URLs, ASNs and CIDRs which are then compiled into a final sources_data.json file using generate-index program.

Example of provider.yaml file - 

yaml
cdn:
   asn contains the ASN numbers for providers
  asn:
    leaseweb:
      - AS60626

   urls contains a list of URLs for CDN providers
  urls:
    cloudfront:
      - https://d7uri8nf7uskq.cloudfront.net/tools/list-cloudfront-ips
    fastly:
      - https://api.fastly.com/public-ip-list

   cidr contains the CIDR ranges for providers
  cidr:
    akamai:
      - "23.23

Top issues

Discussions

Latest release

v1.4.0 v1.4.0 2026-11-01
1.4.0 (2026-11-01)


 Features

 add China CDN CIDR ranges (Aliyun, Wangsu, Tencent, Baidu) (0f9c4a2)


 Documentation

 add docstring to TestCDNCheckValid (6c16d82)

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON