Docker에서 웹 서버나 API 서버를 실행할 때 가장 중요한 설정 중 하나가 바로 포트(Port)입니다. 컨테이너 내부에서 실행되는 서비스는 기본적으로 외부에서 직접 접근할 수 없으며, 포트 매핑(Port Mapping)을 통해 호스트와 연결해야 합니다.
하지만 컨테이너를 여러 개 운영하다 보면 어떤 포트가 어떤 컨테이너와 연결되어 있는지 헷갈리는 경우가 많습니다. 특히 운영 서버에서는 포트 충돌이나 잘못된 매핑 때문에 서비스 장애가 발생하기도 합니다.
이럴 때 사용하는 명령어가 바로 docker port입니다.
Docker Port는 실행 중인 컨테이너의 포트 매핑 정보를 확인하는 명령어입니다. 어떤 내부 포트가 호스트의 어떤 포트와 연결되어 있는지 빠르게 확인할 수 있어 운영 및 장애 분석에 매우 유용합니다.
이번 글에서는 Docker Port의 개념부터 기본 사용법, 특정 포트 조회 방법, 실무 활용 사례, 운영 시 주의사항까지 자세히 알아보겠습니다.
Docker Port란 무엇인가?
Docker Port는 컨테이너의 포트 매핑 정보를 출력하는 명령어입니다.
컨테이너 내부 포트와 호스트 포트가 어떻게 연결되어 있는지 확인할 수 있습니다.
실제 네트워크 연결 상태를 빠르게 확인할 수 있기 때문에 운영 서버에서 자주 사용하는 관리 명령어입니다.
Docker Port는 언제 사용하는가?
다음과 같은 상황에서 많이 사용됩니다.
- 포트 매핑 확인
- 웹 서버 접속 문제 분석
- API 서버 확인
- 포트 충돌 확인
- 서비스 운영 점검
- Docker 네트워크 디버깅
특히 여러 개의 컨테이너를 동시에 운영하는 환경에서 매우 유용합니다.
Docker Port 기본 사용법
기본 명령어는 다음과 같습니다.
docker port <컨테이너명>예를 들어 nginx 컨테이너의 포트를 확인하려면 다음과 같이 실행합니다.
docker port nginx출력 예시는 다음과 같습니다.
80/tcp -> 0.0.0.0:8080이는 컨테이너의 80번 포트가 호스트의 8080 포트와 연결되어 있다는 의미입니다.
특정 포트만 확인하기
특정 포트의 매핑 정보만 확인할 수도 있습니다.
docker port nginx 80출력 예시입니다.
0.0.0.0:8080필요한 포트만 빠르게 조회할 수 있습니다.
여러 포트 확인
컨테이너에서 여러 포트를 사용하는 경우 모든 포트가 출력됩니다.
예를 들어 다음과 같이 표시될 수 있습니다.
80/tcp -> 0.0.0.0:8080
443/tcp -> 0.0.0.0:8443HTTP와 HTTPS가 각각 다른 호스트 포트로 연결되어 있음을 확인할 수 있습니다.
포트 매핑 생성 예제
포트 매핑은 컨테이너 실행 시 지정합니다.
docker run -d -p 8080:80 nginx이후 Docker Port를 실행하면 다음과 같이 확인할 수 있습니다.
docker port <컨테이너명>컨테이너 생성 시 지정한 포트 정보가 그대로 출력됩니다.
Docker Port와 Docker PS의 차이
docker ps에서도 포트 정보를 확인할 수 있습니다.
docker ps하지만 여러 컨테이너가 실행 중인 경우 원하는 컨테이너의 포트만 확인하기는 어렵습니다.
반면 Docker Port는 특정 컨테이너의 포트 정보만 출력하기 때문에 더욱 간편하게 사용할 수 있습니다.
Docker Port 실무 활용 예제
Docker Port는 웹 서비스 장애 분석이나 포트 충돌 확인 시 매우 유용한 명령어입니다. 특히 여러 개의 웹 서버나 API 서버를 동시에 운영하는 환경에서는 포트 매핑을 빠르게 확인할 수 있어 문제 해결 시간을 크게 단축할 수 있습니다.
웹 서버 포트 확인
현재 실행 중인 Nginx 컨테이너의 포트를 확인합니다.
docker port nginx출력 예시입니다.
80/tcp -> 0.0.0.0:8080웹 브라우저에서는 다음 주소로 접속해야 합니다.
http://서버IP:8080컨테이너의 80번 포트가 아닌 호스트의 8080 포트로 접속해야 정상적으로 서비스가 표시됩니다.
HTTPS 포트 확인
HTTPS를 사용하는 경우입니다.
docker port web출력 예시입니다.
80/tcp -> 0.0.0.0:8080
443/tcp -> 0.0.0.0:8443HTTPS는 다음 주소로 접속합니다.
https://서버IP:8443특정 포트 확인
80번 포트만 확인하려면 다음과 같이 실행합니다.
docker port nginx 80결과는 다음과 같습니다.
0.0.0.0:8080필요한 포트만 빠르게 확인할 수 있습니다.
여러 컨테이너 비교
여러 개의 웹 서버를 운영하는 경우 각각 확인할 수 있습니다.
docker port nginx1
docker port nginx2포트 충돌 여부를 쉽게 확인할 수 있습니다.
Linux 서버 문제 해결
운영 서버에서 웹 사이트가 정상적으로 실행되지 않는 문제가 발생했습니다.
컨테이너는 정상적으로 실행되고 있었지만 브라우저에서는 접속이 되지 않았습니다.
먼저 컨테이너 상태를 확인했습니다.
docker ps이후 포트 매핑을 확인했습니다.
docker port nginx출력 결과는 다음과 같았습니다.
80/tcp -> 0.0.0.0:8081관리자는 8080 포트로 접속하고 있었지만 실제 서비스는 8081 포트로 연결되어 있었습니다.
접속 포트를 수정하자 즉시 서비스가 정상적으로 동작했습니다.
Docker Port는 이러한 포트 설정 오류를 가장 빠르게 확인할 수 있는 명령어입니다.
Docker Port 사용 시 주의사항
Docker Port를 사용할 때는 다음 사항을 알아두는 것이 좋습니다.
첫 번째는 실행 중인 컨테이너만 조회할 수 있다는 점입니다.
중지된 컨테이너는 포트 매핑 정보를 확인할 수 없습니다.
두 번째는 포트가 매핑되지 않은 컨테이너에서는 아무 결과도 출력되지 않을 수 있습니다.
세 번째는 Docker Port는 매핑 정보만 보여줄 뿐 실제 서비스가 정상 동작하는지는 확인하지 않습니다.
서비스 상태는 curl, wget 또는 웹 브라우저를 이용해 별도로 확인해야 합니다.
네 번째는 방화벽이나 보안 그룹 설정으로 인해 포트가 차단될 수도 있습니다.
포트 매핑이 정상이라도 외부 접속이 되지 않는다면 운영체제와 클라우드의 방화벽 설정도 함께 확인해야 합니다.
Best Practice
Docker Port를 사용할 때는 다음과 같은 방법을 추천합니다.
- 컨테이너 실행 후 포트 매핑을 확인합니다.
- 운영 서버에서는 포트 충돌 여부를 주기적으로 점검합니다.
- Docker PS와 함께 사용하여 전체 서비스를 확인합니다.
- 웹 서버 장애 발생 시 가장 먼저 포트 매핑을 확인합니다.
- 방화벽과 Docker 포트를 함께 점검합니다.
- 서비스 접속 테스트는
curl이나 브라우저를 함께 사용합니다.
이러한 방법을 적용하면 네트워크 관련 문제를 빠르게 해결할 수 있습니다.
자주 묻는 질문
Docker Port와 Docker PS의 차이는 무엇인가요?
Docker PS는 실행 중인 모든 컨테이너 정보를 출력합니다.
Docker Port는 특정 컨테이너의 포트 매핑만 출력하므로 원하는 정보를 빠르게 확인할 수 있습니다.
Docker Port에서 아무것도 출력되지 않습니다.
포트 매핑 없이 실행한 컨테이너이거나 컨테이너가 실행 중이 아닐 가능성이 있습니다.
docker ps 명령으로 상태를 먼저 확인하는 것이 좋습니다.
Docker Port로 포트를 변경할 수 있나요?
아닙니다.
Docker Port는 조회 전용 명령입니다.
포트를 변경하려면 컨테이너를 삭제한 후 원하는 포트로 다시 실행해야 합니다.
외부 접속이 되지 않는데 Docker Port는 정상입니다.
Docker 포트 매핑은 정상일 수 있습니다.
이 경우에는 운영체제 방화벽, 클라우드 보안 그룹, Reverse Proxy 설정 등을 함께 확인해야 합니다.
마무리
Docker Port는 컨테이너와 호스트 간의 포트 매핑 정보를 확인하는 간단하지만 매우 중요한 명령어입니다.
웹 서버, API 서버, 데이터베이스 등 다양한 서비스를 운영하는 환경에서는 포트 매핑 오류가 자주 발생하며, Docker Port를 사용하면 이러한 문제를 빠르게 확인할 수 있습니다.
특히 Docker PS, Docker Inspect, Docker Logs와 함께 활용하면 서비스 연결 문제를 더욱 효율적으로 분석하고 해결할 수 있습니다.