vimagick/freegeoip

freegeoip

概述

freegeoip 是一个基于 Docker 的 IP 地理定位 Web 服务器镜像，能够通过 HTTP 接口提供 IP 地址的地理位置信息查询服务。该镜像由 vimagick/freegeoip 提供，可快速部署并集成到各类需要获取 IP 地理信息的应用场景中。

核心功能

• IP 地理定位查询：支持通过 HTTP 接口查询指定 IP 地址的地理位置信息，返回 JSON 格式数据，包含国家代码、国家名称、经纬度等信息。
• 监控指标接口：提供独立的 metrics 接口（默认 8888 端口），输出服务运行状态指标，如客户端连接数、IP 协议版本统计、数据库加载事件等。
• 便捷部署：支持通过 docker-compose 快速部署，配置简单，支持自动重启策略。

使用场景

• 日志分析系统：获取访问日志中 IP 地址的地理位置信息，辅助分析用户分布。
• 应用服务优化：根据用户 IP 地理位置调整服务策略，如内容分发、访问控制等。
• 监控告警系统：结合 metrics 接口数据，监控服务运行状态和查询量。

使用方法

环境要求

• Docker Engine 1.13+
• Docker Compose (可选，用于简化部署)

部署配置

docker-compose 配置

创建 docker-compose.yml 文件，内容如下：

yaml
freegeoip:
  image: vimagick/freegeoip  # 使用 vimagick/freegeoip 镜像
  ports:
    - "8080:8080"  # 映射地理定位查询接口端口
    - "8888:8888"  # 映射 metrics 监控接口端口
  restart: always  # 配置服务自动重启

启动服务

通过以下命令启动服务：

bash
docker-compose up -d

独立 Docker 运行命令

若不使用 docker-compose，可直接通过 docker run 命令启动：

bash
docker run -d -p 8080:8080 -p 8888:8888 --restart always --name freegeoip vimagick/freegeoip

接口使用

地理定位查询接口

通过 HTTP GET 请求访问 http://localhost:8080/json/[IP地址] 获取指定 IP 的地理信息，示例：

bash
# 查询 8.8.8.8 的地理信息
curl -s http://localhost:8080/json/8.8.8.8 | jq .

返回结果示例：

json
{
  "ip": "8.8.8.8",
  "country_code": "US",
  "country_name": "United States",
  "region_code": "",
  "region_name": "",
  "city": "",
  "zip_code": "",
  "time_zone": "",
  "latitude": 37.751,
  "longitude": -97.822,
  "metro_code": 0
}

Metrics 监控接口

访问 http://localhost:8888/metrics 获取服务运行指标，示例：

bash
curl -s http://localhost:8888/metrics

返回结果包含服务连接数、IP 协议版本统计、数据库加载事件等指标，例如：

freegeoip_client_connections{proto="http"} 0
freegeoip_client_country_code_total{country_code="unknown"} 7
freegeoip_client_ipproto_version_total{ip="4"} 7
freegeoip_db_events_total{event="loaded"} 1
go_gc_duration_seconds{quantile="0"} 5.9754e-05
...