Visual Studio에서 대상 Linux 시스템에 연결

  • 아티클

Linux 지원은 Visual Studio 2017 이상에서 사용할 수 있습니다.

원격 머신 또는 WSL(Linux용 Windows 하위 시스템)을 대상으로 하도록 Linux 프로젝트를 구성할 수 있습니다. 원격 머신 및 WSL에 대해 Visual Studio 2017에서 원격 연결을 설정해야 합니다.

원격 머신 또는 WSL(Linux용 Windows 하위 시스템)을 대상으로 하도록 Linux 프로젝트를 구성할 수 있습니다. 원격 머신에 대해 Visual Studio에서 원격 연결을 설정해야 합니다. WSL에 연결하려면 WSL에 연결 섹션으로 건너뜁니다.

원격 연결을 사용하는 경우 Visual Studio C++는 원격 머신에 Linux 프로젝트를 빌드합니다. 물리적 컴퓨터인지, 클라우드의 가상 머신인지, WSL인지는 중요하지 않습니다. 프로젝트를 빌드하기 위해 Visual Studio는 소스 코드를 원격 Linux 컴퓨터에 복사합니다. 그런 다음 Visual Studio 설정에 따라 코드를 컴파일합니다.

참고

Visual Studio 2019 버전 16.5부터 Visual Studio는 원격 개발을 위해 Linux 시스템에 대한 안전한 FIPS(Federal Information Processing Standard) 140-2 규격 암호화 연결을 지원합니다. FIPS 규격 연결을 사용하려면 대신 FIPS 규격 보안 원격 Linux 개발 설정의 단계를 따르세요.

원격 시스템에서 SSH 서버 설정

Linux 시스템에서 ssh를 아직 설정하지 않은 상태로 실행한 경우 다음 단계에 따라 설치합니다. 이 문서의 예제에서는 OpenSSH 서버 버전 7.6과 함께 Ubuntu 18.04 LTS를 사용합니다. 그러나 OpenSSH의 비교적 최근 버전을 사용하는 모든 배포판에 대한 지침은 동일해야 합니다.

  1. Linux 시스템에서 OpenSSH 서버를 설치하고 시작합니다.

    sudo apt install openssh-server
sudo service ssh start

  2. 시스템이 부팅될 때 SSH 서버가 자동으로 시작되도록 하려면 systemctl을 사용하여 사용하도록 설정합니다.

    sudo systemctl enable ssh

