VSCode 원격 서버의 프로젝트 개발하기

VS Code의 가장 강력하고 인기 있는 기능 중 하나가 원격 서버(SSH)에 접속하여 작업하는 환경을 구축하는 것입니다.

 

마치 사용자의 PC(로컬)에 있는 파일을 직접 수정하는 것처럼, 원격 서버의 코드를 편집하고 서버의 터미널을 VS Code 내에서 그대로 활용할 수 있습니다.

 

설정하고 사용하는 방법은 매우 직관적입니다. 아래의 순서대로 진행하면 됩니다.

 

1. 확장 프로그램 설치하기

• VS Code 좌측 메뉴에서 블록 모양의 확장(Extensions) 아이콘을 클릭합니다.
• 검색창에 Remote - SSH를 검색하시고, Microsoft에서 공식 제공하는 확장 프로그램을 설치해 줍니다.

2. 서버에 연결하기

• F1 키 또는 Ctrl+Shift+P (Mac의 경우 Cmd+Shift+P)를 눌러 명령 팔레트를 엽니다.
• Remote-SSH: Connect to Host... 를 검색하여 선택합니다.
• + Add New SSH Host...를 클릭한 후, 접속 명령어(ssh 사용자이름@서버주소)를 입력합니다. (예: ssh ubuntu@192.168.0.1)

3. 비밀번호 입력 및 설정 파일 저장

• SSH 설정 파일(~/.ssh/config)을 업데이트할지 묻는 메뉴가 나타나면, 첫 번째 기본 경로를 선택해 줍니다.
• 우측 하단에 'Connect' 알림이 나타나면 클릭하시고, 서버의 운영체제(Linux 등)를 선택한 뒤 서버 비밀번호를 입력합니다.

4. 프로젝트 폴더 열기

• 연결이 완료되면 VS Code 좌측 하단 상태 표시줄에 원격 서버의 접속 정보가 표시됩니다.
• 이제 상단 메뉴에서 파일(File) > 폴더 열기(Open Folder)를 클릭하시면 서버의 디렉토리 경로가 나타납니다. 작업하실 프로젝트 폴더를 선택하고 '확인'을 누르시면 모든 준비가 완료됩니다.