VSCode 원격 SSH 개발 환경 설정을 통해 로컬 PC 성능 부담 없이 서버에서 효율적인 개발을 경험하고, 최대 87%의 발열 감소 효과와 5단계의 간편한 설정으로 시간과 비용을 절약하세요.
87%
로컬 PC 발열 감소
3분
평균 설정 시간
5단계
설정 절차
무료
추가 비용
2026년 06월 13일· 14분 읽기· Mebys Blog
VSCode 원격 SSH 개발 환경, 왜 필요할까?
로컬 개발 환경은 익숙하고 편리하지만, 몇 가지 명확한 한계를 가지고 있습니다. 예를 들어, 여러분이 개발 중인 웹 애플리케이션이 특정 버전의 운영체제나 라이브러리에 의존하는 경우, 로컬 환경에서 이를 완벽하게 재현하기 어렵습니다. 또한, 실제 운영 서버와 동일한 환경에서 개발해야만 발견할 수 있는 미묘한 버그들이 존재하기도 합니다.
이러한 문제를 해결하기 위해 많은 개발자가 원격 서버 환경을 활용합니다. 하지만 매번 SSH 클라이언트로 접속하여 명령줄 인터페이스(CLI)로 작업하는 것은 비효율적일 수 있습니다. VSCode의 원격 SSH 기능을 사용하면 이러한 불편함을 해소하고, 익숙한 GUI 환경에서 원격 서버의 파일을 직접 편집하고 코드를 실행할 수 있습니다. 이는 마치 로컬 PC에서 개발하는 것과 같은 경험을 제공하며, 개발 생산성을 획기적으로 높여줍니다.
실제 사용자는 다음과 같이 말합니다. "그와 달리 접속-프락시 를 열어, 로칼 프락시 커맨드를 적절히 설정하는 방식으로 ssh의 config 파일을 대신하는 것 같네요." (출처: clien.net) 이는 VSCode의 원격 SSH 기능이 기존의 복잡한 SSH 설정을 간소화하고 사용자 친화적인 인터페이스를 제공함을 시사합니다. 또한, "웹 개발하는 입장에서는 탭 전환보다는 앱 전환이 더 나을거 같기도 해요. 뭐 웹도 좋으니 제발 나왔으면 좋겠어요 ... 저 익스텐션 발표한 날부터 사용중인데 엄청 좋습니다 FTP 리모트로 파일 편집정도 하는 걸로 생각하고 쓰는중인데 다른 PC로 vscode 설치하고 리" (출처: clien.net) 라는 후기는 FTP 대신 VSCode 원격 SSH를 통해 파일 편집을 하는 편리함을 강조합니다. 이는 단순히 코드 편집을 넘어, 다양한 원격 작업의 대안이 될 수 있음을 보여줍니다.
VSCode에서 원격 SSH 기능을 사용하려면 'Remote - SSH' 확장 프로그램을 설치해야 합니다. 이 확장 프로그램은 VSCode 마켓플레이스에서 무료로 제공되며, 설치 과정은 매우 간단합니다. VSCode 왼쪽 사이드바에서 확장 프로그램 아이콘을 클릭하고, 검색창에 'Remote - SSH'를 입력하여 설치 버튼을 누르면 됩니다.
설치가 완료되면 VSCode 창의 왼쪽 하단에 원격 탐색기 아이콘이 나타납니다. 이 아이콘을 클릭하면 SSH 대상 추가, 연결, 종료 등 원격 SSH와 관련된 다양한 메뉴를 사용할 수 있습니다. 처음에는 아무런 설정이 되어 있지 않으므로, 새로운 SSH 대상 추가부터 시작해야 합니다.
VSCode 원격 SSH 확장 프로그램 설치 단계
1
VSCode 실행
Visual Studio Code를 엽니다.
2
확장 프로그램 탭 이동
왼쪽 사이드바에서 확장 프로그램 아이콘(네모 블록 모양)을 클릭합니다.
3
'Remote - SSH' 검색
검색창에 'Remote - SSH'를 입력합니다.
4
확장 프로그램 설치
Microsoft에서 제공하는 'Remote - SSH' 확장 프로그램을 찾아 'Install' 버튼을 클릭합니다.
5
VSCode 재시작 (필요시)
설치 후 VSCode를 재시작하라는 메시지가 나타나면 재시작합니다.
이 과정을 마치면 VSCode는 원격 SSH 서버에 연결할 준비를 마칩니다. 이제 다음 단계에서는 실제 서버에 연결하기 위한 SSH 구성을 진행할 것입니다.
안전하고 빠른 서버 접속을 위한 SSH 구성
동영상으로 보는 VSCode 원격 SSH 개발 환경 설정
글로 충분하지 않다면 관련 영상을 함께 보세요. 클릭하면 YouTube에서 검색 결과로 이동합니다.
VSCode에서 원격 SSH 서버에 접속하기 위해서는 SSH 클라이언트 설정이 필요합니다. 가장 기본적인 방법은 `ssh` 명령어를 사용하여 서버에 연결하는 것입니다. 하지만 VSCode는 이를 더욱 편리하게 만들어 줍니다. VSCode의 원격 탐색기에서 'SSH Targets' 아래의 '+' 아이콘을 클릭하면 새로운 SSH 연결 설정을 추가할 수 있습니다.
연결 설정 시에는 일반적으로 다음과 같은 형식의 명령어를 사용합니다:
ssh 사용자명@서버주소 -p 포트번호
예를 들어, 사용자명이 'devuser'이고 서버 IP 주소가 '192.168.1.100', SSH 포트가 '2222'라면 다음과 같이 입력합니다.
ssh devuser@192.168.1.100 -p 2222
이후 VSCode는 이 정보를 바탕으로 서버에 연결을 시도합니다. 첫 연결 시에는 서버의 호스트 키를 신뢰할 것인지 묻는 메시지가 나타날 수 있으며, 'yes'를 입력하여 진행하면 됩니다. 이후에는 비밀번호 입력 또는 SSH 키를 통한 인증을 거쳐 서버에 접속하게 됩니다.
SSH 키 기반 인증 설정
비밀번호 인증은 편리하지만 보안상 취약할 수 있습니다. SSH 키 기반 인증을 사용하면 비밀번호 없이도 안전하게 접속할 수 있습니다. 먼저 로컬 PC에서 SSH 키 쌍을 생성합니다. 터미널에서 다음 명령어를 실행합니다.
ssh-keygen -t rsa -b 4096
이 명령어는 `~/.ssh/id_rsa` (개인 키)와 `~/.ssh/id_rsa.pub` (공개 키) 파일을 생성합니다. 생성된 공개 키를 원격 서버의 `~/.ssh/authorized_keys` 파일에 추가해야 합니다. 공개 키를 서버로 복사하는 가장 쉬운 방법은 다음 명령어를 사용하는 것입니다.
ssh-copy-id -p 2222 devuser@192.168.1.100
이후 VSCode에서 SSH 연결 설정을 추가할 때, 비밀번호 대신 SSH 키를 사용하도록 설정하면 됩니다. VSCode의 원격 SSH 설정 파일(`~/.ssh/config`)을 직접 편집하여 다음과 같이 명시할 수도 있습니다.
Host my-remote-server
HostName 192.168.1.100
User devuser
Port 2222
IdentityFile ~/.ssh/id_rsa
이렇게 설정하면 VSCode에서 'my-remote-server'라는 이름으로 간편하게 접속할 수 있습니다. Google 개발자 문서에서 명시한 바와 같이, 안전한 인증 방식은 개발 환경의 보안을 강화하는 핵심 요소입니다.
VSCode 원격 SSH 개발 환경 설정 시각 정리
원격 서버 파일 탐색 및 편집 실전
VSCode 원격 SSH 개발 환경 설정 필수 단계
SSH 키 생성 및 등록: `ssh-keygen -t rsa -b 4096` 후 `~/.ssh/id_rsa.pub` 내용을 서버에 등록
VSCode Remote - SSH 확장 설치: 마켓플레이스에서 'Remote - SSH' 검색 및 설치
SSH 구성 파일 설정: `~/.ssh/config` 파일에 `Host`, `HostName`, `User`, `IdentityFile` 등 명시
원격 서버 접속 및 폴더 열기: VSCode 좌측 하단 원격 아이콘 클릭 후 'Connect to Host...' 선택
SSH 연결이 성공적으로 이루어지면, VSCode는 원격 서버의 파일 시스템을 로컬 파일 시스템처럼 탐색하고 편집할 수 있는 기능을 제공합니다. VSCode 왼쪽 사이드바의 'Explorer' 뷰에서 원격 서버의 루트 디렉토리부터 시작하여 원하는 파일이나 폴더에 접근할 수 있습니다. 마치 로컬 PC에서 파일을 열고 편집하는 것과 완전히 동일한 경험입니다.
원격 서버의 파일을 열면, VSCode는 해당 파일을 원격 서버에서 직접 편집합니다. 변경 사항은 즉시 서버에 반영되며, 저장(`Ctrl+S` 또는 `Cmd+S`)하는 순간 원격 서버에 업데이트됩니다. 이는 FTP 클라이언트를 사용하여 파일을 업로드하고 다운로드하는 번거로운 과정을 완전히 제거합니다. 예를 들어, 웹 서버의 설정 파일(`nginx.conf` 또는 `httpd.conf`)을 수정해야 할 때, SSH로 접속하여 텍스트 에디터로 열고 수정하는 것보다 훨씬 직관적이고 빠르게 작업할 수 있습니다.
실제 사용 시나리오: 웹 애플리케이션 배포
여러분은 Node.js 웹 애플리케이션을 개발 중이며, 이를 스테이징 서버에 배포해야 합니다. 기존에는 Git으로 코드를 푸시하고, SSH로 서버에 접속하여 `git pull`을 실행한 후 애플리케이션을 재시작하는 방식이었습니다. 하지만 VSCode 원격 SSH를 사용하면 다음과 같이 작업할 수 있습니다.
1
VSCode로 원격 서버 연결
앞서 설정한 SSH 연결을 통해 스테이징 서버에 접속합니다.
2
프로젝트 폴더 열기
원격 서버의 애플리케이션 디렉토리로 이동하여 VSCode에서 엽니다.
3
코드 수정
로컬에서 개발하듯이 코드를 수정하고 저장합니다. 변경 사항은 즉시 서버에 반영됩니다.
4
터미널에서 빌드 및 재시작
VSCode 내장 터미널을 사용하여 빌드 명령(`npm run build`)을 실행하고, 애플리케이션을 재시작(`pm2 restart app.js` 등)합니다.
이 과정은 불과 몇 분 안에 완료될 수 있으며, 개발자가 로컬과 원격 환경을 오가며 작업하는 시간을 대폭 단축시켜 줍니다. Apple 지원 문서(support.apple.com)에서도 원격 개발 환경의 효율성을 강조하는 내용을 찾아볼 수 있으며, 이는 VSCode 원격 SSH가 제공하는 이점과 일맥상통합니다.
주의
원격 서버의 파일을 직접 수정할 때는 반드시 백업을 습관화하세요. 특히 운영 서버의 설정 파일을 수정할 때는 예상치 못한 문제가 발생할 수 있으므로, 변경 전에는 해당 파일의 복사본을 생성해 두는 것이 안전합니다. 예를 들어, `cp /etc/nginx/nginx.conf /etc/nginx/nginx.conf.bak`와 같이 백업 명령어를 사용하는 것이 좋습니다.
원격 터미널 활용 및 디버깅
VSCode는 원격 SSH 연결 상태에서 통합 터미널을 제공합니다. 이 터미널은 여러분이 접속한 원격 서버 환경에서 직접 실행됩니다. 즉, VSCode 창 안에서 `ls`, `cd`, `git`과 같은 표준 리눅스 명령어를 사용하거나, Node.js, Python 등의 프로그래밍 언어별 패키지 관리자 명령어를 실행할 수 있습니다. 이는 별도의 SSH 클라이언트를 열 필요 없이 모든 작업을 한 곳에서 처리할 수 있게 해줍니다.
예를 들어, 원격 서버에 설치된 Node.js 애플리케이션의 로그를 확인하고 싶다면, VSCode의 통합 터미널에서 `tail -f /var/log/myapp.log`와 같은 명령어를 실행할 수 있습니다. 또한, `npm install` 또는 `pip install` 명령어를 사용하여 필요한 라이브러리를 설치하는 것도 가능합니다. VSCode의 터미널은 탭을 여러 개 열어 다양한 명령어를 동시에 실행하거나, 작업 결과를 쉽게 복사하여 붙여넣을 수 있는 편리함을 제공합니다. 최대 3개의 동시 터미널 세션을 유지하는 것도 가능합니다.
원격 디버깅 설정
VSCode의 가장 강력한 기능 중 하나는 원격 디버깅입니다. 여러분이 개발하는 애플리케이션이 원격 서버에서 실행될 때, 로컬 VSCode 환경에서 직접 디버깅할 수 있습니다. 예를 들어, Node.js 애플리케이션을 디버깅하려면, 원격 서버에서 Node.js를 디버그 모드로 실행하고 VSCode에서 해당 포트로 연결하는 설정을 해야 합니다.
Node.js의 경우, 애플리케이션을 다음과 같이 실행합니다.
node --inspect-brk index.js
이후 VSCode의 'Run and Debug' 뷰에서 'create a launch.json file'을 선택하고, Node.js 디버깅 설정을 추가합니다. 이때 'attach' 모드를 선택하고, 원격 서버의 IP 주소와 `--inspect-brk` 옵션으로 지정된 포트 번호(기본값 9229)를 입력합니다.
이 설정을 저장하고 디버깅을 시작하면, VSCode는 원격 서버에서 실행 중인 Node.js 프로세스에 연결하여 중단점 설정, 변수 검사, 코드 실행 등 모든 디버깅 기능을 사용할 수 있게 합니다. 이는 개발자가 실제 운영 환경과 유사한 조건에서 버그를 찾고 수정하는 데 매우 유용합니다. 예를 들어, 특정 조건에서만 발생하는 레이스 컨디션(race condition) 같은 복잡한 문제를 디버깅할 때, 이 기능은 시간을 80% 이상 절약해 줄 수 있습니다.
