# devAlice — .wslconfig 템플릿 (개발자 워크스테이션용) # # 위치: %USERPROFILE%\.wslconfig # 예: C:\Users\me\.wslconfig # # 적용: # 1. 위 경로에 본 파일을 ".wslconfig" 이름으로 저장 # 2. 관리자 PowerShell에서: wsl --shutdown # 3. 다음 wsl 실행 시 자동 반영 # # 공식 문서: https://learn.microsoft.com/en-us/windows/wsl/wsl-config [wsl2] # 메모리 한도 — 호스트 RAM의 50~75% 권장. 기본은 50%지만 명시하는 게 안전. # 너무 크게 잡으면 Windows 본체가 스왑. 너무 작으면 빌드 OOM. memory=8GB # CPU 개수 — 기본은 호스트의 모든 논리 코어. 명시적으로 줄이고 싶다면. # processors=8 # Swap (디스크) — 메모리 한도 초과 시 스왑. 0 = 비활성. 권장 4~8GB. swap=4GB # Swap 파일 위치 (기본: %TEMP%/swap.vhdx). 빠른 SSD 경로 권장. # swapFile=C:\\wsl-swap.vhdx # Localhost 포워딩 — WSL 내 서비스(예: node dev server)를 Windows 브라우저에서 # 'localhost:PORT'로 접근 가능하게. 기본 true. 일부 환경에서 충돌 시 false. localhostForwarding=true # 페이지 보고 (DEBUG) — 일반적으로 끔. # debugConsole=false # GUI 앱 지원 (WSLg) — Linux GUI를 Windows에 직접 렌더. 기본 true (Win11). guiApplications=true # Nested virtualization — WSL 안에서 다시 VM(예: Docker Desktop, qemu) 실행. # 기본 false. 필요시 활성화. # nestedVirtualization=true # 커널 변경 (고급) — 커스텀 커널 사용 시. # kernel=C:\\wsl-kernels\\my-kernel # kernelCommandLine=cgroup_no_v1=all systemd.unified_cgroup_hierarchy=1 # Mirrored Networking (Windows 11 22H2+) — WSL이 Windows 네트워크 인터페이스를 # 그대로 미러링. localhostForwarding보다 호환성 ↑ (VPN·회사망 친화). # 활성화 시 별도 [experimental] 섹션 필요. # networkingMode=mirrored [experimental] # Mirrored networking (위와 짝). 회사 VPN으로 자주 깨지는 경우 시도. # networkingMode=mirrored # DNS 터널링 — 회사 DNS·VPN과 잘 동작. # dnsTunneling=true # Autoproxy — Windows의 시스템 프록시 설정을 WSL에 자동 반영. # autoProxy=true # Sparse VHD — 동적 디스크. 사용 안 하는 공간을 자동 회수. # sparseVhd=true