Solución de problemas de proxy y firewall en Visual Studio

Al usar Visual Studio detrás de un proxy corporativo o un firewall, es posible que encuentre problemas de conectividad que afecten a las características que requieren acceso a la red, como la restauración de paquetes NuGet, la instalación de extensiones y las características con tecnología de IA. Por lo general, los problemas de proxy se dividen en dos categorías:

• Problemas de configuración: problemas con la configuración del servidor proxy, los certificados o la configuración de red. El administrador de TI resuelve estos problemas.

• Configuración necesaria: Visual Studio requiere información adicional sobre la configuración de red. Puede configurar los valores de proxy directamente en el IDE. Consulte Configuración de los valores de proxy en Visual Studio para obtener instrucciones de configuración.

  Nota:

  La experiencia de configuración de proxy aún no está disponible en todas las instalaciones de Visual Studio 2026. Si no lo ve en la instalación, puede instalar Visual Studio Insider para probarlo. O bien, vea la versión de Visual Studio 2022 de esta página para obtener instrucciones.

• Problemas del producto: si ha determinado que el problema no es un problema de configuración o que la configuración proporcionada no soluciona el problema que ve, podría tratarse de un problema de producto. Antes de enviar un ticket, siga los pasos en Recopilar información de diagnóstico.

Este artículo le ayuda a identificar en qué categoría entra el problema y proporciona soluciones para problemas comunes.

Prerrequisitos

Antes de solucionar problemas de proxy, asegúrese de que tiene:

• Visual Studio instalado y actualizado a la versión más reciente.
• Las direcciones URL necesarias permitidas a través del firewall. Consulte Instalación y uso de Visual Studio detrás de un firewall o servidor proxy.

Problemas conocidos y soluciones

En las secciones siguientes se describen los problemas comunes relacionados con el proxy y sus soluciones.

Errores de conexión SSL (entidad de certificación no de confianza)

Síntoma: aparece un error como System.Net.Http.HttpRequestException: The SSL connection could not be established con una excepción IOException: Unable to read data from the transport connection: An existing connection was forcibly closed by the remote hostinterna.

Categoría: Problema de configuración

Solución: el servidor proxy usa una autoridad certificadora (CA) que se debe instalar y en la que se debe confiar. Complete los dos pasos siguientes:

1. Instale todos los certificados relacionados con el proxy (raíz e intermedios) en el almacén de Entidades de Certificación Raíz de Confianza de Windows. Para obtener más información, consulte Almacén de certificados de entidades de certificación raíz de confianza.
2. Establezca la NODE_EXTRA_CA_CERTS variable de entorno en la ruta de acceso del archivo de certificado de CA. Este paso es necesario para las características que usan procesos de Node.js.

Nota:

Este error también puede producirse si un firewall bloquea la conexión en lugar de un problema de proxy.

Errores de proxy transparentes

Síntoma: se produce un error en las llamadas de red al usar un proxy transparente, con varios mensajes de error.

Categoría: Problema de configuración

Solución: los servidores proxy transparentes pueden provocar una amplia variedad de problemas porque interceptan el tráfico sin configuración explícita. Es posible que el servidor proxy use listas de permitidos o bloqueados para procesos y aplicaciones específicos. Trabaje con el administrador de red para:

• Comprobación de que los procesos de Visual Studio están permitidos a través del proxy
• Comprobación de si se bloquean puntos de conexión específicos
• Revisión de la configuración de inspección de SSL

La autenticación de Copilot funciona mientras que el chat de Copilot no

Síntoma: Puede iniciar sesión en GitHub y Copilot indica que se autentica, pero el uso del chat de Copilot produce un error.

Categoría: Problema de configuración

Solución: estos síntomas significan que las propias solicitudes de .NET de Visual Studio producen un error, pero las solicitudes de .NET Framework funcionan. Hay muchas causas posibles, incluidos los servidores proxy que bloquean puntos de conexión específicos o que se bloquea el tráfico IPv6 general. Compruebe que el proxy o el firewall no bloquean el tráfico IPv6. Pruebe una de estas soluciones:

