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

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

Zaloguj

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

Uwaga

Konta usługi AD (ADFS) i konta GitHub Enterprise nie są obecnie obsługiwane (głosy up-vote 👍 ).

Tryby połączenia

Aby zapewnić optymalną wydajność, program Visual Studio Live Share automatycznie wykrywa, czy maszyna hosta sesji współpracy i maszyna gościa mogą komunikować się bezpośrednio przez sieć i tylko za pośrednictwem chmury, jeśli między nimi nie ma trasy. Ten mieszany tryb "automatycznego" jest elastyczny, a nawet umożliwia niektórym gościom przekazywanie za pośrednictwem chmury, podczas gdy inni łączą się bezpośrednio w ramach 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 od 5990 do 5999, aby umożliwić łączność. W związku z tym podczas udostępniania po raz pierwszy zapora pulpitu może monitować o otwarcie portu. Zaakceptowanie tego ustawienia jest opcjonalne, ponieważ zignorowanie go spowoduje po prostu, Live Share zawsze używać przekaźnika w trybie automatycznym.

Wszystkie połączenia w usłudze Visual Studio Live Share są szyfrowane za pomocą protokołu SSH lub SSL i uwierzytelniane w centralnej usłudze w celu zapewnienia, że tylko te połączenia w sesji współpracy mogą uzyskać dostęp do jej zawartości. Ponadto przekaźnik Live Share w chmurze nie utrzymuje żadnego ruchu kierowanego przez ten przekaźnik i w żaden sposób nie "odsyła" ruchu.

Zmienianie trybu połączenia

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

Tryb Zachowanie hosta Zachowanie gościa
Auto 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 powraca 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żna nawiązać połączenia.
Przekaźnik Sesja współpracy hosta nie zezwala na połączenia bezpośrednie. Port nie jest otwierany na maszynie hosta. Zawsze nawiązuje połączenie za pośrednictwem chmury.

Aby zmienić tryb:

VS:

  1. Przejdź do menu Narzędzia > opcje > Live Share.
  2. Wybierz tryb z listy rozwijanej "Tryb połączenia".
  3. Uruchom ponownie program VS.

VS Code:

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

Wymagania dotyczące trybów połączenia

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

Tryb Wymaganie dostępu klienta Rozwiązywanie problemów
Dowolne Dostęp wychodzący do *.liveshare.vsengsaas.visualstudio.com:443 Upewnij się, że firmowa lub osobista zapora sieciowa umożliwia nawiązywanie połączenia z tą domeną. Wprowadź https://insiders.liveshare.vsengsaas.visualstudio.com w przeglądarce i sprawdź, czy jesteś na stronie Visual Studio Live Share głównej. Mogą również wystąpić problemy z serwerem proxy, które należy rozwiązać.
Dowolne (VS Code) Dostęp wychodzący do download.microsoft.com:443 Upewnij się, że firmowa lub osobista zapora sieciowa umożliwia nawiązywanie połączenia z tą domeną. Mogą również wystąpić problemy z serwerem proxy, które należy rozwiązać.
Auto Przełączniki automatyczne. Zobacz tryby bezpośrednie i przekaźnika. Przełącz się do trybu bezpośredniego lub przekazywania, aby rozwiązać problemy.
Direct Hosty: należy otworzyć port z zakresu 5990–5999, aby akceptować przychodzące połączenia sieci lokalnej.

Goście: trasa sieciowa i dostęp wychodzący do hosta na tym samym porcie.
Sprawdź, czy program zapory pulpitu nie blokuje polecenia "vsls-agent" dla tego zakresu portów i czy można wysyłać do siebie polecenia ping. Chociaż Windows i inne oprogramowanie klasyczne powinny wyświetlać monit przy pierwszym uruchamianiu agenta, zobaczyliśmy wystąpienia, w których zasady grupy uniemożliwiają to i należy ręcznie dodać wpis. Mogą również wystąpić problemy z serwerem proxy, które należy rozwiązać.
Przekaźnik Dostęp wychodzący do *.servicebus.windows.net:443 . Upewnij się, że firmowa lub osobista zapora sieciowa umożliwia nawiązywanie połączenia z tą domeną. Mogą również wystąpić problemy z serwerem proxy, które należy rozwiązać.

Ręczne dodawanie wpisu zapory

Jak wspomniano powyżej, tryb bezpośredni wymaga, aby osobista zapora zezwalała agentowi vsls na akceptowanie połączeń z zakresu portów 5990–5999. Jeśli chcesz użyć trybu bezpośredniego, ale wiesz, że zapora nie ma wpisu vsls-agent, możesz dodać ją ręcznie. Sposób, w jaki to zrobisz, zależy od oprogramowania zapory, ale informacje o konfigurowaniu zapory zapory można znaleźć tutaj Windows:.

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

VS Code lokalizacji agenta

Zastąp zmienną VERSION numerem wersji rozszerzenia w jednej z poniższych ścieżek:

  • macOS, Linux

    $HOME/.vscode/extensions/ms-vsliveshare.vsliveshare-VERSION/dotnet_modules/vsls-agent

  • Windows

    %USERPROFILE%\.vscode\extensions\ms-vsliveshare.vsliveshare-VERSION\dotnet_modules\vsls-agent.exe

Visual Studio lokalizacji agenta

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

  1. Przejdź do lokalizacji Visual Studio instalacji. Zwykle jest to C:\Program Files (x86)\Microsoft Visual Studio\EDITION wersja COMMUNITY, Enterprise itp.

  2. Uruchom wyszukiwanie w vsls-agent.exe folderze w podfoldecie IDE\Extensions.

Niestety ten krok może być konieczne za każdym razem, gdy aktualizujesz Visual Studio Live Share.

Serwerów proxy

Visual Studio Live Share obecnie ma pewne ograniczenia dotyczące użycia serwera proxy. Mimo że 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 programie Windows) zmienne środowiskowe HTTP_PROXY i HTTPS_PROXY muszą być ustawiane globalnie.

Jeśli serwer proxy nie ustawi ich automatycznie, możesz ręcznie ustawić zmienne w następującej postaci:

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

Jeśli masz serwer proxy uwierzytelniania, 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ółowe informacje dotyczące konfiguracji serwera proxy, abyśmy przyjrzeli się ulepszaniu obsługi.

Zobacz też

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