🔱 compose 포트 매핑 정리 | 충돌 바로 찾기

서비스와 포트 매핑 — 한 줄에 "서비스명: 매핑, 매핑". 매핑은 호스트:컨테이너, IP:호스트:컨테이너, 범위, /udp 를 받습니다

비교 항목	ports	expose
호스트에서 접속	호스트 포트를 열어 바깥에서 접속 가능	열지 않음. 같은 네트워크의 컨테이너만 접속
호스트 포트 충돌	같은 호스트 포트를 두 번 쓰면 기동 실패	호스트 포트를 쓰지 않아 충돌이 없음
적는 값	호스트:컨테이너 형태	컨테이너 포트만

어느 서비스끼리 호스트 포트를 다투는지 찾기

compose 파일의 포트 목록을 붙이면 호스트:컨테이너 표기를 한 줄씩 펼쳐 정리하고, 같은 호스트 포트를 쓰는 서비스를 짝지어 지목합니다. 범위 표기는 포트 하나씩 펼쳐서 비교하고, 호스트 포트를 적지 않은 매핑은 실행할 때 자동 배정되므로 충돌 대상에서 뺍니다. 프로토콜이 다르면 같은 번호라도 충돌로 보지 않습니다.

바인딩 주소도 함께 봅니다. 주소를 적지 않으면 모든 인터페이스에 열리므로 특정 주소로 적은 같은 번호와 겹치고, 서로 다른 특정 주소끼리는 겹치지 않습니다. ports 와 expose 의 차이는 아래 표에 정리했습니다. 표기 규칙은 Compose 파일 규격 문서를 따릅니다(2026년 10월 기준).

compose 파일 전체를 파싱하지는 않습니다. 긴 형식의 ports 블록, 변수 치환, profiles, 호스트 네트워크 모드는 해석하지 않고, 호스트와 컨테이너 범위 길이가 다른 표기는 오류로 알립니다. 실제로 쓰이는 포트는 기동 후 직접 확인하세요.

자주 묻는 질문

호스트 포트를 적지 않으면 충돌하지 않나요?

컨테이너 포트만 적으면 호스트 포트는 실행할 때 비어 있는 번호로 자동 배정됩니다. 번호가 미리 정해지지 않으므로 이 도구는 충돌 대상에서 제외하고 따로 세어 보여 줍니다.

주소를 적은 쪽과 안 적은 쪽이 같은 번호면 어떻게 되나요?

겹치는 것으로 봅니다. 주소를 적지 않으면 모든 인터페이스에 열리므로 특정 주소로 같은 번호를 연 쪽과 범위가 겹칩니다. 서로 다른 특정 주소끼리는 겹치지 않습니다.

ports 와 expose 는 무엇이 다른가요?

ports 는 호스트 포트를 열어 바깥에서 접속할 수 있게 하고, expose 는 호스트 포트를 쓰지 않아 같은 네트워크의 컨테이너만 접속합니다. 그래서 expose 만 쓰면 호스트 포트 충돌이 생기지 않습니다.

🔱docker-compose 포트 매핑 정리 도구

관련된 도구

.dockerignore 생성기

Dockerfile 베스트프랙티스 체크리스트

어느 서비스끼리 호스트 포트를 다투는지 찾기

자주 묻는 질문

관련된 도구

.dockerignore 생성기

Dockerfile 베스트프랙티스 체크리스트

어느 서비스끼리 호스트 포트를 다투는지 찾기

자주 묻는 질문

같은 카테고리 도구