Share via

Live Share 연결 요구 사항

  • 아티클

이 문서에서는 Visual Studio Live Share의 연결 요구 사항, 사용 가능한 연결 옵션 및 해당하는 경우 알려진 해결 방법을 간단하게 설명합니다.

로그인

Azure Active Directory에서 제공하는 회사 또는 학교 계정, Microsoft 계정 또는 GitHub 프로필을 사용하여 Live Share에 로그인할 수 있습니다. 일반적으로 이러한 경우에 사용하는 로그인 URL은 대부분의 조직에서 공개됩니다. 수많은 공용 제품이 이 URL을 사용하기 때문입니다. 공개되지 않는다면 네트워크 관리자에게 login.microsoftonline.com 및/또는 github.com를 아래 나열된 도메인과 함께 개방해 달라고 요청하세요.

참고 항목

온-프레미스 AD(ADFS) 계정과 온-프레미스 GitHub Enterprise 계정은 현재는 지원되지 않습니다(👍 투표).

커넥트ion 모드

최상의 성능을 보장하기 위해 기본적으로 Visual Studio Live Share에서는 협업 세션 호스트 컴퓨터와 게스트 컴퓨터가 네트워크를 통해 직접 통신하며 중간에 경로가 없다면 클라우드만을 통해 릴레이하는지를 자동으로 감지합니다. 이러한 혼합된 “자동” 모드는 유연하며, 일부 게스트는 클라우드를 통해 릴레이하고 다른 게스트는 같은 세션에 직접 연결할 수 있습니다.

보안을 보장하기 위해 직접 연결은 클라우드 기반 메커니즘을 통해 인증되지만, 연결을 활성화하려면 5990~5999 사이의 포트를 열어야 합니다. 따라서 처음으로 공유할 때는 데스크톱 방화벽에서 포트 개방을 요청할 수도 있습니다. 이 옵션은 수락하지 않아도 됩니다. 무시하더라도 Live Share에서는 자동 모드일 때 항상 릴레이를 사용하기 때문입니다.

Visual Studio Live Share에 있는 모든 연결은 SSH 또는 SSL로 암호화되고 중앙 서비스를 대상으로 인증되어, 협업 세션에 있는 사람만이 세션 내용을 확인할 수 있게 합니다. 또한 Live Share의 클라우드 릴레이는 이를 통해 라우팅되는 트래픽을 유지하지 않으며 어떤 방식으로도 트래픽을 “스눕”하지 않습니다.

연결 모드 변경

직접 또는 릴레이 연결을 비활성화하거나 연결 문제만 해결하고 싶다면 다른 연결 모드를 강제 적용할 수 있습니다.

모드 호스트 동작 게스트 동작
자동 호스트의 협업 세션은 안전하고 인증된 직접 연결 또는 클라우드 릴레이 연결을 허용합니다. 직접 연결 사용을 시도한 다음 실패하면 클라우드를 통한 릴레이로 대체합니다.
Direct 호스트의 협업 세션은 인증된 안전한 직접 연결만 허용합니다. 직접 연결 사용을 시도한 다음 연결할 수 없다면 사용을 중지합니다.
릴레이 호스트의 협업 세션은 직접 연결을 허용하지 않습니다. 호스트 컴퓨터의 포트는 열리지 않습니다. 항상 클라우드를 통해 연결합니다.

모드를 변경하려면 다음을 수행합니다.

VS:

  1. 도구 > 옵션 > Live Share로 이동합니다.
  2. “연결 모드” 드롭다운에서 모드를 선택합니다.
  3. 다시 시작 VS.

VS Code:

  1. settings.json을 편집합니다(파일 > 기본 설정 > 설정).
  2. 기본 설정에 맞게 "liveshare.connectionMode"를 "auto", "direct" 또는 "relay"로 설정합니다.
  3. VS Code를 다시 시작합니다.

연결 모드 관련 요구 사항

사용 중인 연결 모드에 따라 Live Share가 정상적으로 기능하는 데 필요한 구체적인 포트와 URL이 결정됩니다.

모드 클라이언트 액세스 요구 사항 문제 해결
모두 *.liveshare.vsengsaas.visualstudio.com:443에 대한 아웃바운드 액세스입니다. 회사 또는 개인 네트워크 방화벽을 통해 이 도메인에 연결할 수 있는지 확인합니다. 브라우저에서 https://visualstudio.microsoft.com/services/live-share/을 입력하고 Visual Studio Live Share 홈페이지로 연결되는지 확인합니다. 반드시 해결해야 하는 프록시 문제가 발생할 수도 있습니다.
모두(VS Code) download.microsoft.com:443에 대한 아웃바운드 액세스입니다. 회사 또는 개인 네트워크 방화벽을 통해 이 도메인에 연결할 수 있는지 확인합니다. 반드시 해결해야 하는 프록시 문제가 발생할 수도 있습니다.
자동 자동으로 전환합니다. 직접 및 릴레이 모드를 확인합니다. 문제를 해결하기 위해 직접 또는 릴레이 모드로 전환합니다.
Direct 호스트: 인바운드 로컬 네트워크 연결을 허용하려면 5990~5999 사이의 포트를 열어야 합니다.

