Partilhar via

Resolver problemas com proxy e firewall no Visual Studio

Quando usa o Visual Studio atrás de um proxy corporativo ou firewall, pode encontrar problemas de conectividade que afetam funcionalidades que exigem acesso à rede, como restauro de pacotes NuGet, instalação de extensões e funcionalidades baseadas em IA. As questões de procuração geralmente enquadram-se em duas categorias:

  • Problemas de configuração: Problemas com a configuração do seu servidor proxy, certificados ou configuração de rede. Estes problemas são resolvidos pelo seu administrador de TI.

  • Definições necessárias: O Visual Studio requer informações adicionais sobre a configuração da sua rede. Podes configurar as definições do proxy diretamente no IDE. Consulte Configurar definições de proxy no Visual Studio para instruções de configuração.

    Observação

    A experiência de configuração do proxy ainda não está disponível em todas as instalações do Visual Studio 2026. Se não vires isto na tua instalação, podes instalar o Visual Studio Insiders para experimentar. Ou, consulte a versão Visual Studio 2022 desta página para obter orientações.

  • Definições necessárias: O Visual Studio requer informações adicionais sobre a configuração da sua rede. Pode encontrar mais informações sobre como fornecer as definições necessárias ao Visual Studio neste artigo.
  • Problemas com o produto: Se determinou que o seu problema não é de configuração ou se as definições fornecidas não resolvem o problema que está a observar, então pode ser um problema de produto. Siga os passos em Recolher informação de diagnóstico antes de submeter um ticket.

Este artigo ajuda-o a identificar em que categoria se enquadra o seu problema e oferece soluções para problemas comuns.

Pré-requisitos

Antes de resolver problemas de proxy, certifique-se de que tem:

Problemas conhecidos e soluções

As secções seguintes descrevem questões comuns relacionadas com proxy e respetivas soluções.

Erros de ligação SSL (autoridade certificadora não confiável)

Sintoma: Vês um erro como System.Net.Http.HttpRequestException: The SSL connection could not be established com uma exceção IOException: Unable to read data from the transport connection: An existing connection was forcibly closed by the remote hostinterna .

Categoria: Problema de configuração

Solução: O seu servidor proxy utiliza uma autoridade certificadora (CA) que deve ser instalada e confiável. Complete ambos os seguintes passos:

  1. Instale todos os certificados de emissão de proxy (raiz e intermédio) na loja de Autoridades de Certificação de Raiz Confiáveis do Windows. Para mais informações, consulte a Loja de Certificados das Autoridades de Certificação de Raízes Confiáveis.
  2. Defina a NODE_EXTRA_CA_CERTS variável de ambiente para o caminho do ficheiro certificado da CA. Este passo é obrigatório para funcionalidades que utilizam Node.js processos.

Observação

Este erro também pode ocorrer se um firewall estiver a bloquear a ligação em vez de um problema de proxy.

Falhas de proxy transparente

Sintoma: As chamadas de rede falham ao usar um proxy transparente, com várias mensagens de erro.

Categoria: Problema de configuração

Solução: Proxies transparentes podem causar uma vasta gama de problemas porque intercetam tráfego sem uma configuração explícita. O servidor proxy pode estar a usar listas de permissão ou blocos para processos e aplicações específicas. Trabalhe com o seu administrador de rede para:

  • Verifique se os processos do Visual Studio são permitidos através do proxy
  • Verifique se pontos finais específicos estão bloqueados
  • Rever as definições de inspeção SSL

A autenticação Copilot funciona enquanto o Copilot Chat não funciona

Sintoma: Consegues iniciar sessão no GitHub e o Copilot indica que estás autenticado, no entanto, usar o chat do Copilot resulta num erro.

Categoria: Problema de configuração

Solução: Estes sintomas significam que os próprios pedidos .NET do Visual Studio falham, mas os pedidos do .NET Framework estão a funcionar. Existem muitas causas possíveis, incluindo proxies que bloqueiam endpoints específicos, ou que o tráfego IPv6 geral é bloqueado. Verifica se o tráfego IPv6 não está bloqueado pelo teu proxy ou firewall. Experimente uma das seguintes soluções:

  • Preferencial: Configure o seu proxy para permitir tráfego IPv6.
  • Alternativa: definir a variável de ambiente DOTNET_SYSTEM_NET_DISABLEIPV6 para forçar 1 IPv4.
  • Se usar listas de permissões de processos: Adicione DevHub.exe à sua lista de permissões de firewall ou proxy.
  • Preferencial: Configure o seu proxy para permitir tráfego IPv6.
  • Alternativa: definir a variável de ambiente DOTNET_SYSTEM_NET_DISABLEIPV6 para forçar 1 IPv4.
  • Se usar listas de permissões de processos: Adicione ServiceHub.Host.dotnet.x64.exe à sua lista de permissões de firewall ou proxy.

