Skip to main content

VS Code Remote SSH 및 바로가기 연동

윈도우 로컬 개발 환경을 리눅스 홈서버로 이전하고, VS Code Remote - SSH를 통해 쾌적하게 개발 환경을 구축하는 방법을 정리함.

1. 사전 준비 (Linux Server)​

  • 리눅스 서버에 개발에 필요한 소스 코드 배포 및 git push 완료 상태 확인.
  • 프로젝트 경로 확인 (예: /home/sleepzz/dev/workspaces/nexus).

2. SSH 키 기반 비밀번호 없는 접속 설정​

매번 비밀번호를 입력하는 번거로움을 피하기 위해 윈도우 PC의 공개키를 서버에 등록함.

윈도우 PC에서 키 생성​

  • PowerShell 실행: ssh-keygen -t rsa -b 4096 입력.
  • ~/.ssh/id_rsa.pub 파일의 내용을 복사함.

리눅스 서버에 키 등록​

  • 서버의 ~/.ssh/authorized_keys 파일을 열고 복사한 내용을 새로운 줄에 추가함.
  • 주의: 기존 데이터가 있을 경우 지우지 말고 한 줄 내려서 이어서 붙여넣기 함.
  • 권한 설정: 
    chmod 700 ~/.ssh
    chmod 600 ~/.ssh/authorized_keys

3. VS Code Remote - SSH 설정​

  1. 확장 프로그램 설치: VS Code 마켓플레이스에서 Remote - SSH 설치.
  2. 호스트 등록:
    • Ctrl+Shift+P -> Remote-SSH: Add New SSH Host... 클릭.
    • ssh 유저명@서버IP 입력 후 Config 파일 저장.
  3. 접속: 왼쪽 하단 초록색 아이콘 클릭 후 등록한 호스트 선택하여 연결.

4. 바탕화면 바로가기 아이콘 생성 (자동화)​

특정 서버 접속, 특정 폴더 열기, 특정 프로필 적용을 한 번에 실행하는 바로가기를 생성함.

바로가기 대상 입력값 양식​

  • 기본 프로필 사용 시: "C:\Users\유저명\AppData\Local\Programs\Microsoft VS Code\bin\code.cmd" --profile "기본값" --folder-uri "vscode-remote://ssh-remote+유저명@서버IP/서버/절대/경로"
  • 특정 프로필 사용 시: --profile "프로필이름"으로 변경하여 사용.

생성 방법​

  1. 바탕화면 우클릭 -> 새로 만들기 -> 바로가기.
  2. 위의 전체 경로(따옴표 포함)를 입력 창에 붙여넣기.
  3. 바로가기 이름을 설정(예: Nexus Project)하여 완료.

5. Git 및 작업 환경 관리​

  • Git 연동: 원격 서버 폴더를 열면 해당 서버의 .git 설정을 VS Code가 자동으로 인식함. 별도 설정 없이 Source Control 탭에서 커밋/푸시 가능함.
  • 프로필 관리: 한국어 설정 VS Code의 경우 기본 프로필 명칭이 "기본값"으로 인식될 수 있으므로 설정 시 주의가 필요함.
  • 확장 프로그램: 일부 언어 관련 확장 프로그램은 원격 서버(SSH 대상) 측에 추가로 설치해야 정상 작동함.

6. 트러블슈팅 및 팁​

  • 폴더 연동 문제: 단순 폴더 열기가 안 될 경우 --folder-uri 옵션을 사용하거나, .code-workspace 파일의 전체 경로를 명시함.
  • 시각적 구분: 프로필별로 titleBar.activeBackground 색상을 다르게 지정하여 로컬/서버 환경을 쉽게 구분할 수 있음.