--net-alias 是 docker run 的网络选项，仅在容器启动时为容器在用户自定义网络中设置 DNS 可解析别名，不支持运行时修改、删除或重命名，且对默认 bridge 网络无效；别名随容器生命周期绑定，重启保留、删除即失。
在 docker 中，docker run 的 --net-alias 参数本身**不支持容器生命周期内的动态修改或管理**——它仅在容器启动时一次性设置别名，且该别名只在指定的自定义网络（user-defined bridge network）中生效。别名一旦设定，就无法通过 docker run 或原生命令更新、删除或重命名；容器停止或重启后，别名会随容器一起消失（除非使用 --restart 且网络未被移除）。
什么是 --net-alias？
--net-alias 是 docker run 的一个网络选项，用于为容器在**指定用户自定义网络**中注册额外的 DNS 可解析名称（即别名）。它不作用于默认的 bridge 网络，也不影响容器自身的 /etc/hosts。
例如：
docker run -d --name web1 --network mynet --net-alias app --net-alias v1 nginx
此时，在 mynet 中其他容器可通过 app 或 v1 直接访问该容器（DNS 解析到其 IP）。
为什么不能“生命周期内管理”？
Docker 引擎设计上将网络别名视为容器启动时的静态网络配置项，而非运行时可变属性。当前（Docker 24.x）没有内置命令如 docker network alias add/remove 或 docker update --net-alias。
- 容器运行中：无法添加、删除或修改已有别名
- 容器重启后：原始
--net-alias仍有效（前提是网络存在且容器以相同参数重启） - 容器停止再
start：别名保留（因网络连接信息保留在容器元数据中） - 容器
rm后：别名彻底消失，不可恢复
替代方案：模拟“生命周期内管理”
若需实现类似动态别名的效果，可结合以下实践：
-
用 docker network connect/disconnect 控制可见性：
先启动无别名的容器，再按需连接到不同网络并指定别名：docker network connect --alias current-app mynet web1
之后可通过docker network disconnect mynet web1移除该网络上下文中的别名（本质是断开连接） -
用服务发现工具补充：在 Swarm 模式下，使用
docker service create --network mynet --name app，服务名天然具备 DNS 负载均衡和滚动更新能力，比手动管理别名更健壮 -
用容器标签 + 外部 DNS 或 Consul：为容器打标签（
--label version=v2），配合外部 DNS 服务监听 Docker 事件，自动更新记录 -
脚本化重建容器：当需变更别名时，
docker stop && docker rm原容器，再用新--net-alias重新run（适用于可中断场景）
注意事项与最佳实践
使用 --net-alias 时需注意：
- 必须搭配
--network <custom-network></custom-network>使用，对default bridge无效 - 同一网络中多个容器可共用同一别名，DNS 查询会轮询返回（但非负载均衡，只是随机 A 记录）
- 别名不支持通配符或正则，仅纯字符串
- 避免在生产中依赖单一别名做关键路由；建议配合健康检查和服务注册机制
