Docker Network

컨테이너 간 연결과 외부 노출 경로를 제어하는 docker network 관리 그룹.

• 기본 bridge 외에 사용자 정의 bridge를 만들면 서비스명 기반 DNS와 격리 구성을 더 일관되게 관리할 수 있다.
• connect 와 disconnect 는 이미 실행 중인 컨테이너의 네트워크 참여를 바꿀 때 쓴다.
• prune 는 어떤 컨테이너도 참조하지 않는 네트워크를 정리한다.

docker network COMMAND

• create: 새 네트워크 생성
  • 주요 옵션: -d bridge|overlay|macvlan, –subnet, –gateway, –attachable, –internal, –label, –ipv6
• ls: 네트워크 목록 조회
  • 주요 옵션: –filter, –format, -q
• inspect: 네트워크 상세 JSON 확인
  • 주요 옵션: -f, –verbose
• connect: 컨테이너를 기존 네트워크에 연결
  • 주요 옵션: –alias, –ip, –ip6, –link, –driver-opt
• disconnect: 컨테이너를 네트워크에서 분리
  • 주요 옵션: -f
• rm: 네트워크 삭제
• prune: 미사용 네트워크 정리
  • 주요 옵션: -f, –filter until=…

# 사용자 정의 bridge 생성
docker network create --driver bridge app-net
 
# 실행 중 컨테이너를 추가 네트워크에 연결
docker network connect app-net web
 
# 네트워크 확인
docker network inspect app-net
 
# 미사용 네트워크 정리
docker network prune

• 컨테이너가 서로 이름 해석을 못 하면 같은 사용자 정의 bridge 또는 overlay에 붙어 있는지 먼저 확인한다.
• rm 이 실패하면 해당 네트워크를 사용하는 컨테이너가 남아 있을 가능성이 크다. inspect 의 Containers 목록을 점검한다.
• Swarm overlay 네트워크는 stack 또는 service 배포와 함께 쓰이는 경우가 많다.

+ docker network --help

Usage:  docker network COMMAND
 
Manage networks
 
Commands:
  connect     Connect a container to a network
  create      Create a network
  disconnect  Disconnect a container from a network
  inspect     Display detailed information on one or more networks
  ls          List networks
  prune       Remove all unused networks
  rm          Remove one or more networks
 
Run 'docker network COMMAND --help' for more information on a command.

+

• docker
• container
• stack
• service

• codex:: 2026-07-06 Added docker network subpage with create, connect, inspect, and prune guidance.