{"id":18605954,"url":"https://github.com/axllent/goiplookup","last_synced_at":"2025-04-10T20:31:20.623Z","repository":{"id":57557564,"uuid":"173402785","full_name":"axllent/goiplookup","owner":"axllent","description":"GoIPLookup uses the GeoLite2-Country database to find the Country of an IP address or hostname","archived":false,"fork":false,"pushed_at":"2024-02-06T00:30:01.000Z","size":56,"stargazers_count":71,"open_issues_count":0,"forks_count":6,"subscribers_count":4,"default_branch":"develop","last_synced_at":"2025-03-25T04:06:54.507Z","etag":null,"topics":["geoip2","geoiplookup","geolite2","geolite2-country-database","geolocation","go","golang"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/axllent.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-03-02T04:25:02.000Z","updated_at":"2025-03-05T11:17:26.000Z","dependencies_parsed_at":"2022-08-28T11:41:10.027Z","dependency_job_id":"927b3d87-acf6-49f2-95cd-f83c940e9747","html_url":"https://github.com/axllent/goiplookup","commit_stats":{"total_commits":64,"total_committers":3,"mean_commits":"21.333333333333332","dds":0.03125,"last_synced_commit":"b3fe08c970aad1c03eb756dd905194afdabdc1dd"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axllent%2Fgoiplookup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axllent%2Fgoiplookup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axllent%2Fgoiplookup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axllent%2Fgoiplookup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/axllent","download_url":"https://codeload.github.com/axllent/goiplookup/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248290033,"owners_count":21078923,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["geoip2","geoiplookup","geolite2","geolite2-country-database","geolocation","go","golang"],"created_at":"2024-11-07T02:23:42.871Z","updated_at":"2025-04-10T20:31:20.367Z","avatar_url":"https://github.com/axllent.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# GoIPLookup - geoiplookup for GeoLite2 written in Go\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/axllent/goiplookup)](https://goreportcard.com/report/github.com/axllent/goiplookup)\n\nGoIPLookup is a geoiplookup replacement for the [free MaxMind GeoLite2-Country](https://dev.maxmind.com/geoip/geoip2/geolite2/),\nwritten in [Go](https://golang.org/).\n\nIt currently only supports the free GeoLite2-Country database, and there is no planned support for the other types.\n\n\n## Features\n\n- Drop-in replacement for the now defunct `geoiplookup` utility, simply rename it\n- Works with the current MaxMind database format (mmdd)\n- IPv4, IPv6 and fully qualified domain name (FQDN) support\n- Options to return just the country iso (`NZ`) or country name (`New Zealand`), rather than the full `GeoIP Country Edition: NZ, New Zealand`\n- Built-in database update support (see [Database updates](#database-updates))\n- Built-in self updater (if new release is available)\n\n\n## Installing\n\nMultiple OS/Architecture binaries are supplied with releases. Extract the binary, make it executable, and move it to a location such as `/usr/local/bin`.\n\nIf you wish to replace an existing defunct implementation of geoiplookup, then simply name the file `geoiplookup`.\n\n\n## Basic usage\n\n```\nUsage: goiplookup [-i] [-c] [-d \u003cdatabase directory\u003e] \u003cipaddress|hostname|db-update|self-update\u003e\n\nOptions:\n  -V\tshow version number\n  -c\treturn country name\n  -d string\n    \tdatabase directory or file (default \"/usr/share/GeoIP\")\n  -h\tshow help\n  -i\treturn country iso code\n  -v\tverbose/debug output\n\nExamples:\ngoiplookup 8.8.8.8\t\t\tReturn the country ISO code and name\ngoiplookup -d ~/GeoIP 8.8.8.8\t\tUse a different database directory\ngoiplookup -i 8.8.8.8\t\t\tReturn just the country ISO code\ngoiplookup -c 8.8.8.8\t\t\tReturn just the country name\ngoiplookup db-update\t\t\tUpdate the GeoLite2-Country database (do not run more than once a month)\ngoiplookup self-update\t\t\tUpdate the GoIpLookup binary with the latest release\n```\n\n\n## GoIPLookup updates\n\nGoIPLookup comes with a built-in self-updater:\n\n```\ngoiplookup self-update\n```\n\nVersion checked (`goiplookup -V`) will tell you if your version is out of date.\n\n\n## Database updates\n\nGoIPLookup is able to update your GeoLite2 Country database. As of 01/01/2020 MaxMind require a (free) License Key in order to download these updates. The release (binary) versions of goiplookup (\u003e= 0.2.2) already contain a key for this, however if you are compiling from source you will need to set your own licence key in your environment (see below).\n\n\n### Binary release database updates\n\n```\ngoiplookup db-update\n```\n\n\n### Self-compiled database updates\n\nIf you wish to use your own MaxMind license key, or you are compiling from source, then you must provide a key in your environment.\nTo generate your own license key from MaxMind you must first [register a free account](https://www.maxmind.com/en/geolite2/signup) and follow the instructions.\n\n```\nLICENSEKEY=\"xxxxxxxx\" goiplookup db-update\n```\nor\n```\nexport LICENSEKEY=\"xxxxxxxx\"\ngoiplookup db-update\n```\n\nor if you wish to compile the source code yourself with your key:\n```\nmake LICENSEKEY=\"xxxxxxxx\"\n```\n\n## Compiling from source\n\nGo \u003e= 1.11 required:\n\n```\ngo get github.com/axllent/goiplookup\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faxllent%2Fgoiplookup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faxllent%2Fgoiplookup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faxllent%2Fgoiplookup/lists"}