WSL mirrored 네트워크 모드 구성 가이드
WSL2.6.0 네트워크 모드 업그레이드 구성 가이드
Categories:
버전 요구사항
현재 버전 상태:
- 최신 안정 버전: 2.5.9(네트워크 구성 결함 존재)
- 권장 버전: 2.6.0 프리뷰 버전(mirrored 모드 전체 지원)
모드 비교 분석
| 특징 | bridge 모드(폐기됨) | mirrored 모드(권장) |
|---|---|---|
| 프로토콜 스택 아키텍처 | 이중 프로토콜 스택 | 공유 프로토콜 스택 |
| IP 주소 할당 | 독립 IP(Windows+WSL) | 호스트 IP 공유 |
| 포트 리소스 | 독립 사용 | 공유 포트(충돌 방지 필요) |
| 네트워크 성능 | 비교적 무거움 | 가볍고 효율적 |
| 구성 복잡도 | 간단 | 방화벽 정책 심층 구성 필요 |
표준 구성 절차
1. 네트워크 모드 설정
WSL Settings 애플리케이션을 통해 기본 모드 설정:
- 설정 애플리케이션 열기
- “Network” 탭 선택
- 네트워크 모드를 “Mirrored"로 설정
- 구성 적용 후 WSL 재시작
2. 방화벽 정책 구성
PowerShell을 통해 전체 정책 구성 실행:
# WSL 가상 머신 GUID 정의
$wslGuid = '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}'
# 방화벽 정책 구성(순서대로 실행)
Set-NetFirewallHyperVVMSetting -Name $wslGuid -Enabled True
Set-NetFirewallHyperVVMSetting -Name $wslGuid -DefaultInboundAction Allow
Set-NetFirewallHyperVVMSetting -Name $wslGuid -DefaultOutboundAction Allow
Set-NetFirewallHyperVVMSetting -Name $wslGuid -LoopbackEnabled True
Set-NetFirewallHyperVVMSetting -Name $wslGuid -AllowHostPolicyMerge True
# 구성 결과 검증
Get-NetFirewallHyperVVMSetting -Name $wslGuid
3. 포트 매핑 검증
# 예시: 80 포트 점유 상황 확인
Get-NetTCPConnection -LocalPort 80
일반적인 문제 해결
문제1: 외부 연결 수립 불가
- 점검 절차:
Get-NetFirewallHyperVVMSetting출력에서 모든 필드는 True/Allow 여야 함 - 해결책: 방화벽 정책 구성 순서대로 재실행
문제2: 포트 충돌
- 검증 방법:
netstat -ano로 포트 점유 확인 - 처리 권장: Windows 측 포트 점유 우선 해제, 또는 WSL 서비스 리스닝 포트 수정
검증 방법
- WSL 서비스(Nginx/Apache 등) 시작
- Windows 호스트에서
http://localhost:<port>접근 - 로컬 네트워크 장치에서
http://<host-ip>:<port>접근