Opções de configuração de runtime para rede

Protocolo HTTP/2

Configura se o suporte para o protocolo HTTP/2 está habilitado.
Se você omitir essa configuração, o suporte para o protocolo HTTP/2 estará habilitado. Isso é equivalente a definir o valor como true.

	Nome da configuração	Valores
runtimeconfig.json	`System.Net.Http.SocketsHttpHandler.Http2Support`	`false` -desabilitado `true` – Habilitado
Variável de ambiente	`DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_HTTP2SUPPORT`	`0` -desabilitado `1` – Habilitado

Essa definição de configuração não tem uma propriedade específica do MSBuild. No entanto, você pode adicionar um item RuntimeHostConfigurationOption do MSBuild. Use o nome da configuração runtimeconfig.json como o valor do atributo Include. Para ver um exemplo, confira Propriedades do MSBuild.

Protocolo HTTP/3

A partir do .NET 7, HTTP/3 é habilitado por padrão.

	Nome da configuração	Valores
runtimeconfig.json	`System.Net.SocketsHttpHandler.Http3Support`	`false` -Desativado `true` – Habilitado
Variável de ambiente	`DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_HTTP3SUPPORT`	`0` -desabilitado `1` – Habilitado

Criação de SPN no HttpClient (.NET 6 e posterior)

Afeta a geração de SPN ( nomes de entidade de serviço ) para autenticação Kerberos e NTLM quando Host o cabeçalho está ausente e o destino não está em execução na porta padrão.
O .NET 6 e versões posteriores não incluem a porta no SPN por padrão. No entanto, o comportamento é configurável.

	Nome da configuração	Valores
runtimeconfig.json	`System.Net.Http.UsePortInSpn`	`true` – incluir o número da porta no SPN, por exemplo, `HTTP/host:port` `false` - não inclua a porta no SPN, por exemplo, `HTTP/host`
Variável de ambiente	`DOTNET_SYSTEM_NET_HTTP_USEPORTINSPN`	`1` – incluir o número da porta no SPN, por exemplo, `HTTP/host:port` `0` - não inclua a porta no SPN, por exemplo, `HTTP/host`

Dimensionamento de janela dinâmica HTTP/2

Configura se o algoritmo de dimensionamento de janela dinâmica HTTP/2 está desabilitado para o controle de fluxo. O algoritmo é habilitado por padrão.
Quando definido como true, o algoritmo de dimensionamento de janela dinâmica é desabilitado.

	Nome da configuração	Valores
runtimeconfig.json	`System.Net.SocketsHttpHandler.Http2FlowControl.DisableDynamicWindowSizing`	`false` - habilitado (padrão) `true` -desabilitado
Variável de ambiente	`DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_HTTP2FLOWCONTROL_DISABLEDYNAMICWINDOWSIZING`	`0` - habilitado (padrão) `1` -desabilitado

Tamanho da janela de recebimento do fluxo HTTP/2

Configura o tamanho máximo da janela de recebimento do fluxo HTTP/2.
O padrão é 16 MB. Os valores abaixo de 65.535 são fixados em 65.535. Não há limite superior rígido, mas aumentar essa configuração além do padrão só é benéfico em redes que são de alta taxa de transferência e alta latência.

	Nome da configuração	Valores
Variável de ambiente	`DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_FLOWCONTROL_MAXSTREAMWINDOWSIZE`	Inteiro (padrão: 16 MB; mínimo: 65.535)

Limite de escala da janela de fluxo HTTP/2

Configura o multiplicador que controla a agressividade com que a janela de recebimento de fluxo HTTP/2 cresce. Valores mais altos resultam em um crescimento de janela mais conservador, o que reduz a taxa de transferência de pico.
O valor padrão é 1.0. Os valores abaixo de 0 são redefinidos para o padrão. Não há limite superior rígido, mas valores muito acima do padrão limitam progressivamente a taxa de transferência por solicitação.

Observação

Essa configuração destina-se a diagnósticos avançados e ajuste interno. A maioria dos desenvolvedores não precisa alterá-lo.

	Nome da configuração	Valores
Variável de ambiente	`DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_FLOWCONTROL_STREAMWINDOWSCALETHRESHOLDMULTIPLIER`	Float (padrão: 1.0; mínimo: 0)

Propagação de atividade HTTP

