VSCode에서 SSH를 이용한 Ubuntu 서버 원격 접속 방법

 

VSCode(Visual Studio Code)에서 Ubuntu 서버에 원격으로 접속하는 방법은 다음과 같습니다.

주로 SSH를 이용한 접속 방식을 사용하며, 아래는 기본적인 설정 과정입니다.

🔧 단계별 접속 방법

1. Remote - SSH 확장 설치

2. VSCode에서 Remote SSH 실행

F1 또는 Ctrl+Shift+P → "Remote-SSH: Connect to Host..." 선택

3. 새 호스트 추가

"Add New SSH Host..." 선택 후 다음 형식 입력:

ssh {username}@{your.server.ip}

 

예를 들어, username이 ubuntu이고, 서버 ip가 192.168.1.100라면

ssh ubuntu@192.168.1.100

 

만약, 기본 포트가 아닌 경우: -p {포트번호}를 추가합니다.

ssh ubuntu@192.168.1.100 -p 2222

4. SSH 설정 파일 편집

위와같이 호스트를 추가해 주었다면, 다시 "Remote-SSH: Connect to Host..." 에 들어갔을 때, 아래와 같이 정상적으로 추가된 ssh host가 보일겁니다.

 

이때, 추가로 ssh 설정파일을 수정하고 싶다면, 아래 "Configure SSH Hosts..." → "C:\Users\사용자명\.ssh\config"에서 ssh 설정파일을 편집할 수 있습니다.

5. Remote SSH 접속

F1 또는 Ctrl+Shift+P → "Remote-SSH: Connect to Host..." 선택 → 추가된 호스트 선택

모두 정상적으로 끝났다면, 위와 같은 방법으로 Ubuntu 서버에 원격으로 접속할 수 있습니다.

• 연결되면 VSCode 왼쪽 하단에 "SSH: hostname" 표시됨
• 이제 해당 서버의 디렉토리를 탐색하고 파일을 수정 가능
• 터미널도 원격 환경에서 직접 사용 가능 (Ctrl + ~)