{{tag>[docker cli network]}}

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

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

===== Usage =====
<code bash>
docker network COMMAND
</code>

===== Command Groups =====
  * ''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=...''

===== Examples =====
<code bash>
# 사용자 정의 bridge 생성
docker network create --driver bridge app-net

# 실행 중 컨테이너를 추가 네트워크에 연결
docker network connect app-net web

# 네트워크 확인
docker network inspect app-net

# 미사용 네트워크 정리
docker network prune
</code>

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

===== Help =====
+++ docker network --help |
<code text>
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.
</code>
+++

===== See Also =====
  * [[docker:ko]]
  * [[docker:container]]
  * [[docker:stack]]
  * [[docker:service]]

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