본문 바로가기
개발 Error

VS Code Remote - SSH connection ERROR

by doraemin_dev 2025. 6. 30.

현재 VS Code Remote - SSH 접속 시 아래와 같은 에러가 발생하고 있습니다:

Could not establish connection to "min146": Failed to install the VS Code Server.
Error: UnpackFailed (Failed to install the VS Code Server)

이건 VS Code 서버 파일을 원격 서버에 설치하거나 압축 해제하는 과정에서 실패했을 때 나오는 오류입니다.


🚩 원인

1️⃣ 서버의 디스크 용량 부족 (특히 /tmp 또는 홈 디렉토리)
2️⃣ 서버의 권한 문제 (파일/폴더 권한 문제, /tmp 권한 이상 등)
3️⃣ 이전 설치가 꼬여서 재설치 실패
4️⃣ 네트워크 불안으로 파일이 완전히 전송되지 않음


해결 방법

1️⃣ 서버에 직접 SSH 접속

터미널에서:

ssh [user]@[server_ip_or_hostname]

# 포트 포함시
# ssh <원격지_서버의_User_ID>@<원격지_서버의_Host_Name> -p <Port_번호>

접속이 안 된다면 서버/네트워크 문제입니다. 접속된다면 아래 진행.


2️⃣ 기존 VS Code 서버 폴더 삭제

서버에 접속 후:

rm -rf ~/.vscode-server
rm -rf ~/.vscode-remote
rm -rf ~/.cache/vscode-remote

혹시 초록색 터미널 입력줄이 안 뜬다면, 더 기다리면 뜬다.

👉 VS Code 서버 캐시/설치파일 강제 삭제


여기까지만해도, vsCode로 SSH 접속이 다시 잘 된다!


 

3️⃣ (옵션) 디스크 용량 확인

df -h

특히 /, /home, /tmp 용량을 확인하세요. 90% 이상이면 용량 부족일 수 있습니다.

필요 시:

# 용량 큰 폴더를 찾아 정리
# du -sh ~/* | sort -h

 


4️⃣ (옵션) 다른 임시 디렉토리 지정

만약 /tmp 권한/용량 문제라면, SSH config에 아래처럼 임시 디렉토리 변경:

Host min146
  HostName [server_ip_or_hostname]
  User [user]
  RemoteCommand mkdir -p ~/.vscode_tmp && export TMPDIR=~/.vscode_tmp && bash

👉 VS Code가 압축 해제를 다른 곳에 하도록 유도

 

'개발 Error' 카테고리의 다른 글

Postman 422 Unprocessable Entity Error  (0) 2025.04.02
[Docker] container Exec 발생 에러 모음  (0) 2025.02.26
[MySQL] DB 수정하기  (0) 2025.02.25
[WSL] CUDA Version Downgrade  (0) 2025.02.24
[GitHub] LFS 삭제 후, failed error 발생  (0) 2025.02.22