게스트: 동일한 포트의 호스트에 대한 네트워크 경로 및 아웃바운드 액세스입니다.		 "vsls-agent"(VS의 경우), "코드"(Visual Studio Code의 경우) 또는 "코드 - 참가자"(Visual Studio Code 참가자의 경우)가 이 포트 범위에 대한 데스크톱 방화벽 소프트웨어에 의해 차단되지 않고 서로 ping할 수 있는지 확인합니다. Windows 및 기타 데스크톱 소프트웨어에서는 에이전트를 처음으로 시작할 때 메시지를 표시하지만, 그룹 정책에서 이를 금지하며 사용자가 항목을 수동으로 추가해야 하는 경우도 있습니다. 반드시 해결해야 하는 프록시 문제가 발생할 수도 있습니다.
릴레이 *.servicebus.windows.net:443에 대한 아웃바운드 액세스입니다. 회사 또는 개인 네트워크 방화벽을 통해 이 도메인에 연결할 수 있는지 확인합니다. 반드시 해결해야 하는 프록시 문제가 발생할 수도 있습니다.
모두 *.online.visualstudio.com에 대한 아웃바운드 액세스입니다. 회사 또는 개인 네트워크 방화벽을 통해 이 도메인에 연결할 수 있는지 확인합니다. 브라우저에서 https://sts.online.visualstudio.com/api/swagger/index.html을 입력하고 swagger 페이지로 연결되는지 확인합니다. 반드시 해결해야 하는 프록시 문제가 발생할 수도 있습니다.

방화벽 항목을 수동으로 추가

위에서 설명한 것처럼 직접 모드에서는 개인 방화벽에서 vsls-agent, 코드 또는 코드-내부자가 포트 범위 5990-5999의 연결을 수락하도록 허용해야 합니다. 직접 모드를 사용하고 싶지만 방화벽에 vsls-agent 항목이 없다면, 수동으로 추가할 수 있습니다. 수동 추가 방법은 방화벽 소프트웨어에 따라 다르지만 여기에서 Windows 방화벽을 구성하는 자세한 방법을 확인할 수 있습니다.

Vsls-agent 관련 항목이 표시되지 않는 경우 다음 위치 중 하나에서 에이전트 실행 파일을 찾을 수 있습니다.

VS Code 설치 위치

Windows, MacOS 또는 Linux에서 VS Code 또는 VS Code 참가자에 대해 방화벽을 수동으로 구성할 때 VS Code 앱 설치 위치의 경로를 사용합니다.

예: Windows(기본 설치 위치)

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

Visual Studio 에이전트 위치

Visual Studio 위치는 보다 동적이지만, 다음 단계를 수행하면 실행 파일을 찾을 수 있습니다.

  1. Visual Studio 설치 위치로 이동합니다. 대부분의 경우 C:\Program Files (x86)\Microsoft Visual Studio\EDITION이며, 여기서 EDITION은 Community나 Enterprise 등을 말합니다.

  2. IDE\Extensions 하위 폴더에서 vsls-agent.exe를 검색합니다.

안타깝지만 이 단계는 Visual Studio Live Share를 업데이트할 때마다 실행해야 합니다.

프록시

Visual Studio Live Share에는 현재 프록시 사용에 대한 몇 가지 제한 사항이 있습니다. 자동 프록시 설정은 Windows에서 작동해야 하지만 macOS 또는 Linux(및 Windows의 특정 프록시 구성)를 사용하는 경우 VS 또는 VS Code의 애플리케이션 > 프록시 설정에서 HTTP_PROXY 및 HTTPS_PROXY 환경 변수를 전역적으로 설정해야 합니다.

참고: 프록시가 VS Code의 애플리케이션 > 프록시 설정에서 구성되지 않은 경우 http_proxy 및 https_proxy 환경 변수에서도 상속됩니다.

프록시가 이러한 설정을 자동으로 설정하지 않는다면, 변수를 다음 형식으로 수동으로 설정할 수 있습니다.

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

인증 프록시가 있는 경우에는 다음과 같이 사용자와 암호를 추가할 수 있습니다.

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

이러한 설정으로도 문제가 해결되지 않는다면, 지원 개선을 위해 프록시 설정 세부 정보를 Microsoft에 알려주세요.

참고 항목

문제가 있으신가요? 문제 해결을 참조하거나 피드백을 제공해 주세요.