외부와 통신하기: 포트 매핑의 원리

왜 포트 매핑이 필요한가요?

도커 컨테이너는 일종의 작은 가상 머신처럼 동작합니다. 내 컴퓨터(호스트) 안에 있지만, 네트워크는 완전히 독립된 공간으로 나뉘어져 있습니다.

철저히 격리된 컨테이너의 세계

예를 들어, 컨테이너 안에서 Node.js 서버가 3000번 포트로 실행되었다고 가정해 보겠습니다. 이 3000번 포트는 컨테이너 내부의 포트일 뿐, 내 컴퓨터의 3000번 포트와는 아무런 관련이 없습니다. 따라서 브라우저를 열고 내 컴퓨터의 `localhost:3000`에 접속하더라도 아무것도 응답하지 않게 됩니다.

이 두 세계를 연결하기 위해서는 내 컴퓨터의 특정 포트로 들어오는 요청을 컨테이너 내부의 특정 포트로 전달(Forwarding)해 주어야 합니다. 이 과정을 포트 매핑(Port Mapping)이라고 부릅니다.

포트 매핑 설정 방법

도커 컨테이너를 실행할 때, 명령어에 `-p` (publish) 옵션을 추가하여 포트 매핑을 설정할 수 있습니다.

`-p 호스트_포트:컨테이너_포트` 공식

포트 매핑의 규칙은 아주 단순하지만, 순서를 헷갈리기 쉽습니다. 항상 콜론(:)을 기준으로 왼쪽이 내 컴퓨터(호스트)의 포트, 오른쪽이 컨테이너 내부의 포트입니다.

docker run -p 8080:3000 my-node-app

위와 같이 실행한 후에는 브라우저에서 `localhost:8080`으로 접속해야 합니다. 사용자가 8080으로 접속하면 도커가 이를 가로채서 컨테이너 안의 3000번에서 기다리고 있는 앱에게 전달해 줍니다.

실전 예제로 이해하는 포트 매핑

바이브코딩을 하다 보면 여러 개의 컨테이너를 동시에 띄워야 할 때가 있습니다. 이때 포트 매핑의 진가가 발휘됩니다.

하나의 이미지로 여러 개의 포트 열기

동일한 애플리케이션 이미지를 두 개 실행하되, 각각 다른 포트로 접근하고 싶다면 어떻게 해야 할까요? 컨테이너 내부 포트는 고정해두고, 호스트 포트만 다르게 매핑하면 됩니다.

# 첫 번째 서버 실행
docker run -d -p 8081:80 nginx

# 두 번째 서버 실행
docker run -d -p 8082:80 nginx

포트를 열어두지 않았을 때의 보안 효과

역으로 생각해보면, 포트 매핑을 명시적으로 해주지 않으면 외부에서 해당 컨테이너로 절대 접근할 수 없다는 뜻이기도 합니다. 이는 보안상 큰 장점이 됩니다. 예를 들어 데이터베이스 컨테이너를 띄울 때 호스트와 포트 매핑을 하지 않으면, 오직 도커 네트워크 내부에 있는 다른 컨테이너(예: API 서버)만이 데이터베이스에 접근할 수 있게 됩니다. 외부의 악의적인 접근을 원천 차단하는 것이죠.