원격 연결 설정

  1. Visual Studio의 메뉴 모음에서 도구 > 옵션을 선택하여 옵션 대화 상자를 엽니다. 그런 다음, 플랫폼 간 > 연결 관리자를 선택하여 연결 관리자 대화 상자를 엽니다.

    이전에 Visual Studio에서 연결을 설정하지 않은 경우 프로젝트를 처음 빌드할 때 Visual Studio에서 연결 관리자 대화 상자를 엽니다.

  2. 연결 관리자 대화 상자에서 추가 단추를 선택하여 새 연결을 추가합니다.

    Visual Studio 옵션 창의 스크린샷. CrossPlatform > C++ > 연결 관리자 선택되고 추가 단추가 강조 표시됩니다.

    어느 쪽 경우이든 원격 시스템에 연결 창이 표시됩니다.

    Visual Studio에서 원격 시스템으로 커넥트 창의 스크린샷 호스트 이름, 포트, 사용자 이름, 인증 유형 및 암호에 대한 필드가 있습니다. 포트는 22로 설정됩니다. 인증 유형이 '암호'로 설정됩니다. :::image-end:::

  3. 다음 정보를 입력합니다.

    입력 설명
    호스트 이름 대상 디바이스의 이름 또는 IP 주소
    포트 SSH 서비스가 실행되는 포트(일반적으로 22)
    사용자 이름 인증할 사용자
    인증 형식 암호 및 프라이빗 키가 모두 지원됨
    암호 입력한 사용자 이름의 암호
    프라이빗 키 파일 SSH 연결을 위해 생성된 프라이빗 키 파일
    암호 위에서 선택한 프라이빗 키와 함께 사용된 암호

    인증을 위해 암호 또는 키 파일과 암호를 사용할 수 있습니다. 대부분의 개발 시나리오에서는 암호 인증으로 충분하지만 키 파일은 더 안전합니다. 키 쌍이 이미 있는 경우 다시 사용할 수 있습니다.

    17.10 이전 버전의 Visual Studio는 원격 연결에 대한 EC, RSA 및 DSA 키를 지원합니다. 보안 문제로 인해 VS 17.10 이상에서는 RSA 및 DSA 키가 더 이상 지원되지 않습니다. 현재 EC 키만 지원됩니다. 연결 관리자와 호환되는 키 쌍을 만들려면 다음 명령을 사용합니다. ssh-keygen -m pem -t ecdsa -f <key-name>

    참고 항목

    프라이빗 키를 만드는 데 사용하는 ssh-keygen 경우 스위치 -m pem를 지정해야 합니다. 그렇지 않으면 Visual Studio에서 키를 수락하지 않습니다. 프라이빗 키로 시작하는 경우 .으로 -----BEGIN OPENSSH PRIVATE KEY-----ssh-keygen -p -f <FILE> -m pem변환해야 합니다.

  4. 연결 단추를 선택하여 원격 컴퓨터에 대한 연결을 시도합니다.

    연결에 성공하면 Visual Studio에서 원격 헤더를 사용하도록 IntelliSense를 구성합니다. 자세한 내용은 원격 시스템의 헤더에 대한 IntelliSense를 참조하세요.

    연결이 실패하면 변경해야 하는 입력 상자에 빨간색 윤곽선이 표시됩니다.

    Visual Studio에서 원격 시스템으로 커넥트 창의 스크린샷 호스트 이름 및 포트 필드는 잘못된 항목을 나타내기 위해 빨간색으로 표시됩니다.

    인증을 위해 키 파일을 사용하는 경우 대상 머신의 SSH 서버가 실행 중이고 올바르게 구성되었는지 확인합니다.

    localhost에서 WSL에 연결하는 데 문제가 있는 경우 WSL localhost 연결 문제 해결을 참조하세요.

호스트 키 확인

Visual Studio 버전 16.10 이상에서는 Visual Studio가 처음으로 원격 시스템에 연결할 때마다 서버의 호스트 키 지문 확인하라는 메시지가 표시됩니다. 이전에 OpenSSH 명령줄 클라이언트 또는 PuTTY를 사용한 경우 이 프로세스에 익숙할 수 있습니다. 지문은 서버를 식별합니다. Visual Studio는 신뢰할 수 있으며 의도하는 서버에 연결되도록 보장하기 위해 지문을 사용합니다.

Visual Studio가 처음으로 새 원격 연결을 설정하면 서버에서 제공하는 호스트 키 지문 수락하거나 거부하라는 메시지가 표시됩니다. 또는 캐시된 지문이 변경될 때 이 메시지가 표시됩니다. 연결 관리자에서 연결을 선택하고 확인을 클릭하여 필요할 때 지문을 확인할 수도 있습니다.

이전 버전에서 Visual Studio 16.10 이상으로 업그레이드하는 경우 기존 원격 연결이 새 연결로 취급됩니다. 먼저 호스트 키 지문 수락하라는 메시지가 표시됩니다. 그러면 Visual Studio는 연결을 설정하고 수락된 지문을 캐시합니다.

update 인수를 사용하여 ConnectionManager.exe에서 원격 연결을 업데이트할 수도 있습니다.

지원되는 SSH 알고리즘

Visual Studio 버전 16.9부터 데이터 및 교환 키를 암호화하는 데 사용되는 이전의 비보안 SSH 알고리즘에 대한 지원이 제거되었습니다. 다음 알고리즘만 지원됩니다. 클라이언트-서버 및 서버-클라이언트 SSH 통신 모두에 대해 지원됩니다.

