Live Share 연결 요구 사항Connectivity requirements for Live Share

이 문서에서는 Visual Studio Live Share, 사용 가능한 연결 옵션 및 알려진 해결 방법 (해당 하는 경우)에 대 한 연결 요구 사항을 요약 합니다.This article summarizes the connectivity requirements for Visual Studio Live Share, available connectivity options, and known workarounds when applicable.

로그인Sign in

Azure Active Directory 지원 되는 회사 또는 학교 계정, Microsoft 계정또는 GitHub 프로필을 사용 하 여 Live Share에 로그인 할 수 있습니다.You can sign into Live Share using any Azure Active Directory backed work or school account, a Microsoft account, or a GitHub profile. 이러한 항목에 대 한 로그인 Url은 일반적으로이를 사용 하는 공용 제품의 수를 감안 하 여 대부분의 조직에서 열려 있지만, 그렇지 않은 경우에는 login.microsoftonline.com github.com 아래 나열 된도메인을 열거나 추가 하는 방법에 대 한 자세한 내용은 네트워크 관리자에 게 문의 하세요.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.

참고

온-프레미스 AD (ADFS) 계정 및 온-프레미스 GitHub Enterprise 계정은 현재 지원 되지 않습니다 (최신 응답 👍 ).On-prem AD (ADFS) accounts and on-prem GitHub Enterprise accounts are not currently supported (up-vote 👍).

연결 모드Connection modes

최적의 성능을 보장 하기 위해 기본적으로 Visual Studio Live Share는 공동 작업 세션 호스트 컴퓨터와 게스트 컴퓨터가 네트워크를 통해 직접 통신할 수 있는지 여부를 자동으로 감지 하 고 둘 사이에 경로가 없는 경우 클라우드를 통해서만 릴레이 합니다.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. 이러한 혼합 된 "자동" 모드는 유연 하 고 일부 게스트가 동일한 세션에 직접 연결 하는 동안 클라우드를 통해 릴레이할 수 있습니다.This mixed "auto" mode is flexible and even allows some guests to relay through the cloud while others connect directly for the same session.

직접 연결은 보안을 보장 하기 위해 클라우드 기반 메커니즘을 통해 인증 되지만, 연결을 사용 하도록 설정 하려면 5990 ~ 5999 사이의 포트를 열어야 합니다.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. 결과적으로, 처음으로 공유 하는 경우 데스크톱 방화벽에서 포트를 열도록 요청할 수 있습니다.As a result, when sharing for the first time your desktop firewall may prompt you open a port. 이 옵션을 사용 하는 것은 무시 해도 되지만 자동 모드에서 항상 릴레이를 사용 하는 Live Share 발생 합니다.Accepting this is optional as ignoring it will simply cause Live Share to always use the relay when in auto mode.

Visual Studio Live Share의 모든 연결은 공동 작업 세션의 해당 콘텐츠에 대 한 액세스 권한을 얻을 수 있도록 중앙 서비스에 대해 암호화 및 인증 된 SSH 또는 SSL입니다.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. 또한 Live Share의 클라우드 relay는이를 통해 라우팅되는 트래픽을 유지 하지 않으며 어떤 방식으로든 트래픽을 "스 눕" 하지 않습니다.In addition, Live Share's cloud relay does not persist any traffic routed through it and does not "snoop" the traffic in any way.

연결 모드 변경Changing the connection mode

직접 또는 릴레이 된 연결을 사용 하지 않도록 설정 하거나 단순히 연결 문제를 해결 하려는 경우 다른 연결 모드를 강제 적용할 수 있습니다.If you would prefer to disable direct or relayed connections or are simply troubleshooting connectivity problems, you can force other connection modes.

