Linux 설치 정보Linux installation details

Linux는 가변성이 큰 환경이며 데스크톱 환경 및 배포 수가 너무 많아 작업하는 데 복잡할 수 있습니다.Linux is a highly variable environment and with the sheer number of desktop environments and distributions can be complicated to get working. 지원 되는 버전의 Ubuntu Desktop (16.04 +), CentOS 7또는 Fedora Workstation (27 이상)을 사용 하 고 VS Code의 공식 배포만 사용 하는 경우 프로세스를 바로 찾아야 합니다.If you stick to supported versions of Ubuntu Desktop (16.04+), CentOS 7, or Fedora Workstation (27+) and only use official distributions of VS Code, you should find the process straight forward. 그러나 비표준 구성 또는 다운스트림 배포를 사용하는 경우 일부 문제가 발생할 수도 발생하지 않을 수도 있습니다.However, in the event that you are using a non-standard configuration or downstream distribution, you may or may not run into some hiccups. 이 문서에서는 구성의 커뮤니티 에서만 지원 되는 경우에도 실행 하는 데 도움이 되는 요구 사항 및 문제 해결 세부 정보에 대해 설명 합니다.This document provides some information on requirements and some troubleshooting details that might help you get up and running even if your configuration is only community supported. Live Share는 64 비트 Linux만 지원 합니다.Note that Live Share only supports 64-bit Linux.

Linux 필수 구성 요소 설치Install Linux prerequisites

일부 Linux 배포에는 Live Share가 작동하는 데 필요한 라이브러리가 누락되어 있습니다.Some distributions of Linux are missing libraries Live Share needs to function. 기본적으로 Live Share는 Linux 필수 구성 요소를 탐지하여 설치하려고 합니다.By default, Live Share attempts to detect and install Linux prerequisites for you. Live Share에서 누락된 라이브러리로 인해 문제가 발생하는 경우 해당 라이브러리를 설치하는 데 필요한 권한을 요청하는 알림 메시지가 표시됩니다.You'll see a toast notification when Live Share encounters a problem that can originate from missing libraries asking you for permission to install them.

Linux 필수 구성 요소가 없다는 메시지를 표시 하는 알림 메시지

"설치"를 클릭 하면 OS에서 sudo (admin/root) 암호를 입력 하도록 요청 하는 메시지가 표시 됩니다.When you click "Install", a terminal window will appear where your OS will ask you to enter your admin / root (sudo) password to continue. 스크립트가 성공적으로 완료 되었다고 가정 하면 모두 설정 해야 한다는 메시지가 표시 되 면 Visual Studio Code를 다시 로드 합니다.Assuming the script completes successfully, reload Visual Studio Code when prompted you should be all set! 다른 힌트 및 해결 방법이 있는 경우 배포별 팁 을 확인하려 할 수도 있습니다.You may also want to check out tips by distribution for other hints and workarounds if any exist.

스크립트에서 배포를 지원하지 않는다는 메시지가 표시되면 커뮤니티가 공유한 커뮤니티 지원 배포 팁 을 참조하세요.If you see a message indicating the script does not support your distribution, see tips for community supported distributions for information the community has shared with us.

명령을 VS Code 실행 하지않으려는 경우 터미널 창에서 다음 명령을 사용 하 여 언제 든 지이 스크립트의 최신 버전을 다시 실행 하도록 선택할 수도 있습니다.If you prefer not to have VS Code run the command for you, you can also opt to re-run the very latest version of this script at any time manually by using the following command in a Terminal window:

wget -O ~/vsls-reqs https://aka.ms/vsls-linux-prereq-script && chmod +x ~/vsls-reqs && ~/vsls-reqs

배포용 팁Tips by distribution

위의 필수 구성 요소 설치 스크립트는 다양 한 배포를 다루지만 일반적으로 바닐라 설치에서 누락 된 항목을 확인할 수 있습니다.While the prerequisite install script above covers a variety of distributions, you may be wondering what is typically missing from vanilla installations. 다음 목록에서는 지정 된 배포를 새로 설치 하는 동안 누락 된 키 라이브러리를 보여 줍니다.The following list shows the key libraries that were missing in a fresh install of a given distribution. 이 목록에는 문제가 발생할 경우 시작 및 실행 하는 데 도움이 되는 몇 가지 팁도 제공 됩니다.The list also provides some tips that can help you get up and running if you hit a problem.