Configura se a propagação de atividade de rastreamento distribuído está habilitada para HttpClient. Quando habilitadas, as solicitações HTTP de saída propagam cabeçalhos de contexto de rastreamento (como traceparent) para ferramentas de rastreamento distribuído, como OpenTelemetry.

	Nome da configuração	Valores
runtimeconfig.json	`System.Net.Http.EnableActivityPropagation`	`true` - habilitado (padrão) `false` -desabilitado
Variável de ambiente	`DOTNET_SYSTEM_NET_HTTP_ENABLEACTIVITYPROPAGATION`	`1` - habilitado (padrão) `0` -desabilitado

Tempo limite de conexão pendente na conclusão da solicitação

Configura o tempo limite (em milissegundos) para concluir uma tentativa de conexão pendente após a conclusão da solicitação HTTP de início. Quando uma conexão ainda está sendo estabelecida após a conclusão da solicitação, esse tempo limite determina quanto tempo aguardar antes de abandonar a tentativa de conexão.

O padrão é 5000 (5 segundos).
Defina para -1 aguardar indefinidamente até que a conexão seja concluída.
Defina para 0 cancelar a conexão pendente imediatamente quando a solicitação for concluída.
Não há limite superior rígido, mas valores muito grandes são impraticáveis.

	Nome da configuração	Valores
runtimeconfig.json	`System.Net.SocketsHttpHandler.PendingConnectionTimeoutOnRequestCompletion`	Inteiro (padrão: `5000`)
Variável de ambiente	`DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_PENDINGCONNECTIONTIMEOUTONREQUESTCOMPLETION`	Inteiro (padrão: `5000`)

Pré-autenticação de proxy

Quando habilitado, SocketsHttpHandler envia Basic proativamente as credenciais de autenticação de proxy na primeira solicitação em vez de aguardar uma 407 resposta de desafio do proxy. Isso é útil para proxies que não enviam 407 respostas de desafio.

	Nome da configuração	Valores
runtimeconfig.json	`System.Net.Http.SocketsHttpHandler.ProxyPreAuthenticate`	`false` - desabilitado (padrão) `true` – Habilitado
Variável de ambiente	`DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_PROXYPREAUTHENTICATE`	`0` - desabilitado (padrão) `1` – Habilitado

Máximo de conexões por servidor

Configura o número máximo de conexões TCP simultâneas que SocketsHttpHandler são abertas para um único servidor. O manipulador ignora valores menores que 1 e usa o padrão.

O padrão é ilimitado (int.MaxValue).

	Nome da configuração	Valores
runtimeconfig.json	`System.Net.SocketsHttpHandler.MaxConnectionsPerServer`	Inteiro (padrão: ilimitado)
Variável de ambiente	`DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_MAXCONNECTIONSPERSERVER`	Inteiro (padrão: ilimitado)

Conclusões embutidas do soquete

Configura se as continuações do soquete têm permissão para serem executadas no thread de evento em vez de serem enviadas para o System.Threading.ThreadPool. Habilitar essa configuração pode melhorar o desempenho em alguns cenários. No entanto, isso poderá prejudicar o desempenho se o trabalho caro mantiver o thread de E/S por mais tempo do que o necessário.

Observação

Teste para garantir que a habilitação dessa configuração ajude o desempenho em seu cenário específico.

	Nome da configuração	Valores
Variável de ambiente	`DOTNET_SYSTEM_NET_SOCKETS_INLINE_COMPLETIONS`	`0` - desabilitado (padrão) `1` – Habilitado

Contagem de threads do soquete

Configura o número de threads usados para E/S do soquete. Quando não substituído, o valor é calculado com base na contagem de processadores e na arquitetura. Os valores práticos estão no intervalo [1, ProcessorCount]. Valores fora desse intervalo não são rejeitados, mas é improvável que melhorem o desempenho.

Observação

Essa configuração destina-se a cenários de carga extremos. A maioria dos desenvolvedores não precisa alterá-lo.

	Nome da configuração	Valores
Variável de ambiente	`DOTNET_SYSTEM_NET_SOCKETS_THREAD_COUNT`	Integer

IPv6

Configura se o Protocolo de Internet versão 6 (IPv6) está desabilitado.

	Nome da configuração	Valores
