容器间无法通信的核心原因在于网络配置未对齐：未接入同一自定义网络导致dns解析失败、服务监听地址为127.0.0.1而非0.0.0.0、或宿主机ip转发与iptables规则拦截。

容器服务间连通性故障，核心往往不在应用代码，而在网络接口的配置逻辑是否对齐。关键不是“换网络”，而是让接口行为匹配通信预期——比如监听地址、网络归属、DNS可达性这三点没对上，服务再健康也互相看不见。

确认容器是否接入同一可解析网络

默认 bridge 网络只分配 IP，不启用容器名解析。两个容器即使都在 bridge 下，ping app 会报 Name or service not known，但 ping 172.17.0.3 可能通。

• 用 docker inspect 容器名 --format '{{.NetworkSettings.Networks}}' 查每个容器实际接入的网络名称
• 若不在同一自定义网络（如 mynet），直接改连： docker network connect mynet 容器名
• 自定义网络自动启用 DNS 解析，无需额外配置，容器名即服务名

验证监听地址是否允许跨容器访问

很多服务默认只监听 127.0.0.1，这在容器内等于“只给自己听”，其他容器根本连不上。

minimax-mcp-docker版（适配极空间）

MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。

下载

• 进入容器执行 netstat -tuln 或 ss -tuln，确认端口监听的是 0.0.0.0:8080 而非 127.0.0.1:8080
• Spring Boot 项目需设 server.address=0.0.0.0；Node.js 用 app.listen(3000, '0.0.0.0')
• 镜像启动时加 -e SERVER_ADDRESS=0.0.0.0 并在启动脚本中读取该变量，比硬编码更灵活

检查网络接口路由与 DNS 是否就绪

IP 通不代表服务通，DNS 解析失败或路由缺失会导致连接被静默拒绝。

• 在 A 容器里执行 nslookup api（假设目标服务叫 api）： 若返回 ** server can't find api: NXDOMAIN，说明 DNS 未生效，大概率没进同一自定义网络
• 执行 cat /etc/resolv.conf，确认 nameserver 是 127.0.0.11（Docker 内置 DNS）而非空或错误地址
• 若用 curl http://api:8080/health 失败，先试 curl http://$(nslookup api | grep Address | tail -1 | awk '{print $2}'):8080/health 绕过 DNS 直连 IP，判断是 DNS 还是服务本身问题

排查宿主机层干扰因素

容器网络看似独立，实则依赖宿主机内核转发与防火墙策略，尤其在 Ubuntu/CentOS 上容易被默认规则拦截。

• 运行 cat /proc/sys/net/ipv4/ip_forward，输出必须为 1，否则容器无法转发流量
• 查 Docker 相关 iptables 链：sudo iptables -L DOCKER-USER -n，该链优先级高于 DOCKER，常被误加拒绝规则
• 临时放行测试：sudo iptables -I DOCKER-USER -j ACCEPT，验证后按需细化规则，避免直接禁用 ufw/firewalld