fiorix/freegeoip

freegeoip 镜像说明

镜像概述

该Docker镜像用于部署freegeoip web服务器，提供IP地址地理定位服务。注意： 自2018年4月起，该仓库不再维护，建议访问https://github.com/apilayer/freegeoip/%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E7%89%88%E6%9C%AC%E3%80%82%E9%95%9C%E5%83%8F%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87JSON%E3%80%81XML%E3%80%81CSV%E7%AD%89%E6%A0%BC%E5%BC%8F%E8%BF%94%E5%9B%9EIP%E7%9A%84%E5%9B%BD%E5%AE%B6%E3%80%81%E5%9F%8E%E5%B8%82%E7%AD%89%E5%9C%B0%E7%90%86%E4%BF%A1%E6%81%AF%EF%BC%8C%E5%9F%BA%E4%BA%8EMaxMind%E7%9A%84GeoLite2%EF%BC%88%E5%85%8D%E8%B4%B9%EF%BC%89%E6%88%96%E5%95%86%E4%B8%9AGeoIP2%E6%95%B0%E6%8D%AE%E5%BA%93%E3%80%82

核心功能

• 多格式API：支持JSON、XML、CSV格式的地理定位查询，可通过/json/{ip}、/xml/{ip}等端点访问。
• 数据库自动更新：默认使用免费GeoLite2数据库，并定期自动更新；也支持商业GeoIP2数据库的本地文件或URL自动更新。
• HTTPS支持：可通过Let's Encrypt自动获取证书，或使用自定义证书启用HTTPS，支持HTTP/2。
• 监控与指标：通过内部服务器提供Prometheus metrics和pprof性能分析。
• 灵活配置：支持CORS、HSTS、X-Forwarded-For（反向代理场景）、请求配额限制等。

使用场景

• 自建IP地理定位服务，满足应用对用户位置信息的需求。
• 集成到日志分析、用户行为统计等系统中，补充IP位置数据。
• 为网络安全工具提供IP归属地查询功能。

配置说明

快速部署

使用Docker快速启动服务：

bash
docker run --restart=always -p 8080:8080 -d fiorix/freegeoip  

测试API：

bash
curl localhost:8080/json/1.2.3.4  

HTTPS配置（Let's Encrypt）

通过Let's Encrypt自动获取证书并启用HTTPS：

bash
docker run -p 8888:8888 -p 80:8080 -p 443:8443 -d fiorix/freegeoip \
    -internal-server=:8888 \
    -http=:8080 \
    -https=:8443 \
    -hsts=max-age=31536000 \
    -letsencrypt \
    -letsencrypt-hosts=yourdomain.com  

环境变量配置

可通过环境变量替代命令行参数（前缀FREEGEOIP_，大写，下划线分隔）：

1. 创建prod.env文件：

env
FREEGEOIP_INTERNAL_SERVER=:8888  
FREEGEOIP_HTTP=:8080  
FREEGEOIP_HTTPS=:8443  
FREEGEOIP_HSTS=max-age=31536000  
FREEGEOIP_LETSENCRYPT=true  
FREEGEOIP_LETSENCRYPT_HOSTS=yourdomain.com  

2. 启动容器：

bash
docker run --env-file=prod.env -p 8888:8888 -p 80:8080 -p 443:8443 -d fiorix/freegeoip  

查看所有配置选项

bash
docker run --rm -it fiorix/freegeoip -help