external_links是docker compose中用于链接外部已存在容器的机制，仅适用于v2.x格式；它在v3+中已被弃用，官方推荐改用用户自定义网络实现跨容器通信。
external_links 是 Docker Compose 为服务连接已存在、且不在当前 docker-compose.yml 文件中定义的容器而提供的机制。它允许你在启动 Compose 服务时，将外部容器（比如用 docker run 启动的、或由其他 docker-compose 项目管理的容器）“链接”进来，使当前服务能通过别名访问它们。
但需特别注意：external_links 在 Compose 文件格式 v3+ 中已被明确弃用，官方不再推荐使用，且在较新版本的 Docker Desktop 或 Docker Engine 中可能已失效或产生不可预期行为。不过，如果你确需兼容旧环境或临时调试，仍可了解其用法；更稳妥的做法是改用网络共享方案。
✅ external_links 的基本写法（仅限 v2.x 或兼容模式）
version: '2.4' # 必须用 v2.x 格式
services:
app:
image: nginx
external_links:
- redis-container:redis
- db-legacy:mysql
说明：
-
redis-container是宿主机上已运行的容器名（可通过docker ps --format "{{.Names}}"查看） -
redis是你在app容器内用来访问它的主机名（即/etc/hosts中会自动添加172.18.0.x redis） - 容器必须和 Compose 默认网络处于同一 Docker 网络桥接段（通常是
bridge），否则 DNS 解析失败
⚠️ 常见限制：
- 外部容器必须已启动，且不能属于
host或none网络模式 -
external_links不支持自定义网络（如networks: [mynet]）下的跨网通信 - 无法传递环境变量或健康检查信息，纯 DNS +
/etc/hosts映射
? 更现代、推荐的替代方式（v3+ 兼容）
1. 让外部容器加入 Compose 项目的网络
先查 Compose 项目默认网络名：
docker network ls | grep myproject # 通常为 <project-name>_default</project-name>
再将外部容器接入该网络：
docker network connect myproject_default redis-container
之后，在 app 服务中直接用 redis-container 当主机名访问（无需 external_links）：
version: '3.8'
services:
app:
image: nginx
depends_on: [redis-container] # 可选，仅用于启动顺序提示
✅ 优势：支持 DNS 自动发现、IPv6、健康状态感知，完全符合 Docker 网络设计哲学。
2. 显式定义共享自定义网络（推荐用于多项目协作）
在 docker-compose.yml 中声明一个外部可复用网络：
networks:
shared-net:
external: true
name: shared-net
提前创建该网络：
docker network create shared-net
再分别让独立容器和 Compose 服务都加入它：
docker run -d --network shared-net --name redis-standalone redis # 和 docker-compose up -d # 其中 services 配置 networks: [shared-net]
此时所有容器可通过服务名（如 redis-standalone）互相访问。
❌ 为什么不应再依赖 external_links？
- 它绕过 Docker 内置 DNS，仅靠静态 hosts 映射，不支持服务动态扩缩容
- 与用户自定义网络（
user-defined bridge）不兼容，容易引发 IP 冲突或解析失败 - Compose v3+ 文档已移除该字段说明，Docker CLI 未来可能彻底屏蔽
- 同一容器无法被多个
external_links引用时做负载均衡或故障转移
? 小贴士：验证是否连通
进入你的 Compose 服务容器，测试外部容器可达性：
docker exec -it myproject_app_1 sh # 然后执行 ping redis-container telnet redis-container 6379
若失败，优先检查：
- 容器是否在同一网络（
docker inspect redis-container | jq '.NetworkSettings.Networks'） - 目标容器是否监听
0.0.0.0而非127.0.0.1 - 防火墙或
iptables是否拦截了跨容器流量
不复杂但容易忽略。
