anroe/nginx-geoip2

Nginx-GeoIP2镜像文档

镜像概述

本镜像基于官方Nginx镜像（Alpine和Debian版本）构建，集成了GeoIP2动态模块，用于通过IP地址获取地理信息（如国家代码等）。镜像仅包含模块加载指令，需配合MMDB格式的地理数据库使用。

标签说明

• https://github.com/anroe/docker-nginx-geoip2/blob/master/debian/Dockerfile
• https://github.com/anroe/docker-nginx-geoip2/blob/master/alpine/Dockerfile
• 1.18.0-geoip2-3.3, stable
• 1.18.0-alpine-geoip2-3.3, stable-alpine

标签语法：{nginx版本}-{模块名称}-{模块版本}

如何使用本镜像

本镜像除主Nginx配置文件中的load_module指令外，不包含其他预设配置。使用时需准备MMDB格式的地理数据库，可从以下免费来源获取：

• DB-IP
• https://dev.maxmind.com/geoip/geoip2/geolite2/%EF%BC%88%E9%9C%80%E6%B3%A8%E5%86%8C%E8%B4%A6%E5%8F%B7%EF%BC%89

使用示例

1. 下载DB-IP国家数据库：

   bash
   wget https://download.db-ip.com/free/dbip-country-lite-2020-08.mmdb.gz
   gunzip dbip-country-lite-2020-08.mmdb.gz
   

2. 提取默认nginx.conf：

   bash
   docker run --rm docker.xuanyuan.run/anroe/nginx-geoip2:1.19.2-alpine-geoip2-3.3 cat /etc/nginx/nginx.conf > nginx.conf
   

3. 编辑nginx.conf：在http块中添加以下配置：

   nginx
   geoip2 /etc/nginx/dbip-country-lite-2020-08.mmdb {
       $geoip2_data_country_code default=US source=$http_x_forwarded_for country iso_code;
   }
   
   add_header X-Country-Code "$geoip2_data_country_code" always;
   

4. 运行容器：

   bash
   docker run --name nginx-geoip2 --rm \
       -p 8080:80 \
       -v /path/to/dbip-country-lite-2020-08.mmdb:/etc/nginx/dbip-country-lite-2020-08.mmdb \
       -v /path/to/nginx.conf:/etc/nginx/nginx.conf \
       docker.xuanyuan.run/anroe/nginx-geoip2:1.19.2-alpine-geoip2-3.3
   

5. 测试配置：执行以下命令验证地理信息解析：

   bash
   curl -s -I --header "X-Forwarded-For: $(dig +short myip.opendns.com @resolver1.opendns.com)" localhost:8080 | grep Country
   

   应返回您的国家代码。

如何在自定义镜像中使用

可将本镜像中编译的GeoIP2模块集成到您的自定义Nginx镜像中。

配置nginx.conf

在配置文件开头添加模块加载指令：

nginx
load_module /usr/lib/nginx/modules/ngx_http_geoip2_module.so;

Debian系统

在Dockerfile中添加：

dockerfile
RUN apt-get update && apt-get install -y libmaxminddb0
COPY --from=anroe/nginx-geoip2:1.19.2-geoip2-3.3 /usr/lib/nginx/modules/ngx_http_geoip2_module.so /usr/lib/nginx/modules/ngx_http_geoip2_module.so

Alpine系统

在Dockerfile中添加：

dockerfile
RUN apk add --no-cache --update libmaxminddb
COPY --from=anroe/nginx-geoip2:1.19.2-alpine-geoip2-3.3 /usr/lib/nginx/modules/ngx_http_geoip2_module.so /usr/lib/nginx/modules/ngx_http_geoip2_module.so

GeoIP2 Nginx模块

模块源码：https://github.com/leev/ngx_http_geoip2_module

其他Nginx模块

• https://hub.docker.com/r/anroe/nginx-modsecurity-coreruleset
• https://hub.docker.com/r/anroe/nginx-brotli