Package Information
Documentation
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 |
What works without a token?
| 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:
First Use
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
Storage Location
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)
Auto-Refresh
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
- Add the IP2Location node to your workflow
- Configure credentials (optional - only needed for proxy/ASN or full geolocation)
- Select an operation (Geolocate, Detect Proxy, or Lookup ASN)
- Provide an IP address (can use expressions like
{{$json.ip}})
Resources
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