• Preferido: configure el proxy para permitir el tráfico IPv6.
• Alternativa: establezca la variable DOTNET_SYSTEM_NET_DISABLEIPV6 de entorno en 1 para forzar IPv4.
• Si usa listas de permitidos de procesos: agregue DevHub.exe a la lista de permitidos del firewall o del proxy.

Errores de cadena de certificados parciales

Síntoma: los seguimientos de pila muestran The remote certificate is invalid because of errors in the certificate chain: PartialChain.

Categoría: Problema de configuración

Solución: faltan uno o varios certificados intermedios de la cadena de certificados. Consulte Diagnóstico de problemas de cadena de certificados parciales para conocer los pasos para identificar los certificados que faltan y, a continuación, trabajar con el administrador de TI para instalarlos.

Autenticación de proxy necesaria (error 407 con autenticación básica)

Síntoma: se muestran registros de pila (407) Proxy Authentication Required cuando se utiliza un proxy con autenticación básica.

Categoría: Configuración necesaria

Solución: Visual Studio admite el inicio de sesión en cuentas de GitHub y Microsoft Entra detrás de un proxy de autenticación con autenticación básica, pero la mayoría de las versiones de Visual Studio no tienen compatibilidad con Copilot detrás de un proxy de autenticación con autenticación básica.

Al iniciarse, aparece un mensaje para capturar credenciales. Las credenciales se conservan en el Administrador de Credenciales de Windows bajo Credenciales de Windows junto con la dirección de red o Internet, así como el nombre de usuario y la contraseña que requiere el proxy.

También puede configurar las credenciales de proxy directamente en Visual Studio. Consulte Configuración de los valores de proxy en Visual Studio.

Se requiere autenticación del proxy (NTLM o Kerberos)

Síntoma: las características dependientes de la red no funcionan cuando se usa un servidor proxy con autenticación NTLM o Kerberos.

Categoría: Configuración necesaria

Solución: configure Visual Studio para usar credenciales de proxy predeterminadas:

1. Vaya a Opciones de herramientas>>Configuración del proxy.
2. Seleccione Usar la cuenta de Windows con sesión iniciada para utilizar las credenciales actuales de Windows.
3. Reinicie Visual Studio para que los cambios surtan efecto.

Para obtener más información, vea Configurar las opciones de proxy en Visual Studio.

Nota:

Para deshabilitar esta solución alternativa más adelante, elimine completamente la variable de entorno. Configurar false no desactiva la característica.

Configuración de proxy explícita necesaria

Síntoma: las características dependientes de la red no funcionan aunque el proxy no requiera autenticación.

Categoría: Configuración necesaria

Solución: configure la dirección del servidor proxy explícitamente:

1. Vaya a Opciones de herramientas>>Configuración del proxy.
2. Seleccione Usar configuración de proxy personalizada.
3. Escriba la dirección URL y el puerto del servidor proxy.
4. Reinicie Visual Studio para que los cambios surtan efecto.

Para obtener más información, vea Configurar las opciones de proxy en Visual Studio.

Para ver los pasos detallados de configuración de proxy, consulte Configuración de los valores de proxy en Visual Studio.

Solución de problemas de certificados SSL

Los errores de certificado SSL suelen producirse cuando el servidor proxy realiza la inspección SSL y los certificados necesarios no están instalados correctamente o no son fiables. Siga estos pasos para diagnosticar la causa principal.

Respuesta a preguntas de diagnóstico

Siga estas preguntas para reducir el problema:

1. ¿Son de confianza los certificados? Compruebe si el certificado de la Autoridad de Certificación del proxy está instalado en el almacén de certificados del usuario actual o en el almacén del equipo local.
2. ¿Se ejecuta Visual Studio como un usuario diferente? Si Visual Studio se ejecuta como un usuario diferente al que inició sesión en Windows, es posible que no tenga acceso a los certificados en el almacén del usuario actual.
3. ¿Está autenticado en servicios en línea? Compruebe si puede iniciar sesión en su cuenta de Microsoft o GitHub en Visual Studio.
4. ¿La característica funcionó anteriormente? Si la característica funcionó antes y dejó de funcionar, es probable que se produzca un cambio de configuración de red ascendente. Esto no es un problema de producto de Visual Studio.
5. ¿Puede acceder a otros recursos de red? Si puede examinar la web pero se produce un error en las características de Visual Studio, el problema es específicamente con las conexiones de red de Visual Studio.

