VS Code Remote - SSH 확장 설치

요즘은 Chatgpt나 인공지능으로 검색이 넘어가 버려서 구글링으로 정보를 찾기가 어려워진것 같다

 

암튼 아래 글도 chatgpt에서 검색한 결과이다 내용을 정리하기 위해서 남겨둔다.

 

1. Remote - SSH 확장 설치

1. VS Code를 열고 확장(Extensions) 메뉴(Ctrl + Shift + X)를 클릭합니다.
2. 검색창에 **"Remote - SSH"**를 입력하고 Microsoft에서 제공하는 확장을 설치합니다.

---

2. SSH 연결 준비

2.1. 로컬 컴퓨터에서 SSH 키 생성

만약 SSH 키가 없다면 생성합니다:

bash

코드 복사

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

• 기본 경로(~/.ssh/id_rsa)에 저장하도록 Enter를 누릅니다.
• 생성된 공개 키를 원격 서버에 등록합니다.

2.2. 공개 키 등록

원격 서버에서 인증을 위해 공개 키를 등록합니다.

1. 로컬에서 공개 키 확인:
   bash

   코드 복사

   cat ~/.ssh/id_rsa.pub
2. 원격 서버에 로그인 후 ~/.ssh/authorized_keys에 공개 키를 추가:
   bash

   코드 복사

   echo "복사한 공개 키" >> ~/.ssh/authorized_keys chmod 600 ~/.ssh/authorized_keys

2.3. SSH 접속 테스트

SSH가 정상적으로 연결되는지 확인:

bash

코드 복사

ssh username@hostname

• username은 원격 서버의 사용자 이름, hostname은 서버 주소(IP 또는 도메인).

---

3. Remote - SSH 설정

3.1. SSH 설정 파일 업데이트

1. VS Code에서 Ctrl + Shift + P를 눌러 **명령 팔레트(Command Palette)**를 엽니다.
2. Remote-SSH: Add New SSH Host를 입력하고 선택합니다.
3. 아래와 같은 형식으로 호스트 정보를 입력:
   css

   코드 복사

   ssh username@hostname
4. SSH 설정 파일 경로를 선택(~/.ssh/config).

3.2. SSH 설정 파일 확인

~/.ssh/config 파일에 새 호스트 정보가 추가되었는지 확인합니다. 예제:

plaintext

코드 복사

Host my-server HostName 192.168.0.1 User username IdentityFile ~/.ssh/id_rsa

---

4. 원격 서버에 연결

1. VS Code에서 명령 팔레트(Command Palette)(Ctrl + Shift + P)를 열고 Remote-SSH: Connect to Host를 선택합니다.
2. SSH 설정 파일에 등록한 호스트 이름을 선택합니다.
3. 연결이 완료되면 원격 서버의 파일 시스템이 VS Code에 나타납니다.

---

5. 원격 개발

5.1. VS Code에서 파일 열기

• VS Code의 파일 탐색기에서 원격 서버의 파일을 탐색하고 수정할 수 있습니다.

5.2. 터미널 사용

• 원격 서버의 터미널을 사용하려면 Ctrl + ~를 눌러 터미널을 열고 명령을 실행합니다.

5.3. 확장 프로그램 설치

• 원격 서버에서 필요한 확장을 설치할 수 있습니다.
  VS Code는 로컬과 원격의 확장을 구분하므로 필요한 경우 원격 확장을 따로 설치하세요.

---

6. 문제 해결

6.1. 접속 오류

• SSH 키가 잘못된 경우: 원격 서버의 ~/.ssh/authorized_keys 파일을 확인하고 올바른 공개 키가 등록되었는지 확인하세요.
• 방화벽 문제: SSH 포트(기본 22번)가 열려 있는지 확인하고, 방화벽 규칙을 수정합니다.

6.2. 연결이 느린 경우

• SSH 연결 속도가 느릴 경우 ~/.ssh/config 파일에 아래를 추가:
  plaintext

  코드 복사

  Host * Compression yes ServerAliveInterval 30

6.3. 원격 확장이 설치되지 않는 경우

• 원격 서버에 설치된 Node.js 버전이 너무 낮을 수 있습니다. 최신 버전으로 업데이트하세요:
  bash

  코드 복사

  curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash - sudo apt-get install -y nodejs

---

7. 추가 팁

7.1. 멀티 SSH 설정

여러 서버를 관리하려면 ~/.ssh/config에 추가로 호스트를 등록:

plaintext

코드 복사

Host server1 HostName server1.example.com User user1 IdentityFile ~/.ssh/id_rsa_server1 Host server2 HostName server2.example.com User user2 IdentityFile ~/.ssh/id_rsa_server2

7.2. 포트 포워딩

원격 서버의 특정 포트를 로컬로 포워딩:

plaintext

코드 복사

Host my-server HostName 192.168.0.1 User username LocalForward 8080 localhost:8080

이 설정으로 원격 서버의 8080 포트를 로컬에서 접근할 수 있습니다.

---

이제 VS Code Remote - SSH로 원격 서버에서 효율적으로 작업할 수 있을 것입니다! 🚀