배포Distribution 누락 된 라이브러리 설치 바닐라Vanilla install missing libraries 추가 단계Additional steps
Ubuntu Desktop 18.04 (64 비트)Ubuntu Desktop 18.04 (64-bit) <none><none> <none><none>
Ubuntu Desktop 16.04 (64 비트)Ubuntu Desktop 16.04 (64-bit) <none><none> <none><none>
Kubuntu 18.04 (64 비트)Kubuntu 18.04 (64-bit) gnome-keyring desktop-file-utils <none><none>
Kubuntu 16.04 (64 비트)Kubuntu 16.04 (64-bit) gnome-keyring desktop-file-utils <none><none>
Xubuntu 18.04 (64 비트)Xubuntu 18.04 (64-bit) <none><none>
  • "세션 및 시작"의 "고급" 탭에서 "시작 시 GNOME 서비스 시작"이 선택 되어 있는지 확인 합니다.Ensure "Launch GNOME services on startup" is checked in the "Advanced" tab of "Session and Startup".
  • 로그인 문제가 발생 한 경우 seahorse를 설치 하 고 "암호 및 키"를 시작 하 고 "로그인" 인증 기능이 있는지 확인 하 고 잠금을 해제할 수 있는지 확인 합니다.If you run into sign-in trouble, install seahorse, start "Passwords and Keys", verify you have "Login" keyring and that you can unlock it.
Xubuntu 16.04 (64 비트)Xubuntu 16.04 (64-bit) <none><none>
  • "세션 및 시작"의 "고급" 탭에서 "시작 시 GNOME 서비스 시작"이 선택 되어 있는지 확인 합니다.Ensure "Launch GNOME services on startup" is checked in the "Advanced" tab of "Session and Startup".
  • 로그인 문제가 발생 한 경우 seahorse를 설치 하 고 "암호 및 키"를 시작 하 고 "로그인" 인증 기능이 있는지 확인 하 고 잠금을 해제할 수 있는지 확인 합니다.If you run into sign-in trouble, install seahorse, start "Passwords and Keys", verify you have "Login" keyring and that you can unlock it.
Mint 19 Cinnamon (64 비트)Mint 19 Cinnamon (64-bit) <none><none> <none><none>
Mint 18.3 Cinnamon (64 비트)Mint 18.3 Cinnamon (64-bit) <none><none> <none><none>
Debian 10 (Buster) 테스트 (64 비트)Debian 10 (Buster) Testing (64-bit) 릴리스가 안정적이 지 않아 알 수 없습니다.Release not stable, so unknown.
Debian 9 GNOME Desktop (64 비트)Debian 9 GNOME Desktop (64-bit) <none><none>
  • 자동 설치 스크립트를 사용 하려면 sudo를 설치 하 고 sudo 그룹에 사용자를 추가 해야 할 수 있습니다.You may need to install sudo and add your user to the sudo group to use the automated install script.
Fedora Workstation 29 (64 비트)Fedora Workstation 29 (64-bit) openssl-compat10 <none><none>
Fedora 워크스테이션 28 (64 비트)Fedora Workstation 28 (64-bit) <none><none> <none><none>
Fedora 워크스테이션 27 (64 비트)Fedora Workstation 27 (64-bit) <none><none> <none><none>
CentOS 7 GNOME Desktop (64 비트)CentOS 7 GNOME Desktop (64-bit) <none><none> <none><none>

다른 비 Debian/Ubuntu 또는 RHL 기반 배포에 대 한 정보는 커뮤니티 지원 배포판에 대 한 팁 을 참조 하세요.See tips for community supported distributions for information about other non-Debian / Ubuntu or RHL based distributions.

추가 세부 정보는 필요한 Live Share 특정 라이브러리에서 확인할 수도 있습니다.Additional details can also be found below on the specific libraries Live Share needs.

커뮤니티 지원 배포판에 대 한 팁Tips for community supported distros

Debian/Ubuntu 또는 RHL 트리 외부의 배포는 Visual Studio Code 또는 .NET Core에서 공식적으로 지원 되지 않습니다.Distributions outside of the Debian / Ubuntu or RHL trees are not officially supported by Visual Studio Code or .NET Core. 따라서 확장에 의해 Visual Studio Live Share는 공식적으로 지원 되지 않습니다.Therefore, by extension, they are not officially supported by Visual Studio Live Share either. 그러나 커뮤니티는 여러 추가 배포에 대 한 Live Share 실행 및 실행에 대 한 몇 가지 유용한 정보를 제공 합니다.However, the community has contributed some useful information about getting Live Share up and running on a number of additional distributions.

