{"id":13420916,"url":"https://github.com/varnishcache-friends/libvmod-geoip2","last_synced_at":"2026-03-15T04:11:19.939Z","repository":{"id":19072419,"uuid":"22299528","full_name":"varnishcache-friends/libvmod-geoip2","owner":"varnishcache-friends","description":"Varnish VMOD to query MaxMind GeoIP2 DB files","archived":false,"fork":false,"pushed_at":"2024-04-08T15:32:22.000Z","size":233,"stargazers_count":39,"open_issues_count":1,"forks_count":17,"subscribers_count":9,"default_branch":"devel","last_synced_at":"2024-08-10T06:02:00.441Z","etag":null,"topics":["c","geoip2","module","varnish","vmod"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/varnishcache-friends.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.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":"2014-07-27T00:25:57.000Z","updated_at":"2024-04-08T04:27:39.000Z","dependencies_parsed_at":"2024-04-08T00:28:03.960Z","dependency_job_id":"2c68c460-4748-44e1-a4c8-1f4229c491bf","html_url":"https://github.com/varnishcache-friends/libvmod-geoip2","commit_stats":null,"previous_names":["fgsch/libvmod-geoip2"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/varnishcache-friends%2Flibvmod-geoip2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/varnishcache-friends%2Flibvmod-geoip2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/varnishcache-friends%2Flibvmod-geoip2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/varnishcache-friends%2Flibvmod-geoip2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/varnishcache-friends","download_url":"https://codeload.github.com/varnishcache-friends/libvmod-geoip2/tar.gz/refs/heads/devel","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243701267,"owners_count":20333614,"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":["c","geoip2","module","varnish","vmod"],"created_at":"2024-07-30T22:01:44.080Z","updated_at":"2025-12-17T23:42:19.960Z","avatar_url":"https://github.com/varnishcache-friends.png","language":"C","funding_links":[],"categories":["TODO scan for Android support in followings"],"sub_categories":[],"readme":"libvmod-geoip2\n==============\n\n![ci](https://github.com/varnishcache-friends/libvmod-geoip2/workflows/ci-devel/badge.svg)\n[![codecov](https://codecov.io/gh/varnishcache-friends/libvmod-geoip2/branch/devel/graph/badge.svg?token=4xGDQ6c35o)](https://codecov.io/gh/varnishcache-friends/libvmod-geoip2)\n\n## About\n\nA Varnish master VMOD to query MaxMind GeoIP2 DB files.\n\nFor Varnish 6.0, 7.4 and 7.5 refer to main branch.  Older Varnish\nversions are no longer supported.\n\n## Requirements\n\nTo build this VMOD you will need:\n\n* make\n* a C compiler, e.g. GCC or clang\n* pkg-config\n* python3-docutils or docutils in macOS [1]\n* Varnish master built from sources\n* libmaxminddb-dev in recent Debian/Ubuntu releases, maxminddb in\n  macOS [1]. See also https://github.com/maxmind/libmaxminddb\n\nIf you are building from Git, you will also need:\n\n* autoconf\n* automake\n* libtool\n\nYou will also need to set `PKG_CONFIG_PATH` to the directory where\n**varnishapi.pc** is located before running `autogen.sh` and\n`configure`.  For example:\n\n```\nexport PKG_CONFIG_PATH=/usr/local/lib/pkgconfig\n```\n\nFinally, to use it you will need one or more GeoIP2 or GeoLite2\nbinary databases.  See https://dev.maxmind.com/.\n\n## Installation\n\n### From a tarball\n\nTo install this VMOD, run the following commands:\n\n```\n./configure\nmake\nmake check\nsudo make install\n```\n\nThe `make check` step is optional but it's good to know whether the\ntests are passing on your platform.\n\n### From the Git repository\n\nTo install from Git, clone this repository by running:\n\n```\ngit clone --recursive https://github.com/varnishcache-friends/libvmod-geoip2\n```\n\nAnd then run `./autogen.sh` followed by the instructions above for\ninstalling from a tarball.\n\n### Packages\n\nSee https://github.com/varnishcache-friends/libvmod-geoip2/wiki#packages.\n\n## Example\n\n```\nimport geoip2;\n\nsub vcl_init {\n\tnew country = geoip2.geoip2(\"/path/to/GeoLite2-Country.mmdb\");\n}\n\nsub vcl_recv {\n\tif (country.lookup(\"country/names/en\", client.ip) != \"Japan\") {\n\t\t...\n\t}\n}\n```\n\nMore examples available at https://github.com/varnishcache-friends/libvmod-geoip2/wiki.\n\n## DB updates\n\nTo update the GeoIP2 DB, download the new file on the same filesystem\nas the old one and move it over. See also\nhttps://github.com/maxmind/geoipupdate.\n\n## License\n\nThis VMOD is licensed under BSD license. See LICENSE for details.\n\n### Note\n\n1. Using Homebrew, https://github.com/Homebrew/brew/.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvarnishcache-friends%2Flibvmod-geoip2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvarnishcache-friends%2Flibvmod-geoip2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvarnishcache-friends%2Flibvmod-geoip2/lists"}