Požadavky na připojení pro Live ShareConnectivity requirements for Live Share

Tento článek shrnuje požadavky na připojení pro Visual Studio Live Share, dostupné možnosti připojení a známá řešení v případě potřeby.This article summarizes the connectivity requirements for Visual Studio Live Share, available connectivity options, and known workarounds when applicable.

Přihlásit seSign in

K Live Share se můžete přihlásit pomocí Azure Active Directory zálohovaného pracovního nebo školního účtu, účet Microsoftnebo profilu GitHubu.You can sign into Live Share using any Azure Active Directory backed work or school account, a Microsoft account, or a GitHub profile. Obvykle jsou adresy URL pro přihlášení pro ně ve většině organizací otevřené, a to s ohledem na počet veřejných produktů, které je používají, ale pokud ne, požádejte správce sítě o otevření login.microsoftonline.com a/nebo github.com kromě domén uvedených níže.Typically sign-in URLs for these are open in most organizations given the number of public facing products that use them, but if not, contact your network administrator about opening up login.microsoftonline.com and/or github.com in addition to the domains listed below.

Poznámka

Účty AD FS (on-Prem AD) a účty na Prem GitHubu na úrovni Standard se momentálně nepodporují (👍pro hlasování).On-prem AD (ADFS) accounts and on-prem GitHub Enterprise accounts are not currently supported (up-vote 👍).

Režimy připojeníConnection modes

Aby se zajistil optimální výkon, ve výchozím nastavení Visual Studio Live Share automaticky detekuje, jestli počítač hostitele relace spolupráce a počítač hosta můžou komunikovat přímo přes síť a přenáší se jenom přes Cloud, pokud mezi nimi neexistují žádné trasy.To ensure optimal performance, by default Visual Studio Live Share automatically detects whether a collaboration session host machine and guest machine can communicate directly over a network and only relays via the cloud if there is no route between them. Tento smíšený režim "automatické" je flexibilní a dokonce umožňuje některým hostům přenášet přes Cloud, zatímco ostatní se připojují přímo ke stejné relaci.This mixed "auto" mode is flexible and even allows some guests to relay through the cloud while others connect directly for the same session.

Přímá připojení se ověřují prostřednictvím cloudového mechanismu, aby se zajistilo zabezpečení, ale vyžaduje se otevření portu mezi 5990 a 5999, aby bylo možné připojení povolit.The direct connections are authenticated via a cloud based mechanism to ensure security but require a port between 5990 and 5999 be opened to enable the connectivity. V důsledku toho se při prvním sdílení může zobrazit výzva k otevření portu v bráně firewall vaší plochy.As a result, when sharing for the first time your desktop firewall may prompt you open a port. Přijetí tohoto požadavku je volitelné, protože ho ignoruje, stačí, když Live Share vždycky používat předávání v automatickém režimu.Accepting this is optional as ignoring it will simply cause Live Share to always use the relay when in auto mode.

Všechna připojení v Visual Studio Live Share jsou zašifrovaná pomocí protokolu SSH nebo SSL a ověřená proti centrální službě, aby se zajistilo, že k obsahu budou mít přístup jenom ty, které jsou v relaci spolupráce.All connections in Visual Studio Live Share are SSH or SSL encrypted and authenticated against a central service to ensure that only those in the collaboration session can gain access to its content. Cloud Relay Live Share navíc neuchovává žádný provoz, který je prostřednictvím něj směrován, a žádným způsobem nepracuje s přenosy "Snoop".In addition, Live Share's cloud relay does not persist any traffic routed through it and does not "snoop" the traffic in any way.

Změna režimu připojeníChanging the connection mode

Pokud chcete zakázat přímá nebo přepřenosná připojení nebo jednoduše řešit problémy s připojením, můžete vynutit jiné režimy připojení.If you would prefer to disable direct or relayed connections or are simply troubleshooting connectivity problems, you can force other connection modes.

