docker container에서 localhost 접속하기 host.docker.internal

Intro

docker에서 컨테이너들이 실행 중인 서버를 바라 봐야 할 경우가 있습니다.

Docker Compose를 이용해 여러개의 도커 컨테이너를 실행해서 하나의 어플리케이션을 담당한다고 했을때, 하나의 네트워크로 연결해 사용하게 되는데요. 정작 컨테이너에서 로컬 서버에는 어떻게 접근해야 할까요?

제 맥북에서 사용중인 Docker에는 컨테이너가 아직 PostgreSQL 하나밖에 없어서, 이 컨테이너를 이용해서 시도 해 보겠습니다.

제 컨테이너 같이 DB 서버라면 사실 필요할 일은 없지만, Apache나 NginX 같은 웹 서버의 경우는 흔하게 필요한 상황이 발생 할 수 있겠습니다.

실습

일단 제일 먼저 해당 Container로 접속 해 보겠습니다.

컨테이너 접속 GUI

Github Desktop을 사용하는 경우 컨테이너에 접속하는 방법입니다.

위에 보이는 CLI 버튼으로 쉽게 접속 해 터미널을 띄울 수 있습니다.

간단하죠.

컨테이너 접속 CLI

그렇다면 이번에는 CLI 환경에서 한번 차근차근 띄워보겠습니다.

1. 터미널을 켭니다

2. 실행중인 Docker 컨테이너 목록 확인

docker ps

명령어로 가동중인 컨테이너들을 볼 수 있습니다. -a 옵션을 붙이면 멈춰있는 컨테이너도 다 표시해줍니다.

그럼 제일 왼쪽에 79..로 시작하는게 해당 컨테이너의 ID 입니다.

그럼 이제 docker exec 명령어를 통해 해당 컨테이너의 STDIN 표준 입출력을 열어 가상 TTY를 통해 접속합니다.

 docker exec -it 79edaba9d6cb /bin/bash

그러면 이제 해당 컨테이너에 접속이 완료 된 상태입니다.

CURL 설치

각자 컨테이너에 접속을 잘 해다고 보고, 이제 다음 스텝으로 넘어가겠습니다.

curl 을 이용해 테스트 해 보려 했는데 curl이 없습니다.

apt update

로 업데이트를 한번 해주고

apt install curl

curl을 설치 해 줍니다.

당연히 Y 를 입력해야 설치가 됩니다.

​

이제 localhost로 curl 명령을 보내 보겠습니다.

curl localhost:8080

​

Failed to connect to localhost port 8080: Connection refused 가 나오네요..

​

하지만

​

저는 분명 localhost에 서버를 하나 띄워 두었습니다.

로컬에서 같은 명령어를 입력 하면

잘 받아오는 것을 확인할 수 있습니다. Docker에서 localhost는 컨테이너 그 자신의 주소기 때문에 이런 문제가 발생 한 것 입니다.

해결

그렇다면 docker container에서 localhost에 어떻게 접근할 수 있을까요?

첫번째: 쉬운 방법

첫번째로 아주 단순하지만 좋지 않은 방법이 있습니다.

바로 내부 아이피를 이용하는 것 입니다. Windows에서는 ipconfig를, Mac에서는

ipconfig getifaddr en0

를 입력해 간단히 내부아이피 주소를 찾을 수 있습니다.

그 다음 해당 내부아이피 주소를 이용하면 됩니다.

curl 192.168.0.19:8080

물론, 접속이 잘 되지만 이건 좋은 방법이 아닙니다. 내부아이피야 인터넷 사용하는 환경에 따라 매번 달라질 수 있는데 그럴때마다 수정을 할 수도 없고 번거롭습니다.

두번째: 좋은 방법

이 글을 작성한 이유입니다. host.docker.internal를 이용합니다.

curl host.docker.internal:8080

아주 간단하죠. 환경에 따라 변할 걱정도 할 필요가 없습니다.

docker-compose

docker로 localhost를 바라 볼 상황이야 여러경우가 있겠지만 저는 웹서버를 docker에서 띄우고, 나머지 개발중인 여러개의 어플리케이션들은 로컬에서 띄운 상황입니다. docker-compose 에서는 웹 서버인 nginx를 비롯해 데이터베이스나 검색엔진, 세션db, FTP 서버 등 여러가지를 한번에 관리 하고 있는데요.

docker-compose.yml 과 같은 폴더에 있는 conf/nginx.conf 파일의 일부 입니다.

  server {
      listen 80 default;
    server_name localhost;

    # 인증 어플리케이션
    location /auth/ {
      proxy_pass http://host.docker.internal:8081/auth/;
    }

    # 메인 어플리케이션
    location /main/ {
      proxy_pass http://host.docker.internal:8082/main/;
    }
}

이처럼 proxy_pass 에서 로컬에 띄워 둔 어플리케이션을 바라 보기 위해 host.docker.internal:포트번호 를 사용했습니다. Windows 에서 docker를 띄울 때는 상관 없지만 Linux 환경의 docker에서는 docker-compose.yml 에서

nginx:
    extra_hosts:
      - "host.docker.internal:host-gateway"

이런식으로 해당 컨테이너에게 extra_hosts 에 대해 알려 주어야 합니다.

그렇지 않으면 아래의 에러를 뿜어냅니다.

nginx: [emerg] host not found in upstream "host.docker.internal" in /etc/nginx/nginx.conf:77

​

이상입니다.