알고리즘 형식 지원되는 알고리즘
암호화 aes128-cbc
aes128-ctr
aes192-cbc
aes192-ctr
aes256-cbc
aes256-ctr
HMAC hmac-sha2-256
hmac-sha2-512
키 교환 diffie-hellman-group14-sha256
diffie-hellman-group16-sha512
diffie-hellman-group-exchange-sha256
ecdh-sha2-nistp256
ecdh-sha2-nistp384
ecdh-sha2-nistp521
호스트 키 ecdsa-sha2-nistp256
ecdsa-sha2-nistp384
ecdsa-sha2-nistp521

SSH 서버 구성

먼저 약간의 배경 설명입니다. Visual Studio에서 사용할 SSH 알고리즘을 선택할 수 없습니다. 대신, SSH 서버를 사용하여 초기 핸드셰이크 중에 알고리즘이 결정됩니다. 각 측면(클라이언트 및 서버)은 지원하는 알고리즘의 목록을 제공합니다. 그러면 두 목록에서 공통된 첫 번째 알고리즘이 선택됩니다. Visual Studio와 서버 사이에 암호화, HMAC, 키 교환 등을 위한 공통된 알고리즘이 하나 이상 있는 경우에는 연결에 성공합니다.

Open SSH 구성 파일( sshd_config )은 기본적으로 사용할 알고리즘을 구성하지 않습니다. 지정된 알고리즘이 없으면 SSH 서버에서 보안 기본값을 사용해야 합니다. 이러한 기본값은 SSH 서버의 버전과 공급업체에 따라 다릅니다. Visual Studio가 이러한 기본값을 지원하지 않는 경우 다음과 같은 오류가 발생할 수 있습니다. “원격 시스템에 연결할 수 없습니다. 공통 클라이언트-서버 HMAC 알고리즘을 찾을 수 없습니다.” SSH 서버가 Visual Studio에서 지원하지 않는 알고리즘을 사용하도록 구성된 경우에도 오류가 나타날 수 있습니다.

대부분의 최신 Linux 배포판의 기본 SSH 서버는 Visual Studio와 작동합니다. 그러나 안전하지 않은 이전 알고리즘을 사용하도록 구성된 이전 SSH 서버를 실행하고 있을 수 있습니다. 다음 예제에서는 좀 더 안전한 버전으로 업데이트하는 방법을 설명합니다.

다음 예제에서 SSH 서버는 Visual Studio 16.9에서 지원하지 않는 안전하지 hmac-sha1 않은 알고리즘을 사용합니다. SSH 서버에서 OpenSSH를 사용하는 경우 아래와 같이 /etc/ssh/sshd_config 파일을 편집하여 더 안전한 알고리즘을 사용하도록 설정할 수 있습니다. 다른 SSH 서버를 구성하는 방법은 해당 서버의 설명서를 참조하세요.

먼저, 서버에서 사용 중인 알고리즘 세트에 Visual Studio에서 지원되는 알고리즘이 포함되어 있는지 확인합니다. 서버에서 지원되는 알고리즘을 나열하려면 원격 머신에서 다음 명령을 실행합니다.

ssh -Q cipher; ssh -Q mac; ssh -Q kex; ssh -Q key

이 명령은 다음 출력을 생성합니다.

3des-cbc
aes128-cbc
aes192-cbc
aes256-cbc
...
ecdsa-sha2-nistp521-cert-v01@openssh.com
sk-ecdsa-sha2-nistp256-cert-v01@openssh.com

SSH 서버에서 지원되는 모든 암호화, HMAC, 키 교환, 호스트 키 알고리즘이 출력에 나열됩니다. 목록에 Visual Studio에서 지원하는 알고리즘이 포함되어 있지 않으면 계속하기 전에 SSH 서버를 업그레이드합니다.

