🔧 WSL2에서 VSCode + Docker 연동 시 permission denied 오류 해결하기

WSL2에서 CLI 기반 Docker 환경을 사용하면서, VSCode의 Docker 확장에서 다음과 같은 오류가 발생:

permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock

이 글은 이 문제의 원인과 해결 과정을 기록한 것입니다.

🧩 문제 원인

리눅스에서 Docker는 /var/run/docker.sock 소켓을 통해 동작하는데,
이 파일은 docker라는 그룹에 속한 사용자만 접근할 수 있게 제한되어 있습니다.

하지만 기본적으로 새로 만든 사용자 계정(예: hi)은 docker 그룹에 포함되지 않기 때문에 위와 같은 권한 오류가 발생

🧠 예시
학교에서 도서관, 실험실, 연구실 출입이 있다고 생각해보면

너는 "학생"이지만

도서관 출입 그룹에 속하면 도서관에 들어갈 수 있고

실험실 그룹에 속하면 실험실도 출입 가능

관리자 그룹(sudo)에 속하면 교무실도 출입 가능

→ groups 명령은 "내가 지금 출입 가능한 공간 목록"을 보는 것과 같음.

🛠️ 해결 절차

1. 현재 그룹 확인

   groups

   → 출력에 docker가 없으면 권한이 없는 상태입니다.

2. docker 그룹에 사용자 추가(한번해두면 영구 적용)

   sudo usermod -aG docker $USER

3. 터미널에서 그룹 변경사항 즉시 적용

   newgrp docker

4. 다시 그룹 확인

   groups

   → 출력에 docker가 포함되었는지 확인합니다.

5. Docker 명령 테스트

   docker ps

   → 권한 오류 없이 실행되면 성공입니다.

ℹ️ 왜 내 사용자 이름(hi)이 groups에 뜨는 걸까?

groups
# 출력: docker adm ... hi

이는 리눅스에서 각 사용자 계정이 기본적으로 동일한 이름의 그룹(Primary Group) 에 자동으로 포함되기 때문이다.
즉, 사용자 hi는 hi라는 그룹을 기본 소속 그룹으로 가지며,
이 그룹은 사용자가 만든 파일의 소유 그룹으로도 사용됨.

touch test.txt
ls -l test.txt
# 결과: -rw-r--r-- 1 hi hi 0 ...

여기서 두 번째 hi가 바로 기본 그룹이다.

• 이 작업을 통해 sudo 없이도 Docker 명령을 사용할 수 있게 되었다.
• VSCode에서도 Docker 확장을 통해 WSL2 내 Docker 데몬과 정상적으로 연동된다.