<!-- review: finished -->

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

# Proxy

Permite hacer proxy de flujos de datos sobre TCP, UDP y sockets de dominio UNIX.

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

## Ejemplo de configuración

```nginx
server {
    listen 127.0.0.1:12345;
    proxy_pass 127.0.0.1:8080;
}

server {
    listen 12345;
    proxy_connect_timeout 1s;
    proxy_timeout 1m;
    proxy_pass example.com:12345;
}

server {
    listen 53 udp reuseport;
    proxy_timeout 20s;
    proxy_pass dns.example.com:53;
}

server {
    listen [::1]:12345;
    proxy_pass unix:/tmp/stream.socket;
}
```

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

## Directivas

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

<a id="s-proxy-bind"></a>

### proxy_bind

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_bind` dirección [`transparent`] | `off`;   |
|--------------------------------------------------------------------------------------------|---------------------------------------------------|
| Predeterminado                                                                             | —                                                 |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                                    |

Hace que las conexiones salientes a un servidor proxy se originen desde la dirección IP local especificada. El valor del parámetro puede contener variables. El valor especial `off` cancela el efecto de la directiva proxy_bind heredada del nivel de configuración anterior, lo que permite que el sistema asigne automáticamente la dirección IP local.

El parámetro `transparent` permite que las conexiones salientes a un servidor proxy se originen desde una dirección IP no local, por ejemplo, desde la dirección IP real de un cliente:

```nginx
proxy_bind $remote_addr transparent;
```

Para que este parámetro funcione,
los procesos worker de Angie normalmente deben ejecutarse
con privilegios de [superusuario](https://es.angie.software//angie/docs/configuration/modules/core.md#user).
En Linux no es necesario:
si se especifica el parámetro `transparent`,
los procesos worker heredan la capacidad CAP_NET_RAW del proceso maestro.

#### NOTE
También debe configurarse la tabla de enrutamiento del kernel
para interceptar el tráfico de red desde el servidor proxy.

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

<a id="s-proxy-buffer-size"></a>

### proxy_buffer_size

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_buffer_size` tamaño;   |
|--------------------------------------------------------------------------------------------|-------------------------------|
| Predeterminado                                                                             | `proxy_buffer_size 16k;`      |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                |

Establece el tamaño del buffer usado para leer datos desde el servidor proxy. También establece el tamaño del buffer usado para leer datos desde el cliente.

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

<a id="s-proxy-connect-timeout"></a>

### proxy_connect_timeout

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_connect_timeout` tiempo;   |
|--------------------------------------------------------------------------------------------|-----------------------------------|
| Predeterminado                                                                             | `proxy_connect_timeout 60s;`      |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                    |

Define un tiempo de espera para establecer una conexión con un servidor proxy.

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

<a id="s-proxy-connection-drop"></a>

### proxy_connection_drop

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_connection_drop` tiempo | `on` | `off`;   |
|--------------------------------------------------------------------------------------------|--------------------------------------------------|
| Predeterminado                                                                             | `proxy_connection_drop off;`                     |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                                   |

