首页/云/Docker 容器速查/docker network ls 列出网络
网络与存储52 条

docker network ls 列出网络

列出主机上的 Docker 网络(bridge/host/none 三个预置网络加用户自建网络),确认容器该接入哪个网络时先看这张表。

Docker 容器速查云更新于 2026-10-13

网络列表是什么

列出引擎上的网络:三个预置网络加上用户自建的网络,并显示驱动与作用范围。接入哪个网络决定了容器能被谁访问、能不能用名称互访,动手前先看这张表,能避免「创建时报网段冲突」「接入后解析不了」这类问题。

基本信息

语法docker network ls [选项]
预置网络默认桥接、宿主模式、无网络模式
常用选项按驱动或名称筛选,用模板控制输出列
列含义标识、名称、驱动、作用范围
作用范围本机范围内的网络与集群范围的覆盖网络区分显示

典型使用场景

  • 接入前确认:确认目标网络已存在且名称正确,避免启动失败
  • 排查解析失败:确认容器是否接在支持名称解析的自定义网络上
  • 规划网段:创建新网络前先查看既有网段,避免冲突
  • 清理残留:项目下线后核对不再使用的网络并清理
  • 集群环境排障:区分本机网络与集群范围网络,判断通信范围

常用示例

常用示例
docker network ls                                    # 列出全部网络
docker network ls --filter driver=bridge             # 按驱动筛选
docker network ls --format '{{.Name}} {{.Driver}} {{.Scope}}'   # 自定义列
docker network inspect app-net                       # 看网络里的容器与网段
docker network ls -q | head                          # 只取标识

输出逐列读法

列含义怎么用
标识网络的唯一短码名称重名或有歧义时用标识定位
名称网络名,访问时使用脚本与编排里引用这个名字
驱动网络实现方式桥接用于本机多容器,覆盖用于跨主机
作用范围作用范围是本机还是集群集群环境里区分两类网络的具体范围
预置项默认创建的三个网络日常多容器应用建议自建网络而不是都用默认

与接入命令的配合

  • 启动容器前先确认网络存在,批量脚本里可先做一次存在性判断
  • 接入自定义网络后应用配置写服务名,不要写地址
  • 同一网络内容器默认互通,需要隔离就划分不同网络
  • 名称有歧义时改用标识引用,避免操作到错误的网络
  • 网络变更会影响在跑的容器,删除前先确认没有容器接入
作用范围列区分本机网络与集群网络。跨主机通信要靠集群范围的覆盖网络,本地桥接网络只在单台机器内有效。
网络重名时用名称引用会有歧义,脚本里建议用标识或先按名称取出标识再操作,减少误操作风险。

易错点

  • 网络名重名时用名称引用,操作到错误的网络,容器接入后通信异常
  • 创建新网络时没看既有网段,报网段重叠,排查方向被带偏
  • 把本机网络与集群范围网络混用,跨主机通信失败
  • 项目下线后不清理网络,多次部署后残留大量无用网络,排查时干扰判断

数据来源与参考

  • Docker 官方 CLI 参考:docker network ls(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