Wymagania dotyczące łączności dla rozszerzenia Live Share

  • Artykuł

Ten artykuł zawiera podsumowanie wymagań dotyczących łączności dla programu Visual Studio Live Share, dostępnych opcji łączności i znanych obejść, jeśli ma to zastosowanie.

Zaloguj się

Możesz zalogować się do usługi Live Share przy użyciu dowolnego konta służbowego lub szkolnego usługi Azure Active Directory, konta Microsoft lub profilu usługi GitHub. Zazwyczaj adresy URL logowania dla nich są otwarte w większości organizacji, biorąc pod uwagę liczbę produktów publicznych, które ich używają, ale jeśli nie, skontaktuj się z administratorem sieci w celu otwarcia login.microsoftonline.com i/lub github.com oprócz domen wymienionych poniżej.

Uwaga

Lokalne konta usługi AD (ADFS) i lokalne konta gitHub Enterprise nie są obecnie obsługiwane (up-vote 👍).

Tryby Połączenie ion

Aby zapewnić optymalną wydajność, domyślnie program Visual Studio Live Share automatycznie wykrywa, czy maszyna hosta sesji współpracy i maszyna gościa mogą komunikować się bezpośrednio za pośrednictwem sieci i tylko przekaźniki za pośrednictwem chmury, jeśli nie ma trasy między nimi. Ten mieszany tryb "automatyczny" jest elastyczny, a nawet umożliwia niektórym gościom przekazywanie za pośrednictwem chmury, podczas gdy inni łączą się bezpośrednio w tej samej sesji.

Połączenia bezpośrednie są uwierzytelniane za pośrednictwem mechanizmu opartego na chmurze w celu zapewnienia bezpieczeństwa, ale wymagają otwarcia portu z zakresu od 5990 do 5999 w celu włączenia łączności. W związku z tym podczas udostępniania po raz pierwszy zapora pulpitu może wyświetlić monit o otwarcie portu. Akceptowanie tego elementu jest opcjonalne, ponieważ ignorowanie spowoduje, że funkcja Live Share będzie zawsze używać przekaźnika w trybie automatycznym.

Wszystkie połączenia w programie Visual Studio Live Share są szyfrowane za pomocą protokołu SSH lub SSL i uwierzytelniane względem usługi centralnej, aby upewnić się, że tylko te w sesji współpracy mogą uzyskać dostęp do jego zawartości. Ponadto przekaźnik chmury usługi Live Share nie utrzymuje żadnego ruchu kierowanego przez nią i nie "wsłania" ruchu w żaden sposób.

Zmienianie trybu połączenia

Jeśli wolisz wyłączyć połączenia bezpośrednie lub przekazywane lub po prostu rozwiązywać problemy z łącznością, możesz wymusić inne tryby połączenia.

Tryb Zachowanie hosta Zachowanie gościa
Automatycznie Sesja współpracy hosta akceptuje zabezpieczone, uwierzytelnione połączenia bezpośrednie lub połączenia przekazywane w chmurze. Próbuje użyć bezpośredniego połączenia i powróci do przekazywania za pośrednictwem chmury, jeśli to się nie powiedzie.
Direct Sesja współpracy hosta akceptuje tylko uwierzytelnione, bezpieczne połączenia bezpośrednie. Próbuje użyć połączenia bezpośredniego i zatrzymuje się, jeśli nie może nawiązać połączenia.
Przekaźnik Sesja współpracy hosta nie zezwala na połączenia bezpośrednie. Na maszynie hosta nie jest otwarty żaden port. Zawsze łączy się za pośrednictwem chmury.

Aby zmienić tryb:

VS:

  1. Przejdź do pozycji Narzędzia > Opcje > udostępniania na żywo.
  2. Wybierz tryb z listy rozwijanej "tryb Połączenie ion".
  3. Uruchom ponownie program VS.

VS Code:

  1. Edytuj plik settings.json (preferencje > plików > Ustawienia).
  2. Ustaw "liveshare.connectionMode" wartość "auto", "direct"lub "relay" w zależności od preferencji.
  3. Uruchom ponownie program VS Code.

Wymagania dotyczące trybów połączenia

Tryb połączenia, w którym pracujesz, będzie określać określone porty i adresy URL, które muszą być dostępne dla funkcji Live Share.

Tryb Wymaganie dostępu klienta Rozwiązywanie problemów
Dowolne Dostęp wychodzący do usługi *.liveshare.vsengsaas.visualstudio.com:443. Upewnij się, że zapora sieci firmowa lub osobista umożliwia łączenie się z tą domeną. Wprowadź https://visualstudio.microsoft.com/services/live-share/ ciąg w przeglądarce i sprawdź, czy jesteś na stronie głównej programu Visual Studio Live Share. Możesz również napotkać problemy z serwerem proxy, które należy rozwiązać.
Dowolne (VS Code) Dostęp wychodzący do usługi download.microsoft.com:443. Upewnij się, że zapora sieci firmowa lub osobista umożliwia łączenie się z tą domeną. Możesz również napotkać problemy z serwerem proxy, które należy rozwiązać.
Automatycznie Przełączniki automatyczne. Zobacz tryby bezpośrednie i przekaźniki. Przejdź do trybu bezpośredniego lub przekaźnika, aby rozwiązać problemy.
Direct Hosty: należy otworzyć port z zakresu 5990–5999, aby akceptował przychodzące połączenia sieciowe lokalne.