Erros parciais da cadeia de certificados

Sintoma: Os rastreamentos de pilha mostram The remote certificate is invalid because of errors in the certificate chain: PartialChain.

Categoria: Problema de configuração

Solução: Um ou mais certificados intermédios estão em falta na cadeia de certificados. Consulte Diagnosticar problemas parciais da cadeia de certificados para os passos que identificam certificados em falta, depois trabalhe com o seu administrador de TI para os instalar.

É necessária autenticação por proxy (erro 407 com autenticação Básica)

Sintoma: Os traços da pilha aparecem (407) Proxy Authentication Required ao usar um proxy com autenticação Basic.

Categoria: Definições necessárias

Solução: O Visual Studio suporta iniciar sessão em contas do GitHub e Microsoft Entra atrás de um proxy de autenticação com autenticação básica, mas a maioria das versões do Visual Studio não tem suporte para o Copilot atrás de um proxy de autenticação com autenticação básica.

No arranque, aparece um prompt para captar credenciais. As credenciais permanecem no Gestor de Credenciais do Windows, em Credenciais do Windows , como VSCredentials_<proxyAddress> o endereço de internet ou rede, depois o nome de utilizador e a palavra-passe que o proxy exige.

No arranque, aparece um prompt para captar credenciais. As credenciais permanecem no Gestor de Credenciais do Windows, em Credenciais do Windows , como VSCredentials_<proxyAddress> o endereço de internet ou rede, depois o nome de utilizador e a palavra-passe que o proxy exige.

Também pode configurar as credenciais do proxy diretamente no Visual Studio. Consulte Configurar definições de proxy no Visual Studio.

É necessária autenticação por proxy (NTLM ou Kerberos)

Sintoma: Funcionalidades dependentes da rede não funcionam quando se usa um servidor proxy com autenticação NTLM ou Kerberos.

Categoria: Definições necessárias

Solução: Configurar o Visual Studio para usar credenciais proxy predefinidas:

  1. Vai a Ferramentas>Opções>Definições do Proxy.
  2. Selecione Usar a conta do Windows com sessão iniciada para usar as suas credenciais do Windows atuais.
  3. Reinicie o Visual Studio para que as alterações entrem em vigor.

Para mais informações, consulte Configurar definições de proxy no Visual Studio.

Defina a variável VS_USE_DEFAULTPROXY de ambiente como true. Para o Copilot, também defina COPILOT_USE_DEFAULTPROXY para true.

Observação

Para desativar esta solução alternativa mais tarde, elimine completamente a variável de ambiente. Definir para false não desativa a funcionalidade.

Configuração explícita de proxy necessária

Sintoma: Funcionalidades dependentes da rede não funcionam mesmo que o seu proxy não exija autenticação.

Categoria: Definições necessárias

Solução: Configurar explicitamente o endereço do servidor proxy:

  1. Vai a Ferramentas>Opções>Definições do Proxy.
  2. Selecionar Usar definições de proxy personalizadas.
  3. Introduza a URL do servidor proxy e a porta.
  4. Reinicie o Visual Studio para que as alterações entrem em vigor.

Para mais informações, consulte Configurar definições de proxy no Visual Studio.

Defina as HTTPS_PROXY variáveis de ambiente e HTTP_PROXY para o endereço do seu servidor proxy. O Copilot precisa que estes estejam configurados para o Visual Studio.

Para passos detalhados de configuração do proxy, consulte Configurar definições de proxy no Visual Studio.

Resolver problemas com certificados SSL

Erros de certificados SSL normalmente ocorrem quando o seu servidor proxy realiza uma inspeção SSL e os certificados necessários não são devidamente instalados ou confiáveis. Use os seguintes passos para diagnosticar a causa raiz.

Responder a perguntas de diagnóstico

Trabalhe estas questões para restringir a questão:

  1. Os certificados são de confiança? Verifique se o certificado de CA do proxy está instalado na loja de certificados do utilizador atual ou na loja local de máquinas.
  2. O Visual Studio está a correr como um utilizador diferente? Se o Visual Studio for executado por um utilizador diferente daquele que está ligado ao Windows, pode não ter acesso a certificados no repositório do utilizador atual.
  3. Está autenticado em serviços online? Verifica se consegues iniciar sessão na tua conta Microsoft ou GitHub no Visual Studio.
  4. A funcionalidade funcionava anteriormente? Se a funcionalidade funcionava antes e deixava de funcionar, provavelmente ocorreu uma alteração na configuração da rede a montante. Isto não é um problema de produto Visual Studio.
  5. Consegues aceder a outros recursos de rede? Se conseguires navegar na web mas as funcionalidades do Visual Studio falharem, o problema está especificamente nas ligações de rede do Visual Studio.

