SSH 원격 접속과 VS Code 연동

SSH 원격 접속과 VS Code 연동

우분투 가상머신을 개발 환경으로 사용할 때 SSH 연결은 가장 안정적이고 전문적인 접근 방식입니다. 단순히 터미널 접속용이라는 수준을 넘어, VS Code와 연동하면 VM 내부를 로컬처럼 개발할 수 있어 생산성이 비약적으로 향상됩니다. 특히 Python·Django·Node.js 개발에서 일반적으로 사용하는 구조이며, 클라우드 서버 연결 방식과 동일하기 때문에 학습 효과도 큽니다.

---

● SSH 연결의 개념

SSH(Secure Shell)는 네트워크를 통해 안전하게 리눅스 서버에 접속하는 방식입니다.
호스트에서 다음 기능을 수행할 수 있습니다.

• 우분투 VM 터미널 원격 접속
• 파일 전송 및 작업
• root 또는 일반 사용자 계정으로 명령 실행
• VS Code 원격 개발 환경 연결

즉, 가상머신을 로컬 리눅스 서버로 다루는 구조입니다.

---

● SSH 서버 설치 (우분투 VM)

우분투 터미널에서 아래 명령 실행

sudo apt update
sudo apt install openssh-server

설치 상태 확인

sudo systemctl status ssh

서비스가 정상 Running 상태여야 합니다.

---

● VM IP 주소 확인

ip addr show

일반적으로 192.168.x.x 형태 IP가 표시됩니다.
NAT 또는 브리지 모드에서 사용 가능합니다.

---

● 호스트에서 SSH 접속

호스트(Windows) 터미널 또는 PowerShell에서

ssh 사용자명@가상머신_IP

예시

ssh ubuntu@192.168.120.5

처음 접속 시 fingerprint 확인 질문이 나오며, yes 입력 후 비밀번호 입력합니다.

---

● VS Code 원격 접속(필수 확장 기능)

1) 확장 설치

VS Code에서 다음 확장 설치

• Remote Development Pack
• 또는 개별로
  • Remote SSH
  • Remote Explorer

2) SSH 접속 구성

VS Code 좌측 하단 아이콘 클릭
Remote SSH: Connect to Host 선택

또는 명령 팔레트(F1)에서 입력

Remote-SSH: Add New SSH Host

SSH 명령 입력 예시

ssh ubuntu@192.168.120.5

저장 후 목록에서 해당 항목 선택하여 접속합니다.

---

● 최초 접속 후 자동 환경 구성

VS Code가 아래 작업을 자동으로 수행합니다.

• VM 내부에 VS Code 서버 설치
• 확장 기능 동기화
• 파일 탐색기 연결

이제 우분투 내부 파일을 VS Code에서 바로 열고 수정할 수 있으며, 터미널도 VS Code에서 직접 VM 터미널로 열립니다.

---

● 개발 구조 예시

VS Code(호스트)  
   ↓ SSH 연결  
Ubuntu VM 프로젝트 디렉터리  
   ↓ 실행  
웹/DB/AI 서버 동작

이 방식은 실제 AWS EC2, Lightsail, GCP VM, Naver Cloud 서버 운영 방식과 동일하여 향후 클라우드 개발로 자연스럽게 이어집니다.

---

● 장점 요약

기능	장점
터미널	빠르고 안정적
파일 편집	VS Code 활용, 자동 저장
패키지 설치	VM 환경 그대로 유지
재현성	개발 환경 충돌 최소화
확장성	실전 서버 운영 방식과 동일

---

● 권장 팁

• ~/.ssh/config 활용하여 접속 단축
• 키 인증 방식(Password → SSH Key)으로 전환 추천

예시 키 생성

ssh-keygen -t rsa -b 4096

• 인증키 등록 시

ssh-copy-id ubuntu@VM_IP

비밀번호 없이 접속 가능해집니다.