IP Index
A self-sufficient web-service providing info about an IP, particularly its ASN, country of origin and whether it's a hosting or not.
Project contains:
- Data-center ASNs CSV list
- Dockerized webservice (nginx and nodejs)
- NPM library
Updates daily. False positives are possible, use at own risk.
Usage
For a quick and easy start and evaluation you can start the docker container directly:
docker run -d -it -p 80:4000 --rm --name ipindex ghcr.io/umkus/ipindex-node:latest For a more advanced usage with pre-configured nginx throttling and caching:
# git clone [email protected]:Umkus/ip-index.git
# cd ip-index
docker compose -f docker-compose.yml up -dNow open this url in browser: http://localhost/?ip=8.8.8.8
You will see the following data structure:
[
{
"start": 134217728,
"end": 142606335,
"subnet": "8.0.0.0/9",
"asn": 3356,
"hosting": false,
"handle": "LEVEL3",
"description": "Level 3 Parent",
"country": "US",
"subnetsNum": 531
},
{
"start": 134744064,
"end": 134744319,
"subnet": "8.8.8.0/24",
"asn": 15169,
"hosting": true,
"handle": "GOOGLE",
"description": "Google LLC",
"country": "US",
"subnetsNum": 76
}
]
Why this exists
Most existing solutions to detect VPNs/Proxies provide HTTP APIs or binary databases on a subscription model. Downsides of the existing projects might be at least one of the following:
- Not cost-effective
- Not portable
- Not fast enough
This solution is:
- Free
- Portable (Docker image)
- Fast and efficient (caching, throttling reverse proxy)
Methods of validation
One of the target ASN IPs is checked against one or more of the known IP scoring services:
- https://www.ipqualityscore.com/free-ip-lookup-proxy-vpn-test/lookup/1.1.1.1
- https://www.ip2location.com/demo/1.1.1.1
- https://scamalytics.com/ip/1.1.1.1
Acknowledgments
- This product includes IP2Location LITE data available from http://www.ip2location.com.
- This product includes GeoLite2 data created by MaxMind, available from https://www.maxmind.com.