callstats/maxmind-geoipupdate-docker

maxmind-geoipupdate-docker镜像说明

镜像概述

本Docker镜像封装了MaxMind官方的geoipupdate工具，旨在简化地理IP数据库的自动更新流程。通过该镜像，用户可轻松配置并定期获取MaxMind提供的最新地理IP数据，适用于需要基于IP地址进行定位分析的各类应用场景。

核心功能

• 自动从MaxMind服务器拉取指定版本的地理IP数据库
• 支持通过环境变量配置账号信息、数据库类型及更新频率
• 轻量级镜像设计，占用资源少且易于集成
• 兼容主流Docker环境，支持单机及集群部署

使用场景

• 网络分析系统需要实时更新IP地理定位数据
• 用户定位服务需依赖准确的地理IP信息
• 合规要求下需定期更新MaxMind数据库的企业应用
• 个人项目中需要快速获取地理IP数据的场景

配置说明

需通过环境变量设置以下关键参数：

• GEOIPUPDATE_ACCOUNT_ID: MaxMind账号ID
• GEOIPUPDATE_LICENSE_KEY: MaxMind授权密钥
• GEOIPUPDATE_EDITION_IDS: 需更新的数据库类型（如GeoLite2-City, GeoLite2-Country）
• GEOIPUPDATE_FREQUENCY: 更新频率（单位：小时，默认24）

部署示例

Docker Run命令

bash
docker run -d \
  --name geoipupdate \
  -e GEOIPUPDATE_ACCOUNT_ID=YOUR_ACCOUNT_ID \
  -e GEOIPUPDATE_LICENSE_KEY=YOUR_LICENSE_KEY \
  -e GEOIPUPDATE_EDITION_IDS=GeoLite2-City \
  -e GEOIPUPDATE_FREQUENCY=24 \
  -v /path/to/local/db:/usr/share/GeoIP \
  callstats/maxmind-geoipupdate-docker

Docker Compose配置

yaml
version: '3'
services:
  geoipupdate:
    image: callstats/maxmind-geoipupdate-docker
    environment:
      - GEOIPUPDATE_ACCOUNT_ID=YOUR_ACCOUNT_ID
      - GEOIPUPDATE_LICENSE_KEY=YOUR_LICENSE_KEY
      - GEOIPUPDATE_EDITION_IDS=GeoLite2-City,GeoLite2-Country
      - GEOIPUPDATE_FREQUENCY=12
    volumes:
      - ./geoip-db:/usr/share/GeoIP
    restart: always

注：使用前需先在MaxMind官网注册账号并获取授权密钥。