编辑“︁Docker网络故障排查”︁

= Docker网络故障排查 =

'''Docker网络故障排查'''是Docker容器化环境中常见的问题解决过程，涉及诊断和修复容器间或容器与外部网络之间的连接问题。本指南将详细介绍常见网络问题、排查工具、实用命令以及解决方案。

== 介绍 ==

Docker网络是容器间通信的基础设施，但配置错误、防火墙规则或网络驱动问题可能导致连接失败。理解Docker网络模型（如桥接网络、主机网络、覆盖网络）是排查的前提。常见症状包括：
* 容器无法访问互联网
* 容器间无法通信
* 端口映射失效
* DNS解析失败

== 基础排查工具 ==

=== 1. 检查容器网络状态 ===
使用以下命令查看容器网络配置：
<syntaxhighlight lang="bash">
docker inspect <container_id> | grep -i network
</syntaxhighlight>
输出示例：
<syntaxhighlight lang="json">
"NetworkSettings": {
    "Networks": {
        "bridge": {
            "IPAddress": "172.17.0.2"
        }
    }
}
</syntaxhighlight>

=== 2. 测试容器连通性 ===
进入容器执行网络测试：
<syntaxhighlight lang="bash">
docker exec -it <container_id> ping 8.8.8.8  # 测试互联网连接
docker exec -it <container_id> ping <another_container_ip>  # 测试容器间连接
</syntaxhighlight>

== 常见问题及解决方案 ==

=== 问题1：容器无法访问外部网络 ===
'''可能原因'''：  
* iptables规则阻止  
* DNS配置错误  

'''解决方案'''：  
1. 检查iptables规则：
<syntaxhighlight lang="bash">
sudo iptables -L -n
</syntaxhighlight>
2. 验证DNS配置：
<syntaxhighlight lang="bash">
docker run --rm busybox nslookup example.com
</syntaxhighlight>

=== 问题2：端口映射失效 ===
'''现象'''：主机端口未正确映射到容器端口  
'''验证命令'''：
<syntaxhighlight lang="bash">
docker port <container_id>  # 查看端口映射
netstat -tuln | grep <port>  # 检查主机端口监听状态
</syntaxhighlight>

=== 问题3：自定义网络中的容器无法互通 ===
'''诊断步骤'''：  
1. 创建自定义网络并验证：
<syntaxhighlight lang="bash">
docker network create --driver bridge my_network
docker network inspect my_network  # 查看子网配置
</syntaxhighlight>
2. 检查容器是否连接到同一网络：
<syntaxhighlight lang="bash">
docker network connect my_network <container_id>
</syntaxhighlight>

== 高级诊断技术 ==

=== 使用tcpdump抓包分析 ===
在主机或容器内捕获网络流量：
<syntaxhighlight lang="bash">
docker run --net=host --privileged -it nicolaka/netshoot tcpdump -i eth0 port 80
</syntaxhighlight>

=== 网络拓扑分析 ===
使用mermaid绘制网络关系图：
<mermaid>
graph TD
    Host[宿主机] -->|bridge| Container1[容器A]
    Host -->|bridge| Container2[容器B]
    Container1 -.->|自定义网络| Container2
</mermaid>

== 实际案例 ==

'''案例：跨主机容器通信失败'''  
'''环境'''：两台Docker主机使用overlay网络  
'''现象'''：容器无法通过服务名发现彼此  
'''解决步骤'''：  
1. 检查overlay网络创建参数：
<syntaxhighlight lang="bash">
docker network create -d overlay --attachable my_overlay_net
</syntaxhighlight>
2. 验证Swarm模式配置（如需）：
<syntaxhighlight lang="bash">
docker node ls
</syntaxhighlight>
3. 检查网络插件日志：
<syntaxhighlight lang="bash">
journalctl -u docker -f
</syntaxhighlight>

== 数学建模（可选） ==
网络延迟分析可使用公式：
<math>
T_{total} = T_{processing} + \sum_{i=1}^{n} (T_{transmission_i} + T_{propagation_i})
</math>

== 总结 ==
Docker网络故障排查需要系统性地：
1. 确认网络拓扑结构  
2. 验证基础连接（容器内、容器间、外部）  
3. 检查网络配置（IP、端口、DNS）  
4. 分析防火墙和路由规则  
5. 必要时抓包分析  

掌握这些技能能有效解决80%以上的Docker网络问题。建议在日常使用中积累不同场景的排查经验。

[[Category:集成部署]]
[[Category:Docker]]
[[Category:Docker故障排查]]