모드Mode 호스트 동작Host Behavior 게스트 동작Guest Behavior
자동Auto 호스트의 공동 작업 세션은 보안, 인증 된 직접 연결 또는 클라우드 릴레이 된 연결을 허용 합니다.The host's collaboration session accepts secured, authenticated direct connections or cloud relayed connections. 는 직접 연결을 사용 하려고 시도 하 고 실패 하는 경우 클라우드를 통한 릴레이로 대체 합니다.Attempts to use a direct connection and falls back to relaying through the cloud if this fails.
직접Direct 호스트의 공동 작업 세션은 인증 된 보안 직접 연결만 허용 합니다.The host's collaboration session only accepts authenticated, secure direct connections. 직접 연결을 사용 하려고 시도 하 고 연결할 수 없는 경우 중지 합니다.Attempts to use a direct connection and stops if it cannot connect.
릴레이Relay 호스트의 공동 작업 세션에서 직접 연결을 허용 하지 않습니다.The host's collaboration session does not allow direct connections. 호스트의 컴퓨터에서 열려 있는 포트가 없습니다.No port is opened on the host's machine. 는 항상 클라우드를 통해 연결 합니다.Always connects via the cloud.

모드를 변경하려면:To change the mode:

-VS:

  1. 도구 > 옵션 > Live Share으로 이동 합니다.Go to Tools > Options > Live Share.
  2. "연결 모드" 드롭다운에서 모드를 선택 합니다.Select the mode from the "Connection Mode" dropdown.
  3. 다시 시작 및Restart VS.

VS Code:VS Code:

  1. settings.js(파일 > 기본 설정 > 설정)을 편집 합니다.Edit settings.json (File > Preferences > Settings).
  2. "liveshare.connectionMode"기본 설정 "auto" "direct" 에 따라, 또는로 설정 "relay" 합니다.Set "liveshare.connectionMode" to "auto", "direct", or "relay" depending on your preference.
  3. VS Code를 다시 시작 합니다.Restart VS Code.

연결 모드에 대 한 요구 사항Requirements for connection modes

연결 모드에 따라 Live Share 작동 하는 데 사용할 수 있어야 하는 특정 포트 및 Url이 결정 됩니다.The connection mode you are in will dictate the specific ports and URLs that need to be available for Live Share to function.

모드Mode 클라이언트 액세스 요구 사항Client Access Requirement 문제 해결Troubleshooting
모두Any 아웃 바운드 액세스 *.liveshare.vsengsaas.visualstudio.com:443Outbound access to *.liveshare.vsengsaas.visualstudio.com:443 회사 또는 개인 네트워크 방화벽을 통해이 도메인에 연결할 수 있는지 확인 합니다.Ensure your corporate or personal network firewall allows you to connect to this domain. 브라우저에서를 입력 하 https://insiders.liveshare.vsengsaas.visualstudio.com 고 Visual Studio Live Share 홈페이지를 확인 합니다.Enter https://insiders.liveshare.vsengsaas.visualstudio.com in a browser and verify you land at the Visual Studio Live Share home page. 해결 해야 하는 프록시 문제 를 실행할 수도 있습니다.You may also be running into proxy issues that need to be resolved.
Any (VS Code)Any (VS Code) 아웃 바운드 액세스 download.microsoft.com:443Outbound access to download.microsoft.com:443 회사 또는 개인 네트워크 방화벽을 통해이 도메인에 연결할 수 있는지 확인 합니다.Ensure your corporate or personal network firewall allows you to connect to this domain. 해결 해야 하는 프록시 문제 를 실행할 수도 있습니다.You may also be running into proxy issues that need to be resolved.
자동Auto 자동 전환.Auto-switches. 직접 및 릴레이 모드를 참조 하세요.See direct and relay modes. 문제를 해결 하려면 직접 또는 릴레이 모드로 전환 합니다.Switch to direct or relay mode to troubleshoot.
직접Direct 호스트: 인바운드 로컬 네트워크 연결을 허용 하려면 5990-5999 범위의 포트를 열어야 합니다.Hosts: A port in the range 5990 - 5999 needs to be opened to accept inbound local network connections.

