Docker에서는 여러 컨테이너가 하나의 네트워크를 통해 서로 통신합니다. 단순히 네트워크가 존재하는지만 확인하는 것으로는 현재 어떤 컨테이너가 연결되어 있는지, 어떤 IP 대역을 사용하는지, 어떤 Driver가 적용되어 있는지 알 수 없습니다.
운영 환경에서는 특정 컨테이너가 네트워크에 제대로 연결되어 있는지 확인하거나 IP 주소 충돌, 통신 오류, Gateway 설정 등을 점검해야 하는 경우가 자주 발생합니다.
이럴 때 사용하는 명령어가 바로 docker network inspect입니다.
Docker Network Inspect는 특정 Docker Network의 상세 정보를 JSON 형식으로 출력하는 명령어입니다. 연결된 컨테이너, Driver, 서브넷, Gateway, Network ID 등 다양한 정보를 확인할 수 있어 Docker 네트워크 관리에서 매우 중요한 역할을 합니다.
이번 글에서는 Docker Network Inspect의 개념부터 기본 사용법, 출력 결과 해석, 주요 옵션, 실무 활용 방법까지 자세히 알아보겠습니다.
Docker Network Inspect란 무엇인가?
Docker Network Inspect는 특정 Docker Network의 상세 정보를 조회하는 명령어입니다.
네트워크 이름만 확인하는 docker network ls와 달리 실제 네트워크 설정과 연결된 컨테이너 정보를 모두 확인할 수 있습니다.
Docker 네트워크 문제를 분석하거나 설정을 점검할 때 가장 많이 사용하는 명령어입니다.
Docker Network Inspect는 언제 사용하는가?
다음과 같은 상황에서 자주 사용합니다.
- 연결된 컨테이너 확인
- IP 주소 확인
- Gateway 확인
- Driver 확인
- 네트워크 장애 분석
- 서브넷 확인
운영 서버에서는 네트워크 문제 해결 시 가장 먼저 실행하는 명령어 중 하나입니다.
Docker Network Inspect 기본 사용법
가장 기본적인 사용 방법입니다.
docker network inspect web_network실행하면 JSON 형식으로 상세 정보가 출력됩니다.
예시는 다음과 같습니다.
[
{
"Name": "web_network",
"Id": "8fd9ab23...",
"Driver": "bridge",
"Subnet": "172.20.0.0/16",
"Gateway": "172.20.0.1"
}
]실제 환경에서는 연결된 컨테이너 정보까지 함께 출력됩니다.
출력 결과 이해하기
Docker Network Inspect에서 자주 확인하는 항목은 다음과 같습니다.
Name
Docker Network의 이름입니다.
컨테이너 연결 시 사용하는 이름입니다.
Id
Docker 내부에서 사용하는 고유 Network ID입니다.
Driver
현재 사용하는 Network Driver입니다.
대부분 Bridge Driver를 사용합니다.
IPAM
IP 주소 관리 정보를 의미합니다.
Subnet과 Gateway 정보도 포함됩니다.
Containers
현재 해당 Network에 연결되어 있는 컨테이너 목록입니다.
네트워크 문제를 분석할 때 가장 많이 확인하는 항목입니다.
Options
네트워크 생성 시 지정한 추가 옵션입니다.
특수한 네트워크 환경에서 활용됩니다.
특정 정보만 출력하기
JSON 전체 대신 필요한 정보만 출력할 수도 있습니다.
예를 들어 Driver만 확인하려면 다음과 같이 입력합니다.
docker network inspect \
--format "{{.Driver}}" \
web_networkBridge Driver라면 다음과 같이 출력됩니다.
bridge연결된 컨테이너 확인하기
현재 네트워크에 연결된 컨테이너 목록만 확인하는 방법입니다.
docker network inspect \
--format "{{json .Containers}}" \
web_network운영 환경에서 컨테이너 연결 상태를 빠르게 점검할 때 매우 유용합니다.
Docker Network Inspect 실무 활용 예제
Docker Network Inspect는 운영 서버에서 네트워크 구성과 연결 상태를 확인할 때 가장 많이 사용하는 명령어입니다. 컨테이너 간 통신 문제를 해결하거나 IP 주소를 확인해야 하는 상황에서 매우 유용합니다.
특정 Network 상세 정보 확인하기
가장 기본적인 사용 방법입니다.
docker network inspect web_network해당 네트워크의 모든 설정 정보를 JSON 형식으로 출력합니다.
Driver만 확인하기
사용 중인 Network Driver만 출력합니다.
docker network inspect \
--format "{{.Driver}}" \
web_network출력 결과입니다.
bridge현재 Bridge Driver를 사용하고 있는 것을 확인할 수 있습니다.
Gateway 확인하기
Gateway 주소만 확인하는 방법입니다.
docker network inspect \
--format "{{(index .IPAM.Config 0).Gateway}}" \
web_network출력 예시입니다.
172.20.0.1네트워크 설정을 점검할 때 자주 사용하는 정보입니다.
Subnet 확인하기
서브넷만 확인하는 방법입니다.
docker network inspect \
--format "{{(index .IPAM.Config 0).Subnet}}" \
web_network출력 결과입니다.
172.20.0.0/16IP 충돌 여부를 확인할 때 매우 유용합니다.
연결된 컨테이너 확인하기
현재 해당 네트워크에 연결된 컨테이너를 조회합니다.
docker network inspect \
--format "{{json .Containers}}" \
web_network운영 환경에서는 서비스 간 연결 상태를 확인하기 위해 자주 사용합니다.
Network 생성 정보 확인하기
네트워크의 전체 설정을 다시 확인합니다.
docker network inspect backend_network생성 옵션과 IP 설정까지 모두 확인할 수 있습니다.
Linux 서버 문제 해결
운영 중인 Docker 서버에서 Nginx는 정상적으로 실행되고 있었지만 Backend API와 통신하지 못하는 문제가 발생했습니다.
관리자는 먼저 Network 정보를 확인했습니다.
docker network inspect backend_network확인 결과 Backend 컨테이너만 네트워크에 연결되어 있었고 Nginx 컨테이너는 다른 네트워크에 연결되어 있었습니다.
현재 연결된 컨테이너 목록도 확인했습니다.
docker network inspect \
--format "{{json .Containers}}" \
backend_network이후 Nginx 컨테이너를 동일한 네트워크에 연결했습니다.
docker network connect backend_network nginx다시 Network Inspect를 실행해 보니 두 컨테이너가 모두 표시되었고 서비스도 정상적으로 복구되었습니다.
운영 환경에서는 통신 장애가 발생하면 Docker Network Inspect를 이용해 연결 상태를 확인하는 것이 가장 빠른 해결 방법입니다.
Docker Network Inspect 사용 시 주의사항
Docker Network Inspect를 사용할 때는 다음 사항을 알아두면 좋습니다.
첫 번째는 출력 결과가 JSON 형식이므로 필요한 정보만 확인하려면 --format 옵션을 사용하는 것이 효율적입니다.
두 번째는 Subnet과 Gateway가 다른 네트워크와 충돌하지 않는지 확인하는 것이 중요합니다.
세 번째는 네트워크에 연결된 컨테이너를 확인하면 대부분의 통신 문제를 빠르게 분석할 수 있습니다.
네 번째는 운영 환경에서는 사용자 정의 Bridge Network를 기준으로 점검하는 것이 일반적입니다.
Best Practice
Docker Network Inspect를 사용할 때는 다음과 같은 방법을 추천합니다.
- 네트워크 장애 발생 시 가장 먼저 실행합니다.
- 연결된 컨테이너 목록을 확인합니다.
- Subnet과 Gateway를 함께 점검합니다.
--format옵션으로 필요한 정보만 조회합니다.- 프로젝트별 네트워크 구성을 정기적으로 확인합니다.
- 컨테이너 연결 상태를 주기적으로 점검합니다.
이러한 방법을 적용하면 Docker 네트워크를 더욱 안정적으로 운영할 수 있습니다.
자주 묻는 질문
Docker Network Inspect는 어떤 정보를 보여주나요?
Network 이름, Driver, Subnet, Gateway, 연결된 컨테이너, IPAM 설정 등 상세 정보를 제공합니다.
연결된 컨테이너도 확인할 수 있나요?
가능합니다.
Containers 항목에서 현재 네트워크에 연결된 모든 컨테이너를 확인할 수 있습니다.
Gateway와 Subnet도 확인할 수 있나요?
네.
IPAM 정보를 통해 Gateway와 Subnet을 모두 확인할 수 있습니다.
JSON 대신 필요한 정보만 출력할 수 있나요?
가능합니다.
--format 옵션을 사용하면 Driver, Gateway, Subnet 등 원하는 정보만 출력할 수 있습니다.
마무리
Docker Network Inspect는 Docker 네트워크의 상세 구성을 확인하는 핵심 관리 명령어입니다.
Driver, Gateway, Subnet뿐 아니라 현재 연결된 컨테이너까지 확인할 수 있어 네트워크 문제 해결과 운영 환경 점검에 매우 중요한 역할을 합니다.
특히 컨테이너 간 통신 장애가 발생했다면 Docker Network Inspect를 가장 먼저 실행하여 연결 상태와 네트워크 구성을 확인하는 습관을 가지면 빠르게 문제를 해결할 수 있습니다.