Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ip2location/ip2location-nmap

This IP2Location Nmap script provides a fast lookup of country, region, city, latitude, longitude, ZIP code, time zone, ISP, domain name, connection type, IDD code, area code, weather station code, station name, mcc, mnc, mobile brand, elevation, usage type, address type and IAB category from IP address by using the IP2Location Lua Package.
https://github.com/ip2location/ip2location-nmap

geocoder geolocation geolocation-database ip-address-lookup ip-geolocation-ip2location ip2location-lua ip2location-nmap lua lua-packages nmap nmap-scripts

Last synced: 23 days ago
JSON representation

Host: GitHub
URL: https://github.com/ip2location/ip2location-nmap
Owner: ip2location
Created: 2019-03-25T06:07:47.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2024-01-03T05:57:41.000Z (12 months ago)
Last Synced: 2024-01-03T06:44:43.878Z (12 months ago)
Topics: geocoder, geolocation, geolocation-database, ip-address-lookup, ip-geolocation-ip2location, ip2location-lua, ip2location-nmap, lua, lua-packages, nmap, nmap-scripts
Language: Lua
Homepage:
Size: 7.81 KB
Stars: 16
Watchers: 3
Forks: 2
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

## IP2Location Nmap script

This IP2Location Nmap script provides a fast lookup of country, region, city, latitude, longitude, ZIP code, time zone, ISP, domain name, connection type, IDD code, area code, weather station code, station name, mcc, mnc, mobile brand, elevation, usage type, address type, IAB category, district, autonomous system number (ASN) and autonomous system (AS) from IP address by using the IP2Location Lua Package.

The database will be updated on a monthly basis for greater accuracy. Free LITE databases are available at upon registration.

The paid databases are available at [https://www.ip2location.com](https://www.ip2location.com/) under Premium subscription package.

Both IPv4 and IPv6 are supported.

## Installation

If the Luarocks have installed with the latest dependency (5.3), you can install with the following steps:

1. Download and unzip the package.

2. Copy the ip-geolocation-ip2location.nse to your Nmap program directory/scripts.

Note: The default Nmap program directory for Linux user should be under /usr/share/, for example /usr/share/nmap. For Windows user, the Nmap directory should be C:\Program Files (x86)\Nmap.

3. Install the [IP2Location Lua](https://github.com/ip2location/ip2location-lua) Library by using this command: `luarocks install ip2location`

4. Download the database from for free version or [https://www.ip2location.com](https://www.ip2location.com/) for paid version.

However, if the Luarocks is not installed, or you do not prefer to install the Luarocks, you can also install the script manually with the following steps:

1. Download and unzip the package.

2. Copy the ip-geolocation-ip2location.nse to your Nmap program directory/scripts.

Note: The default Nmap program directory for Linux user should be under /usr/share/, for example /usr/share/nmap. For Windows user, the Nmap directory should be C:\Program Files (x86)\Nmap.

3. Get the [ip2location.lua](https://github.com/ip2location/ip2location-lua/blob/master/ip2location.lua) & [BigNum library](https://github.com/user-none/lua-nums) and copy it to your Nmap program directory/nselib.

4. Download the database from https://lite.ip2location.com/ for free version or [https://www.ip2location.com](https://www.ip2location.com/) for paid version.

## Usage

`nmap --script ip-geolocation-ip2location --script-args ip-geolocation-ip2location.ip2location_db=`

Replace the `` with the IP Address that you wish to search and the `` with the IP2Location database file path in your computer. Remember to put double backslashes (\\\\) instead of single backslash(\\) in the path.

## Parameters

**ip2location_db**

Indicates the path of the database file to use.