Řešení potíží s proxy serverem a bránou firewall v sadě Visual Studio

Když používáte Visual Studio za podnikovým proxy serverem nebo bránou firewall, můžou nastat problémy s připojením, které mají vliv na funkce vyžadující přístup k síti, jako je obnovení balíčku NuGet, instalace rozšíření a funkce využívající umělou inteligenci. Problémy s proxy serverem obecně spadají do dvou kategorií:

• Problémy s konfigurací: Problémy s nastavením proxy serveru, certifikáty nebo konfigurací sítě Tyto problémy řeší správce IT.

• Požadováno nastavení: Visual Studio vyžaduje další informace o konfiguraci sítě. Nastavení proxy serveru můžete nakonfigurovat přímo v integrovaném vývojovém prostředí ( IDE). Pokyny k nastavení najdete v tématu Konfigurace nastavení proxy serveru v sadě Visual Studio .

  Poznámka:

  Prostředí konfigurace proxy serveru ještě není k dispozici ve všech instalacích sady Visual Studio 2026. Pokud tuto možnost v instalaci nevidíte, můžete si ji vyzkoušet pomocí programu Visual Studio Insider . Nebo si prohlédněte verzi této stránky v sadě Visual Studio 2022 pro pokyny.

• Problémy s produktem: Pokud jste zjistili, že váš problém není problém s konfigurací nebo zadaná nastavení problém nevyřeší, může se jednat o problém s produktem. Před odesláním lístku postupujte podle pokynů v části Shromáždit diagnostické informace .

Tento článek vám pomůže identifikovat kategorii, do které váš problém spadá, a poskytuje řešení běžných problémů.

Požadavky

Před řešením potíží s proxy serverem se ujistěte, že máte:

• Visual Studio se nainstalovalo a aktualizovalo na nejnovější verzi.
• Požadované adresy URL, které jsou povoleny na vašem firewallu. Viz Instalace a použití sady Visual Studio za bránou firewall nebo proxy serverem.

Známé problémy a řešení

Následující části popisují běžné problémy související s proxy serverem a jejich řešení.

Chyby připojení SSL (certifikační autorita není důvěryhodná)

Příznak: Vidíte chybu, například System.Net.Http.HttpRequestException: The SSL connection could not be established, s vnitřní výjimkou IOException: Unable to read data from the transport connection: An existing connection was forcibly closed by the remote host.

Kategorie: Problém s konfigurací

Řešení: Proxy server používá certifikační autoritu (CA), která musí být nainstalovaná a důvěryhodná. Proveďte oba následující kroky:

1. Nainstalujte všechny certifikáty proxy serveru (kořenové a zprostředkující) v úložišti důvěryhodných kořenových certifikačních autorit systému Windows. Další informace najdete v tématu Úložiště certifikátů důvěryhodných kořenových certifikačních autorit.
2. Nastavte proměnnou NODE_EXTRA_CA_CERTS prostředí na cestu k souboru certifikátu certifikační autority. Tento krok je vyžadován pro funkce, které používají procesy Node.js.

Poznámka:

K této chybě může dojít také v případě, že brána firewall blokuje připojení, nikoliv kvůli problému s proxy serverem.

Selhání transparentního proxy serveru

Příznak: Síťová volání selžou při použití transparentního proxy serveru s různými chybovými zprávami.

Kategorie: Problém s konfigurací

Řešení: Transparentní proxy servery můžou způsobit širokou škálu problémů, protože zachycují provoz bez explicitní konfigurace. Proxy server může používat seznamy povolených nebo blokovaných pro konkrétní procesy a aplikace. Spolupracujte se správcem sítě na:

• Ověřte, že procesy sady Visual Studio jsou povolené prostřednictvím proxy serveru.
• Kontrola, jestli jsou zablokované konkrétní koncové body
• Kontrola nastavení kontroly SSL

Ověřování Copilot funguje, zatímco chat Copilot nefunguje.

Příznak: Můžete se přihlásit k GitHubu a Copilotu znamená, že jste ověřeni, ale při použití chatu Copilot dojde k chybě.

Kategorie: Problém s konfigurací

Řešení: Tyto příznaky znamenají, že vlastní požadavky .NET sady Visual Studio selžou, ale požadavky rozhraní .NET Framework fungují. Existuje mnoho možných příčin, včetně proxy serverů, které blokují konkrétní koncové body nebo že se zablokuje obecný provoz IPv6. Zkontrolujte, jestli proxy server nebo brána firewall neblokuje provoz IPv6. Vyzkoušejte jedno z následujících řešení:

