whitfin/geoipupdate

Docker Geoipupdate

镜像概述和主要用途

Docker Geoipupdate是一个最小化容器，用于在主机系统上更新Maxmind GeoIP数据库，无需在主机上安装相关依赖。该镜像包含自定义安装所需的一切组件，同时体积远小于Docker Hub上其他geoipupdate镜像（约6MB）。

核心功能和特性

• 最小化设计：镜像体积约6MB，资源占用低
• 无依赖安装：无需在主机系统安装geoipupdate依赖
• 灵活配置：支持通过配置文件或环境变量自定义更新参数
• 完整功能：包含geoipupdate工具的全部核心功能

使用场景和适用范围

适用于需要定期更新GeoIP数据库的场景，如：

• 需要IP地理位置信息的应用服务
• 服务器日志分析系统
• 网络安全监控平台
• 基于地理位置的访问控制服务

使用方法和配置说明

基本使用方法

该镜像设计为单命令执行模式，用于从主机调用geoipupdate。

默认配置下载

将默认数据库下载到当前目录下的geoip文件夹：

bash
docker run --rm \
    -v ./geoip:/usr/local/share/GeoIP \
    whitfin/geoipupdate

使用自定义配置文件

通过自定义配置文件下载数据库：

bash
docker run --rm \
    -e GEOIP_CONFIG_FILE=/usr/local/share/GeoIP/config.conf \
    -v ./geoip:/usr/local/share/GeoIP \
    whitfin/geoipupdate

注：需确保./geoip目录下存在config.conf配置文件

手动配置环境变量

通过环境变量手动配置更新参数：

bash
docker run --rm \
    -e GEOIP_ACCOUNT_ID=999999 \
    -e GEOIP_LICENSE_KEY=000000000000 \
    -e GEOIP_EDITION_IDS='GeoLite2-City GeoLite2-Country' \
    -e GEOIP_DIRECTORY='/usr/local/share/GeoIP' \
    -v ./geoip:/usr/local/share/GeoIP \
    whitfin/geoipupdate

环境变量说明

旧版本兼容性

如果使用旧版本的geoipupdate，可能需要使用以下环境变量替代：

• GEOIP_USER_ID 代替 GEOIP_ACCOUNT_ID
• GEOIP_PRODUCT_IDS 代替 GEOIP_EDITION_IDS