RežimMode Chování hostiteleHost Behavior Chování hostůGuest Behavior
AutoAuto Relace spolupráce hostitele přijímá zabezpečená, ověřená přímá připojení nebo připojení v cloudu.The host's collaboration session accepts secured, authenticated direct connections or cloud relayed connections. Pokusí se použít přímé připojení a vrátit se k předávání přes Cloud v případě, že dojde k chybě.Attempts to use a direct connection and falls back to relaying through the cloud if this fails.
PříméDirect Relace spolupráce hostitele přijímá pouze ověřená a zabezpečená přímá připojení.The host's collaboration session only accepts authenticated, secure direct connections. Pokusí se použít přímé připojení a zastaví se, pokud se nemůže připojit.Attempts to use a direct connection and stops if it cannot connect.
DávatRelay Relace spolupráce hostitele nepovoluje přímá připojení.The host's collaboration session does not allow direct connections. Na počítači hostitele není otevřený žádný port.No port is opened on the host's machine. Vždy se připojuje přes Cloud.Always connects via the cloud.

Postup změny režimu:To change the mode:

INFRASTRUKTURAVS:

  1. V nabídce Nástroje > Možnosti > Live Share.Go to Tools > Options > Live Share.
  2. Vyberte režim v rozevíracím seznamu "režim připojení".Select the mode from the "Connection Mode" dropdown.
  3. Restartujte VS.Restart VS.

VS Code:VS Code:

  1. Edit settings. JSON (> Předvolby souboru > nastavení).Edit settings.json (File > Preferences > Settings).
  2. V závislosti na vaší preferenci nastavte "liveshare.connectionMode" na "auto", "direct"nebo "relay".Set "liveshare.connectionMode" to "auto", "direct", or "relay" depending on your preference.
  3. Restartujte VS Code.Restart VS Code.

Požadavky na režimy připojeníRequirements for connection modes

Režim připojení, ve kterém se nacházíte, určí konkrétní porty a adresy URL, které musí být k dispozici, aby mohla Live Share fungovat.The connection mode you are in will dictate the specific ports and URLs that need to be available for Live Share to function.

RežimMode Požadavek na klientský přístupClient Access Requirement Poradce při potížíchTroubleshooting
JakýmikoliAny Odchozí přístup k *.liveshare.vsengsaas.visualstudio.com:443Outbound access to *.liveshare.vsengsaas.visualstudio.com:443 Ujistěte se, že vaše firemní nebo osobní síťová brána firewall vám umožní připojit se k této doméně.Ensure your corporate or personal network firewall allows you to connect to this domain. V prohlížeči zadejte https://insiders.liveshare.vsengsaas.visualstudio.com a ověřte, že máte na Visual Studio Live Share domovské stránce.Enter https://insiders.liveshare.vsengsaas.visualstudio.com in a browser and verify you land at the Visual Studio Live Share home page. Můžete také spustit problémy proxy , které je třeba vyřešit.You may also be running into proxy issues that need to be resolved.
Any (VS Code)Any (VS Code) Odchozí přístup k download.microsoft.com:443Outbound access to download.microsoft.com:443 Ujistěte se, že vaše firemní nebo osobní síťová brána firewall vám umožní připojit se k této doméně.Ensure your corporate or personal network firewall allows you to connect to this domain. Můžete také spustit problémy proxy , které je třeba vyřešit.You may also be running into proxy issues that need to be resolved.
AutoAuto Automatické přepínače.Auto-switches. Viz režimy přímých a přenosů.See direct and relay modes. Přepněte na přímý nebo předávací režim a odstraňte potíže.Switch to direct or relay mode to troubleshoot.
PříméDirect Hostitelé: pro příjem příchozích místních síťových připojení je potřeba otevřít port v rozsahu 5990-5999.Hosts: A port in the range 5990 - 5999 needs to be opened to accept inbound local network connections.

Hosté: Síťová trasa a odchozí přístup k hostiteli na tomto stejném portu.Guests: A network route and outbound access to the host on this same port.
Ověřte, jestli váš software brány firewall pro tento rozsah portů neblokoval "vsls-agent" a že můžete provést příkaz k dalšímu příkazu k otestování.Verify "vsls-agent" is not blocked by your desktop firewall software for this port range and that you can ping one another. I když by se vám systém Windows a jiný desktopový software měl vyzvat k prvnímu spuštění agenta, zjistili jsme instance, které brání zásadám skupiny v tom, aby se to stalo, a budete muset položku přidat ručně.While Windows and other desktop software should prompt you the first time the agent starts up, we have seen instances where group policies prevent this from happening and you will need to manually add the entry. Můžete také spustit problémy proxy , které je třeba vyřešit.You may also be running into proxy issues that need to be resolved.
DávatRelay Odchozí přístup k *.servicebus.windows.net:443.Outbound access to *.servicebus.windows.net:443. Ujistěte se, že vaše firemní nebo osobní síťová brána firewall vám umožní připojit se k této doméně.Ensure your corporate or personal network firewall allows you to connect to this domain. Můžete také spustit problémy proxy , které je třeba vyřešit.You may also be running into proxy issues that need to be resolved.

