Rozwiązywanie problemów z serwerem proxy i zaporą w programie Visual Studio

W przypadku korzystania z programu Visual Studio za firmowym serwerem proxy lub zaporą mogą wystąpić problemy z łącznością, które mają wpływ na funkcje wymagające dostępu do sieci, takie jak przywracanie pakietów NuGet, instalacja rozszerzenia i funkcje oparte na sztucznej inteligencji. Problemy z serwerem proxy zazwyczaj należą do dwóch kategorii:

• Problemy z konfiguracją: problemy z konfiguracją serwera proxy, certyfikatami lub konfiguracją sieci. Te problemy są rozwiązywane przez administratora IT.

• Wymagane ustawienia: program Visual Studio wymaga dodatkowych informacji o konfiguracji sieci. Ustawienia serwera proxy można skonfigurować bezpośrednio w środowisku IDE. Aby uzyskać instrukcje dotyczące konfigurowania, zobacz Konfigurowanie ustawień serwera proxy w programie Visual Studio .

  Uwaga / Notatka

  Środowisko konfiguracji serwera proxy nie jest jeszcze dostępne we wszystkich instalacjach programu Visual Studio 2026. Jeśli nie widzisz tego w swojej instalacji, możesz zainstalować Visual Studio Insiders, aby go przetestować. Możesz też wyświetlić wersję programu Visual Studio 2022 na tej stronie , aby uzyskać wskazówki.

• Problemy z produktami: jeśli ustaliliśmy, że problem nie jest problemem z konfiguracją lub podanymi ustawieniami nie rozwiążą problemu, który widzisz, może to być problem z produktem. Wykonaj kroki opisane w temacie Zbieranie informacji diagnostycznych przed przesłaniem biletu.

Ten artykuł pomaga zidentyfikować kategorię, do której należy problem, i zawiera rozwiązania typowych problemów.

Wymagania wstępne

Przed rozwiązaniem problemów z serwerem proxy upewnij się, że masz:

• Program Visual Studio został zainstalowany i zaktualizowany do najnowszej wersji.
• Wymagane adresy URL dozwolone przez zaporę. Zobacz Instalowanie i używanie programu Visual Studio za zaporą lub serwerem proxy.

Znane problemy i rozwiązania

W poniższych sekcjach opisano typowe problemy związane z serwerem proxy i ich rozwiązania.

Błędy połączenia SSL (urząd certyfikacji nie jest zaufany)

Objaw: Widzisz błąd taki jak System.Net.Http.HttpRequestException: The SSL connection could not be established z wewnętrznym wyjątkiem IOException: Unable to read data from the transport connection: An existing connection was forcibly closed by the remote host.

Kategoria: Problem z konfiguracją

Rozwiązanie: Serwer proxy używa certyfikatu wystawionego przez zaufany urząd certyfikacji, który musi być zainstalowany. Wykonaj obie następujące czynności:

1. Zainstaluj wszystkie certyfikaty wystawiane przez serwer proxy (główny i pośredni) w magazynie zaufanych głównych urzędów certyfikacji systemu Windows. Aby uzyskać więcej informacji, zobacz Magazyn Certyfikatów Zaufanych Głównych Urzędów Certyfikacji.
2. Ustaw zmienną NODE_EXTRA_CA_CERTS środowiskową na ścieżkę pliku certyfikatu urzędu certyfikacji. Ten krok jest wymagany w przypadku funkcji korzystających z procesów Node.js.

Uwaga / Notatka

Ten błąd może również wystąpić, jeśli zapora blokuje połączenie, a nie problem z serwerem proxy.

Błędy przezroczystego serwera proxy

Objaw: Wywołania sieciowe kończą się niepowodzeniem przy korzystaniu z przezroczystego serwera proxy, wyświetlając różne komunikaty o błędach.

Kategoria: Problem z konfiguracją

Rozwiązanie: Przezroczyste serwery proxy mogą powodować szeroką gamę problemów, ponieważ przechwytują ruch bez jawnej konfiguracji. Serwer proxy może używać list dozwolonych lub zablokowanych dla określonych procesów i aplikacji. Skontaktuj się z administratorem sieci, aby:

