Skip to content

네트워크 설정 ​

WSL Dashboard는 WSL 2와 호스트 OS(Windows) 간의 네트워크 통신 구성을 단순화합니다. 포트 포워딩과 전역 HTTP 프록시를 지원합니다.

포트 포워딩 (Port Forwarding) ​

WSL 2는 가상 네트워크 어댑터를 사용하므로, LAN의 다른 장치에서 WSL 내부 서비스에 액세스하는 것은 일반적으로 복잡합니다.

  • 핵심 기능: Windows의 특정 포트를 WSL 인스턴스 내부의 포트에 매핑할 수 있습니다.
  • 자동 방화벽 규칙: WSL Dashboard는 포워딩 규칙 생성 시 Windows Defender 방화벽에 필요한 인바운드 규칙을 자동으로 추가하여 외부 트래픽이 통과할 수 있도록 합니다.
  • 구성 항목:
    • 호스트 IP: 일반적으로 0.0.0.0(모든 네트워크 카드에서 수신) 또는 127.0.0.1.
    • 호스트 포트: Windows 쪽에서 개방하는 포트.
    • WSL 포트: 인스턴스 내부 서비스가 수신하는 포트.

전역 HTTP 프록시 (HTTP Proxy) ​

WSL 내부에서 프록시를 구성하려면(git clone 또는 apt install이 느릴 때) 일반적으로 여러 설정 파일을 수정해야 합니다.

  • 빠른 구성: WSL Dashboard는 전역 프록시 스위치를 제공합니다.
  • 작동 원리: 설정에 따라 선택한 인스턴스의 프록시 환경 변수 또는 관련 서비스의 프록시 옵션을 자동으로 구성하여 호스트 IP를 수동으로 가져오는 번거로움을 없앱니다.
  • 지원 프로토콜: 일반적인 http:// 및 socks5:// 프로토콜.

네트워크 상태 모니터링 ​

네트워크 패널에서 다음을 실시간으로 확인할 수 있습니다:

  • WSL 호스트 IP: Windows 가상 네트워크 어댑터의 IP.
  • WSL 인스턴스 IP: 인스턴스 내부에서 실제로 할당된 주소.
  • 활성 연결: 현재 적용 중인 포트 포워딩 규칙 및 트래픽 상태를 모니터링.

고급 네트워크 모드 (Mirrored Mode) ​

Windows 11 사용자의 경우 WSL 2는 "미러" 네트워크 모드를 지원합니다.

  • 장점: 미러 모드를 사용하면 WSL 인스턴스가 호스트 OS의 네트워크 인터페이스를 직접 공유하여 복잡한 VPN 또는 LAN 발견 문제를 많이 해결합니다.
  • 구성 권장 사항: 미러 모드를 활성화한 경우 WSL Dashboard의 포트 포워딩 기능은 계속 작동하지만, 호스트 IP를 통해 직접 서비스에 액세스하는 것이 더 나을 수 있습니다.

팁

settings.toml에서 auto_shutdown_distros = true를 구성하면 Dashboard를 닫은 후 백그라운드에 불필요한 네트워크 수신 작업이 남지 않도록 보장할 수 있습니다.

일반적인 문제 해결 ​

포트 충돌 ​

포트 포워딩이 작동하지 않으면 다음을 확인하세요:

  1. 호스트 포트가 점유되었는지: netstat -ano | findstr :<포트 번호>로 확인.
  2. 관리자 권한: 일부 포트(1024 미만 등)는 수신하려면 관리자 권한이 필요할 수 있습니다.

방화벽 차단 ​

WSL Dashboard가 규칙을 자동으로 구성하려고 시도하지만, 타사 방화벽(화웨이, 360 등)을 설치한 경우 wsldashboard.exe의 네트워크 액세스 권한을 수동으로 허용해야 할 수 있습니다.