Identifique o problema com base nos sintomas

Use estes padrões para identificar o seu problema específico:

  • Certificados na user store, VS a correr como utilizador diferente: O Visual Studio pode não conseguir aceder aos certificados. Instala os certificados na loja de máquinas local em vez disso.
  • Algumas funcionalidades funcionam, mas outras falham: Isto normalmente indica um problema com IPv6 ou uma diferença entre o .NET Framework e a rede .NET Core. Veja A autenticação do Copilot funciona, mas o Copilot Chat não.
  • Funcionou ontem, avariou hoje: ocorreu uma alteração na configuração da rede a montante. Contacte o seu administrador de TI para identificar o que mudou.

Diagnosticar problemas parciais na cadeia de certificados

Se detetar PartialChain erros, utilize os seguintes passos para identificar certificados em falta. Estes passos requerem a ferramenta de linha de comandos OpenSSL.

  1. Execute o seguinte comando para visualizar a cadeia de certificados, substituindo PROXY_HOST:PORT pelo seu endereço proxy e target.host.com pelo endpoint que está a tentar alcançar:

    openssl s_client -proxy PROXY_HOST:PORT -connect target.host.com:443 -showcerts -verify 5 </dev/null

  2. Para cada certificado na saída, execute o seguinte comando para verificar a cadeia (após guardar cada certificado num ficheiro como cert1.pem, cert2.pem, e assim sucessivamente):

    openssl x509 -in cert1.pem -noout -subject -issuer -ski -aki

  3. Verifique a cadeia de certificados verificando:

    • O Identificador de Chave de Autoridade (AKI) do certificado N deve corresponder ao Identificador de Chave de Sujeito (SKI) do certificado N+1.
    • O DN do Emitente do certificado N deve corresponder ao DN Sujeito do certificado N+1.

Se encontrar uma falha na cadeia, contacte o seu administrador de TI para obter e instalar os certificados intermédios em falta.

Observação

O .NET rejeita pedidos se o AKI de um certificado não corresponder ao SKI do certificado seguinte na cadeia, mesmo quando os navegadores web têm sucesso. Esta é uma validação mais rigorosa do que a que a maioria dos navegadores realiza.

Problemas com o produto: Recolha de informações diagnósticas para suporte

Se determinou que o seu problema não é uma questão de configuração depois de ter fornecido as definições necessárias no Visual Studio, por favor abra um pedido de feedback. Veja Como reportar um problema com o Visual Studio. Ao abrir um pedido de feedback para questões de proxy, inclua a seguinte informação para nos ajudar a investigar. Quanto mais detalhes fornecer, mais rapidamente podemos identificar se o problema é um erro do produto ou um problema de configuração.

Verificar o estado da autenticação

Verifique os seguintes estados de autenticação:

  1. Autenticação no GitHub:

    • AbrirWindows>Gestor de Credenciais>Credenciais do Windows.
    • Procure credenciais com o git: prefixo.
    • Verifique %LocalAppData%/.IdentityService/GitHubV3AccountStore.json os metadados da conta do GitHub.

  2. Estado das funcionalidades: Note quais funcionalidades funcionam e quais falham (por exemplo, restauração NuGet, instalação de extensões, funcionalidades de IA).

Recolha registos e detalhes de configuração

Colete as seguintes informações:

  1. Registos do Visual Studio: Crie um ficheiro zip de %temp%/Vslogs.

  2. Rastreio de rede: Se possível, recolha um rastreio Fiddler que mostre os pedidos falhados.

  3. Detalhes da configuração do proxy:

    • Isto é um proxy explícito ou transparente?
    • O proxy requer autenticação? Se sim, de que tipo (Basic, NTLM, Kerberos)?
    • O proxy bloqueia ou permite aplicações específicas?
    • Os certificados necessários são instalados e confiáveis? Algum certificado é revogado ou expirado?
    • Também está configurado um firewall?
    • A inspeção SSL está ativada?
    • O tráfego IPv6 está a ser encaminhado através do proxy?

  4. Comparação com outras ferramentas: O Visual Studio Code ou outras aplicações funcionam através deste proxy?

Conteúdo relacionado

  • Last updated on