• Sprawdź, czy procesy programu Visual Studio są dozwolone za pośrednictwem serwera proxy
• Sprawdzanie, czy określone punkty końcowe są zablokowane
• Przeglądanie ustawień inspekcji protokołu SSL

Uwierzytelnianie Copilot działa, podczas gdy czat Copilot nie działa.

Objaw: Możesz zalogować się do usługi GitHub, a aplikacja Copilot wskazuje, że użytkownik jest uwierzytelniony, jednak użycie czatu Copilot powoduje wystąpienie błędu.

Kategoria: Problem z konfiguracją

Rozwiązanie: Te objawy oznaczają, że żądania platformy .NET programu Visual Studio kończą się niepowodzeniem, ale żądania programu .NET Framework działają. Istnieje wiele możliwych przyczyn, w tym serwerów proxy, które blokują określone punkty końcowe, lub że ogólny ruch IPv6 jest blokowany. Sprawdź, czy ruch IPv6 nie jest blokowany przez serwer proxy lub zaporę. Spróbuj zastosować jedno z następujących rozwiązań:

• Preferowane: Skonfiguruj serwer proxy tak, aby zezwalał na ruch IPv6.
• Alternatywa: ustaw zmienną środowiskową DOTNET_SYSTEM_NET_DISABLEIPV6 na 1, aby wymusić protokół IPv4.
• W przypadku korzystania z list dozwolonych procesów: dodaj DevHub.exe do listy wyjątków w zaporze ogniowej lub serwerze proxy.

Błędy częściowego łańcucha certyfikatów

Objaw: ślady stosu pokazują The remote certificate is invalid because of errors in the certificate chain: PartialChain.

Kategoria: Problem z konfiguracją

Rozwiązanie: w łańcuchu certyfikatów brakuje co najmniej jednego certyfikatu pośredniego. Zobacz Diagnozowanie częściowych problemów z łańcuchem certyfikatów , aby uzyskać instrukcje identyfikowania brakujących certyfikatów, a następnie skontaktuj się z administratorem IT, aby je zainstalować.

Wymagane uwierzytelnianie serwera proxy (błąd 407 z uwierzytelnianiem podstawowym)

Objaw: Ślady stosu są wyświetlane (407) Proxy Authentication Required podczas korzystania z serwera proxy z uwierzytelnianiem podstawowym.

Kategoria: wymagane ustawienia

Rozwiązanie: program Visual Studio obsługuje logowanie się do kont GitHub i Microsoft Entra za uwierzytelniającym serwerem proxy przy użyciu uwierzytelniania podstawowego, ale większość wersji programu Visual Studio nie ma obsługi rozwiązania Copilot za uwierzytelniającym serwerem proxy z uwierzytelnianiem podstawowym.

Podczas uruchamiania zostanie wyświetlony monit o przechwycenie poświadczeń. Poświadczenia są przechowywane w Menedżerze poświadczeń systemu Windows w sekcji Poświadczenia systemu Windows jako VSCredentials_<proxyAddress> adres internetowy lub sieciowy, oraz nazwę użytkownika i hasło wymagane przez serwer proxy.

Możesz również skonfigurować poświadczenia serwera proxy bezpośrednio w programie Visual Studio. Zobacz Konfigurowanie ustawień serwera proxy w programie Visual Studio.

Wymagane jest uwierzytelnianie serwera proxy (NTLM lub Kerberos)

Objaw: Funkcje zależne od sieci nie działają podczas korzystania z serwera proxy z uwierzytelnianiem NTLM lub Kerberos.

Kategoria: wymagane ustawienia

Rozwiązanie: Skonfiguruj program Visual Studio do używania domyślnych poświadczeń serwera proxy:

1. Przejdź do pozycji Narzędzia>Opcje>ustawienia serwera proxy.
2. Wybierz Użyj zalogowanego konta systemu Windows, by wykorzystać bieżące poświadczenia systemu Windows.
3. Uruchom ponownie program Visual Studio, aby zmiany zaczęły obowiązywać.

