crazymax/geoip-updater

GeoIP Updater Docker镜像文档

镜像概述

GeoIP Updater是一个Docker镜像，用于基于时间调度自动下载和更新MaxMind的GeoIP2数据库（如GeoLite2-City、GeoLite2-Country等），方便需要地理位置信息的应用定期获取最新数据，确保IP地址地理定位的准确性。

核心功能与特性

• 定时自动更新：支持自定义CRON调度表达式，配置数据库更新频率（如每日、每周）
• 多数据库支持：可下载MaxMind提供的多种GeoIP2数据库（需有效的MaxMind许可证）
• 配置灵活：通过环境变量自定义数据库版本、下载路径、更新日志等
• 轻量级设计：基于轻量级基础镜像，资源占用低，易于集成到现有容器化环境

使用场景

• Web服务器（如Nginx、Apache）配置IP地理位置解析时，需定期更新GeoIP数据库
• 日志分析工具（如ELK Stack）解析IP地址归属地时，确保数据时效性
• 网络监控系统、安全审计平台等需要实时IP地理信息的应用

使用方法

前置要求

• 需拥有有效的MaxMind许可证密钥（可通过https://www.maxmind.com/%E6%B3%A8%E5%86%8C%E8%8E%B7%E5%8F%96%EF%BC%89
• Docker环境（19.03+版本）

快速启动（docker run）

bash
docker run -d \
  --name geoip-updater \
  -e MAXMIND_LICENSE_KEY="your_maxmind_license_key" \
  -e GEOIP_DB_EDITION="GeoLite2-City,GeoLite2-Country" \
  -e SCHEDULE="0 0 * * *" \
  -v /path/to/local/db:/data \
  crazy-max/geoip-updater

环境变量配置

Docker Compose配置示例

yaml
version: '3.8'

services:
  geoip-updater:
    image: crazy-max/geoip-updater
    container_name: geoip-updater
    restart: always
    environment:
      - MAXMIND_LICENSE_KEY=your_maxmind_license_key
      - GEOIP_DB_EDITION=GeoLite2-City,GeoLite2-Country
      - SCHEDULE=0 0 * * *
      - DOWNLOAD_PATH=/data
      - LOG_LEVEL=info
    volumes:
      - ./geoip-db:/data

注意事项

• MaxMind许可证密钥需妥善保管，避免泄露
• 首次运行时需确保网络通畅，以便成功下载初始数据库
• 数据库更新失败时，镜像会记录错误日志，可通过LOG_LEVEL=debug排查问题
• 更多详细配置及高级用法请参考https://github.com/crazy-max/geoip-updater