VSCode Remote-SSH 접속 방법

리눅스 또는 우분트 등의 Unix 베이스의 빌드 환경에서는 원격 SSH로 접속해서 작업을 해야 합니다. 이 경우 보틍 많이 사용하시는 SSH 원격 접속 툴이 Putty나 확장 툴인 MTPutty 등의 툴 등을 사용하시는데요. 이런 Putty툴을 별도로 사용하지 않고 VSCode상에서 확장 패키지를 설치하시면 바로 원격 SSH 접속해서 빌드까지 확인이 가능합니다.

 

VSCode Remote-SSH 접속 방법

 

 

VSCode 우측 상단의 확장(Extention)에서 'Remote Development'를 검색하셔서 설치하시면 됩니다.

 

참고로 Remote Development 확장 팩을 설치하시면 Remote - WSL, Remote -Containers, Remote- SSH 세 개의 확장팩이 함께 설치됩니다.

Remote Development

 

view- command palette (또는 CTL + F1) 에서 SSH로 검색 후 'Remote-SSH: Open SSH Configuration File...'을 클릭합니다.

Remote-SSH

 

C:\Users\.ssh\config 에 들어가셔서, 다음 config를 세팅해줍니다.

 

Host [본인 계정 이름]@[IP adress or Host Name]:[Port 번호]
HostName [IP adress or Host Name]
User [본인 계정 이름]
Port [Port 번호]

 

e.g.,

.ssh config

 

view-palette.. 에서 다음 (Connect to Host...)을 클릭합니다.

위 config에서 세팅했던 Host 정보가 보입니다. 클릭해서 들어갑니다.

remote host의 플랫폼을 선택해 줍니다. Linux 환경이므로 Linux를 선택해 줬습니다.

 

만약 해당 Host에 Password 가 있다면 Password 입력해 줍니다.

 

정상적으로 해당 SSH로 해당 Host에 접속이 되었네요. 

좌측 하단에도 SSH:[호스트명] 그림이 보이면 정상적으로 접속이 된 겁니다.

 

Note) 간혹 플랫폼 선택 후 'vscode ssh installation couldn't be found' 에러 뜨며 ssh 접속이 되지 않는 경우가 있는데요.

원인은 자신의 Windows에 OpenSSH가 설치가 되지 않은 경우인데요. 이 경우는 Apps & features - Add an optional feature에서 openssh로 검색, 다음의 OpenSSH Clinet와 OpenSSH Server를 설치해야 합니다.

설치가 완료되었다고 끝난건 아닌데요. 마지막으로 시스템 환경 변수에 설치된 경로(Path)를 추가해 주셔야 SSH의 경로를 찾아 정상적으로 실행이 됩니다. PC의 시스템 환경 변수에 Path가 정상적으로 설치되었는지의 확인은 C:\WINDOWS\system32\에서 'ssh' 명령 실행하셔서 다음처럼 usage 화면이 나오면 정상적으로 설치가 된 것으로 보시면 됩니다. 

 

windows ssh path