Docker 容器内 DNS 解析失败网络不通怎么排查？

Question

仓乃文 · Accepted Answer

Docker 容器网络问题是最让初学者头疼的，常见表现为：容器内无法访问外网、容器间无法通过名称通信、DNS 解析超时。排查需要从容器内到宿主机逐层定位。常见问题与排查： ```bash # 问题 1：容器内无法访问外网 docker run --rm alpine ping -c 3 baidu.com # ping: bad address "baidu.com" → DNS 解析失败 # 排查步骤： # 1. 检查容器 DNS 配置 docker run --rm alpine cat /etc/resolv.conf # nameserver 127.0.0.11 ← Docker 内置 DNS # 2. 检查宿主机 DNS cat /etc/resolv.conf # nameserver 8.8.8.8 # 3. 指定 DNS 启动容器 docker run --dns 8.8.8.8 --dns 223.5.5.5 alpine ping baidu.com ``` 全局 DNS 配置： ```json // /etc/docker/daemon.json { "dns": ["223.5.5.5", "8.8.8.8"] } ``` ```bash # 问题 2：容器间无法通过名称通信 # 默认 bridge 网络不支持容器名解析！ docker run -d --name app1 alpine sleep 9999 docker run --rm alpine ping app1 # ping: bad address "app1" → 解析失败 # 修复：使用自定义 bridge 网络 docker network create mynet docker run -d --name app1 --network mynet alpine sleep 9999 docker run --rm --network mynet alpine ping app1 # PING app1 (172.18.0.2): 56 data bytes → 成功！ ``` Docker Compose 网络： ```yaml # docker-compose.yml 中同一 services 下的容器默认在同一网络 # 可直接通过服务名访问 services: web: image: nginx depends_on: - api api: image: myapi db: image: mysql # web 中可用 http://api:3000 访问 api # api 中可用 mysql://db:3306 访问数据库 ``` 端口映射问题排查： ```bash # 容器内服务正常但外部无法访问 # 1. 确认端口映射 docker port # 80/tcp -> 0.0.0.0:8080 # 2. 确认容器内服务是否监听 docker exec netstat -tlnp # 或 docker exec ss -tlnp # 3. 检查宿主机防火墙 sudo iptables -L -n | grep 8080 sudo ufw status # 4. 检查是否绑定了 127.0.0.1 docker run -p 127.0.0.1:8080:80 nginx # 只能本机访问 docker run -p 8080:80 nginx # 所有网卡可访问 ``` 补充说明： - 默认 bridge 网络不支持容器名 DNS，自定义 bridge 支持 - Docker Compose 自动创建自定义网络，服务名即主机名 - --network host 直接使用宿主机网络，跳过端口映射，但失去隔离性 - 规则：多容器通信用自定义网络，不要用 --link（已废弃） - DNS 问题优先检查 daemon.json 中的 dns 配置