WSL 재시작: shutdown과 terminate 차이와 안전한 설정 적용

WSL 설정을 바꾸거나 Linux 환경을 다시 시작해야 한다면 먼저 종료 범위를 정한다. 특정 배포판만 다시 시작할 때는 wsl --terminate, WSL 2 가상 머신 전체를 다시 시작하거나 .wslconfig 변경을 적용할 때는 wsl --shutdown을 사용한다. 두 명령 모두 실행 중인 작업을 중단할 수 있으므로 저장과 서비스 종료를 먼저 확인한다.

터미널 창과 재시작을 표현한 AI 생성 일러스트

종료 전에 실행 중인 배포판 확인하기

Windows PowerShell 또는 명령 프롬프트에서 다음 명령을 실행한다. Linux 셸 안에서는 wsl 대신 wsl.exe를 사용한다.

첫 명령은 설치된 배포판 이름, 실행 상태, WSL 1 또는 2를 보여준다. 두 번째 명령은 현재 실행 중인 배포판을 나열한다. 이름은 출력에 표시된 값을 그대로 사용한다. Microsoft WSL 기본 명령

진행 중인 빌드와 파일 편집을 저장하고, 데이터베이스나 개발 서버 등은 해당 프로그램의 정상 종료 절차를 먼저 수행한다. WSL에서 실행 중인 VPN, SSH 세션, 포트 포워딩도 끊길 수 있다. Docker Desktop 같은 다른 프로그램이 WSL을 사용한다면 함께 중단될 수 있으므로 영향을 확인한다.

한 배포판만 종료하기

예를 들어 목록에 Ubuntu가 있을 때 다음과 같이 실행한다. 이름에 공백이 있다면 따옴표로 묶는다.

첫 명령은 지정한 배포판을 중지한다. 다음 명령으로 상태를 확인하고, 마지막 명령으로 해당 배포판을 다시 시작한다. 다른 배포판을 직접 종료하는 명령은 아니다. Ubuntu는 예시이므로 자신의 배포판 이름으로 바꾼다.

WSL 전체를 종료하기

--shutdown은 실행 중인 모든 배포판과 WSL 2의 경량 유틸리티 가상 머신을 즉시 종료한다. 다시 시작할 때는 필요한 배포판을 실행한다. 모든 배포판이 자동으로 재시작되는 명령은 아니다. 목록 조회 결과는 확인 시점의 상태이며 다른 프로그램이 WSL을 다시 열 수 있다. Microsoft WSL 기본 명령

설정 변경 시 어느 쪽을 쓸까?

/etc/wsl.conf는 각 배포판에 적용된다. 해당 배포판이 완전히 중지된 뒤 다시 시작해야 변경이 반영된다. Microsoft는 셸을 닫은 직후 서브시스템이 아직 실행 중일 수 있다고 설명한다. 특정 배포판을 --terminate로 종료한 뒤 재실행하고 결과를 확인할 수 있다.

Windows 사용자 폴더의 .wslconfig는 WSL 2 가상 머신의 전역 설정이다. 메모리 제한 등 이 파일의 변경을 적용하려면 관련 작업을 정리한 뒤 wsl --shutdown으로 VM을 종료하고 배포판을 다시 시작한다. .wslconfig는 WSL 1 배포판 설정이 아니다. Microsoft 고급 설정

종료와 삭제는 다르다

--terminate와 --shutdown은 배포판을 중지하는 명령이며 배포판 등록을 삭제하지 않는다. 반면 wsl --unregister는 해당 배포판과 관련 데이터·설정·소프트웨어를 영구 삭제하므로 재시작 용도로 사용하지 않는다. 저장하지 않은 작업은 종료 시 잃을 수 있다. Microsoft 배포판 등록 해제 경고

이 명령 설명은 2026년 11월 11일 확인한 Microsoft 문서를 기준으로 했다. 예제는 문서 기반이며 실제 Windows WSL 환경에서 실행하지 않았다.

English version · Restart WSL Safely: shutdown vs terminate and Configuration Changes