Aby uzyskać więcej informacji, zobacz Konfigurowanie ustawień serwera proxy w programie Visual Studio.

Uwaga / Notatka

Aby wyłączyć to obejście później, usuń całkowicie zmienną środowiskową. Ustawienie jej na false wartość nie powoduje wyłączenia funkcji.

Wymagana jawna konfiguracja serwera proxy

Objaw: Funkcje zależne od sieci nie działają, mimo że serwer proxy nie wymaga uwierzytelniania.

Kategoria: wymagane ustawienia

Rozwiązanie: Jawne konfigurowanie adresu serwera proxy:

1. Przejdź do pozycji Narzędzia>Opcje>ustawienia serwera proxy.
2. Wybierz pozycję Użyj niestandardowych ustawień serwera proxy.
3. Wprowadź adres URL i port serwera proxy.
4. Uruchom ponownie program Visual Studio, aby zmiany zaczęły obowiązywać.

Aby uzyskać więcej informacji, zobacz Konfigurowanie ustawień serwera proxy w programie Visual Studio.

Aby uzyskać szczegółowe instrukcje konfiguracji serwera proxy, zobacz Konfigurowanie ustawień serwera proxy w programie Visual Studio.

Rozwiązywanie problemów z certyfikatem SSL

Błędy certyfikatów SSL zwykle występują, gdy serwer proxy przeprowadza inspekcję protokołu SSL, a wymagane certyfikaty nie są prawidłowo zainstalowane ani zaufane. Aby zdiagnozować główną przyczynę, wykonaj następujące kroki.

Odpowiadanie na pytania diagnostyczne

Wykonaj następujące pytania, aby zawęzić problem:

1. Czy certyfikaty są zaufane? Sprawdź, czy certyfikat CA proxy jest zainstalowany w magazynie certyfikatów bieżącego użytkownika lub w magazynie lokalnego komputera.
2. Czy program Visual Studio działa z uprawnieniami innego użytkownika? Jeśli program Visual Studio działa jako inny użytkownik niż zalogowany w systemie Windows, może nie mieć dostępu do certyfikatów w magazynie bieżącego użytkownika.
3. Czy uwierzytelniasz się w usługach online? Sprawdź, czy możesz zalogować się do konta Microsoft lub GitHub w programie Visual Studio.
4. Czy funkcja działała wcześniej? Jeśli funkcja działała przed i przestała działać, prawdopodobnie wystąpiła zmiana konfiguracji sieci nadrzędnej. Nie jest to problem z produktem Visual Studio.
5. Czy możesz uzyskać dostęp do innych zasobów sieciowych? Jeśli możesz przeglądać internet, ale funkcje programu Visual Studio kończą się niepowodzeniem, problem dotyczy połączeń sieciowych programu Visual Studio.

Identyfikowanie problemu na podstawie objawów

Użyj tych wzorców, aby zidentyfikować konkretny problem:

• Certyfikaty w repozytorium użytkownika, VS działa jako inny użytkownik: program Visual Studio może nie mieć dostępu do certyfikatów. Zamiast tego zainstaluj certyfikaty w magazynie komputerów lokalnych.
• Niektóre funkcje działają, ale inne kończą się niepowodzeniem: zwykle oznacza to problem z protokołem IPv6 lub różnicę między siecią .NET Framework i .NET Core. Zobacz Copilot Authentication działa, gdy Copilot Chat nie działa.
• Pracowało wczoraj, zepsute dziś: Wystąpiła zmiana konfiguracji sieci nadrzędnej. Skontaktuj się z administratorem IT, aby zidentyfikować zmiany.

Diagnozowanie problemów z częściowym łańcuchem certyfikatów

Jeśli wystąpią PartialChain błędy, wykonaj następujące kroki, aby zidentyfikować brakujące certyfikaty. Te kroki wymagają narzędzia wiersza polecenia OpenSSL.

