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 모드를 사용하는 것이 네트워킹 호환성 및 성능 면에서 더 유리할 수 있습니다.

요약

1. 네트워크 초기화 및 재부팅
2. .wslconfig 파일의 네트워킹 모드 점검 및 변경
3. Hyper-V, 방화벽, 어댑터 상태 확인
4. WSL/Windows 최신 업데이트 적용

위 절차를 순차적으로 적용하면 대부분의 WSL 네트워크 구성 오류를 해결할 수 있습니다.

참고자료:

1. https://developer-itspjc.tistory.com/44
2. https://butteryoon.github.io/tools/2020/09/13/wsl2.html
3. https://learn.microsoft.com/ko-kr/windows/wsl/troubleshooting
4. 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/
5. https://p-ssw0rd.tistory.com/173
6. https://hbcha0916.tistory.com/33
7. https://pinetree0308.tistory.com/206
8. https://blog.naver.com/bsmouse/223624044811
9. 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

 

---

변경 사항

2025-02-23: 관련 정보를 모아서 내용 추가

2025-02-23: 개인 유저 아이디 경로 표시 된 문제 수정