首页/云/Docker 容器速查/网络别名 --network-alias 与容器名解析
本包目录(366 条)
基础命令50 条镜像与构建107 条
网络与存储52 条
Compose 编排55 条资源与安全50 条容器排障52 条

网络别名 --network-alias 与容器名解析

给容器在指定网络上追加可解析的名称:其他容器用别名访问即可,适合在副本间做无差别调用的场景。

Docker 容器速查云更新于 2026-10-12
用途同一网络内多个可解析名称
语法--network-alias 名称(可多次)
作用范围仅所在的用户自定义网络

示例

示例
docker run -d --network app-net --network-alias api --network-alias web app/web:1.0
docker run --rm --network app-net alpine getent hosts api
别名与容器名同机制由内嵌 DNS 解析;默认 bridge 网络不支持该能力。

易错点

  • 别名与容器名冲突或与已用别名重复时会报错,命名前先看 inspect 里现有记录
  • 别名只在所属网络有效,跨网络访问时名字解析不到

数据来源与参考

  • Docker 官方文档:容器 DNS 与 network-alias(docs.docker.com/network)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