https://github.com/threefoldtech/whereisip
https://github.com/threefoldtech/whereisip
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/threefoldtech/whereisip
- Owner: threefoldtech
- License: apache-2.0
- Created: 2018-10-11T11:52:02.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-10-12T08:38:01.000Z (over 1 year ago)
- Last Synced: 2024-06-21T19:50:35.562Z (11 months ago)
- Language: Go
- Size: 13.7 KB
- Stars: 1
- Watchers: 4
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Where Is My IP
Small webservice using GeoLite2 database to give geographic information about IP address location
# Dependencies
This project depends on [MaxMind GeoLite2](https://www.maxmind.com/en/geoip2-city)
# Build
Simply build the project with Go:
```go
go build
```
# Installation
First you need to copy a version of `GroLite2-City` database from MaxMind.
Copy this file into the same directory than `whereisip` binary: `GeoLite2-City.mmdb`
Then run the webservice: `./whereisip`
There is no command line arguments supported for now.
# Usage
Only one GET request to `/` is supported and you'll get a JSON response of GeoLite database content based on your remote address.
Server listen on `:8085`.
Example response:
```json
{
"address": "82.212.171.24",
"country_code": "BE",
"country_name": "Belgium",
"subdivision": "Wallonia",
"continent": "Europe",
"city_name": "Liège",
"latitude": 50.6337,
"longitude": 5.5675,
"source": "maxmind geolite2"
}
```