<!-- review: finished -->

<a id="http-realip"></a>

# RealIP

Este módulo se utiliza para cambiar la dirección del cliente y, opcionalmente, el puerto a los valores enviados en el campo de cabecera especificado.

Al [compilar desde el código fuente](https://es.angie.software//angie/docs/installation/sourcebuild.md#sourcebuild),
este módulo no se compila por defecto;
debe habilitarse con la
`‑‑with‑http_realip_module`
[opción de compilación](https://es.angie.software//angie/docs/installation/sourcebuild.md#configure).

En paquetes e imágenes de [nuestros repositorios](https://es.angie.software//angie/docs/installation/index.md#install-packages),
el módulo está incluido en la compilación.

<a id="configuration-example-36"></a>

## Ejemplo de configuración

```nginx
set_real_ip_from  192.168.1.0/24;
set_real_ip_from  192.168.2.1;
set_real_ip_from  2001:0db8::/32;
real_ip_header    X-Forwarded-For;
real_ip_recursive on;
```

<a id="directives-37"></a>

## Directivas

<a id="index-0"></a>

<a id="set-real-ip-from"></a>

### set_real_ip_from

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `set_real_ip_from` dirección | CIDR | `unix:`;   |
|--------------------------------------------------------------------------------------------|--------------------------------------------------|
| Predeterminada                                                                             | —                                                |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | http, server, location                           |

Define direcciones de confianza que se sabe que envían direcciones de reemplazo correctas.
Si se especifica el valor especial `unix:`, todos los sockets de dominio UNIX serán
considerados de confianza. Las direcciones de confianza también pueden especificarse usando un nombre de host.

<a id="index-1"></a>

<a id="real-ip-header"></a>

### real_ip_header

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `real_ip_header` campo | `X-Real-IP` | `X-Forwarded-For` | `proxy_protocol`;   |
|--------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------|
| Predeterminado                                                                             | `real_ip_header X-Real-IP;`                                                    |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | http, server, location                                                         |

Define el campo de cabecera de solicitud cuyo valor se utilizará para reemplazar la dirección del cliente.

El valor del campo de cabecera de solicitud que contiene un puerto opcional también se utiliza para reemplazar el puerto del cliente. La dirección y el puerto deben especificarse según [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986).

El parámetro `proxy_protocol` cambia la dirección del cliente a la de la cabecera del protocolo PROXY. El protocolo PROXY debe estar previamente habilitado configurando el parámetro proxy_protocol en la directiva [listen](https://es.angie.software//angie/docs/configuration/modules/http/index.md#listen).

<a id="index-2"></a>

<a id="real-ip-recursive"></a>

### real_ip_recursive

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `real_ip_recursive` `on` | `off`;   |
|--------------------------------------------------------------------------------------------|-------------------------------------|
| Predeterminada                                                                             | `real_ip_recursive off;`            |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | http, server, location              |

Si la búsqueda recursiva está deshabilitada, la dirección original del cliente que coincide con una de las direcciones de confianza se reemplaza por la última dirección enviada en el campo de cabecera de solicitud definido por la directiva [real_ip_header](#real-ip-header). Si la búsqueda recursiva está habilitada, la dirección original del cliente que coincide con una de las direcciones de confianza se reemplaza por la última dirección no confiable enviada en el campo de cabecera de solicitud.

<a id="built-in-variables-7"></a>

## Variables integradas

<a id="v-realip-remote-addr"></a>

### `$realip_remote_addr`

mantiene la dirección original del cliente

<a id="v-realip-remote-port"></a>

### `$realip_remote_port`

mantiene el puerto original del cliente