Pr 시작: 선호 하는 배포로이 정보를 업데이트 하는 데 관심이 있는 경우 문서 GitHub 리포지토리에서 이 파일 에 대 한 PR을 제출 하세요.PRs welcome: If you're interested in updating this information with your favorite distribution, submit a PR for this file in our docs GitHub repo. 선호 하는 배포를 지 원하는 종속성 설치 관리자를 가져오려는 경우에도 이 파일에 대 한PR을 제출할 수 있습니다.Even better, if you'd like to get the dependency installer supporting your favorite distribution, you can submit a PR for this file.

배포Distribution 작업?Working? 누락 된 라이브러리 설치 바닐라Vanilla install missing libraries 추가 단계Additional Steps
아키텍처 Linux (64 비트)Arch Linux (64-bit) Yes 잠기기.Varies. 가능한 라이브러리: gcr liburcu openssl-1.0 krb5 zlib icu gnome-keyring libsecret desktop-file-utils xorg-xpropPossible libraries: gcr liburcu openssl-1.0 krb5 zlib icu gnome-keyring libsecret desktop-file-utils xorg-xprop
Manjaro 17.1 (64 비트)Manjaro 17.1 (64-bit) Yes xorg-xprop liburcu
openSuSE LEAP 15 KDE (64 비트)openSuSE LEAP 15 KDE (64-bit) Yes libopenssl1_0_0 gnome-keyring
  • 필수 구성 요소 설치 스크립트에서 지원 됩니다.Supported by the prerequisite install script.
Sus 3 (64 비트)Solus 3 (64-bit) Yes xprop
  • 필수 구성 요소 설치 스크립트에서 지원 됩니다.Supported by the prerequisite install script.
  • 릴리스 57 이전의 vscode 패키지 버전에는 필요한 product. json 값이 없습니다 (아래 참조).Versions of the vscode package prior to release 57 were missing required product.json values (see below). 이 문제를 해결 하려면 vscode 패키지를 업그레이드 하십시오.Upgrade the vscode package to resolve this issue.
Gentoo (64 비트)Gentoo (64-bit) Yes 변수가 매우 높습니다.Highly variable. 누락 된 패키지: dev-libs/openssl-1.0.2 net-libs/libgsasl dev-libs/icu sys-libs/zlib sys-apps/util-linux app-crypt/libsecret gnome-base/gnome-keyring x11-apps/xpropPossible missing packages: dev-libs/openssl-1.0.2 net-libs/libgsasl dev-libs/icu sys-libs/zlib sys-apps/util-linux app-crypt/libsecret gnome-base/gnome-keyring x11-apps/xprop
  • Jorgicio 오버레이의 visual-studio-code 패키지는 작동 하는 것으로 알려져 있습니다.The visual-studio-code package in the jorgicio overlay is known to work.

필수 구성 요소 수동 설치Install prerequisites manually

Live Share의 종속성 설치 스크립트를 사용 하는 것이 좋지만이 섹션에서는 이러한 단계를 직접 수행 하거나 스크립트에서 지원 하지 않는 배포를 사용 하는 경우의 라이브러리 요구 사항에 대 한 자세한 정보를 제공 합니다.While we recommend using Live Share's dependency install script, this section provides further details on library requirements in the event you want perform these steps yourself or are using a distribution not supported by the script.

바닐라 설치에서 일반적인 누락 된 라이브러리는 커뮤니티에서 지 원하는 배포 섹션에 대 한 배포 및 팁의 에서 찾을 수 있습니다.Typical missing libraries in vanilla installations can be found in the tips by distribution and tips for community supported distributions sections.

자세한 라이브러리 요구 사항Detailed library requirements

Visual Studio Live Share의 기본 라이브러리 요구 사항은 .NET Core 2.1를 사용 하 고, 자격 증명을 유지 하 고, 브라우저 통합을 위해 제공 됩니다.Visual Studio Live Share's native library requirements come from its use of .NET Core 2.1, libsecret to persist credentials, and its browser integration. 다음 표에서는 .NET Core에서 공식적으로 지원 되는 배포에 대 한 이러한 요구 사항을 요약 합니다.The following table summarizes these requirements for distributions officially supported by .NET Core.

