맥에서 VSCode의 Remote SSH로 우분투에 접속하기

SSH는 간단히 말하면 다른 컴퓨터의 터미널을 사용할 수 있는 기능입니다.

그리고 VSCode에는 Remote SSH라고 하는,

SSH를 간단하게 사용할 수 있도록 도와주는 확장프로그램이 존재합니다.

 

오늘은 맥(M1 맥 포함)에서 VSCode의 Remote-SSH를 이용해 우분투에 원격 접속해보겠습니다.

 

1. VSCode에서 Remote-SSH 설치하기

VSCode 확장 탭에서 ssh를 검색하면 [Remote - SSH]를 설치할 수 있습니다.

설치가 완료되면 VSCode의 좌측 하단에 [><]모양 아이콘이 생깁니다.

이걸 누르면,

위 사진과 같이 VSCode 상단에 메뉴가 뜹니다.

이 중에서 [SSH 구성 파일 열기]를 눌러줍니다.

그럼 위 사진과 같은 옵션이 뜨는데

여기서 [/Users/사용자명/.ssh/config]라는 옵션을 눌러줍니다.

그럼 위 이미지와 같이 설정파일이 뜹니다.

 

Host에는 SSH로 접속할 서버의 이름을 지정해줍니다.

이 이름은 본인이 알아보기 쉬운 이름으로 임의로 지정해주면 됩니다.

 

HostName에는 SSH로 접속할 서버의 IP 주소를 입력해줍니다.

 

User에는 SSH로 접속할 서버의 계정명을 입력합니다.

보통은 우분투를 처음 켰을때 로그인할때 사용하는 계정명을 입력하면 됩니다.

 

Port에는 SSH로 접속할 서버의 포트 번호를 입력합니다.

 

IdentityFile에는 퍼블릭키의 경로를 지정해줘야 합니다.

이건 뭔지 모르겠다구요?

우린 지금부터 퍼블릭 키를 생성해보겠습니다.

 

우선 설정을 변경했으니 저장해주세요.

 

2. Public Key 생성하기

ssh 우분투계정명@우분투IP -p 포트번호

구글에서 '맥'과 'ssh'를 키워드로 검색하면 이렇게 하라고 뜹니다.

진짜 간단하죠?

개발하려면 맥북을 쓰라는 말이 있는 이유가 이런 단순성과 전능성 때문인 것 같기도 하네요.

 

아무튼 그냥 이렇게 시키는대로 하면 Permission denied 메시지가 뜨는 경우가 있습니다.

패스워드가 틀렸나? 싶어서 여러번 접속해보면 이렇게 publickey라는 메시지가 뜹니다.

 

이럴때 해결방법은 ssh가 원하는 public key를 만들어주면 됩니다.

# 터미널에서 ssh-keygen을 실행한다.
ssh-keygen

# 키 파일을 저장할 경로를 설정한다.
# 임의의 경로를 설정해도 되지만 다들 사용하는 경로는 아래와 같다.
/Users/사용자명/.ssh/id_rsa

# public key로 ssh 접속 시, 패스워드를 사용한다면 패스워드를 입력한다.
# 패스워드 안쓸거면 그냥 엔터 누르면 된다.
# 패스워드 확인도 해준다.

터미널에서 이렇게 명령어들을 입력하면 퍼블릭 키가 만들어집니다.

cd ~/.ssh
ls -al

위 명령어를 입력하면 /.ssh 디렉터리에 존재하는 파일 및 폴더를 확인할 수 있는데,

퍼블릭키가 잘 만들어졌으면 id_rsa관련 파일이 생성됩니다.

 

3. VSCode에서 SSH접속 시 사용 할 퍼블릭 키 설정하기

이제 다시 VSCode에서 위 화면을 띄워줍니다.

제일 밑에 있는 IdentityFile 항목에 public key가 설치된 경로를 입력해주고 저장하면 됩니다.

저장했으면 VSCode 좌측 하단의 [><]아이콘을 누르고, 이번엔 [호스트에 연결]을 눌러줍니다.

그럼 이렇게 접속 가능한 SSH 서버의 이름이 뜹니다.

이걸 눌러주면 비밀번호를 요구하는데, 비밀번호를 입력하면 접속이 완료됩니다.

무사히 접속이 완료되었다면, VSCode 좌측 아래에 이렇게 [>< SSH: 서버이름]이 표시됩니다.

 

이제 우분투 환경에서 VSCode를 실행한 것과 동일한 효과를 얻을 수 있습니다.

터미널도 우분투 터미널이 돌아가고, VSCode로 코드를 작성하면 우분투 환경에 저장되고 실행됩니다.