wsl2host

호스트 파일 자동 업데이트

WSL2 VM의 IP 주소가 변경될 때마다(예: VM을 중지하고 다시 시작할 때) 서비스가 Windows 호스트 파일을 자동으로 업데이트합니다. 수동으로 IP를 확인하고 hosts 파일을 수정할 필요가 없습니다.

호스트 이름 기반 접속

WSL2 배포판 이름을 기반으로 호스트 이름을 생성합니다. 예를 들어, ‘Ubuntu-18.04’ 배포판은 ‘ubuntu1804.wsl’이라는 호스트 이름으로 등록됩니다. 여러 개의 배포판이 동시에 실행 중인 경우 모두 등록됩니다.

별칭(Alias) 지원

v0.3부터 개별 사용자가 WSL2 VM IP에 대한 별칭을 지정할 수 있습니다. WSL2의 기본 배포판에서 ‘~/.wsl2hosts’ 파일을 생성하고, 공백으로 구분된 호스트 이름을 입력하면 됩니다(예: some.client.local my-app.local). 이 기능은 특정 개발 워크플로우에 유용합니다.

다운로드·설치 방법

GitHub 릴리즈 페이지에서 최신 바이너리 파일을 다운로드합니다. 파일을 적절한 위치(예: Documents 폴더)에 넣고, 관리자 권한으로 실행되는 명령 프롬프트에서 다음 명령어를 실행합니다.

• 설치 및 시작: .wsl2host.exe install 명령어를 실행한 후 Windows 사용자 이름과 비밀번호를 입력합니다.
• 제거: .wsl2host.exe remove 명령어를 실행합니다.

기본 사용법

설치가 완료되면 서비스가 자동으로 시작됩니다. WSL을 실행하고 Windows의 명령 프롬프트에서 WSL2 배포판에 해당하는 호스트 이름으로 ping 테스트(예: ping ubuntu1804.wsl)를 수행하여 연결을 확인할 수 있습니다.

이런 경우에 유용합니다

• WSL2에서 실행 중인 웹 서버나 애플리케이션에 Windows 브라우저에서 호스트 이름으로 접근해야 할 때
• 로컬 개발 환경에서 여러 서비스 간의 통신을 호스트 이름으로 설정해야 할 때
• WSL2 VM의 IP가 자주 변경되어 hosts 파일을 수동으로 관리하기 번거로울 때

지원 환경·시스템 요구사항

WSL2를 지원하는 Windows 시스템에서 작동합니다. 사용자 계정은 ‘서비스로 로그온’ 권한을 보유해야 합니다.

최신 버전·업데이트

최신 버전은 GitHub 릴리즈 페이지에서 확인할 수 있습니다. Windows Insider를 업그레이드하면 서비스가 제거될 수 있으므로, 업그레이드 후에는 최신 버전으로 다시 설치해야 합니다.

제한 사항·확인 사항

• Windows Insider 업그레이드 시 서비스가 불완전하게 제거될 수 있습니다.
• 설치 시 ‘서비스로 로그온’ 권한 설정이 필요합니다.
• v0.2.0부터 ‘windows.local’ 이름 사용이 지원되지 않습니다.