maurosoft1973/alpine-maxmind-geolite Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Docker MaxMind GeoLite 2 镜像（基于Alpine Linux）

![Docker Automated build]([] ![Docker Pulls]([] ![Docker Stars]([***]

![Alpine Version]([***]

Docker镜像 (maurosoft1973/alpine-maxmind-geolite) 基于轻量级 Alpine Linux 构建。

Alpine 版本：3.21.0

MaxMind GeoLite 2 数据库版本：20251021（发布于2025-10-21）

镜像概述

该镜像包含一个用Go编写的小型REST应用，用于根据IP地址返回地理信息。

核心功能与API端点

可用端点

/:ip

返回指定IP的地理信息

• URL: /:ip/
• URL参数: ip=[varchar] - 需查询的IPv4地址
• 方法: GET
• 认证: 无需

成功响应

• 条件: IP地址存在于数据库中
• 状态码: 200 OK
• 响应示例:

json
{
  "City": {
    "GeoNameID": 3176959,
    "Names": {
      "de": "Florenz",
      "en": "Florence",
      "es": "Florencia",
      "fr": "Florence",
      "ja": "フィレンツェ",
      "pt-BR": "Florença",
      "ru": "Флоренция",
      "zh-CN": "佛罗伦萨"
    }
  },
  "Continent": {
    "Code": "EU",
    "GeoNameID": 6255148,
    "Names": {
      "de": "Europa",
      "en": "Europe",
      "es": "Europa",
      "fr": "Europe",
      "ja": "ヨーロッパ",
      "pt-BR": "Europa",
      "ru": "Европа",
      "zh-CN": "欧洲"
    }
  },
  "Country": {
    "GeoNameID": 3175395,
    "IsInEuropeanUnion": true,
    "IsoCode": "IT",
    "Names": {
      "de": "Italien",
      "en": "Italy",
      "es": "Italia",
      "fr": "Italie",
      "ja": "イタリア共和国",
      "pt-BR": "Itália",
      "ru": "Италия",
      "zh-CN": "意大利"
    }
  },
  "Location": {
    "AccuracyRadius": 50,
    "Latitude": 43.7686,
    "Longitude": 11.2509,
    "MetroCode": 0,
    "TimeZone": "Europe/Rome"
  },
  "Postal": {
    "Code": "50125"
  },
  "RegisteredCountry": {
    "GeoNameID": 3175395,
    "IsInEuropeanUnion": true,
    "IsoCode": "IT",
    "Names": {
      "de": "Italien",
      "en": "Italy",
      "es": "Italia",
      "fr": "Italie",
      "ja": "イタリア共和国",
      "pt-BR": "Itália",
      "ru": "Италия",
      "zh-CN": "意大利"
    }
  },
  "RepresentedCountry": {
    "GeoNameID": 0,
    "IsInEuropeanUnion": false,
    "IsoCode": "",
    "Names": null,
    "Type": ""
  },
  "Subdivisions": [
    {
      "GeoNameID": 3165361,
      "IsoCode": "52",
      "Names": {
        "de": "Toskana",
        "en": "Tuscany",
        "es": "Toscana",
        "fr": "Toscane",
        "ja": "トスカーナ州",
        "pt-BR": "Toscana",
        "ru": "Тоскана",
        "zh-CN": "托斯卡纳"
      }
    },
    {
      "GeoNameID": 3176958,
      "IsoCode": "FI",
      "Names": {
        "de": "Florenz",
        "en": "Province of Florence",
        "es": "Florencia",
        "fr": "Florence",
        "pt-BR": "Florença"
      }
    }
  ],
  "Traits": {
    "IsAnonymousProxy": false,
    "IsSatelliteProvider": false
  }
}

/myip

返回客户端的远程IP地址

• URL: /myip/
• URL参数: 无
• 方法: GET
• 认证: 无需

成功响应

• 状态码: 200 OK
• 响应示例:

text
88.49.36.133

支持的架构

• :aarch64 - 64位ARM
• :armhf - 32位ARM v6
• :armv7 - 32位ARM v7
• :ppc64le - 64位PowerPC
• :x86_64 - 64位Intel/AMD (x86_64/amd64)

镜像标签

• :latest - 最新版本（自动架构选择）
• :aarch64 - 最新64位ARM版本
• :armhf - 最新32位ARM v6版本
• :armv7 - 最新32位ARM v7版本
• :ppc64le - 最新64位PowerPC版本
• :x86_64 - 最新64位Intel/AMD版本
• :test - 测试分支版本（自动架构选择）
• :test-aarch64 - 测试分支64位ARM版本
• :test-armhf - 测试分支32位ARM v6版本
• :test-armv7 - 测试分支32位ARM v7版本
• :test-ppc64le - 测试分支64位PowerPC版本
• :test-x86_64 - 测试分支64位Intel/AMD版本
• :3.21.0 - Alpine 3.21.0版本（自动架构选择）
• :3.21.0-aarch64 - Alpine 3.21.0 64位ARM版本
• :3.21.0-armhf - Alpine 3.21.0 32位ARM v6版本
• :3.21.0-armv7 - Alpine 3.21.0 32位ARM v7版本
• :3.21.0-ppc64le - Alpine 3.21.0 64位PowerPC版本
• :3.21.0-x86_64 - Alpine 3.21.0 64位Intel/AMD版本
• :3.21.0-20251021 - Alpine 3.21.0+数据库20251021版本（自动架构选择）
• :3.21.0-20251021-aarch64 - Alpine 3.21.0+数据库20251021 64位ARM版本
• :3.21.0-20251021-armhf - Alpine 3.21.0+数据库20251021 32位ARM v6版本
• :3.21.0-20251021-armv7 - Alpine 3.21.0+数据库20251021 32位ARM v7版本
• :3.21.0-20251021-ppc64le - Alpine 3.21.0+数据库20251021 64位PowerPC版本
• :3.21.0-20251021-x86_64 - Alpine 3.21.0+数据库20251021 64位Intel/AMD版本

镜像大小

环境变量

主要配置参数

支持的Locale列表

设置LC_ALL时，可选择以下Locale（默认en_GB.UTF-8）：

+-----------------+
| Locale          |
+-----------------+
| fr_CH.UTF-8     |
| fr_FR.UTF-8     |
| de_CH.UTF-8     |
| de_DE.UTF-8     |
| en_GB.UTF-8     |
| en_US.UTF-8     |
| es_ES.UTF-8     |
| it_CH.UTF-8     |
| it_IT.UTF-8     |
| nb_NO.UTF-8     |
| nl_NL.UTF-8     |
| pt_PT.UTF-8     |
| pt_BR.UTF-8     |
| ru_RU.UTF-8     |
| sv_SE.UTF-8     |
+-----------------+

使用示例

1. 使用默认参数创建容器

bash
docker run -d --name alpine-maxmind-geo -p 3001:3001 maurosoft1973/alpine-maxmind-geolite

# 测试IP查询
curl http://localhost:3001/8.8.8.8
# 测试获取客户端IP
curl http://localhost:3001/myip

2. 使用自定义端口（9002）创建容器

bash
docker run -d --name alpine-maxmind-geo -p 9002:9002 -e LISTEN_PORT=9002 maurosoft1973/alpine-maxmind-geolite

# 测试IP查询（使用自定义端口）
curl http://localhost:9002/8.8.8.8
# 测试获取客户端IP（使用自定义端口）
curl http://localhost:9002/myip