원격 머신에서 /etc/ssh/sshd_config를 편집하여 Visual Studio에서 지원되는 알고리즘을 사용하도록 설정할 수 있습니다. 다음 예제는 해당 구성 파일에 다양한 유형의 알고리즘을 추가하는 방법을 보여 줍니다.

이러한 예제는 /etc/ssh/sshd_config의 어느 위치에나 추가할 수 있습니다. 별도의 줄에 위치하도록 해야 합니다.

파일을 편집한 후에는 SSH 서버를 다시 시작하고(Ubuntu의 경우 sudo service ssh restart) Visual Studio에서 다시 연결을 시도합니다.

암호화 예제

추가: Ciphers <algorithms to enable>
예: Ciphers aes128-cbc,aes256-cbc

HMAC 예제

추가: MACs <algorithms to enable>
예: MACs hmac-sha2-256,hmac-sha2-512

키 교환 예제

추가: KexAlgorithms <algorithms to enable>
예: KexAlgorithms ecdh-sha2-nistp256,ecdh-sha2-nistp384

호스트 키 예제

추가: HostKeyAlgorithms <algorithms to enable>
예: HostKeyAlgorithms ecdsa-sha2-nistp256,ecdsa-sha2-nistp384

원격 연결에 대한 로깅

로깅을 활성화하여 연결 문제를 해결할 수 있습니다. 메뉴 모음에서 도구 > 옵션을 선택합니다. 옵션 대화 상자에서 플랫폼 간 > 로깅을 선택합니다.

Visual Studio 옵션 화면의 스크린샷.

로그에는 연결, 원격 머신으로 전송되는 모든 명령(해당 텍스트, 종료 코드, 실행 시간), Visual Studio에서 셸로 전송되는 모든 출력이 포함됩니다. 로깅은 Visual Studio의 모든 플랫폼 간 CMake 프로젝트 또는 MSBuild 기반 Linux 프로젝트에 대해 작동합니다.

파일 또는 출력 창의 플랫폼 간 로깅 창에 출력되도록 구성할 수 있습니다. MSBuild 기반 Linux 프로젝트의 경우 원격 머신으로 전송된 MSBuild 명령은 Out of Process로 내보내므로 출력 창으로 라우팅되지 않습니다. 대신 “msbuild_” 접두사가 포함된 형태로 파일에 기록됩니다.

연결 관리자에 대한 명령줄 유틸리티

Visual Studio 2019 버전 16.5 이상: ConnectionManager.exe는 Visual Studio 외부에서 원격 개발 연결을 관리하는 명령줄 유틸리티입니다. 새 개발 컴퓨터를 프로비저닝하는 등의 작업에 유용합니다. 또는 연속 통합을 위해 Visual Studio를 설정하는 데 사용할 수 있습니다. ConnectionManager 명령에 대한 예제 및 전체 참조는 ConnectionManager 참조를 참조하세요.

TCP 포트 전달

rsync 명령은 MSBuild 기반 Linux 프로젝트 및 CMake 프로젝트 모두에서 IntelliSense에 사용할 원격 시스템의 헤더를 Windows에 복사하는 데 사용됩니다. TCP 포트 전달을 사용하도록 설정할 수 없는 경우 원격 헤더의 자동 다운로드를 사용하지 않도록 설정합니다. 이 기능을 사용하지 않도록 설정하려면 도구 > 옵션 > 플랫폼 간 > 연결 관리자 > 원격 헤더 IntelliSense 관리자를 사용합니다. 원격 시스템에 TCP 포트 전달을 사용하도록 설정하지 않은 경우 IntelliSense에 대한 원격 헤더 다운로드가 시작될 때 이 오류가 나타납니다.

SSH 채널을 열 수 없다는 Visual Studio 오류 메시지의 스크린샷 로그 파일의 경로가 제공됩니다.