배포Distribution .NET Core 요구 사항.NET Core Reqs 자격 증명 저장소 요구 사항Credential Storage Reqs 브라우저 통합 요구 사항Browser Integration Reqs
Ubuntu 및 다운스트림 배포Ubuntu and downstream distributions libssl1.0.0 libkrb5-3 zlib1g libicu55 (Ubuntu 16.04, Mint 18.3) 또는 libicu57 (Ubuntu 17.10의 경우) 또는 libicu60 (Ubuntu 18.04, Mint 19의 경우)libssl1.0.0 libkrb5-3 zlib1g libicu55 (for Ubuntu 16.04, Mint 18.3) or libicu57 (for Ubuntu 17.10) or libicu60 (for Ubuntu 18.04, Mint 19) libsecret-1-0 gnome-keyring (또는 기능 비밀 지원 되는 인증 키-Kwallet은 기능 비밀을 지원 하지 않음)libsecret-1-0 gnome-keyring (or libsecret supported keyring - Kwallet does not support libsecret) desktop-file-utils x11-utils
Debian 9 및 다운스트림 배포Debian 9 and downstream distributions libssl1.0.2 libkrb5-3 zlib1g libicu57 libsecret-1-0 gnome-keyring (또는 기능 비밀 지원 되는 인증 키-Kwallet은 기능 비밀을 지원 하지 않음)libsecret-1-0 gnome-keyring (or libsecret supported keyring - Kwallet does not support libsecret) desktop-file-utils x11-utils
RHL/CentOS/FedoraRHL / CentOS/ Fedora openssl-libs krb5-libs zlib libicu Fedora에는 compat-openssl10도 필요 합니다.openssl-libs krb5-libs zlib libicu Fedora also requires compat-openssl10 libsecret gnome-keyring (또는 기능 비밀 지원 되는 인증 키-Kwallet은 기능 비밀을 지원 하지 않음)libsecret gnome-keyring (or libsecret supported keyring - Kwallet does not support libsecret) desktop-file-utils xorg-x11-utils
Alpine LinuxAlpine Linux openssl1.0 icu krb5 zlib libsecret gnome-keyring (또는 기능 비밀 지원 되는 인증 키-Kwallet은 기능 비밀을 지원 하지 않음)libsecret gnome-keyring (or libsecret supported keyring - Kwallet does not support libsecret) desktop-file-utils xprop

다른 배포에는 동일한 라이브러리가 필요 하지만 패키지 이름은 다를 수 있습니다.While other distributions require the same libraries, their package names may vary. 커뮤니티에서 지 원하는 배포에 대 한 팁 섹션에서 다음 중 일부를 찾을 수 있습니다.You can find some of these in the tips for community supported distributions section.

Debian/UbuntuDebian / Ubuntu

라이브러리는 터미널에서 sudo apt install <library-name>를 실행 하 여 Debian/Ubuntu 기반 배포에 설치할 수 있습니다.Libraries may be installed on Debian/Ubuntu based distributions by running sudo apt install <library-name> in a terminal.

Mint를 포함 하는 Ubuntu 기반 배포의 경우 다음을 실행 합니다.For Ubuntu based distributions including Mint, run:

sudo apt install libssl1.0.0 libkrb5-3 zlib1g libicu[0-9][0-9] gnome-keyring libsecret-1-0 desktop-file-utils x11-utils

Debian 9 및 비 Ubuntu 다운스트림 배포의 경우 다음을 실행 합니다.For Debian 9 and non-Ubuntu downstream distributions, run:

sudo apt install libssl1.0.2 libkrb5-3 zlib1g libicu57 gnome-keyring libsecret-1-0 desktop-file-utils x11-utils

Fedora/CentOS/RHLFedora / CentOS / RHL

라이브러리는 터미널에서 sudo yum install <library-name>를 실행 하 여 Fedora/CentOS/RHL 기반 배포에 설치할 수 있습니다.Libraries may be installed on Fedora/CentOS/RHL based distributions by running sudo yum install <library-name> in a terminal. 예를 들어, 다음과 같이 모든 항목을 설치 합니다.For example, this will install everything:

sudo yum install openssl-libs compat-openssl10 krb5-libs zlib libicu libsecret gnome-keyring desktop-file-utils xorg-x11-utils

OSS 문제 VS CodeVS Code OSS Issues

아키텍처 Linux/Manjaro 사용자: 이 문제를 방지 하려면 visual studio-bin AUR 패키지를 사용 합니다.Arch Linux/Manjaro Users: Use the visual-studio-bin AUR package to avoid this problem.

바닐라 또는 수정 된 버전의 VS Code OSS 인 Visual Studio Code 패키지에는 product.json 파일의 중요 한 값이 누락 되어 Visual Studio Live Share를 활성화할 수 없습니다.Packages of Visual Studio Code that are either vanilla or modified versions of VS Code OSS can be missing a critical value in product.json file that prevents Visual Studio Live Share from activating.