1. Uruchom następujące polecenie, aby wyświetlić łańcuch certyfikatów, zastępując PROXY_HOST:PORT ciąg adresem serwera proxy i target.host.com punktem końcowym, do którego próbujesz uzyskać dostęp:

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

2. Dla każdego certyfikatu w danych wyjściowych uruchom następujące polecenie, aby sprawdzić łańcuch (po zapisaniu każdego certyfikatu do pliku takiego jak cert1.pem, cert2.pemitd.):

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

3. Sprawdź łańcuch certyfikatów, sprawdzając:

   • Identyfikator klucza urzędu (AKI) certyfikatu N powinien być zgodny z identyfikatorem klucza podmiotu (SKI) certyfikatu N+1.
   • DN wystawcy certyfikatu N powinno być zgodne z DN podmiotu certyfikatu N+1.

Jeśli znajdziesz przerwę w łańcuchu, skontaktuj się z administratorem IT, aby uzyskać i zainstalować brakujące certyfikaty pośrednie.

Uwaga / Notatka

Platforma .NET odrzuca żądania, jeśli AKI jednego certyfikatu nie jest zgodny z SKI następnego certyfikatu w łańcuchu, nawet jeśli przeglądarkom internetowym się to udaje. Jest to bardziej rygorystyczna weryfikacja niż ta, którą przeprowadza większość przeglądarek.

Problemy z produktami: Zbieranie informacji diagnostycznych na potrzeby pomocy technicznej

Jeśli ustalisz, że problem nie jest problemem z konfiguracją po podaniu wymaganych ustawień w programie Visual Studio, prześlij bilet opinii. Zobacz Jak zgłosić problem z programem Visual Studio. Podczas zgłaszania opinii dotyczących problemów z serwerem proxy dołącz następujące informacje, aby pomóc nam je zbadać. Tym więcej szczegółów podajesz, tym szybciej możemy określić, czy problem dotyczy usterki produktu, czy problemu z konfiguracją.

Sprawdzanie stanu uwierzytelniania

Sprawdź następujące stany uwierzytelniania:

1. Uwierzytelnianie w usłudze GitHub:

   • Otwórz Menedżera poświadczeń WindowsPoświadczenia systemu Windows.
   • Poszukaj poświadczeń z prefiksem git: .
   • Sprawdź %LocalAppData%/.IdentityService/GitHubV3AccountStore.json, aby uzyskać metadane konta usługi GitHub.

2. Stan funkcji: Zwróć uwagę, które funkcje działają i które kończą się niepowodzeniem (na przykład przywracanie NuGet, instalacja rozszerzenia, funkcje sztucznej inteligencji).

Zbieranie logów i szczegółów konfiguracji

Zbierz następujące informacje:

1. Dzienniki programu Visual Studio: utwórz plik zip .%temp%/Vslogs

2. Śledzenie sieci: jeśli to możliwe, zbierz ślad programu Fiddler pokazujący żądania, które zakończyły się niepowodzeniem.

3. Szczegóły konfiguracji serwera proxy:

   • Czy jest to jawny czy przezroczysty serwer proxy?
   • Czy serwer proxy wymaga uwierzytelniania? Jeśli tak, jakiego rodzaju (Basic, NTLM, Kerberos)?
   • Czy serwer proxy blokuje lub zezwala na określone aplikacje?
   • Czy wymagane certyfikaty są zainstalowane i zaufane? Czy jakiekolwiek certyfikaty zostały odwołane lub wygasły?
   • Czy zapora jest również skonfigurowana?
   • Czy włączono inspekcję protokołu SSL?
   • Czy ruch IPv6 jest kierowany przez serwer proxy?

4. Porównanie z innymi narzędziami: czy program Visual Studio Code lub inne aplikacje działają za pośrednictwem tego serwera proxy?

Treści powiązane

• Konfigurowanie ustawień serwera proxy w programie Visual Studio

• Instalowanie i używanie programu Visual Studio za zaporą lub serwerem proxy
• Rozwiązywanie problemów z łącznością programu Visual Studio