rsync는 원격 시스템에 소스 파일을 복사하기 위한 Visual Studio의 CMake 지원에도 사용됩니다. TCP 포트 전달을 사용하도록 설정할 수 없는 경우 sftp를 원격 소스 복사 방법으로 사용할 수 있습니다. sftp는 대개 rsync보다 느리지만, TCP 포트 전달에 대한 종속성이 없습니다. CMake 설정 편집기에서 remoteCopySourcesMethod 속성을 사용하여 원격 소스 복사 방법을 관리할 수 있습니다. 원격 시스템에서 TCP 포트 전달을 사용하지 않도록 설정하면 처음 호출 rsync할 때 CMake 출력 창에 오류가 표시됩니다.

Rsync 오류 메시지를 표시하는 Visual Studio 출력 창의 스크린샷

gdbserver는 임베디드 디바이스에서 디버그하는 데 사용할 수 있습니다. TCP 포트 전달을 사용하도록 설정할 수 없는 경우 모든 원격 디버깅 시나리오에 대해 gdb를 사용해야 합니다. gdb는 원격 시스템에서 프로젝트를 디버그할 때 기본적으로 사용됩니다.

Visual Studio의 Linux 지원에는 TCP 포트 전달에 대한 종속성이 있습니다. 원격 시스템에서 TCP 포트 전달이 사용되지 않는 경우 rsync 및 gdbserver가 모두 영향을 받습니다. 이 종속성의 영향을 받는 경우 개발자 커뮤니티에서 이 제안 티켓에 투표하세요.

WSL에 연결

Visual Studio 2017에서는 원격 Linux 머신에 사용하는 것과 같은 단계를 사용하여 WSL에 연결합니다. 호스트 이름에 localhost를 사용합니다.

Visual Studio 2019 버전 16.1부터 Visual Studio는 WSL(Linux용 Windows 하위 시스템)과 함께 C++를 사용하기 위한 네이티브 지원을 제공합니다. 즉, 로컬 WSL 설치에서 직접 빌드 및 디버그할 수 있습니다. 더 이상 원격 연결을 추가하거나 SSH를 구성할 필요가 없습니다. 자세한 내용은 여기서 WSL 설치 방법을 참조하세요.

Visual Studio에서 작동하도록 WSL 설치를 구성하려면 gcc 또는 clang, gdb, make, ninja-build(Visual Studio 2019 버전 16.6 이상을 사용하는 CMake 프로젝트에만 필요), rsync, zip 도구가 설치되어 있어야 합니다. g++ 컴파일러도 설치하는 이 명령을 사용하여 apt를 사용하는 배포판에 설치할 수 있습니다.

sudo apt install g++ gdb make ninja-build rsync zip

WSL localhost 연결 문제 해결

localhost에서 WSL(Linux용 Windows 하위 시스템)에 연결할 때 포트 22에서 Windows ssh 클라이언트와 충돌이 발생할 수 있습니다. WSL의 /etc/ssh/sshd_config에서 ssh가 요청을 기다리는 포트를 23으로 변경합니다.

Port 23

암호를 사용하여 연결하는 경우 /etc/ssh/sshd_config에 다음이 설정되었는지 확인합니다.

# To disable tunneled clear text passwords, change to no here!
PasswordAuthentication yes

변경을 완료한 후 SSH 서버(Ubuntu의 sudo service ssh restart)를 다시 시작합니다.

그런 다음 포트 23을 사용하여 localhost 연결을 다시 시도합니다.

자세한 내용은 Linux 작업 다운로드, 설치, 설정을 참조하세요.

WSL에 대해 MSBuild 프로젝트를 구성하려면 Linux 프로젝트 구성을 참조하세요. WSL에 대해 CMake 프로젝트를 구성하려면 Linux CMake 프로젝트 구성을 참조하세요. WSL을 사용하여 간단한 콘솔 애플리케이션을 만드는 단계별 지침을 따르려면 Visual Studio 2019 및 WSL(Linux용 Windows 하위 시스템)의 C++에 대한 소개 블로그 게시물을 참조하세요.

참고 항목

Linux 프로젝트 구성
Linux CMake 프로젝트 구성
Linux 프로젝트 배포, 실행 및 디버그
CMake 디버깅 세션 구성