Ruční přidání položky brány firewallManually adding a firewall entry

Jak je uvedeno výše, přímý režim vyžaduje, aby osobní brána firewall povolovala vsls agenta pro přijímání připojení v rozsahu portů 5990-5999.As outlined above, direct mode requires that your personal firewall allow vsls-agent to accept connections in the port range 5990-5999. Pokud chcete použít přímý režim, ale zjistili jste, že brána firewall nemá položku vsls-agent, můžete ji přidat ručně.If you want to use direct mode but have found that your firewall does not have vsls-agent entry, you can add it manually. Postup se liší podle softwaru brány firewall, ale tady můžete najít informace o konfiguraci brány Windows Firewall .How you do this will vary by firewall software, but you can find information about configuring the Windows Firewall here.

Pokud nevidíte záznam pro vsls-agent, můžete najít spustitelný soubor agenta v jednom z následujících umístění.If you do not see an entry for vsls-agent, you can find the agent executable in one of the following locations.

Umístění agenta VS CodeVS Code agent location

Nahraďte číslo verze rozšíření v jedné z následujících cest:Substitute VERSION for the extension version number in one of the paths below:

  • macOS, LinuxmacOS, Linux

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

  • WindowsWindows

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

Umístění agenta sady Visual StudioVisual Studio agent location

Umístění sady Visual Studio je dynamičtější, ale pomocí těchto kroků můžete najít spustitelný soubor:The Visual Studio location is more dynamic, but you can follow these steps to find the executable:

  1. Přejděte do umístění instalace sady Visual Studio.Navigate to your Visual Studio install location. To je obvykle C:\Program Files (x86)\Microsoft Visual Studio\EDITION, kde edice je komunita, Enterprise atd.This is typically C:\Program Files (x86)\Microsoft Visual Studio\EDITION where EDITION is Community, Enterprise, etc

  2. Spusťte hledání vsls-agent.exe v části pod podsložkou IDE\Extensions .Run a search for vsls-agent.exe in under the IDE\Extensions sub-folder.

Tento krok možná budete muset udělat při každé aktualizaci Visual Studio Live Share.Unfortunately you may need to do this step each time you update Visual Studio Live Share.

ProxyProxies

Visual Studio Live Share má v tuto chvíli nějaká omezení týkající se použití proxy serveru.Visual Studio Live Share currently has some limitations around proxy use. Přestože automatické nastavení proxy serveru by mělo fungovat ve Windows, při použití macOS nebo Linux (a s některými konfiguracemi proxy ve Windows), musí být proměnné prostředí http_proxy a HTTPS_PROXY nastavené globálně.While automatic proxy settings should work on Windows, when using macOS or Linux (and with certain proxy configurations on Windows) the HTTP_PROXY and HTTPS_PROXY environment variables will need to be set globally.

Pokud to váš proxy server nenastaví automaticky, můžete proměnné nastavit ručně v následujícím tvaru:If your proxy doesn't automatically set these for you, you can manually set the variables in the following form:

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

Pokud máte ověřující proxy server, můžete přidat uživatele a heslo následujícím způsobem:If you have an authenticating proxy, you can add your user and password as follows:

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

Pokud tato nastavení problém nevyřeší, sdělte nám prosím informace o nastaveních proxy serveru, abychom se mohli podívat na vylepšení podpory.If these settings don't solve the problem for you, please let us know the specifics of your proxy setup so we can take a look at improving support.

Viz také:See also

Máte potíže?Having problems? Podívejte se na článek o odstraňování potíží nebo nám pošlete svůj názor.See troubleshooting or provide feedback.