wsl `네트워크를 구성하지 못했습니다(networkingMode Nat)`
WSL(Windows Subsystem for Linux)에서 "네트워크를 구성하지 못했습니다(networkingMode Nat)" 오류가 발생하는 경우, 이는 주로 네트워크 설정 문제, Windows 네트워크 서비스 이상, 또는 WSL2 네트워킹 모드(NAT/Bridged/Mirrored) 관련 이슈로 인해 발생할 수 있습니다.
주요 원인 및 해결 방법
1. 네트워크 설정 초기화
- 관리자 권한 CMD 또는 PowerShell에서 아래 명령어를 차례로 실행한 후, PC를 재시작하세요.
wsl --shutdown netsh winsock reset netsh int ip reset all netsh winhttp reset proxy ipconfig /flushdns- 이후 Windows의 "네트워크 초기화" 기능을 사용하면 네트워크 환경이 완전히 재설정됩니다.
2. .wslconfig 파일 확인 및 수정
- 사용자 폴더(C:\Users\사용자명)에 .wslconfig 파일이 있다면, [wsl2] 섹션의 networkingMode=nat 설정을 확인하세요.
- NAT 모드에서 문제가 계속된다면, Windows 11 22H2 이상에서는 networkingMode=mirrored 또는 networkingMode=bridged로 변경해볼 수 있습니다.
[wsl2] networkingMode=mirrored- 변경 후 wsl --shutdown 명령으로 WSL을 완전히 종료하고 다시 실행하세요.
3. Hyper-V 및 네트워크 어댑터 확인
- Hyper-V 기능이 활성화되어 있어야 하며, 가상 네트워크 어댑터가 정상적으로 동작하는지 확인하세요.
- 네트워크 어댑터 충돌이나 가상 스위치 문제로 인해 네트워크가 구성되지 않을 수 있습니다.
4. 방화벽 및 보안 소프트웨어 점검
- Hyper-V 방화벽 규칙이 제대로 설정되어 있는지 확인하세요.
예시 명령어(관리자 PowerShell):(VM-ID는 환경에 따라 다름)
Set-NetFirewallHyperVVMSetting -Name '{VM-ID}' -DefaultInboundAction Allow
5. WSL 및 Windows 업데이트
- Windows 및 WSL이 최신 버전인지 확인하고, 필요하다면 업데이트하세요7.
참고 사항
- NAT 모드는 WSL의 기본 네트워킹 방식으로, 일부 환경(특히 VPN 사용, 특정 방화벽 설정)에서는 네트워크 연결에 문제가 생길 수 있습니다.
- VPN을 사용 중이라면 /etc/resolv.conf 파일을 수동으로 설정해 DNS 문제를 해결할 수도 있습니다.
- Windows 11 22H2 이상에서는 mirrored 모드를 사용하는 것이 네트워킹 호환성 및 성능 면에서 더 유리할 수 있습니다.
요약
- 네트워크 초기화 및 재부팅
- .wslconfig 파일의 네트워킹 모드 점검 및 변경
- Hyper-V, 방화벽, 어댑터 상태 확인
- WSL/Windows 최신 업데이트 적용
위 절차를 순차적으로 적용하면 대부분의 WSL 네트워크 구성 오류를 해결할 수 있습니다.
참고자료:
- https://developer-itspjc.tistory.com/44
- https://butteryoon.github.io/tools/2020/09/13/wsl2.html
- https://learn.microsoft.com/ko-kr/windows/wsl/troubleshooting
- https://sangheon.com/wsl2-%EC%99%B8%EB%B6%80-%EB%84%A4%ED%8A%B8%EC%9B%8C%ED%81%AC-%EC%97%B0%EA%B2%B0-%EB%AC%B8%EC%A0%9C/
- https://p-ssw0rd.tistory.com/173
- https://hbcha0916.tistory.com/33
- https://pinetree0308.tistory.com/206
- https://blog.naver.com/bsmouse/223624044811
- https://learn.microsoft.com/ko-kr/windows/wsl/networking
(이전 게시물)
wsl 실행시 아래와 같은 오류 메세지를 출력하고 실행되지 않는 경우...
네트워크를 구성하지 못했습니다(networkingMode Nat). 네트워킹을 사용하지 않도록 설정하려면 C:\Users\[username]\.wslconfig 'wsl2.networkingMode=None'를 설정합니다. Error code: Wsl/Service/CreateInstance/CreateVm/ConfigureNetworking/HNS/0x80070424
다음과 같은 사항을 체크 해보자...
`Windows 기능 켜기/끄기` 창에서 `가상 머신 플랫폼` 체크 되어 있는지 확인.
해결되지 않는 경우 확인 해볼 수 있는 정보는 아래 링크 참조.
https://github.com/microsoft/WSL/issues/10709
WSL Networking Broken in 2.0.7 · Issue #10709 · microsoft/WSL
Windows Version Microsoft Windows [Version 10.0.22631.2506] WSL Version 2.0.7.0 Are you using WSL 1 or WSL 2? WSL 2 WSL 1 Kernel Version Linux version 5.15.133.1-microsoft-standard-WSL2 (root@1c602...
github.com