Goście: trasa sieciowa i dostęp wychodzący do hosta na tym samym porcie.		 Sprawdź, czy program "vsls-agent" (dla programu VS), "code" (dla programu Visual Studio Code) lub "code - insiders" (dla niejawnych testerów programu Visual Studio Code) nie jest blokowany przez oprogramowanie zapory pulpitu dla tego zakresu portów i że możesz wysłać do siebie polecenie ping. Podczas gdy system Windows i inne oprogramowanie klasyczne powinny monitować o pierwsze uruchomienie agenta, widzieliśmy wystąpienia, w których zasady grupy uniemożliwiają to wystąpienie i trzeba będzie ręcznie dodać wpis. Możesz również napotkać problemy z serwerem proxy, które należy rozwiązać.
Przekaźnik Dostęp wychodzący do usługi *.servicebus.windows.net:443. Upewnij się, że zapora sieci firmowa lub osobista umożliwia łączenie się z tą domeną. Możesz również napotkać problemy z serwerem proxy, które należy rozwiązać.
Dowolne Dostęp wychodzący do usługi *.online.visualstudio.com. Upewnij się, że zapora sieci firmowa lub osobista umożliwia łączenie się z tą domeną. Wprowadź https://sts.online.visualstudio.com/api/swagger/index.html w przeglądarce i sprawdź, czy znajdujesz się na stronie struktury Swagger. Możesz również napotkać problemy z serwerem proxy, które należy rozwiązać.

Ręczne dodawanie wpisu zapory

Jak opisano powyżej, tryb bezpośredni wymaga, aby osobista zapora zezwalała na używanie agenta vsls-agenta, kodu lub kodu — osoby wewnętrzne akceptują połączenia w zakresie portów 5990–5999. Jeśli chcesz użyć trybu bezpośredniego, ale okazało się, że zapora nie ma wpisu vsls-agent, możesz dodać go ręcznie. Jak to zrobić, będzie się różnić w zależności od oprogramowania zapory, ale informacje o konfigurowaniu Zapory systemu Windows można znaleźć tutaj.

Jeśli nie widzisz wpisu dla programu vsls-agent, możesz znaleźć plik wykonywalny agenta w jednej z następujących lokalizacji.

Lokalizacja instalacji programu VS Code

Podczas ręcznego konfigurowania zapory dla niejawnych testerów programu VS Code lub VS Code w systemie Windows, MacOS lub Linux użyj ścieżki do lokalizacji instalacji aplikacji programu VS Code.

Na przykład: Windows (domyślna lokalizacja instalacji)

  • %applocaldata%\Programs\Microsoft VS Code\code.exe
  • %applocaldata%\Programs\Microsoft VS Code Insiders\code - insiders.exe

Lokalizacja agenta programu Visual Studio

Lokalizacja programu Visual Studio jest bardziej dynamiczna, ale możesz wykonać następujące kroki, aby znaleźć plik wykonywalny:

  1. Przejdź do lokalizacji instalacji programu Visual Studio. Zazwyczaj jest to miejsce, w którym wersja to C:\Program Files (x86)\Microsoft Visual Studio\EDITION Community, Enterprise itp.

  2. Uruchom wyszukiwanie vsls-agent.exe w folderze podrzędnym IDE\Extensions .

Niestety może być konieczne wykonanie tego kroku za każdym razem, gdy zaktualizujesz program Visual Studio Live Share.

Serwery proxy

Program Visual Studio Live Share ma obecnie pewne ograniczenia dotyczące używania serwera proxy. Podczas gdy ustawienia automatycznego serwera proxy powinny działać w systemie Windows, w przypadku korzystania z systemu macOS lub Linux (i niektórych konfiguracji serwera proxy w systemie Windows) HTTP_PROXY i HTTPS_PROXY zmiennych środowiskowych należy ustawić globalnie dla programu VS lub ustawień serwera proxy aplikacji > dla programu VS Code.

Uwaga: jeśli serwer proxy nie jest skonfigurowany w ustawieniach serwera proxy aplikacji > programu VS Code, będzie również dziedziczony z http_proxy i https_proxy zmiennych środowiskowych.

Jeśli serwer proxy nie ustawi tych ustawień automatycznie, możesz ręcznie ustawić zmienne w następującym formularzu:

HTTPS_PROXY=http://proxy-ip-address:proxyport

Jeśli masz uwierzytelniający serwer proxy, możesz dodać użytkownika i hasło w następujący sposób:

HTTPS_PROXY=http://user:password@proxy-ip-address:proxyport

Jeśli te ustawienia nie rozwiążą problemu, daj nam znać szczegóły konfiguracji serwera proxy, abyśmy mogli przyjrzeć się poprawie pomocy technicznej.

Zobacz też

Masz problemy? Przejdź do strony rozwiązywania problemów lub przekaż opinię.