# Windows에 Ubuntu VM 설정
Linux용 Windows 서브시스템(WSL)은 Windows에서 가상화 소프트웨어를 사용하지 않고 Linux 배포판을 실행할 수 있는 Windows 기능입니다. 다음 그림에서는 Windows에 WSL을 설정하는 데 관련된 작업을 보여줍니다.
>
>
>
>
>
>
>
>
> **Figure: Workflow to set up WSL**
참고
Qualcomm Linux 빌드는 오직 WSL을 사용하여 컴파일할 수 있습니다. 소프트웨어를 플래시하려면 [QDL 도구를 사용하여 플래시](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-253/upgrade-rb3gen2-software.html#flash-using-windows) 를 참조하세요.
## 전제 조건
WSL을 설정하기 전에 다음을 수행하세요.
- [Windows 호스트 컴퓨터 시스템 요구사항 확인](https://docs.qualcomm.com/doc/80-70018-41KO/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#hopstmachinewin)
- [Windows 기능 활성화](https://docs.qualcomm.com/doc/80-70018-41KO/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#turnonwinfea)
- [기본 WSL 버전 설정](https://docs.qualcomm.com/doc/80-70018-41KO/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#setdefaultwslver)
### Windows 호스트 컴퓨터 시스템 요구사항 확인
WSL을 사용하여 Ubuntu VM을 설정하기 전에 Windows 호스트 컴퓨터가 다음 시스템 요구사항을 충족하는지 확인하세요.
| **프로세서 아키텍처** | X64 |
| --- | --- |
| **CPU 코어** | 8개 이상 |
| **RAM** | 8GB 이상 |
| **스토리지** | 300GB의 사용 가능한 공간 |
| **운영 체제** | Windows 11 |
### Windows 기능 활성화
*Linux용 Windows 서브시스템* 과 *가상 머신 플랫폼* Windows을 기능을 활성화하려면 Windows PowerShell에서 관리 권한으로 다음 명령어를 실행하세요.
| Windows 기능 | 명령어 |
| --- | --- |
| Linux용 Windows 서브시스템 | Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux Copy to clipboard |
| 가상 머신 플랫폼 | Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform Copy to clipboard |
참고
명령어를 실행한 후 Windows 호스트 컴퓨터를 다시 시작하세요.
### 기본 WSL 버전 설정
Linux 2용 Windows 서브시스템을 WSL용 기본 Linux 배포판 버전으로 설정하려면 Windows PowerShell에서 관리 권한으로 다음 명령어를 실행하세요.
wsl --set-default-version 2
Copy to clipboard
**출력**
For information on key differences with WSL 2 please visit [https://aka.ms/wsl2](https://aka.ms/wsl2). The operation completed successfully.
## WSL에 Ubuntu 설치
Qualcomm Linux는 Ubuntu-22.04 Linux 배포판을 사용합니다. Windows 호스트 컴퓨터에서 Ubuntu 22.04가 사용 가능한 배포판인지 확인하고 설치하려면 다음을 수행하세요.
1. Windows PowerShell에서 다음 명령어를 실행하여 설치할 수 있는 배포판을 나열합니다.
>
>
> wsl --list --online
> Copy to clipboard
2. Ubuntu 22.04가 배포판 중 하나로 목록에 포함되는지 확인합니다.
>
>
> 
>
> 참고
>
>
> 나열된 배포판에 Ubuntu 22.04가 표시되지 않으면 Microsoft 지원에 문의하세요.
3. 다음 명령어를 실행하여 WSL을 업데이트합니다.
>
>
> wsl --update
> Copy to clipboard
4. 다음 명령어를 실행하여 Ubuntu 22.04 LTS를 설치합니다.
>
>
> wsl --install -d Ubuntu-22.04
> Copy to clipboard
5. 설치가 완료되면 설치한 Ubuntu 22.04 Linux 배포판의 사용자 이름과 비밀번호를 설정합니다.
## WSL의 글로벌 설정 구성
Ubuntu VM의 메모리, 프로세서, 스왑 스토리지 공간과 같은 WSL 글로벌 설정을 구성하려면 다음을 수행하세요.
1. Windows 파일 탐색기를 열고 `C: Users` 디렉토리로 이동합니다.
2. 다음 작업 중 하나를 수행합니다.
>
>
> - `.wslconfig` 파일이 있으면 3단계로 건너뜁니다.
> - `.wslconfig` 파일이 없으면 `.wslconfig` 라는 파일을 생성합니다.
3. `.wslconfig` 파일을 텍스트 편집기에서 열고 다음 텍스트를 복사하여 저장합니다.
>
>
> # Settings apply across all Linux distributions running on WSL 2
> [wsl2]
> # Limits VM memory to use no more than 4 GB, this can be set as whole numbers using GB or MB
> memory=64GB
> # Sets the VM to use two virtual processors
> processors=16
> # Sets amount of swap storage space to 8GB, default is 25% of available RAM
> swap=64GB
> # Sets swapfile path location, default is %USERPROFILE%\AppData\Local\Temp\swap.vhdx
> swapfile=C:\\temp\\wsl-swap.vhdx
> # Enable experimental features
> [experimental]
> # Automatically releases cached memory after detecting idle CPU usage. Set to gradual for slow release, and dropcache for instant release of cached memory.
> autoMemoryReclaim=dropcache
> Copy to clipboard
>
>
> 참고
>
>
> Windows 호스트 컴퓨터의 사양과 일치하도록 메모리, 프로세서 및 스왑 크기의 값을 설정합니다.
4. Windows PowerShell에서 다음 명령어를 실행하여 WSL을 종료합니다.
>
>
> wsl --shutdown
> Copy to clipboard
5. Windows PowerShell에서 다음 명령어를 실행하여 WSL을 다시 시작합니다.
>
>
> wsl
> Copy to clipboard
## WSL에서 Ubuntu 설정 구성
WSL 환경을 설정하려면 WSL에서 다음 Ubuntu 설정을 구성하세요.
- [DNS 설정](https://docs.qualcomm.com/doc/80-70018-41KO/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#dnssettings)
- [Git 설정](https://docs.qualcomm.com/doc/80-70018-41KO/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#gitsettings)
- [WSL 로컬 설정](https://docs.qualcomm.com/doc/80-70018-41KO/topic/set-up-windows-subsystem-for-linux-on-windows-11.html#wsllocalsettings)
### DNS 설정
WSL용 DNS 설정을 구성하려면 `resolv.conf` 파일을 사용하세요.
1. Linux 터미널 창에서 `sudo` 명령어를 사용하여 `/etc/resolv.conf` 파일에 다음 내용을 추가합니다.
sudo rm /etc/resolv.conf
sudo bash -c 'echo "nameserver 8.8.8.8" > /etc/resolv.conf'
Copy to clipboard
2. Linux 터미널 창을 닫으면 nameserver는 기본 nameserver 설정으로 자동 복귀합니다. `resolv.conf` 파일에 적용된 변경 사항을 영구적으로 저장하려면 다음 명령어를 실행합니다.
sudo chattr -f +i /etc/resolv.conf
Copy to clipboard
3. 쓰기 권한을 변경하고 `resolv.conf` 파일을 수정하려면 다음 명령어를 실행합니다.
sudo chattr -f -i /etc/resolv.conf
Copy to clipboard
### Git 설정
Git에 긴 경로 지원을 활성화하려면 Linux 터미널 창에서 다음 명령어를 실행하세요.
git config --global core.longpaths true
Copy to clipboard
### WSL 로컬 설정
설치된 Ubuntu Linux 배포판의 로컬 설정을 구성하려면 wsl.conf 파일을 사용하세요. wsl.conf 파일의 설정은 WSL을 실행할 때마다 자동으로 적용됩니다.
1. Linux 터미널 창에서 `sudo` 명령어를 사용하여 `/etc/wsl.conf` 파일에 다음 내용을 추가합니다.
[network]
generateResolvConf = false
[automount]
options = "metadata"
[boot]
command = service docker start
Copy to clipboard
2. Windows PowerShell에서 다음 명령어를 실행하여 WSL을 다시 시작합니다.
wsl --shutdown
Copy to clipboard
## 선택 사항: Ubuntu 설치 드라이브 변경
Ubuntu는 기본적으로 C 드라이브에 설치됩니다. Windows 호스트 컴퓨터의 C 드라이브에 빌드를 위한 디스크 공간이 충분하지 않은 경우, Ubuntu 설치를 다른 드라이브로 이동할 수 있습니다.
Ubuntu 설치를 다른 드라이브로 이동하려면 다음을 수행하세요.
1. Add or Remove Programs 를 열고 목록에서 Ubuntu 설치를 찾습니다.
2. Control Panel 에서 Programs > Programs and Features 를 선택합니다.
3. 드라이브를 변경하려는 Ubuntu 설치를 마우스 오른쪽 버튼으로 클릭하고 Uninstall 또는 Uninstall/Change 를 선택합니다.
다음 대화 상자가 나타납니다.
4. Move 를 선택합니다.
5. Ubuntu 설치를 이동하려는 목표 드라이브를 선택하고 Move 를 선택합니다.
참고
WSL 작업 영역에 접근하려면 Windows 파일 탐색기를 사용하여 다음 경로로 이동하세요.
\\wsl$
Copy to clipboard
## 다음 단계
- [Qualcomm Linux 동기화, 빌드 및 플래시](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254)
- [Ubuntu VM의 네트워크 오류 해결](https://docs.qualcomm.com/doc/80-70018-41KO/topic/troubleshoot.html#fix-network-failures-in-the-ubuntu-vm)
Last Published: Aug 21, 2025
[Previous Topic
가상 머신 설정 개요](https://docs.qualcomm.com/bundle/publicresource/80-70018-41KO/topics/getting-started.md) [Next Topic
Arm64 Mac에 Ubuntu Server VM 설정](https://docs.qualcomm.com/bundle/publicresource/80-70018-41KO/topics/set-up-an-ubuntu-vm-on-an-arm64-based-mac.md)