• Upřednostňovaný postup: Nakonfigurujte proxy server tak, aby povoloval provoz IPv6.
• Alternativa: Nastavte proměnnou DOTNET_SYSTEM_NET_DISABLEIPV6 prostředí tak, aby 1 vynutil protokol IPv4.
• Pokud používáte seznam povolených procesů: Přidejte DevHub.exe do svého seznamu povolených ve firewallu nebo proxy.

Částečné chyby řetězu certifikátů

Příznak: Stopy zásobníku ukazují The remote certificate is invalid because of errors in the certificate chain: PartialChain.

Kategorie: Problém s konfigurací

Řešení: V řetězu certifikátů chybí jeden nebo více zprostředkujících certifikátů. Pokyny k identifikaci chybějících certifikátů najdete v tématu Diagnostika problémů s částečným řetězem certifikátů, poté spolupracujte se svým správcem IT na jejich instalaci.

Vyžaduje se ověření proxy serveru (chyba 407 se základním ověřováním)

Příznak: Sada tras je zobrazena (407) Proxy Authentication Required při použití proxy serveru se základním ověřováním.

Kategorie: Požadováno nastavení

Řešení: Visual Studio podporuje přihlašování k účtům GitHub a Microsoft Entra za ověřovacím proxy serverem se základním ověřováním, ale většina verzí sady Visual Studio nemá podporu pro Copilot za ověřovacím proxy serverem se základním ověřováním.

Při spuštění se zobrazí výzva k zachycení přihlašovacích údajů. Přihlašovací údaje se zachovají ve Správci přihlašovacích údajů systému Windows jako internetová nebo síťová adresa, a dále jako uživatelské jméno a heslo, které proxy server vyžaduje.

Můžete také nakonfigurovat přihlašovací údaje proxy serveru přímo v sadě Visual Studio. Viz Konfigurace nastavení proxy serveru v sadě Visual Studio.

Vyžaduje se ověřování proxy serveru (NTLM nebo Kerberos)

Příznak: Funkce závislé na síti nefungují při použití proxy serveru s ověřováním NTLM nebo Kerberos.

Kategorie: Požadováno nastavení

Řešení: Konfigurace sady Visual Studio pro použití výchozích přihlašovacích údajů proxy serveru:

1. Přejděte na Nástroje>Možnosti>Nastavení proxy.
2. Vyberte Použít přihlášený účet Systému Windows pro použití aktuálních přihlašovacích údajů systému Windows.
3. Restartujte Visual Studio, aby se změny projevily.

Další informace najdete v tématu Konfigurace nastavení proxy serveru v sadě Visual Studio.

Poznámka:

Pokud chcete toto alternativní řešení později zakázat, zcela odstraňte proměnnou prostředí. Nastavení na false nezakazuje tuto funkci.

Vyžaduje se explicitní konfigurace proxy serveru.

Příznak: Funkce závislé na síti nefungují, i když váš proxy server nevyžaduje ověřování.

Kategorie: Požadováno nastavení

Řešení: Explicitně nakonfigurujte adresu proxy serveru:

1. Přejděte do Nástroje>Možnosti>Nastavení proxy.
2. Vyberte Použít vlastní nastavení proxy serveru.
3. Zadejte adresu URL a port proxy serveru.
4. Restartujte Visual Studio, aby se změny projevily.

Další informace najdete v tématu Konfigurace nastavení proxy serveru v sadě Visual Studio.

Podrobné kroky konfigurace proxy serveru najdete v tématu Konfigurace nastavení proxy serveru v sadě Visual Studio.

Řešení potíží s certifikátem SSL

K chybám certifikátu SSL obvykle dochází, když proxy server provádí kontrolu SSL a požadované certifikáty nejsou správně nainstalované nebo důvěryhodné. K diagnostice původní příčiny použijte následující postup.

Odpovědi na diagnostické otázky

Pokud chcete tento problém zúžit, projděte si tyto otázky:

1. Jsou certifikáty důvěryhodné? Zkontrolujte, jestli je certifikát certifikační autority proxy serveru nainstalovaný v úložišti certifikátů aktuálního uživatele nebo v úložišti místních počítačů.
2. Běží program Visual Studio jako jiný uživatel? Pokud sada Visual Studio běží jako jiný uživatel, než je uživatel přihlášený k Windows, nemusí mít přístup k certifikátům v úložišti aktuálního uživatele.
3. Ověřujete se u online služeb? Zkontrolujte, jestli se v sadě Visual Studio můžete přihlásit ke svému účtu Microsoft nebo GitHub.
4. Fungovala funkce dříve? Pokud funkce fungovala dříve a přestala fungovat, pravděpodobně došlo ke změně konfigurace nadřazené sítě. Nejedná se o problém s produktem sady Visual Studio.
5. Máte přístup k dalším síťovým prostředkům? Pokud můžete procházet web, ale funkce sady Visual Studio selžou, problém se týká konkrétně síťových připojení sady Visual Studio.

