supermasita/geoip-flask

Python Flask GeoLite2 City 服务

镜像概述和主要用途

基于Python Flask框架和Maxmind GeoLite2数据库构建的IP地理位置查询服务，提供HTTP接口返回IP对应的城市等地理信息，支持直接访问和JSON格式API调用，适用于需获取IP地理信息的应用场景。

核心功能和特性

• 支持查询当前请求IP或指定IP的地理位置信息
• 提供网页直接访问和JSON格式API两种查询方式
• 支持代理环境，可通过自定义HTTP头获取真实IP
• 支持通过环境变量自定义服务配置（端口、端点、数据库路径等）
• 使用UWSGI作为生产服务器，支持多进程运行及状态监控

使用场景和适用范围

• Web应用中获取用户IP地理位置信息
• 日志分析系统补充IP地理属性
• 用户定位相关的服务优化或内容定制
• 开发和生产环境中的IP地理信息查询工具

详细使用方法和配置说明

运行方式

Flask开发模式（仅开发环境）

bash
python3 app.py

UWSGI运行（生产示例）

bash
uwsgi --master --http 0.0.0.0:8888 --module app:app --processes 4

Docker镜像运行

bash
docker pull supermasita/geoip-flask
docker run -d --env GEOIP_APP_ENDPOINT=http://example.com:8888 -p 8888:8888 -t supermasita/geoip-flask

镜像内部UWSGI运行命令：

bash
/usr/local/bin/uwsgi --master --http 0.0.0.0:8888 --chdir /opt/geoip-flask/ --module app:app --processes 4 --stats 0.0.0.0:9191 --stats-http

代理环境配置

应用会检查X-Real-IP请求头以获取真实IP，若存在则优先使用该值。可通过环境变量GEOIP_APP_PROXY_IP_HEADER自定义此请求头。

服务使用方法

• 获取当前IP信息：https://your-endpoint.com/
• 获取指定IP信息（如63.245.208.212）：https://your-endpoint.com/63.245.208.212
• 获取当前IP信息（JSON格式）：https://your-endpoint.com/api/v1.0/ip/
• 获取指定IP信息（JSON格式）：https://your-endpoint.com/api/v1.0/ip/63.245.208.212

环境变量配置说明

可通过以下环境变量覆盖config.py默认配置：

Docker运行时配置示例：

bash
docker run -e GEOIP_APP_ENDPOINT=http://example.com -e GEOIP_APP_PORT=8080 -p 8080:8080 supermasita/geoip-flask

更新Maxmind数据库

目前无内置定期更新机制，如需更新数据库可：

• 下载最新GeoIP数据库并重新构建镜像（参见Dockerfile）
• 使用Docker Hub更新镜像：https://hub.docker.com/r/supermasita/geoip-flask

致谢

• 使用由Maxmind创建的GeoLite2数据