# ngx\_http\_geoip\_module

* [示例配置](/nginx-docs/he-xin-gong-neng/http/ngx_http_geoip_module.md#example_configuration)
* [指令](/nginx-docs/he-xin-gong-neng/http/ngx_http_geoip_module.md#directives)
  * [geoip\_country](/nginx-docs/he-xin-gong-neng/http/ngx_http_geoip_module.md#geoip_country)
  * [geoip\_city](/nginx-docs/he-xin-gong-neng/http/ngx_http_geoip_module.md#geoip_city)
  * [geoip\_org](/nginx-docs/he-xin-gong-neng/http/ngx_http_geoip_module.md#geoip_org)
  * [geoip\_proxy](/nginx-docs/he-xin-gong-neng/http/ngx_http_geoip_module.md#geoip_proxy)
  * [geoip\_proxy\_recursive](/nginx-docs/he-xin-gong-neng/http/ngx_http_geoip_module.md#geoip_proxy_recursive)

`ngx_http_geoip_module` 模块（0.8.6+）使用预编译的 [MaxMind](http://www.maxmind.com/) 数据库，其创建带值的变量依赖客户端 IP 地址。

当使用支持 IPv6 的数据库时（1.3.12、1.2.7），IPv4 地址将被视为 IPv4 映射的 IPv6 地址。

此模块不是默认构建的，可以使用 `--with-http_geoip_module` 配置参数启用。

> 该模块需要 [MaxMind GeoIP](http://www.maxmind.com/app/c) 库。

## 示例配置 <a href="#example_configuration" id="example_configuration"></a>

```
http {
    geoip_country         GeoIP.dat;
    geoip_city            GeoLiteCity.dat;
    geoip_proxy           192.168.100.0/24;
    geoip_proxy           2001:0db8::/32;
    geoip_proxy_recursive on;
    ...
```

## 指令 <a href="#directives" id="directives"></a>

### geoip\_country

|       - | 说明                         |
| ------: | -------------------------- |
|  **语法** | **geoip\_country** `file`; |
|  **默认** | ——                         |
| **上下文** | http                       |

指定一个用于根据客户端 IP 地址确定国家的数据库。使用此数据库时，以下变量可用：

* `$geoip_country_code`

  双字母国家代码，例如 `RU`、`US`
* `$geoip_country_code3`

  三个字母的国家代码，例如 `RUS`、`USA`
* `$geoip_country_name`

  国家名称，例如 `Russian Federation`、`United States`

### geoip\_city

|       - | 说明                      |
| ------: | ----------------------- |
|  **语法** | **geoip\_city** `file`; |
|  **默认** | ——                      |
| **上下文** | http                    |

指定一个用于根据客户端 IP 地址确定国家、地区和城市的数据库。使用此数据库时，以下变量可用：

* `$geoip_area_code`

  电话区号（仅限美国）

  > 由于相应的数据库字段已弃用，因此此变量可能包含过时的信息
* `$geoip_city_continent_code`

  双字母的大陆码，例如 `EU`、`NA`
* `$geoip_city_country_code`

  双字母国家代码，例如 `RU`、`US`
* `$geoip_city_country_code3`

  三个字母的国家代码，例如 `RUS`、`USA`
* `$geoip_city_country_name`

  国家名称，例如 `Russian Federation`、`United States`
* `$geoip_dma_code`

  美国的 DMA 地区代码（也称为**城市代码**），根据 Google AdWords API 中的[地理位置定位](https://developers.google.com/adwords/api/docs/appendix/cities-DMAregions)
* `$geoip_latitude`

  纬度
* `$geoip_longitude`

  经度
* `$geoip_region`

  双符号国家地区代码（地区、领土、州、省、联邦土地等），例如 `48`、`DC`
* `$geoip_region_name`

  国家地区名称（地区，领土，州，省，联邦土地等），例如 `Moscow City`、`District of Columbia`
* `$geoip_city`

  城市名称，例如 `Moscow`、`Washington`
* `$geoip_postal_code`

  邮政编码

### geoip\_org

|       - | 说明                     |
| ------: | ---------------------- |
|  **语法** | **geoip\_org** `file`; |
|  **默认** | ——                     |
| **上下文** | http                   |
|  **提示** | 该指令在 1.0.3 版本中出现       |

指定用于根据客户端 IP 地址确定组织的数据库。使用此数据库时，以下变量可用：

* `$geoip_org`

  组织名称，例如 `The University of Melbourne`

### geoip\_proxy

|       - | 说明                                    |
| ------: | ------------------------------------- |
|  **语法** | **geoip\_proxy** `address` \| `CIDR`; |
|  **默认** | ——                                    |
| **上下文** | http                                  |
|  **提示** | 该指令在 1.3.0 版本和 1.2.1. 版本中出现           |

定义可信地址。当请求来自可信地址时，将使用来自 `X-Forwarded-For` 请求头字段的地址。

### geoip\_proxy\_recursive

|       - | 说明                                         |
| ------: | ------------------------------------------ |
|  **语法** | **geoip\_proxy\_recursive** `on` \| `off`; |
|  **默认** | geoip\_proxy\_recursive off;               |
| **上下文** | http                                       |
|  **提示** | 该指令在 1.3.0 版本和 1.2.1. 版本中出现                |

如果递归搜索被禁用，那么将使用在 `X-Forwarded-For` 中发送的最后一个地址，而不是匹配其中一个可信地址的原始客户端地址。如果启用递归搜索，则将使用在 `X-Forwarded-For` 中发送的最后一个不可信地址，而不是匹配其中一个可信地址的原始客户端地址。

## 原文档

<http://nginx.org/en/docs/http/ngx_http_geoip_module.html>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docshome.gitbook.io/nginx-docs/he-xin-gong-neng/http/ngx_http_geoip_module.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.