容器显示Running但无法联网，是因底层网卡驱动失效：ip a仅显示lo、/sys/class/net/无eth0、dmesg报netdev注册失败；需检查bridge/overlay/veth模块加载、cgroup版本兼容性，清理/var/lib/docker/network/files/后重启Docker服务。
容器显示 running 但完全无法联网，不是应用卡死，也不是端口没映射——而是底层网卡驱动（即网络驱动）在运行时失效。这种情况多见于 overlay2 + bridge 组合下内核模块异常、cgroup 配置变动或网络命名空间损坏，本质是容器虽启动成功，但网络栈未正确挂载或初始化。
确认是否为网卡驱动级失效
进入容器后执行以下命令，观察关键指标：
-
ip a：若只有
lo接口，无eth0或类似虚拟网卡，说明网络命名空间未注入设备 -
cat /proc/sys/net/ipv4/ip_forward：宿主机该值应为
1，否则 bridge 流量无法转发 -
ls /sys/class/net/：容器内应出现
eth0；若只有lo，基本可判定驱动未就绪 -
dmesg | grep -i "bridge\|overlay\|net"（在宿主机执行）：查找如
failed to register netdev或device eth0 does not exist类错误
检查并修复网络驱动依赖状态
驱动失效常源于支撑模块缺失或冲突，需逐层验证：
minimax-mcp-docker版（适配极空间）
下载
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。
- 确认内核已加载必要模块：
lsmod | grep -E 'bridge|overlay|veth'；缺失则执行sudo modprobe bridge overlay veth - 检查 cgroup 版本兼容性：
stat -fc "%T" /sys/fs/cgroup，返回cgroup2fs表示使用 cgroup v2，需确保 Docker 启动参数含--cgroup-manager systemd - 验证
/var/lib/docker/network/files/目录是否存在且非空；若为空，说明 network driver 初始化失败，可能因磁盘满或权限异常
重建网络驱动上下文（不删容器）
无需重启所有容器，只需重置网络子系统：
- 停止 Docker 服务：
sudo systemctl stop docker - 清理网络运行时状态：
sudo rm -rf /var/lib/docker/network/files/* - 保留容器数据，仅重建网络驱动：
sudo dockerd --data-root /var/lib/docker --config-file /etc/docker/daemon.json --debug --dump-sysinfo 2>/dev/null | grep -A5 "NetworkDriver"（用于诊断） - 重启服务：
sudo systemctl start docker；此时新启动的容器将重新获取正常网卡，旧容器需docker restart才能重建网络命名空间
规避驱动失效的长期配置建议
防止问题反复发生，应在 daemon 层加固：
- 在
/etc/docker/daemon.json中显式指定网络驱动："default-runtime": "runc", "network-driver": "bridge"（Docker 24.0+ 支持） - 禁用自动创建默认 bridge 网络，改用自定义网络：
"bridge": "none"，再通过docker network create --driver bridge mynet显式管理 - 对关键业务容器，固定使用 host 网络模式（仅限可信环境）：
docker run --network host ...，绕过 bridge 驱动链 - 定期检查内核更新与 Docker 版本匹配性，overlay2 要求内核 ≥ 4.0，且
overlay模块必须编译进内核（非模块化）
