LAST FORK: https://github.com/fschirinzi/docker-ipinfo

An ipinfo.io clone, without the rate limiting. And some other goodies.

ipinfo.io sets a rate limiting of 1000 requests per day. I understand it, although that is a bit of a bummer.

Copy your MaxMin Databases (*.mmdb files) in the databases folder in the project directory or mount the direcotry with the files in the container (see docker with Mount). They are not included in this repo!

ipinfo:1.0 : how the image should be called and the version tag you want to give it
80:80 : Port binded to you local machine and the port in the docker container
ipinfo-test : the name of the created container

docker image build . -t ipinfo:1.0
docker container run -p 80:80 --name ipinfo-test ipinfo:1.0

For WINDOWS - Change the path to the drive letter like this: C:/... -> /c/...

docker image build . -t ipinfo:1.0
docker container run -p 80:80 -v /c/localDir/databases:/app/databases --name ipinfo-test ipinfo:1.0

This is really similiar to the way ipinfo.io does it. Every response will be identical from ipinfo.io's, almost. So, basic usage: you will just make a GET request to http://ip.zxq.co/[ip], like http://ip.zxq.co/8.8.8.8. Need to get something specific? http://ip.zxq.co/8.8.8.8/country.

$ curl "http://localhost/8.8.8.8"
{
  "ip": "8.8.8.8",
  "city": "Mountain View",
  "region": "California",
  "country": {
    "code": "US",
    "name": "United States"
  },
  "continent": {
    "code": "NA",
    "name": "North America"
  },
  "location": {
    "latitude": 37.386,
    "longitude": -122.0838
  },
  "postal":"94040",
  "asn":15169,
  "organization":
  "Google LLC"
}

Much better! 😄

But what if we don't know the user's IP? In that case, then, we can call /.

$ curl "ip.zxq.co/"
{
  "city": "",
  "continent": "EU",
  "continent_full": "Europe",
  "country": "IT",
  "country_full": "Italy",
  "ip": "87.16.45.15",
  "loc": "42.8333,12.8333",
  "postal": "",
  "region": ""
}

We're aren't done just yet! You want to use JSONP. You guess it, we are using the same system as ipinfo.io's. Just provide a callback parameter to your GET request.

$ curl "ip.zxq.co/8.8.8.8?pretty=1&callback=myFancyFunction"
/**/ typeof myFancyFunction === 'function' && myFancyFunction({
  "city": "Mountain View",
  "continent": "NA",
  "continent_full": "North America",
  "country": "US",
  "country_full": "United States",
  "ip": "8.8.8.8",
  "loc": "37.3860,-122.0838",
  "postal": "94040",
  "region": "California"
});

<script>
var myFancyFunction = function(data) {
  alert("The city of the IP address 8.8.8.8 is: " + data.city);
}
</script>
<script src="http://ip.zxq.co/8.8.8.8?callback=myFancyFunction"></script>

• Hostname. We would have to pick that data from another data source, which is too much effort.

• JSON minified, so it gets to your server quicker.
• Full name for the country!
• We also got continent info, with the full name too.

• We are using Go and not nodejs like them. Go is a compiled language, and therefore is amazingly fast. A response can be generated in a very short time.
• We get data only from one data source. Which means no lookups on other databases, which results in being faster overall.
• We are open source. Which means you can compile and put it on your own server!

Feel free to open an issue or pull request for anything! If you want to run it locally for whatever reason, you can do so this way if you don't need to touch the code:

go get -d http://github.com/TheHowl/ip.zxq.co
cd $GOPATH/src/github.com/TheHowl/ip.zxq.co
go build
./ip.zxq.co # .exe if you're on windows

(the reason you can't just do go get and then execute it from the terminal is that the software requires GeoLite2-City.mmdb to be in the same folder)

If you want to hack in the future, this is a better way:

cd $GOPATH
mkdir -p src/github.com/TheHowl
cd src/github.com/TheHowl
git clone git@github.com:TheHowl/ip.zxq.co.git
cd ip.zxq.co
go build
./ip.zxq.co
# Or if you don't want to create the binary in the folder
go run main.go

This product includes GeoLite2 data created by MaxMind, available from http://www.maxmind.com.

Inspired by jnovack/docker-ipinfo.