n8n-nodes-ip2location-lite

This is an n8n community node for IP geolocation, proxy detection, and ASN lookup using local IP2Location databases.

n8n is a fair-code licensed workflow automation platform.

Installation

Install via Settings > Community Nodes in n8n and search for n8n-nodes-ip2location-lite.

See the n8n community nodes documentation for more details.

Operations

| Operation | Description |
|-----------|-------------|
| Detect Proxy | Check if an IP is a proxy, VPN, or Tor exit node |
| Full Lookup | Combined geolocation + ASN lookup, optionally with proxy detection |
| Geolocate IP | Get geographic location (country, region, city, coordinates, timezone) |
| Lookup ASN | Get Autonomous System information for an IP address |

$3

| Scenario | Geolocation | Proxy Detection | ASN Lookup |
|----------|-------------|-----------------|------------|
| No credentials | Country only | Not available | Not available |
| With token | Full data (city, region, timezone, etc.) | Available | Available |

Credentials are optional - you can use basic geolocation without any setup. For full functionality, get a free token from lite.ip2location.com.

Credentials

- Download Token - Get a free token from lite.ip2location.com. Required for proxy detection and ASN lookup. Optional for geolocation (enables full data instead of country-only).
- Data Directory - Where to store downloaded database files (default: ~/.n8n-files/ip2location/)

How Database Management Works

This node uses local database files for fast, offline IP lookups. Here's how it manages them:

$3

On first execution, the node automatically downloads the required database:
- Without token: Downloads the public DB1 database (~30MB) with country-level data only
- With token: Downloads DB11 (~200MB) for full geolocation, plus proxy/ASN databases as needed

$3

Databases are stored in the configured data directory (default: ~/.n8n-files/ip2location/). Files include:
- IP2LOCATION-LITE-DB1.IPV6.BIN - Basic geolocation (no token)
- IP2LOCATION-LITE-DB11.IPV6.BIN - Full geolocation (with token)
- IP2PROXY-LITE-PX1.BIN - Proxy detection (with token)
- IP2LOCATION-LITE-ASN.IPV6.BIN - ASN lookup (with token)

$3

Databases are automatically refreshed every 30 days to stay current with IP2Location's monthly updates. The refresh happens transparently on the next node execution after the database expires.

Compatibility

- Tested with n8n v1.x
- Supports both IPv4 and IPv6 addresses

Usage

1. Add the IP2Location node to your workflow
2. Configure credentials (optional - only needed for proxy/ASN or full geolocation)
3. Select an operation (Geolocate, Detect Proxy, or Lookup ASN)
4. Provide an IP address (can use expressions like {{$json.ip}})

Resources

- n8n community nodes documentation
- IP2Location LITE Database

Attribution

This site or product includes IP2Location LITE data available from https://lite.ip2location.com.

Users are responsible for registering their own account at lite.ip2location.com to obtain a download token for full database access.

License

MIT