이 문제를 해결 하는 빠른 방법은 도움말 > "개발자 도구 전환"으로 이동 하 여 Live Share 확장이 "제안 된 API"를 사용 하 고 있기 때문에 활성화 되지 않았음을 나타내는 스택 추적을 확인 하는 것입니다.A quick way to see you might be hitting this problem is to go to Help > "Toggle Developer Tools" and see if you find a stack trace indicating the Live Share extension did not activate because it was using a "proposed API."

이것이 문제 인지 확인 하려면 product.json의 내용을 확인 합니다.To verify this is your issue, check the contents of product.json. 파일의 위치는 패키지에 따라 다르지만 일반적으로 다음 위치 중 하나에 있습니다.The file's location does vary by package, but it is usually in one of the following locations:

  • /usr/share/code/resources/app/product.json
  • /usr/share/vscode/resources/app/product.json

extensionAllowedProposedApi 속성이 없거나 "vsliveshare. vsliveshare"가 표시 되지 않는 경우이 문제가 발생 한 OSS 버전을 사용 하 고 있는 것입니다.If the extensionAllowedProposedApi property is missing or you do not see "ms-vsliveshare.vsliveshare" referenced, you are using an OSS version with this problem.

문제를 해결하려면 다음을 제품 json에 추가 하면 됩니다.As a workaround, you can add the following into the product.json:

    "extensionAllowedProposedApi": [
      "ms-vsliveshare.vsliveshare",
      "ms-vscode.node-debug",
      "ms-vscode.node-debug2"
 ]

사용 중인 배포가 작동 하는지 여부에 대 한 자세한 내용은 위의 항목을 참조 하세요.See above for additional details on whether the distribution you are using is known to work.

Linux 브라우저 통합Linux browser integration

Visual Studio Live Share에는 일반적으로 Linux에서 브라우저 통합을 사용하기 위한 추가 설치 단계가 필요하지 않습니다.Visual Studio Live Share typically does not require additional installation steps to enable browser integration on Linux.

이를 위해 Live Share는 자동으로 데스크톱 파일을 ~/.local/share/applications에 배치 하 고 확장이 처음 초기화 될 때 ~/.local/share/vsliveshare에 필수 시작 관리자를 자동으로 배치 합니다.To accomplish this, Live Share automatically places a desktop file in ~/.local/share/applications and the required launcher itself in ~/.local/share/vsliveshare when the extension first initializes. 이 작업이 성공 하면 사용자에 게 아무런 조치도 필요 하지 않습니다.No action is required on your part if this succeeds.

경우에 따라 배포는이 위치를 지원 하지 않거나 바닐라 설치 작업을 수행 하기 위해 조정 해야 합니다.In some cases, distributions either do not support this location or require tweaks to get it to work with their vanilla installs. 이 경우 Live Share는 대신 /usr/local/share를 사용 하는 것으로 대체 됩니다.In these cases, Live Share falls back to using /usr/local/share instead. 따라서 설치 프로세스를 완료 하려면 sudo (관리자) 암호가 필요 하다는 알림이 표시 될 수 있습니다.As a result, you may be notified that your admin (sudo) password is required to complete the installation process. 터미널 창이 표시돼 브라우저 시작 관리자를 설치할 위치를 알려줍니다.A terminal window will appear telling you where the browser launcher will be installed. 메시지가 표시되면 단순히 암호를 입력하고 설치가 완료되면 Enter 키를 눌러 터미널 창을 닫습니다.Simply enter your password when prompted and press enter once the installation completes to close the terminal window.

대신 직접 명령을 실행 하려면 "복사"를 클릭 합니다. 그러면 터미널 명령이 클립보드에 복사 됩니다.If you'd prefer to run the command yourself instead, you can click "Copy instead" which will copy the terminal command to the clipboard instead.

마지막으로이 단계를 완전히 건너뛰려면 수동으로 공동 작업 세션을 조인할수 있지만 브라우저에서 초대 링크를 열어 조인할 수는 없습니다.Finally, if you opt to skip this step entirely, you can still join collaboration sessions manually, but you will not be able to join by opening an invite link in the browser. Ctrl + shift + p/Cmd + shift + P 를 누르고 "Live Share: 시작 관리자 설정" 명령을 선택 하 여 나중에 언제 든 지 명령에 다시 액세스할 수 있습니다.Note that you can always access the command again later, by hitting Ctrl+Shift+P / Cmd+Shift+P and selecting the "Live Share: Launcher Setup" command.

참조See also

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