Identificación del problema en función de los síntomas

Use estos patrones para identificar su problema específico:

• Certificados en el almacén de usuarios, Visual Studio ejecutándose como un usuario diferente: es posible que Visual Studio no pueda acceder a los certificados. Instale certificados en el almacén de máquinas locales en su lugar.
• Algunas características funcionan pero otras producen un error: normalmente indica un problema de IPv6 o una diferencia entre las redes de .NET Framework y .NET Core. Consulte cómo la autenticación de Copilot funciona mientras que el chat de Copilot no.
• Funcionó ayer, roto hoy: se produjo un cambio de configuración de red ascendente. Póngase en contacto con el administrador de TI para identificar lo que ha cambiado.

Diagnóstico de problemas de cadena de certificados parciales

Si ve PartialChain errores, siga estos pasos para identificar los certificados que faltan. Estos pasos requieren la herramienta de línea de comandos OpenSSL.

1. Ejecute el siguiente comando para ver la cadena de certificados, reemplazando PROXY_HOST:PORT por la dirección de proxy y target.host.com por el punto de conexión al que intenta acceder:

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

2. Para cada certificado de la salida, ejecute el siguiente comando para comprobar la cadena (después de guardar cada certificado en un archivo como cert1.pem, cert2.pem, etc.):

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

3. Compruebe la cadena de certificados comprobando:

   • El identificador de clave de autoridad (AKI) del certificado N debe coincidir con el identificador de clave del firmante (SKI) del certificado N+1.
   • El DN del emisor del certificado N debe coincidir con el DN del firmante del certificado N+1.

Si encuentra una interrupción en la cadena, póngase en contacto con el administrador de TI para obtener e instalar los certificados intermedios que faltan.

Nota:

.NET rechaza las solicitudes si el AKI de un certificado no coincide con el SKI del siguiente certificado de la cadena, aun cuando los navegadores web funcionan correctamente. Se trata de una validación más estricta que la mayoría de los exploradores realizan.

Problemas del producto: recopilación de información de diagnóstico para soporte técnico

Si ha determinado que el problema no es un problema de configuración después de haber proporcionado las configuraciones requeridas en Visual Studio, registre un ticket de feedback. Consulte Cómo notificar un problema con Visual Studio. Al presentar un ticket de retroalimentación para problemas de proxy, incluya la siguiente información para ayudarnos a investigar. Cuantos más detalles proporcione, más rápido podemos identificar si el problema es un error de producto o un problema de configuración.

Comprobación del estado de autenticación

Compruebe los siguientes estados de autenticación:

1. Autenticación de GitHub:

   • Abra el Administrador de credenciales>de Windows>Credenciales de Windows.
   • Busque credenciales con el git: prefijo .
   • Verifique los metadatos de la cuenta de GitHub en %LocalAppData%/.IdentityService/GitHubV3AccountStore.json.

2. Estado de la característica: tenga en cuenta qué características funcionan y qué errores (por ejemplo, restauración de NuGet, instalación de extensiones, características de IA).

Recopilación de registros y detalles de configuración

Recopile la siguiente información:

1. Registros de Visual Studio: cree un archivo ZIP de %temp%/Vslogs.

2. Seguimiento de red: si es posible, recopile un seguimiento de Fiddler que muestre las solicitudes con errores.

3. Detalles de configuración del proxy:

   • ¿Es un proxy explícito o transparente?
   • ¿Requiere el proxy la autenticación? Si es así, ¿qué tipo (Básico, NTLM, Kerberos)?
   • ¿El proxy bloquea o permite aplicaciones específicas?
   • ¿Los certificados necesarios están instalados y se consideran de confianza? ¿Hay certificados revocados o expirados?
   • ¿También está configurado un firewall?
   • ¿Está habilitada la inspección SSL?
   • ¿Se enruta el tráfico IPv6 a través del proxy?

4. Comparación con otras herramientas: ¿Funciona Visual Studio Code u otras aplicaciones a través de este proxy?

Contenido relacionado

• Configuración del proxy en Visual Studio

• Instalar y usar Visual Studio detrás de un firewall o servidor proxy
• Solución de problemas de conectividad de Visual Studio