WSL 설치: Ubuntu 실행 실패·가상화 오류부터 백업 복원까지
AI Editter
wsl --install을 실행했는데 Ubuntu가 열리지 않으면 설치 명령부터 반복하기 쉽습니다. 하지만 WSL 실행 환경 설치, Linux 배포판 등록, 최초 사용자 생성은 서로 다른 단계입니다. 어디까지 완료됐는지 확인한 뒤 그 단계만 고치는 편이 빠릅니다.
이 글은 Windows 11에서 WSL을 처음 설치하거나 기존 설치가 실행되지 않는 상황을 다룹니다. 기존 Linux 파일이 있다면 배포판 삭제·초기화 전에 백업 여부부터 확인하세요.
이미 설치된 환경부터 확인
PowerShell에서 아래 명령을 한 줄씩 실행합니다.
wsl --status
wsl --version
wsl --list --verbose
명령을 지원하지 않는 구버전이면 그 오류도 버전 판단에 필요한 정보입니다. 배포판 목록에 Ubuntu가 이미 있으면 새 배포판을 무작정 만들지 않습니다. VERSION 열은 WSL 1/2를 뜻하며 Ubuntu 배포판의 버전 번호와 다릅니다.
| 결과 | 다음 확인 |
|---|---|
| WSL 자체를 찾지 못함 | Windows 빌드와 설치 조건 |
| WSL은 있으나 배포판 목록이 비어 있음 | 설치할 배포판 선택 |
| 배포판이 있으나 시작 실패 | 오류 코드·가상화·저장장치 |
| Linux 셸은 열리나 앱만 실패 | Linux 내부 패키지·설정 |
새로 설치할 때의 순서
관리자 PowerShell에서 지원되는 배포판 목록을 확인하고 설치할 이름을 고릅니다.
wsl --list --online
wsl --install -d Ubuntu
재부팅을 요구하면 저장 중인 작업을 정리한 뒤 재부팅합니다. 이후 Ubuntu를 실행해 Linux 사용자 이름과 암호를 생성합니다. Linux 암호를 입력할 때 화면에 별표가 보이지 않는 것은 정상 동작일 수 있습니다.
Windows 계정과 Linux 사용자는 같은 계정이 아닙니다. 설치가 끝나면 wsl --list --verbose에서 배포판 상태를 확인하고, Linux 셸에서 whoami, pwd, uname -r로 실행 상태를 확인합니다. Microsoft WSL 설치 안내의 최신 요구사항도 함께 확인하세요.
0x80370102라면 가상화 조건을 나눈다
이 오류는 필요한 가상화 기능이나 설정을 확인해야 하는 대표 사례입니다. 작업 관리자의 성능 → CPU에서 가상화 상태를 확인하고, PC 제조사의 절차로 펌웨어 가상화 설정을 점검합니다. Windows의 Virtual Machine Platform 기능과 재부팅 여부도 확인합니다.
Windows 자체가 가상머신 안에서 실행 중이면 물리 PC의 가상화 설정만으로 충분하지 않을 수 있습니다. 호스트에서 중첩 가상화가 지원·허용되는지 관리자에게 확인하세요. 회사 정책으로 기능이 제한된 장치에서는 임의 우회를 하지 않습니다.
오류 코드가 같다는 이유로 BIOS의 여러 설정을 동시에 바꾸지 않습니다. 공식 WSL 문제 해결 문서에 해당 코드와 환경별 조건이 정리돼 있습니다.
종료·업데이트와 삭제를 구분
WSL 환경을 갱신할 때는 wsl --update를 검토할 수 있습니다. 실행 중인 환경을 완전히 종료하는 wsl --shutdown은 Linux 작업도 멈추므로 먼저 문서를 저장하고 서버·배치 작업을 종료합니다.
반면 wsl --unregister는 해당 배포판 등록과 데이터를 제거하는 작업입니다. 단순 재시작 명령이 아닙니다. 오류를 해결하려는 첫 단계로 실행하지 마세요. 앱의 초기화 메뉴 역시 데이터를 지울 수 있으므로 기존 자료가 있으면 복원 가능한 백업이 먼저입니다.
개발 환경을 옮길 때는 export만 하지 말고 import까지
다음 예시는 배포판 이름이 Ubuntu이고 D:\WSL-Backup 폴더를 미리 만들어 둔 경우입니다. 진행 중인 Linux 작업을 정상 종료하고, 데이터베이스가 있다면 해당 DB의 백업 절차를 먼저 완료합니다.
wsl --terminate Ubuntu
wsl --export Ubuntu D:\WSL-Backup\Ubuntu-backup.tar
wsl --import Ubuntu-Check D:\WSL-Check D:\WSL-Backup\Ubuntu-backup.tar --version 2
wsl -d Ubuntu-Check
Ubuntu-Check와 대상 폴더는 기존 배포판과 겹치지 않는 새 이름·위치를 사용합니다. 가져온 환경에서 사용자 홈, 소스 코드, 패키지, 앱과 DB를 확인합니다. 기본 사용자가 원래 환경과 다를 수 있으므로 사용자 설정도 검토하세요.
Windows 쪽의 /mnt/c 등에 있는 파일이나 별도 연결 디스크는 배포판 내보내기로 모두 보존된다고 가정하지 않습니다. WSL 기본 명령 문서의 내보내기·가져오기 범위를 확인하고 별도로 백업합니다.
설치 완료 판정표
Windows 재부팅 후 배포판이 다시 열리는지, Linux 파일을 만들고 재시작 후 읽을 수 있는지 확인합니다. 인터넷 접근과 이름 해석도 시험하고, 업무에 필요한 도구가 정상 실행되는지 봅니다.
문제가 남으면 Windows 빌드, WSL 버전, 배포판 이름, 오류 코드, 가상화 상태를 묶어 기록합니다. ‘Ubuntu 설치 안 됨’보다 이 정보가 있어야 설치 환경과 Linux 내부 문제를 구분할 수 있습니다.
함께 확인할 절차: NetBox Docker 구축: 4.6 버전 고정·보안·백업·업그레이드