VSCode Remote - SSH로 Python 원격 개발하기

VSCode의 Remote - SSH 확장을 활용하여 Ubuntu 24.04 서버에 원격 접속하고 Python 개발 환경을 구성하는 방법을 소개합니다.

 

VSCode Remote - SSH로 Python 원격 개발하기

 

목차

1. Remote - SSH란?

2. Ubuntu 24.04 서버 준비

3. VSCode에 Remote - SSH 확장설치

4. SSH 연결 설정 및 서버 접속

5. Python 프로젝트 생성 및 코드 실행 예제

6. .vscode-server 란?

관련 글 링크

 

 

1. Remote - SSH란?

Remote - SSH는 Visual Studio Code(이하 VSCode)의 확장 기능입니다.
로컬 컴퓨터에서 VSCode를 실행한 상태에서, 원격 Linux 서버에 SSH를 통해 연결하고 원격 파일을 편집 및 실행할 수 있습니다.

• 로컬 PC 리소스를 거의 사용하지 않고, 원격 서버의 고성능 자원을 활용 가능
• VSCode의 확장, IntelliSense, 터미널 기능을 그대로 사용 가능
• 원격 서버에 Python, Node.js, Docker 등 다양한 개발환경 구성 가능

 

2. Ubuntu 24.04 서버 준비

VSCode의 Remote - SSH 기능을 사용하기 위해서는 원격 서버에 OpenSSH Server가 서버에 설치되어 있어야 합니다.

sudo apt update
sudo apt install openssh-server

실행 중인지 확인
sudo systemctl status ssh

서비스를 시작
sudo systemctl start ssh

부팅 시 자동 실행되도록 설정하려면:
sudo systemctl enable ssh

상세한 설명은 "관련 글 링크" 를 참고하세요

 

3. VSCode에 Remote - SSH 확장설치

1. VSCode 실행

2. 좌측 사이드바의 Extensions (확장) 아이콘 클릭

3. Remote - SSH 검색 후 설치

설치가 완료되면 VSCode 하단에 >< 아이콘이 나타납니다.

 

4. SSH 연결 설정 및 서버 접속 

 1. 좌측 하단에 >< 클릭 후  Connec to Host 선택

2. 아래 그림을 참조해서 SSH 접속 설정을 한다.(설정 중 VSCode 새창이 활성화 됩니다.)

 

5. Python 프로젝트 생성 및 코드 실행 예제

연결 후 File > Open Folder 메뉴를 클릭하고 원격 서버의 작업 디렉토리를 선택합니다.

hello-world.py 파일을 생성하고  아래 코드를 작성합니다.

print("Hello, World!")

 

가상환경 설정:

Ctrl + Shift + P → Python: Select Interpreter  → Create Virtual Environment  → Venv  →  Enter interpreter path  → Find 를 선택 후 원격 가상 환경을 설정합니다.

가상환경 설정하는 자세한 내용은 "관련 글 링크" 내용을 참고 하세요

 

6. .vscode-server 란?

.vscode-server는 VSCode가 원격 서버에서 다양한 기능을 사용하기 위해 자동 설치하는 백엔드 컴포넌트 디렉토리입니다.

 

◆ 생성 위치

• 사용자의 홈 디렉터리에 자동 생성됩니다.

~/.vscode-server/

요소	설명
bin/	특정 VSCode 버전에 해당하는 서버 바이너리 (예: VSCode 1.99에 맞는 서버 코드)
extensions/	서버에서 사용하는 확장 프로그램 저장소
data/	임시 실행 상태, 세션 정보 등
logs/	연결, 실행 중 발생한 로그
cli.sh	VSCode 명령어 인터페이스 쉘 스크립트
server.sh	Remote server 실행을 위한 스크립트

 

◆ 생성 흐름

1. VSCode에서 Remote - SSH로 서버에 연결 시도

2. 서버에 .vscode-server 폴더가 있는지 확인

   없다면 자동으로 업로드 및 설치

3. 해당 디렉토리에 VSCode 버전에 맞는 백엔드 서버 코드 설치

4. 이후 VSCode는 이 서버를 통해 원격 실행, 파일 탐색, 디버깅 등을 수행

• 삭제 가능은 하지만, 다음 연결 시 재설치됨

 

---

 

 

관련 글 링크

[1.시스템&인프라/Ubuntu] - 12. Ubuntu에서 SSH 서버 설치 및 보안 설정

12. Ubuntu에서 SSH 서버 설치 및 보안 설정

[1.시스템&인프라/개발환경] - Ubuntu 24.04 에서 여러 버전 Python 설치하기: Portable

Ubuntu 24.04 에서 여러 버전 Python 설치하기: Portable

[1.시스템&인프라/개발환경] - Visual Studio Code 설치 방법 (Installer / Zip 포터블 모드)

Visual Studio Code 설치 방법 (Installer / Zip 포터블 모드)

[1.시스템&인프라/개발환경] - VSCode에서 Python 가상환경(.venv) 설정 및 여러 버전 관리하기

VSCode에서 Python 가상환경(.venv) 설정 및 여러 버전 관리하기