게스트:이 동일한 포트에서 호스트에 대 한 네트워크 경로 및 아웃 바운드 액세스입니다.Guests: A network route and outbound access to the host on this same port.
"Vsls-agent"가이 포트 범위에 대 한 데스크톱 방화벽 소프트웨어에 의해 차단 되지 않는지, 그리고 서로 ping 할 수 있는지 확인 합니다.Verify "vsls-agent" is not blocked by your desktop firewall software for this port range and that you can ping one another. Windows 및 기타 데스크톱 소프트웨어는 에이전트가 처음 시작 될 때 메시지를 표시 해야 하지만 그룹 정책에서이 작업을 차단 하는 것을 방지 하 고 항목을 수동으로 추가해야 하는 경우를 확인 합니다.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. 해결 해야 하는 프록시 문제 를 실행할 수도 있습니다.You may also be running into proxy issues that need to be resolved.
릴레이Relay 에 대 한 아웃 바운드 액세스 *.servicebus.windows.net:443 .Outbound access to *.servicebus.windows.net:443. 회사 또는 개인 네트워크 방화벽을 통해이 도메인에 연결할 수 있는지 확인 합니다.Ensure your corporate or personal network firewall allows you to connect to this domain. 해결 해야 하는 프록시 문제 를 실행할 수도 있습니다.You may also be running into proxy issues that need to be resolved.

수동으로 방화벽 항목 추가Manually adding a firewall entry

위에서 설명한 대로 직접 모드에서는 개인 방화벽이 vsls-agent 가 포트 범위 5990-5999의 연결을 허용 하도록 허용 해야 합니다.As outlined above, direct mode requires that your personal firewall allow vsls-agent to accept connections in the port range 5990-5999. 직접 모드를 사용 하지만 방화벽에 vsls 에이전트 항목이 없다는 것을 발견 한 경우 수동으로 추가할 수 있습니다.If you want to use direct mode but have found that your firewall does not have vsls-agent entry, you can add it manually. 이 작업을 수행 하는 방법은 방화벽 소프트웨어에 따라 다르지만 여기에서 Windows 방화벽을 구성 하는 방법에 대 한 정보를 찾을 수 있습니다.How you do this will vary by firewall software, but you can find information about configuring the Windows Firewall here.

Vsls-agent에 대 한 항목이 표시 되지 않으면 다음 위치 중 하나에서 에이전트 실행 파일을 찾을 수 있습니다.If you do not see an entry for vsls-agent, you can find the agent executable in one of the following locations.

VS Code 에이전트 위치VS Code agent location

다음 경로 중 하나에서 확장 버전 번호를 대체 합니다 .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

Visual Studio 에이전트 위치Visual Studio agent location

Visual Studio 위치는 동적 이지만 다음 단계를 수행 하 여 실행 파일을 찾을 수 있습니다.The Visual Studio location is more dynamic, but you can follow these steps to find the executable:

  1. Visual Studio 설치 위치로 이동 합니다.Navigate to your Visual Studio install location. 일반적으로 C:\Program Files (x86)\Microsoft Visual Studio\EDITION 버전 은 Community, Enterprise 등입니다.This is typically C:\Program Files (x86)\Microsoft Visual Studio\EDITION where EDITION is Community, Enterprise, etc

  2. IDE\Extensions 하위 폴더의에서에 대해 검색을 실행 vsls-agent.exe 합니다. Run a search for vsls-agent.exe in under the IDE\Extensions sub-folder.

그러나 Visual Studio Live Share를 업데이트할 때마다이 단계를 수행 해야 할 수 있습니다.Unfortunately you may need to do this step each time you update Visual Studio Live Share.

프록시Proxies

Visual Studio Live Share 현재 프록시 사용에 대 한 몇 가지 제한 사항이 있습니다.Visual Studio Live Share currently has some limitations around proxy use. Windows에서 자동 프록시 설정이 작동 하는 반면 macOS 또는 Linux를 사용 하는 경우 (그리고 Windows의 특정 프록시 구성에서) HTTP_PROXYHTTPS_PROXY 환경 변수를 전역적 으로 설정 해야 합니다.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.

프록시가 자동으로 이러한 설정을 자동으로 설정 하지 않는 경우 다음과 같은 형식으로 변수를 수동으로 설정할 수 있습니다.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

인증 프록시가 있는 경우 다음과 같이 사용자와 암호를 추가할 수 있습니다.If you have an authenticating proxy, you can add your user and password as follows:

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

이러한 설정으로 인해 문제가 해결 되지 않으면 지원 향상에 대 한 자세한 내용을 확인할 수 있도록 프록시 설정의 세부 정보를 알려주세요.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.

추가 정보See also

문제가 있으신가요?Having problems? 문제 해결을 참조하거나 피드백을 제공해 주세요.See troubleshooting or provide feedback.