docker inspect는 여러 주소를 표시하거나, 평소 확인하던 필드에 IPv4 주소를 표시하지 않을 수 있습니다. URL에 값을 복사하기 전에 해당 주소가 속한 네트워크와 실제로 Docker를 실행하는 호스트를 확인하세요. 아래 명령은 네트워크별로 IPv4 및 IPv6 주소가 포함된 한 줄을 표시합니다. 컨테이너나 네트워크는 변경하지 않습니다.

컨테이너와 Docker 엔진 확인
먼저 컨텍스트를 확인한 다음 이름이나 ID로 컨테이너를 찾으세요.
docker context show
docker ps -a --format 'table {{.ID}}\t{{.Names}}\t{{.Status}}\t{{.Ports}}'
다음 명령에서 NOM_OU_ID_A_REMPLACER를 실제로 표시된 이름이나 식별자로 바꾸세요.
CONTENEUR='NOM_OU_ID_A_REMPLACER'
docker inspect --type=container --format '{{.Name}} etat={{.State.Status}} mode={{.HostConfig.NetworkMode}}' "$CONTENEUR"
docker ps -a에는 중지된 컨테이너도 포함됩니다. 중지된 컨테이너에도 inspect 정보가 남아 있을 수 있지만, 주소가 표시된다고 해서 서비스가 현재 사용 가능하다는 뜻은 아닙니다.
클라이언트가 원격 데몬과 통신할 수도 있습니다. 이 경우 “Docker 호스트”는 명령을 입력하는 컴퓨터가 아니라 데몬이 실행되는 컴퓨터입니다. docker context show는 선택된 컨텍스트를 표시하며, 환경 변수도 대상에 영향을 줄 수 있습니다. 이러한 변수나 전체 docker inspect 결과를 공개하지 마세요. 민감한 데이터가 포함될 수 있습니다.
네트워크별 IP 주소 표시
선택한 컨테이너에 대해 다음을 실행하세요.
docker inspect --type=container --format '{{range $nom, $reseau := .NetworkSettings.Networks}}{{printf "%s\tIPv4=%s\tIPv6=%s\n" $nom $reseau.IPAddress $reseau.GlobalIPv6Address}}{{end}}' "$CONTENEUR"
출력에는 네트워크 연결별로 네트워크 이름과 IPv4 및 IPv6 필드가 한 줄씩 표시됩니다. 값이 비어 있을 수도 있습니다. 따라서 IPv4가 비어 있다고 해서 IPv6도 없다고 결론 내릴 수는 없습니다. 주소는 네트워크 연결에 속합니다. 여러 네트워크에 연결된 컨테이너에는 주소가 여러 개 있을 수 있습니다.
특정 네트워크의 IPv4를 추출하려면 첫 번째 명령에서 확인한 네트워크 이름으로 템플릿의 NOM_RESEAU_A_REMPLACER를 바꾸세요.
docker inspect --type=container --format '{{with index .NetworkSettings.Networks "NOM_RESEAU_A_REMPLACER"}}{{.IPAddress}}{{else}}reseau absent{{end}}' "$CONTENEUR"
reseau absent라는 메시지는 해당 이름의 네트워크가 이 컨테이너에 연결되어 있지 않다는 뜻입니다. 네트워크가 존재하더라도 IPv6 전용으로 작동한다면 IPv4 추출 결과가 비어 있을 수 있습니다. 이때는 전체 표시로 돌아가세요. IPv6 주소가 필요하면 첫 번째 명령의 IPv6 값을 사용하고, 해당 주소를 받는 애플리케이션이 요구하는 형식인지 확인하세요.
네트워크에서 주소 대조하기
Compose 프로젝트 이름이 앞에 붙어 있을 수 있으므로 네트워크의 정확한 이름을 사용하세요.
RESEAU='NOM_RESEAU_A_REMPLACER'
docker network ls
docker network inspect --format '{{.Name}} pilote={{.Driver}}' "$RESEAU"
docker network inspect --format '{{range $id, $c := .Containers}}{{printf "%s\tIPv4=%s\tIPv6=%s\n" $c.Name $c.IPv4Address $c.IPv6Address}}{{end}}' "$RESEAU"
이 화면에서는 각 컨테이너와 해당 네트워크의 주소를 대조할 수 있습니다. docker network inspect의 IPv4Address에는 CIDR 접두사가 포함될 수 있습니다. 예를 들어 주소 뒤에 /24가 붙는 형식입니다. 이는 docker inspect가 제공하는 주소만의 표시 형식과 다릅니다.
inspect 명령은 읽기 전용입니다. Docker 엔진에 대한 접근이 거부되면 여기서 멈추세요. 거부를 우회하려고 소켓 권한을 바꾸거나 그룹 소속을 변경하지 마세요.
내부 IP와 게시된 포트 중 선택하기
어디에서 서비스에 접근하는지에 따라 적절한 시작점이 달라집니다.
기본 Linux Docker Engine과 bridge 네트워크를 사용하는 경우, 내부 주소는 해당 네트워크에서 통신할 때 사용되며 표준 구성에서는 엔진 호스트에서도 사용됩니다. LAN의 다른 컴퓨터에서 접근할 때는 일반적으로 해당 호스트의 주소와 이미 게시된 포트를 사용하세요. 직접 라우팅 구성이나 다른 드라이버도 있지만, 이 절차만으로는 해당 구성 여부를 확인할 수 없습니다.
기존 포트 게시를 확인하려면 다음을 실행하세요.
docker port "$CONTENEUR"
이 명령은 이미 설정된 포트 매핑을 표시합니다. 컨테이너 IP를 제공하거나 새 포트 게시를 만들지는 않습니다. 0.0.0.0과 ::는 일반적인 수신 주소를 나타내므로 URL의 대상으로 복사하지 마세요. 이미지의 EXPOSE는 포트가 호스트에 게시되었다는 뜻이 아닙니다.
Linux의 Docker Desktop은 가상 머신에서 엔진을 실행합니다. 따라서 inspect에 표시된 내부 주소에 물리 컴퓨터에서 직접 접근할 수 있다고 보장할 수 없습니다. 이 경우 먼저 이미 게시된 포트와 호스트 주소를 확인하세요.
rootless 모드에서는 주소가 RootlessKit 네임스페이스에 속할 수 있으며, 해당 네임스페이스 바깥의 환경에서 직접 연결되지 않을 수 있습니다. 결과는 모드와 버전에 따라 다릅니다. 사용하기 쉬운 주소를 얻으려고 격리를 비활성화하지 마세요.
두 가지 네트워크 모드에서도 자체 주소가 표시되지 않을 수 있습니다. 기본 host 모드에서는 컨테이너가 엔진 호스트의 네트워크 공간을 공유하므로 해당 호스트의 주소와 서비스 포트를 확인하세요. none 모드에서는 루프백 인터페이스가 네임스페이스 내부에만 있으므로 127.0.0.1을 호스트에서 사용할 대상으로 복사하면 안 됩니다.
네트워크를 변경하지 않고 서비스 확인하기
IP 주소만으로 서비스가 수신 대기 중이거나 응답한다고 증명할 수는 없습니다. 이미 알고 있는 HTTP 서비스의 경우, 주소와 포트, 경로를 포함한 전체 URL을 실제 읽기 요청의 대상으로 바꾸세요.
URL_SERVICE='http://ADRESSE_A_REMPLACER:PORT_A_REMPLACER/CHEMIN_A_REMPLACER'
curl --connect-timeout 3 --max-time 5 --silent --show-error --output /dev/null --write-out 'HTTP %{http_code}\n' "$URL_SERVICE"
내부 네트워크에 연결할 수 있는 위치에서는 컨테이너 주소와 서비스 내부 포트를 사용하세요. 호스트나 LAN에서는 호스트 주소와 적절히 게시된 포트를 사용하세요. URL에 IPv6 리터럴 주소를 넣을 때는 주소를 대괄호로 묶으세요. 이 요청은 읽기 전용으로 알려진 엔드포인트에만 사용하세요. HTTP 요청은 로그를 남길 수 있고 애플리케이션에 따라 부작용이 발생할 수 있습니다.
HTTP 상태 코드는 서비스나 중개자가 응답했다는 뜻입니다. 401, 403 또는 404는 네트워크가 없다는 뜻이 아닙니다. 시간 초과만으로는 원인을 특정할 수 없으며, HTTP 000은 서버에서 받은 코드가 아닙니다. ping은 ICMP만 확인하므로 ping 실패가 TCP 또는 HTTP 서비스에 접근할 수 없음을 입증하지 않으며, ping 성공도 해당 서비스가 정상임을 확인해 주지 않습니다.
사용자 지정 Docker 네트워크 또는 Compose에서 서비스 간에 지속적으로 통신하려면 동적으로 바뀔 수 있는 IP를 고정 입력하는 대신 서비스 이름과 내부 포트를 사용하는 것이 좋습니다. 컨테이너를 다시 만들면 다른 주소가 할당될 수 있습니다. 대상은 확인되었지만 서비스가 응답하지 않는다면 네트워크를 무작정 바꾸지 말고, 예를 들어 Docker Compose 서비스 로그를 확인하는 등 별도로 진단을 진행하세요.
컨테이너 주소와 호스트 주소를 구분하려면 ip addr로 Linux 주소를 확인할 수도 있습니다. HTTP 확인에 실패하면 curl로 URL 테스트 결과를 해석하는 방법을 알아보세요.
출처: docker inspect, bridge 네트워크, Docker Desktop 네트워크, rootless 모드의 제한 사항, Docker Compose 네트워크.