Identifikace problému na základě příznaků

Pomocí těchto vzorů identifikujte váš konkrétní problém:

• Certifikáty v úložišti uživatelů, VS spuštěné jako jiný uživatel: Visual Studio nemusí mít přístup k certifikátům. Místo toho nainstalujte certifikáty do úložiště místního počítače.
• Některé funkce fungují, ale jiné selžou: Obvykle to značí problém s protokolem IPv6 nebo rozdíl mezi sítěmi .NET Framework a .NET Core. Viz Ověřování Copilot funguje, zatímco Copilot Chat ne.
• Fungovalo včera, dnes přerušeno: Došlo ke změně konfigurace upstreamové sítě. Obraťte se na správce IT a zjistěte, co se změnilo.

Diagnostika problémů s částečným řetězem certifikátů

Pokud se zobrazí PartialChain chyby, identifikujte chybějící certifikáty pomocí následujícího postupu. Tyto kroky vyžadují nástroj příkazového řádku OpenSSL.

1. Spuštěním následujícího příkazu zobrazte řetěz certifikátů a nahraďte PROXY_HOST:PORT svoji proxy adresou a target.host.com koncovým bodem, ke kterým se pokoušíte připojit:

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

2. Pro každý certifikát ve výstupu spusťte následující příkaz, který zkontroluje řetěz (po uložení každého certifikátu do souboru, například cert1.pem, cert2.pematd.):

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

3. Ověřte řetěz certifikátů kontrolou:

   • Identifikátor klíče autority (AKI) certifikátu N by měl odpovídat identifikátoru klíče subjektu (SKI) certifikátu N+1.
   • Issuer DN certifikátu N by se měl shodovat s Subject DN certifikátu N+1.

Pokud v řetězu najdete přerušení, požádejte správce IT o získání a instalaci chybějících zprostředkujících certifikátů.

Poznámka:

.NET odmítá požadavky, pokud AKI jednoho certifikátu neodpovídá SKI dalšího certifikátu v řetězu, i když webové prohlížeče fungují úspěšně. Jedná se o přísnější ověřování, než provádí většina prohlížečů.

Problémy s produktem: Shromažďování diagnostických informací pro podporu

Pokud jste zjistili, že váš problém není problém s konfigurací po zadání požadovaných nastavení v sadě Visual Studio, vytvořte lístek zpětné vazby. Podívejte se, jak nahlásit problém se sadou Visual Studio. Při vytváření lístku zpětné vazby pro problémy s proxy serverem uveďte následující informace, které nám pomůžou prozkoumat. Čím více podrobností zadáte, tím rychleji zjistíme, jestli se jedná o chybu produktu nebo problém s konfigurací.

Kontrola stavu ověřování

Ověřte následující stavy ověřování:

1. Ověřování GitHubu:

   • Otevřete Správce>pověření systému >.
   • Vyhledejte přihlašovací údaje s předponou git: .
   • Zkontrolujte %LocalAppData%/.IdentityService/GitHubV3AccountStore.json metadata účtu na GitHubu.

2. Stav funkce: Všimněte si, které funkce fungují a které selhávají (například obnovení NuGet, instalace rozšíření, funkce AI).

Shromáždění protokolů a podrobností o konfiguraci

Shromážděte následující informace:

1. Protokoly sady Visual Studio: Vytvořte soubor ZIP souboru %temp%/Vslogs.

2. Trasování sítě: Pokud je to možné, shromážděte trasování Fiddleru zobrazující neúspěšné požadavky.

3. Podrobnosti o konfiguraci proxy serveru:

   • Jedná se o explicitní nebo transparentní proxy server?
   • Vyžaduje proxy ověřování? Pokud ano, jaký druh (Basic, NTLM, Kerberos)?
   • Blokuje proxy server nebo povoluje konkrétní aplikace?
   • Jsou požadované certifikáty nainstalované a důvěryhodné? Jsou odvolané nebo prošlé nějaké certifikáty?
   • Je nakonfigurovaná také brána firewall?
   • Je povolená kontrola SSL?
   • Směruje se provoz IPv6 přes proxy server?

4. Porovnání s jinými nástroji: Funguje Visual Studio Code nebo jiné aplikace prostřednictvím tohoto proxy serveru?

Související obsah

• Konfigurace nastavení proxy serveru v sadě Visual Studio

• Jak nainstalovat a používat Visual Studio za bránou firewall nebo proxy serverem
• Řešení potíží s připojením k sadě Visual Studio