[Docker] Windows + Docker Desktop에서 network_mode: host 적용 안되는 문제

 Windows 환경에서 Docker Desktop을 사용하면서 `network_mode: host` 설정이 제대로 적용되지 않는 문제가 발생했습니다. 이 문제를 해결하기 위한 과정을 공유하고자 글을 작성하였습니다.

문제 상황

services:
  spring-app:
    build:
      context: .  # Dockerfile이 위치한 폴더
      dockerfile: Dockerfile.local  # Spring Boot Dockerfile 이름
    network_mode: host

 

 docker-compose.yml 파일을 위와 같이 설정했음에도 불구하고, 컨테이너가 호스트 네트워크를 사용하지 않아 포트 접근에 문제가 발생했습니다.

 

Docker 공식 문서 참고

 Docker의 공식 문서에 따르면, host 네트워킹 드라이버는 Linux 호스트에서만 동작하며, Docker Desktop 버전 4.34 이상에서 선택적으로 사용할 수 있다고 명시되어 있습니다.

The host networking driver only works on Linux hosts, and as an opt-in feature in Docker Desktop version 4.34 and later. To enable this feature in Docker Desktop, navigate to the Resources tab in Settings, and then under Network select Enable host networking.
(출처:https://docs.docker.com/engine/network/tutorials/host/#prerequisites)

 

즉, Windows에서 host 네트워크 모드를 사용하려면 Docker Desktop의 설정에서 해당 기능을 활성화해야 합니다.

 

해결 방법

Docker Desktop에서 host 네트워크 모드를 활성화하는 방법은 다음과 같습니다.

1. Docker Desktop 설정 열기
2. Resources 탭으로 이동
3. Resources 하위 메뉴에서 Network를 선택
4. Enable host networking 옵션 체크
5. Apply & restart 클릭
   
   

접속 확인

docker-compose up --build

컨테이너가 정상적으로 실행되었는지 확인하기 위해 포트 localhost:8080으로 접근해보니 문제가 해결된 것을 확인할 수 있었습니다.

 

마무리

 이번 글에서는 Windows 환경에서 Docker Desktop을 사용할 때 network_mode: host 설정이 적용되지 않는 문제에 대해 살펴보았습니다. Docker 공식 문서를 참고하여 Docker Desktop의 설정에서 호스트 네트워킹을 활성화함으로써 문제를 해결할 수 있었습니다. Docker의 네트워크 설정은 운영 체제에 따라 다르게 동작할 수 있으므로, 공식 문서를 꼼꼼히 확인하는 것이 중요합니다. 도움이 되셨길 바랍니다. 감사합니다.