Habilita la finalización de todas las sesiones hacia el servidor proxy después de que haya sido eliminado del grupo o marcado como permanentemente no disponible por un proceso [reresolve](https://es.angie.software//angie/docs/configuration/modules/http/http_upstream.md#reresolve) o por el [comando API](https://es.angie.software//angie/docs/configuration/modules/http/http_api.md#api-config-methods) `DELETE`.

Una sesión se termina cuando se procesa el siguiente evento de lectura o escritura tanto para el cliente como para el servidor proxy.

Configurar tiempo habilita un [tiempo de espera](https://es.angie.software//angie/docs/configuration/configfile.md#syntax) de finalización de sesión;
con `on`, las sesiones se cierran inmediatamente.

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

<a id="s-proxy-download-rate"></a>

### proxy_download_rate

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_download_rate` velocidad;   |
|--------------------------------------------------------------------------------------------|------------------------------------|
| Predeterminado                                                                             | `proxy_download_rate 0;`           |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                     |

Limita la velocidad de lectura de datos desde el servidor proxy. La `velocidad` se especifica en bytes por segundo.

| `0`   | desactiva la limitación de velocidad   |
|-------|----------------------------------------|

#### NOTE
El límite se establece por conexión, por lo que si Angie abre dos conexiones simultáneamente al servidor proxy, la velocidad total será el doble del límite especificado.

El valor del parámetro puede contener variables. Puede resultar útil en casos donde la velocidad deba limitarse según una condición determinada:

```nginx
map $slow $rate {
    1     4k;
    2     8k;
}

proxy_download_rate $rate;
```

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

<a id="s-proxy-half-close"></a>

### proxy_half_close

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_half_close` `on` | `off`;   |
|--------------------------------------------------------------------------------------------|------------------------------------|
| Predeterminado                                                                             | `proxy_half_close off;`            |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                     |

Habilita o deshabilita el cierre independiente de cada dirección de una conexión TCP ("TCP half-close"). Si está habilitado, el proxy sobre TCP se mantendrá hasta que ambas partes cierren la conexión.

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

<a id="s-proxy-next-upstream"></a>

### proxy_next_upstream

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_next_upstream` `on` | `off`;   |
|--------------------------------------------------------------------------------------------|---------------------------------------|
| Predeterminado                                                                             | `proxy_next_upstream on;`             |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                        |

Cuando no se puede establecer una conexión con el servidor proxy, determina si la conexión del cliente se pasará al siguiente servidor en el [grupo upstream](https://es.angie.software//angie/docs/configuration/modules/stream/stream_upstream.md#stream-upstream).

El paso de una conexión al siguiente servidor puede limitarse mediante el [número de intentos](#s-proxy-next-upstream-tries) y por [tiempo](#s-proxy-next-upstream-timeout).

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

<a id="s-proxy-next-upstream-timeout"></a>

### proxy_next_upstream_timeout

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_next_upstream_timeout` tiempo;   |
|--------------------------------------------------------------------------------------------|-----------------------------------------|
| Predeterminado                                                                             | `proxy_next_upstream_timeout 0;`        |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                          |

Limita el tiempo permitido para pasar una conexión al [siguiente](#s-proxy-next-upstream) servidor.

| `0`   | desactiva esta limitación   |
|-------|-----------------------------|

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

<a id="s-proxy-next-upstream-tries"></a>

### proxy_next_upstream_tries

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_next_upstream_tries` número;   |
|--------------------------------------------------------------------------------------------|---------------------------------------|
| Predeterminado                                                                             | `proxy_next_upstream_tries 0;`        |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                        |

Limita el número de intentos posibles para pasar una conexión al [siguiente](#s-proxy-next-upstream) servidor.

| `0`   | desactiva esta limitación   |
|-------|-----------------------------|

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

<a id="s-proxy-pass"></a>

### proxy_pass

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_pass` dirección;   |
|--------------------------------------------------------------------------------------------|---------------------------|
| Predeterminado                                                                             | —                         |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | server                    |

Establece la dirección de un servidor proxy. La `dirección` puede especificarse como un nombre de dominio o dirección IP, y un puerto:

```nginx
proxy_pass localhost:12345;
```

o como una ruta de socket de dominio UNIX:

```nginx
proxy_pass unix:/tmp/stream.socket;
```

Si un nombre de dominio se resuelve en varias direcciones, todas se usarán en modo round-robin. Además, una dirección puede especificarse como un [grupo de servidores](https://es.angie.software//angie/docs/configuration/modules/stream/stream_upstream.md#stream-upstream).

La dirección también puede especificarse usando variables:

```nginx
proxy_pass $upstream;
```

En este caso, el nombre del servidor se busca entre los [grupos de servidores](https://es.angie.software//angie/docs/configuration/modules/stream/stream_upstream.md#stream-upstream) descritos y, si no se encuentra, se determina usando un [resolver](https://es.angie.software//angie/docs/configuration/modules/stream/index.md#s-resolver).

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

<a id="s-proxy-protocol"></a>

### proxy_protocol

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_protocol` `on` | `off`;   |
|--------------------------------------------------------------------------------------------|----------------------------------|
| Predeterminado                                                                             | `proxy_protocol off;`            |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                   |

Habilita el [protocolo PROXY](http://www.haproxy.org/download/1.8/doc/proxy-protocol.txt) para conexiones a un servidor proxy.

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

<a id="s-proxy-protocol-version"></a>

### proxy_protocol_version

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_protocol_version` `1` | `2`;   |
|--------------------------------------------------------------------------------------------|---------------------------------------|
| Predeterminado                                                                             | `proxy_protocol_version 1;`           |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                        |

Establece la versión del protocolo PROXY usada para conexiones a un servidor proxy. La configuración es efectiva cuando [proxy_protocol](#s-proxy-protocol) está habilitado. La versión 2 permite enviar TLVs configurados por la directiva [proxy_protocol_tlv](#s-proxy-protocol-tlv).

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

<a id="s-proxy-protocol-tlv"></a>

### proxy_protocol_tlv

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_protocol_tlv` nombre valor;   |
|--------------------------------------------------------------------------------------------|--------------------------------------|
| Predeterminado                                                                             | —                                    |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                       |

Añade un TLV a la cabecera del protocolo PROXY v2 enviada a un servidor proxy. El valor puede contener variables. El nombre puede ser un nombre de tipo TLV o su valor numérico; en este último caso, el valor se especifica en hexadecimal y debe comenzar con 0x. Para TLVs SSL, use el prefijo `ssl_`; el nombre especial `ssl_verify` establece el campo verify del TLV SSL. La directiva se usa solo con [proxy_protocol_version](#s-proxy-protocol-version) establecido en `2`.

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

<a id="s-proxy-requests"></a>

### proxy_requests

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_requests` número;   |
|--------------------------------------------------------------------------------------------|----------------------------|
| Predeterminado                                                                             | `proxy_requests 0;`        |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server             |

Establece el número de datagramas de cliente en el que se elimina el enlace entre un cliente y una sesión de flujo UDP existente. Después de recibir el número especificado de datagramas, el siguiente datagrama del mismo cliente inicia una nueva sesión. La sesión termina cuando todos los datagramas del cliente se transmiten a un servidor proxy y se recibe el [número esperado de respuestas](#s-proxy-responses), o cuando alcanza un [tiempo de espera](#s-proxy-timeout).

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

<a id="s-proxy-responses"></a>

### proxy_responses

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_responses` número;   |
|--------------------------------------------------------------------------------------------|-----------------------------|
| Predeterminado                                                                             | —                           |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server              |

Establece el número de datagramas esperados desde el servidor proxy en respuesta a un datagrama de cliente si se usa el protocolo [UDP](https://es.angie.software//angie/docs/configuration/modules/stream/index.md#stream-protocol). El número sirve como pista para la finalización de la sesión. Por defecto, el número de datagramas no está limitado.

Si se especifica el valor cero, no se espera respuesta. Sin embargo, si se recibe una respuesta y la sesión aún no ha terminado, la respuesta será procesada.

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

<a id="s-proxy-socket-keepalive"></a>

### proxy_socket_keepalive

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_socket_keepalive` `on` | `off`;   |
|--------------------------------------------------------------------------------------------|------------------------------------------|
| Predeterminado                                                                             | `proxy_socket_keepalive off;`            |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                           |

Configura el comportamiento de "TCP keepalive" para conexiones salientes a un servidor proxy.

| `off`   | Por defecto, se aplican los ajustes del sistema operativo para el socket.   |
|---------|-----------------------------------------------------------------------------|
| `on`    | La opción de socket SO_KEEPALIVE está activada para el socket.              |

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

<a id="s-proxy-ssl"></a>

### proxy_ssl

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_ssl` `on` | `off`;   |
|--------------------------------------------------------------------------------------------|-----------------------------|
| Predeterminado                                                                             | `proxy_ssl off;`            |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server              |

Habilita el protocolo SSL/TLS para conexiones a un servidor proxy.

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

<a id="s-proxy-ssl-certificate"></a>

### proxy_ssl_certificate

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_ssl_certificate` archivo [archivo];   |
|--------------------------------------------------------------------------------------------|----------------------------------------------|
| Predeterminado                                                                             | —                                            |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                               |

Especifica un archivo con el certificado en formato PEM usado para la autenticación con un servidor proxy. Se pueden usar variables en el nombre del archivo.

Cuando [proxy_ssl_ntls](#s-proxy-ssl-ntls) está habilitado, la directiva acepta dos argumentos en lugar de uno:

```nginx
server {
    proxy_ssl_ntls  on;

    proxy_ssl_certificate      sign.crt enc.crt;
    proxy_ssl_certificate_key  sign.key enc.key;

    proxy_ssl_ciphers "ECC-SM2-WITH-SM4-SM3:ECDHE-SM2-WITH-SM4-SM3:RSA";

    proxy_pass backend:12345;
}
```

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

<a id="s-proxy-ssl-certificate-key"></a>

### proxy_ssl_certificate_key

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_ssl_certificate_key` archivo [archivo];   |
|--------------------------------------------------------------------------------------------|--------------------------------------------------|
| Predeterminado                                                                             | —                                                |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                                   |

Se puede especificar el valor `store:scheme:id` en lugar del `archivo`, que se usa para cargar una clave secreta con un id especificado y un URI scheme de proveedor OpenSSL registrado, como [pkcs11](https://datatracker.ietf.org/doc/html/rfc7512).

Especifica un archivo con la clave secreta en formato PEM usado para la autenticación con un servidor proxy. Se pueden usar variables en el nombre del archivo.

Cuando [proxy_ssl_ntls](#s-proxy-ssl-ntls) está habilitado, la directiva acepta dos argumentos en lugar de uno:

```nginx
server {
    proxy_ssl_ntls  on;

    proxy_ssl_certificate      sign.crt enc.crt;
    proxy_ssl_certificate_key  sign.key enc.key;

    proxy_ssl_ciphers "ECC-SM2-WITH-SM4-SM3:ECDHE-SM2-WITH-SM4-SM3:RSA";

    proxy_pass backend:12345;
}
```

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

<a id="s-proxy-ssl-ciphers"></a>

### proxy_ssl_ciphers

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_ssl_ciphers` cifras;   |
|--------------------------------------------------------------------------------------------|-------------------------------|
| Predeterminado                                                                             | `proxy_ssl_ciphers DEFAULT;`  |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                |

Especifica las cifras habilitadas para las solicitudes a un servidor proxy. Las cifras se especifican en el formato reconocido por la biblioteca OpenSSL.

La lista de cifras depende de la versión de OpenSSL instalada.
La lista completa puede visualizarse usando el comando `openssl ciphers`.

#### WARNING
La directiva `proxy_ssl_ciphers` *no* configura cifras para TLS 1.3 cuando
se usa OpenSSL. Para configurar cifras TLS 1.3 con OpenSSL, use la directiva
[proxy_ssl_conf_command](#s-proxy-ssl-conf-command), que se añadió para la configuración avanzada
de SSL.

- En LibreSSL, las cifras TLS 1.3 *pueden* configurarse usando
  `proxy_ssl_ciphers`.
- En BoringSSL, las cifras TLS 1.3 no pueden configurarse.

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

<a id="s-proxy-ssl-conf-command"></a>

### proxy_ssl_conf_command

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_ssl_conf_command` nombre valor;   |
|--------------------------------------------------------------------------------------------|------------------------------------------|
| Predeterminado                                                                             | —                                        |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                           |

Establece [comandos de configuración](https://docs.openssl.org/master/man3/SSL_CONF_cmd/) arbitrarios de OpenSSL al establecer una conexión con el servidor proxy.

#### NOTE
La directiva es compatible cuando se utiliza OpenSSL 1.0.2 o superior.
Para configurar las cifras TLS 1.3 con OpenSSL, use el comando `ciphersuites`.

Se pueden especificar varias directivas proxy_ssl_conf_command en el mismo nivel. Estas directivas se heredan del nivel de configuración anterior si y solo si no se definen directivas proxy_ssl_conf_command en el nivel actual.

#### WARNING
Tenga en cuenta que configurar OpenSSL directamente puede provocar un comportamiento inesperado.

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

<a id="s-proxy-ssl-crl"></a>

### proxy_ssl_crl

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_ssl_crl` archivo;   |
|--------------------------------------------------------------------------------------------|----------------------------|
| Predeterminado                                                                             | —                          |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server             |

Especifica un archivo con certificados revocados (CRL) en formato PEM usado para [verificar](#s-proxy-ssl-verify) el certificado del servidor proxy.

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

<a id="s-proxy-ssl-name"></a>

### proxy_ssl_name

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_ssl_name` nombre;               |
|--------------------------------------------------------------------------------------------|----------------------------------------|
| Predeterminado                                                                             | `proxy_ssl_name` host de `proxy_pass`; |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                         |

Permite sobrescribir el nombre de servidor usado para [verificar](#s-proxy-ssl-verify) el certificado del servidor proxy y para ser [enviado a través de SNI](#s-proxy-ssl-server-name) al establecer una conexión con el servidor proxy. El nombre del servidor también puede especificarse usando variables.

Por defecto, se utiliza el nombre de host de la dirección especificada en la directiva [proxy_pass](#s-proxy-pass).

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

<a id="s-proxy-ssl-ntls"></a>

### proxy_ssl_ntls

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_ssl_ntls` `on` | `off`;   |
|--------------------------------------------------------------------------------------------|----------------------------------|
| Predeterminado                                                                             | `proxy_ssl_ntls off;`            |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                   |

Habilita el soporte del lado cliente para NTLS al usar la biblioteca TLS [TongSuo](https://github.com/Tongsuo-Project/Tongsuo).

```nginx
server {
    proxy_ssl_ntls  on;

    proxy_ssl_certificate      sign.crt enc.crt;
    proxy_ssl_certificate_key  sign.key enc.key;

    proxy_ssl_ciphers "ECC-SM2-WITH-SM4-SM3:ECDHE-SM2-WITH-SM4-SM3:RSA";

    proxy_pass backend:12345;
}
```

#### NOTE
Angie debe compilarse usando el parámetro de configuración `--with-ntls`, con la biblioteca SSL correspondiente con soporte NTLS

```default
./configure --with-openssl=../Tongsuo-8.3.0 \
            --with-openssl-opt=enable-ntls  \
            --with-ntls
```

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

<a id="s-proxy-ssl-password-file"></a>

### proxy_ssl_password_file

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_ssl_password_file` archivo;   |
|--------------------------------------------------------------------------------------------|--------------------------------------|
| Predeterminado                                                                             | —                                    |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                       |

Especifica un archivo con contraseñas para [claves secretas](#s-proxy-ssl-certificate-key) donde cada contraseña se especifica en una línea separada. Las contraseñas se prueban en orden al cargar la clave.

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

<a id="s-proxy-ssl-protocols"></a>

### proxy_ssl_protocols

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_ssl_protocols` [`SSLv2`] [`SSLv3`] [`TLSv1`] [`TLSv1.1`] [`TLSv1.2`] [`TLSv1.3`];   |
|--------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|
| Predeterminado                                                                             | `proxy_ssl_protocols TLSv1.2 TLSv1.3;`                                                     |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                                                                             |

#### Versionchanged
Distinto en la versión 1.2.0: El parámetro `TLSv1.3` se añadió al conjunto predeterminado.

Habilita los protocolos especificados para las solicitudes a un servidor proxy.

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

<a id="s-proxy-ssl-server-name"></a>

### proxy_ssl_server_name

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_ssl_server_name` `on` | `off`;   |
|--------------------------------------------------------------------------------------------|-----------------------------------------|
| Predeterminado                                                                             | `proxy_ssl_server_name off;`            |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                          |

Habilita o deshabilita el envío del nombre de servidor
especificado por la directiva [proxy_ssl_name](#s-proxy-ssl-name)
a través de la extensión TLS
[Server Name Indication](http://en.wikipedia.org/wiki/Server_Name_Indication)
(SNI,
[RFC 6066](https://datatracker.ietf.org/doc/html/rfc6066.html))
al establecer una conexión con el servidor proxy.

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

<a id="s-proxy-ssl-session-reuse"></a>

### proxy_ssl_session_reuse

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_ssl_session_reuse` `on` | `off`;   |
|--------------------------------------------------------------------------------------------|-------------------------------------------|
| Predeterminado                                                                             | `proxy_ssl_session_reuse on;`             |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                            |

Determina si las sesiones SSL pueden reutilizarse al trabajar con el servidor proxy. Si en los registros aparecen errores "SSL3_GET_FINISHED:digest check failed", pruebe a desactivar la reutilización de sesiones.

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

<a id="s-proxy-ssl-trusted-certificate"></a>

### proxy_ssl_trusted_certificate

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_ssl_trusted_certificate` archivo;   |
|--------------------------------------------------------------------------------------------|--------------------------------------------|
| Predeterminado                                                                             | —                                          |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                             |

Especifica un archivo con certificados de CA confiables en formato PEM utilizado para [verificar](#s-proxy-ssl-verify) el certificado del servidor proxy.

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

<a id="s-proxy-ssl-verify"></a>

### proxy_ssl_verify

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_ssl_verify` `on` | `off`;   |
|--------------------------------------------------------------------------------------------|------------------------------------|
| Predeterminado                                                                             | `proxy_ssl_verify off;`            |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                     |

Habilita o deshabilita la verificación del certificado del servidor proxy.

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

<a id="s-proxy-ssl-verify-depth"></a>

### proxy_ssl_verify_depth

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_ssl_verify_depth` número;   |
|--------------------------------------------------------------------------------------------|------------------------------------|
| Predeterminado                                                                             | `proxy_ssl_verify_depth 1;`        |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server                     |

Establece la profundidad de verificación en la cadena de certificados del servidor proxy.

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

<a id="s-proxy-timeout"></a>

### proxy_timeout

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_timeout` tiempo;   |
|--------------------------------------------------------------------------------------------|---------------------------|
| Predeterminado                                                                             | `proxy_timeout 10m;`      |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server            |

Establece un tiempo de espera entre dos operaciones consecutivas de lectura o escritura en conexiones del cliente o del servidor proxy. Si no se transmite ningún dato durante este tiempo, la conexión se cierra.

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

<a id="s-proxy-upload-rate"></a>

### proxy_upload_rate

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `proxy_upload_rate` tasa;   |
|--------------------------------------------------------------------------------------------|-----------------------------|
| Predeterminado                                                                             | `proxy_upload_rate 0;`      |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | stream, server              |

Limita la velocidad de lectura de datos desde el cliente. La tasa se especifica en bytes por segundo.

| `0`   | desactiva la limitación de velocidad   |
|-------|----------------------------------------|

#### NOTE
El límite se establece por conexión, por lo que si el cliente abre simultáneamente dos conexiones, la velocidad total será el doble del límite especificado.

El valor del parámetro puede contener variables. Esto puede ser útil en casos donde la tasa deba limitarse en función de una condición específica:

```nginx
map $slow $rate {
    1     4k;
    2     8k;
}

proxy_upload_rate $rate;
```