VS code에서 SSH 원격접속하기

며칠 고생했던걸 기록해둬야할 것 같아서 적어보는, 일기 같은 실험기록.✍

내가 앞으로 만들게 될 실서비스가 API로 데이터를 불러오는 부분이 많아서, 데이터를 직접 만져보는게 프론트엔드 측에서 페이지를 만들 때에도 도움이 될 것 같다는 사수님의 제안에 따라, VS code에서 SSH로 서버에 원격접속을 해서 가상의 데이터를 만들기로 했다. 구글링을 통해 VS code로 SSH 원격접속하는 방법을 미리 공부해뒀고, 얼마 후에 백엔드 전문이신 사수님이 서버를 만들고 관련 정보들을 알려주셔서 공부한대로 원격접속을 시도했다.

그런데 여기서부터 약간의 삽질이 시작된다..😂

---

설치된 익스텐션 목록, SSH 원격접속 과정

• 일단 VS code에서 Remote SSH 관련 익스텐션을 설치하려고 보니까 이미 설치가 되어있었다.
  언제 설치했는지 기억도 안 나지만, 아무튼 이미 있으니까 설치과정 패스.
• VS code 왼쪽 하단에 있는 코드 표시를 클릭했더니 호스트에 어떻게 연결할건지 선택하라는 알림(?)이 떴다.
  Connect to Host(새 창으로 연결), Connect Current Window to Host(현재 창에서 연결) 중에서
  나는 2번, '현재 창에서 연결'로 들어갔다.
• 그 다음에 Add New SSH Host (새로운 호스트 생성), Configure SSH Host (호스트 수정) 중에
  나는 1번, '새로운 호스트 생성'으로 들어갔다.
• SSH 접속에 '로그인'할 사용자명을 입력하라고 해서 사수님이 알려주신 서버 정보를 참고해서 입력했다.
  → 사용자이름@ip주소 -p 포트번호
• 그랬더니 서버의 운영체제를 선택하라는 알림이 떴고, 리눅스를 선택했다.

공부한대로 차근차근 진행했는데 접속이 되지 않았다.

VS code 하단에서 OUTPUT을 확인했더니 이런 에러가 떴다.

[12:45:31.287] > ssh: connect to host (ip주소) port 22: Connection timed out
[12:45:31.316] > 프로세스에서 없는 파이프에 쓰려고 했습니다.

전체 OUTPUT 리스트를 살펴보니, ssh.exe 파일을 찾으려고 VS code가 자동으로 C 드라이브의 여러 파일을 탐색해보고 User/.ssh 디렉토리에서 찾은 config 파일을 바탕으로 서버에 접속을 시도했지만, 서버에서 응답하지 않아 연결 타임아웃이 발생한 것 같았다. chatGPT에게 해결방법을 물어보고, 구글링해서 찾은 블로그들을 보면서 다양한 방법으로 해결을 시도했다.

---

가장 먼저, ChatGPT가 OpenSSH 클라이언트와 OpenSSH 서버의 작동 문제를 확인해보라고 해서 내 컴퓨터에 설치되어있는지 확인했다. 제어판에서 확인이 불가능해서 Windows PowerShell에 명령어 입력해서 확인했더니 설치가 안 되어있어서 설치했다.

Powershell 명령어로 OpenSSH 클라이언트와 서버 설치

VS code 익스텐션 config 파일 경로 설정

방화벽 문제도 언급되어서 내 컴퓨터 방화벽에 22번 포트를 허용하는 설정도 했고, VS code 익스텐션 설정에서 config 파일의 경로를 지정해줘야한다고 해서 그것도 진행했다. 이런 작업들을 진행한 덕분에, VS code 좌측에 Remote Explorer가 생겼지만 여전히 접속되지 않고 아까와 같은 타임아웃 에러가 떴다.🤦‍♂️

이날 내가 재택근무였고 나 혼자 해결하는건 무리라고 생각되어서, 다음 출근일에 사무실에서 사수님이랑 같이 확인하기로 했다.

Remote Explorer, config 파일

주말이 지나고 월요일, 사무실에서 다시 원격접속을 시도했지만 역시나 같은 이유로 접속 불가능했다.

구글링하니까 블로그에는 전부 known_host 파일을 삭제하면 된다는데, 나는 그 파일이 없을 때에도 접속이 되지 않았어서 나한테 맞는 해결방법이 아니었다. 사수님이 만들어주신 다른 서버로 접속했더니 그건 정상 연결되어 비밀번호 입력 단계로 넘어갔고, 내가 접속이 안됐던 서버를 사수님 컴퓨터로 시도했더니 접속이 됐다.

이해하기 쉽게 정리하자면,
위 사진의 react 서버는 내 컴퓨터에서는 접속이 안되는데 사수님 컴퓨터에서는 접속이 됐고,
test2 서버는 사수님 컴퓨터랑 내 컴퓨터 모두 접속이 됐다.

저거 하나만 안되는 이유가 뭔지 너무 답답했다.

"다른 서버가 내 컴퓨터에서 접속이 된다면 컴퓨터의 문제는 아닌거 같은데.. 내 컴퓨터에서 안되는게 다른 컴퓨터에서는 된다면 그건 이유가 도대체 뭘까..🤔"

퇴근 직전까지 나 혼자 문제를 해결해보려고 시도하다가, 내가 여전히 혼자 끙끙대고 있는걸 보신 사수님이 혹시나 하는 마음에 내 컴퓨터로 서버에 로그인해서 콘솔을 만져보시고 다시 접속을 시도했더니 접속이 됐다!🙌

그리하여 나를 며칠 골치아프게 만들었던 SSH 원격접속 문제는 이렇게 의외의 부분에서 해결되는 줄 알았다.

그렇게 쉽게 해결됐다면 이 글을 쓰지 않았을거다.😂

접속된다는걸 확인한 그날 가벼운 마음으로 퇴근하고, 다음날 아침에 출근해서 접속을 시도했다.

VS code 우측 하단에 "Setting up SSH Host"라는 메시지가 너무 오래 떠있어서 쎄한 느낌이 들었고, 역시나 OUTPUT을 열어봤더니 전과 같은 이유로 접속이 불가능했다.🤦‍♂️

"어제는 되더니, 오늘은 왜 다시 안 되는거야?!!"

어이가 없어서 한바탕 웃었고, 결국 그날 접속 못하고 다음날 사수님이랑 사무실에서 다시 콘솔을 확인했다.

네트워크로 와이파이를 사용하면 IP가 유동적이라서 서버에서 컴퓨터의 IP가 달라질 수 있다고 하셨던 것 같은데, 사실 나는 백엔드를 하나도 모르는 햇병아리 개발자여서 무슨 말씀인지 이해가 안됐다.😅 어쨌든 결론은 서버가 네트워크 때문에 나의 접속을 거부했던게 원인이었다. 콘솔 확인하고 새로운 접속 정보를 저장했더니 다시 접속이 허용되었다.🙌

이후에 갑자기 로그아웃 됐다가 다시 접속했을 때 비밀번호 헷갈려서 몇 번이나 로그인 실패했었다는건 안비밀..😝

이제 진짜로 SSH 원격접속 문제는 해결되었다!!

---

SSH 원격접속 시의 다양한 오류와 해결방법이 정리된 글.

나도 에러 해결하려고 이 글을 참고했었다.

https://yonlog.tistory.com/103

SSH 커넥션 문제 원인 및 해결방법