[SSH] - MobaXterm을 통해 원격 서버 SSH 접속 후 vscode로 작업하는 법

MobaXterm을 사용해야 하는 이유

원격 서버에서 작업해야 할 경우 대부분 연결을 ssh로 하게 되었는데, 기존에는

• 로컬에서 작업 ➡️ git에 push ➡️ 원격 서버에서 pull
• 로컬에서 scp프로토콜을 이용해 파일 전송

등의 방식을 사용하였고, 크게 불편함을 느낀 적이 없었다.

 

그러나 서버측에서 간단한 수정만을 하거나, 리눅스 서버에 데스크탑 환경이 깔려있지 않음 + 위 두가지 방법을 사용 못하는 경우엔 꼼짝없이 vi로 코딩을 해야만 했다.

 

나의 경우는 원격 서버 내의 파일들이 필요하지만 전부 로컬로 옮길 수 없는 방대한 양인데다가, 기존 코드 자체가 해당 데스크탑의 폴더 구조를 기준으로 짜여져 있기 때문에 반드시 추가 작업을 해당 원격 서버 환경에서 해야만 했다.

 

따라서 SSH로 접속하고, 해당 서버에서 vscode등 ide의 GUI가 필요했다.

개발 환경은 다음과 같다.

Local: Windows 11
Remote: Ubuntu Server 18.04 (VM)

MobaXterm 다운로드 및 설치

MobaXterm free Xserver and tabbed SSH client for Windows

위 사이트에서 Home Edition을 클릭하고, Portable edition을 다운받는다.

설치 후 다음 순서로 SSH를 통해 원격서버에 접속한다.

Session ➡️ SSH ➡️ 원격서버 address 입력 ➡️ username 입력 ➡️ Port 번호 설정 ➡️ OK

그럼 다음과 같이 password를 입력 후, 접속이 가능하다.

접속했을 때 X11-forwarding, DISPLAY에 ✓표시가 되어있으면 별다른 서버 설정 없이 사용 가능하다.

만일 ❌ 표시가 된 경우, SSH 서버의 X11 forwarding 옵션을 켜야 한다.

 

AWS 인스턴스에 연결을 시도할 때

AWS 인스턴스로 연결을 시도하는 거라면, 위 사진 처럼 Advanced SSH settings의 use private key를 체크하고, private key의 경로를 선택해주어야한다.

만약 AWS 연결에 ssh키가 아닌 pem파일을 사용 중이라면 해당 사항은 건너뛰어도 될듯하다.

GUI 테스트

간단한 GUI 시계를 깔아서 테스트 해보자.

이 과정에서 기본적인 X11 라이브러리도 설치된다.

 sudo apt install x11-apps

xclock

 

이 시계가 나오면 성공

VS Code 설치

원격 서버 터미널에 다음 명령어를 입력해 vscode 1.85.1 버전을 설치해준다.

vscode의 버전이 1.66 이하등 예전 버전일 경우 설치되지 않는 익스텐션이 꽤 많았다.

curl -JLO https://update.code.visualstudio.com/1.85.1/linux-deb-x64/stable

 

위 로그에서 설치된 filename에 따라 설치를 해준다.

sudo apt install ./code_1.85.1-1702462158_amd64.deb

이후 로컬에서처럼 code 명령어로 vscode를 사용해주자.

로컬의 extension 들은 github를 통해 연동하여 설정을 그대로 이관할 수 있다.

 

++추가로 만약 에러가 발생한다면 다음 라이브러리들을 설치해보자.

sudo apt install libx11-xcb1
sudo apt install libasound2

 

 

reference

• https://c.innori.com/146