## 🐳 [[Docker]] 네트워크 합치기는 귀찮고, 호스트 포트로 '급하게' 통신하고 싶을 때 {#sec-f27028c85270}

보통 컨테이너끼리 통신할 때는 공용 브릿지 네트워크를 하나 파서 서비스 이름(예: `http://app-b:8080`)으로 호출하는 게 정석입니다. 하지만 살다 보면 정석대로 하기 힘든 '피치 못할 상황'이 생기곤 하죠.

## 이런 '억울한 상황'이라면 이 방법을 쓰세요 {#sec-3da904d03848}

* **호스트에 직접 설치된 서비스와 통신할 때:** DB나 Redis가 컨테이너가 아니라 호스트 OS에 직접 설치되어 있어, 네트워크를 합칠래야 합칠 수가 없을 때.
* **남이 만든 컨테이너라 네트워크 설정을 건드리기 무서울 때:** 내가 관리하지 않는 복잡한 네트워크 설정에 내 컨테이너를 강제로 끼워 넣었다가 장애가 날까 봐 두려울 때.
* **로컬 개발 중 '임시'로 연결만 확인하고 싶을 때:** 네트워크 설계고 뭐고, 일단 지금 당장 호스트 포트로 뚫려 있는 서비스에 요청이 가는지 확인부터 해야 할 때.

이럴 때 유용한 치트키가 바로 `host.docker.internal`입니다.

![호스트이용-컨테이너간-통신.png](/media/whitedec/blog_img/4e661ed1ddb648529e5b1681c022cd25.webp)

---

## 해결책 : "컨테이너 밖 세상을 보는 창" `host.docker.internal` {#sec-979a012d89c8}

컨테이너 안에서 `127.0.0.1`을 외쳐봐야 자기 자신(컨테이너)만 보일 뿐입니다. 이때 `host.docker.internal`이라는 특수 도메인을 사용하면 컨테이너 벽을 뚫고 호스트 머신의 IP를 찾아냅니다.

**파이썬(DRF) 코드 예시:**

```python
# 'localhost' 대신 'host.docker.internal'을 써서 호스트 포트로 나갑니다.
# App-B가 호스트의 8080 포트에 바인딩되어 있다면 아래와 같이 호출합니다.
NEXTCLOUD_URL = "http://host.docker.internal:8080"

response = requests.get(NEXTCLOUD_URL)

```

---

## ⚠️ [[Linux]] 유저라면 '수동 설정'이 필수입니다 {#sec-169e1a1f873c}

Docker Desktop(Mac/Windows)은 이게 기본으로 되지만, **순수 리눅스 서버**에서는 Docker가 이 도메인을 자동으로 잡아주지 않습니다. 빌드나 실행 시 "이 도메인은 호스트 IP를 뜻해"라고 명시해줘야 합니다.

**Docker Compose 설정 예시:**

```yaml
services:
  drf-app:
    image: my-drf-app-image
    extra_hosts:
      # host.docker.internal이라는 이름으로 호스트 게이트웨이에 접근하겠다는 선언
      - "host.docker.internal:host-gateway"

```

---

## 언제나 정답은 아닙니다 {#sec-bb28e4a13c7f}

다시 한번 강조하지만, 이 방식은 **최후의 수단**에 가깝습니다.

1. **가장 좋은 방법:** 공용 브릿지 네트워크를 만들고 컨테이너 이름으로 통신하기 (보안상 가장 안전).
2. **이 방법을 쓰는 이유:** 호스트에 직접 띄운 프로세스에 접근해야 하거나, 네트워크 구조를 도저히 합칠 수 없는 '고립된' 환경일 때.

작년에 적어둔 이 '비상구' 사용법은 정석이 막혔을 때 꺼내 쓰는 히든 카드로만 활용해 보세요!