<!-- review: finished -->

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

# RealIP

Позволяет менять адрес и порт клиента на переданные в заголовке протокола PROXY. Протокол PROXY должен быть предварительно включен при помощи установки параметра `proxy_protocol` в директиве [listen](https://angie.software//angie/docs/configuration/modules/stream/index.md#s-listen).

При [сборке из исходного кода](https://angie.software//angie/docs/installation/sourcebuild.md#sourcebuild) модуль не собирается по умолчанию; его необходимо
включить с помощью [параметра сборки](https://angie.software//angie/docs/installation/sourcebuild.md#configure)
`‑‑with‑stream_realip_module`.
В пакетах и образах из
[наших репозиториев](https://angie.software//angie/docs/installation/index.md#install-packages)
модуль включен в сборку.

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

## Пример конфигурации

```nginx
listen 12345 proxy_protocol;

set_real_ip_from  192.168.1.0/24;
set_real_ip_from  192.168.2.1;
set_real_ip_from  2001:0db8::/32;
```

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

## Директивы

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

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

### set_real_ip_from

| [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile)   | `set_real_ip_from` адрес | CIDR | `unix:`;   |
|------------------------------------------------------------------------------------------|----------------------------------------------|
| По умолчанию                                                                             | —                                            |
| [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile)    | stream, server                               |

Задает доверенные адреса, которые передают верный адрес для замены. Если указано специальное значение `unix:`, доверенными будут считаться все UNIX-сокеты.

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

## Встроенные переменные

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

### `$realip_remote_addr`

хранит исходный адрес клиента

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

### `$realip_remote_port`

хранит исходный порт клиента