runtimeconfig.json	`System.Net.DisableIPv6`	`false` - habilitado (padrão) `true` -desabilitado
Variável de ambiente	`DOTNET_SYSTEM_NET_DISABLEIPV6`	`0` - habilitado (padrão) `1` -desabilitado

Retomada da sessão TLS

Controlar se a retomada da sessão do TLS desabilita a retomada da sessão do TLS para SslStream. A retomada da sessão permite que as reconexões TLS ignorem um handshake completo reutilizando parâmetros de sessão negociados anteriormente, o que reduz a latência.

	Nome da configuração	Valores
runtimeconfig.json	`System.Net.Security.DisableTlsResume`	`false` - habilitado (padrão) `true` -desabilitado
Variável de ambiente	`DOTNET_SYSTEM_NET_SECURITY_DISABLETLSRESUME`	`0` - habilitado (padrão) `1` -desabilitado

Downloads do AIA do servidor

Quando habilitado, o cliente TLS baixa automaticamente certificados intermediários das URLs de extensão do Acesso às Informações da Autoridade (AIA) em certificados de servidor. Isso permite que o cliente crie uma cadeia de certificados completa mesmo quando o servidor não envia a cadeia completa.

	Nome da configuração	Valores
runtimeconfig.json	`System.Net.Security.EnableServerAiaDownloads`	`false` - desabilitado (padrão) `true` – Habilitado
Variável de ambiente	`DOTNET_SYSTEM_NET_SECURITY_ENABLESERVERAIADOWNLOADS`	`0` - desabilitado (padrão) `1` – Habilitado

Cache de configuração do QUIC

Desabilita o cache de objetos de configuração msquic. Quando habilitado (padrão), o sistema armazena em cache e reutiliza objetos de configuração entre conexões, o que reduz a sobrecarga de instalação de TLS e QUIC para conexões repetidas com os mesmos parâmetros.

	Nome da configuração	Valores
runtimeconfig.json	`System.Net.Quic.DisableConfigurationCache`	`false` – cache habilitado (padrão) `true` – cache desabilitado
Variável de ambiente	`DOTNET_SYSTEM_NET_QUIC_DISABLE_CONFIGURATION_CACHE`	`0` – cache habilitado (padrão) `1` – cache desabilitado

MsQuic local do aplicativo (Windows)

Quando habilitada, a implementação do QUIC usa a biblioteca MsQuic do diretório do aplicativo em vez da biblioteca fornecida pelo sistema agrupada com o assembly .NET.

	Nome da configuração	Valores
runtimeconfig.json	`System.Net.Quic.AppLocalMsQuic`	`false` – usar o msquic do sistema (padrão) `true` – usar o MsQuic local do aplicativo

Buffer de resposta do kernel HttpListener (Windows)

Quando habilitado, HttpListener os buffers de dados de resposta no kernel via HTTP.sys. O buffer de kernel pode melhorar significativamente a taxa de transferência em relação a conexões de alta latência para aplicativos que usam E/S síncrona ou E/S assíncrona com no máximo uma gravação pendente por vez. Não habilite essa configuração para aplicativos com várias gravações pendentes simultâneas.

Observação

Habilitar o buffer de resposta do kernel pode resultar em maior uso de CPU e memória HTTP.sys.

	Nome da configuração	Valores
runtimeconfig.json	`System.Net.HttpListener.EnableKernelResponseBuffering`	`false` - desabilitado (padrão) `true` – Habilitado

Comentários

Esta página foi útil?

Last updated on 2026-03-18

Compartilhar via

Opções de configuração de runtime para rede

Protocolo HTTP/2

Protocolo HTTP/3

Criação de SPN no HttpClient (.NET 6 e posterior)

Dimensionamento de janela dinâmica HTTP/2

Tamanho da janela de recebimento do fluxo HTTP/2

Limite de escala da janela de fluxo HTTP/2

Propagação de atividade HTTP

Tempo limite de conexão pendente na conclusão da solicitação

Pré-autenticação de proxy

Máximo de conexões por servidor

Conclusões embutidas do soquete

Contagem de threads do soquete

IPv6

Retomada da sessão TLS

Downloads do AIA do servidor

Cache de configuração do QUIC

MsQuic local do aplicativo (Windows)

Buffer de resposta do kernel HttpListener (Windows)

Comentários

Recursos adicionais