문서의 이전 판입니다!

목차

Visual Studio용 Remote .NET Debugger 확장

ComfilePi와 같은 원격 장치에서 실행 중인 .NET 5 이상 응용 프로그램은 수동으로 배포하고 실행한 뒤 디버거를 연결하여 디버깅할 수 있습니다.

하지만 Visual Studio 2022 및 2026에는 이러한 과정을 한 번에 수행하는 기능이 기본적으로 제공되지 않습니다.

ComfileTech Remote .NET Debugger는 이러한 불편함을 해결하기 위해 개발된 Visual Studio 확장 프로그램입니다.

이 확장 프로그램을 설치하면 Visual Studio에서 버튼 클릭 또는 F5 키만으로 다음 작업을 자동으로 수행할 수 있습니다.

  • 응용 프로그램 빌드
  • 원격 장치로 배포
  • 응용 프로그램 실행
  • 디버거 연결

이를 통해 로컬 PC에서 개발하는 것과 유사한 방식으로 원격 장치에서 실행 중인 .NET 응용 프로그램을 디버깅할 수 있습니다.

이 확장 프로그램은 .NET 5 이상을 지원합니다.

.NET Framework 4.x 및 Mono 환경을 사용한다면 Remote Mono Debugger Visual Studio 확장을 사용하시기 바랍니다.

다운로드 및 설치

다운로드 날짜 릴리즈 노트
ComfileTech.RemoteDotnetDebugger_v1.5.vsix 2026-01-28 릴리즈 노트
ComfileTech.RemoteDotnetDebugger_v1.4.vsix 2025-09-24 릴리즈 노트
ComfileTech.RemoteDotnetDebugger_v1.3.vsix 2025-07-21 릴리즈 노트
ComfileTech.RemoteDotnetDebugger_v1.2.vsix 2025-06-04 릴리즈 노트
ComfileTech.RemoteDotnetDebugger_v1.1.vsix 2025-04-29 릴리즈 노트

설치하려면 Visual Studio를 모두 종료한 후 .vsix 파일을 더블 클릭하면 됩니다.

요구 사항

개발 PC

  • Windows 10 이상 (64비트)
  • Visual Studio 2022 또는 Visual Studio 2026

대상 장치

  • SSH 서버 실행 중
  • .NET Runtime 또는 .NET SDK 설치
  • vsdbg 설치

vsdbg 설치 방법은 vsdbg 설치 항목을 참고하시기 바랍니다.

SSH 인증

보안상의 이유로 Windows에 포함된 OpenSSH는 비밀번호를 코드에 저장하여 사용하는 인증 방식을 허용하지 않습니다.

따라서 본 확장 프로그램을 사용하려면 개발 PC와 원격 장치 간의 SSH 인증이 공개키(Public Key)와 개인키(Private Key)를 이용하는 방식으로 구성되어 있어야 합니다.

ComfilePi 또는 Raspberry Pi를 사용하는 경우, 새로운 운영체제 이미지를 설치할 때 Raspberry Pi Imager에서 매우 쉽게 설정할 수 있습니다.

자세한 내용은 Raspberry Pi 공식 문서를 참고하시기 바랍니다.

개발 PC의 Windows 터미널에서 ssh 명령을 실행하여 원격 장치에 접속해 보십시오.

비밀번호를 묻지 않고 바로 접속되어야 정상적으로 설정된 것입니다.

vsdbg 설치

원격 장치에는 Microsoft의 .NET 디버거인 vsdbg가 설치되어 있어야 합니다.

Trixie 및 Bookworm

ComfilePi Trixie 또는 Bookworm 운영체제를 사용하는 경우 vsdbg는 기본적으로 설치되어 있으며 다음 위치에 있습니다. 

/opt/Microsoft/vsdbg/vsdbg

만약 설치되어 있지 않다면 다음 명령으로 설치할 수 있습니다. 

sudo apt install cpi-vsdbg

기타 운영체제

다른 Linux 운영체제를 사용하는 경우 아래 절차에 따라 설치하십시오.

  1. wget https://aka.ms/getvsdbgsh 명령으로 설치 스크립트를 다운로드합니다.
  2. chmod +x getvsdbgsh 명령으로 실행 권한을 부여합니다.
  3. sudo ./getvsdbgsh -v latest -l /opt/Microsoft/vsdbg 명령으로 설치합니다.

설치 경로는 원하는 위치로 변경할 수 있지만, 이후 Launch Profile 설정 시 해당 경로를 정확히 입력해야 합니다.

설정 및 사용 방법

확장 프로그램을 설치하고 SSH 통신이 정상적으로 동작하는 것을 확인한 후에는 프로젝트에 새로운 .NET Remote Debugger Launch Profile을 추가하면 됩니다.

일반적으로 다음 세 가지 항목만 설정하면 됩니다.

  • Remote Machine
  • Remote User
  • Path to vsdbg

Path to vsdbg에는 설치 폴더가 아니라 vsdbg 실행 파일의 전체 경로를 입력해야 합니다.

예를 들어 vsdbg를 다음 위치에 설치했다면 

/opt/Microsoft/vsdbg

실행 파일 경로는 다음과 같이 입력해야 합니다. 

/opt/Microsoft/vsdbg/vsdbg

문제 해결

문제가 발생하면 Visual Studio의 Remote .NET Debugger 출력 창을 확인하십시오.

출력 창에는 원격 연결, 배포 및 디버깅 과정에서 발생한 오류 정보가 표시됩니다.