Shell脚本如何重置容器网络配置

wen 实用脚本 2026-07-16 2

Shell脚本如何重置容器网络配置 —— 从原理到实战

目录导读

为什么需要重置容器网络配置？
理解容器网络的核心组件（Docker/Containerd）
Shell脚本重置网络的分步策略
三种典型场景下的重置脚本实例
常见陷阱与排错问答（FAQ）
最佳实践与安全建议

为什么需要重置容器网络配置？

在实际生产或开发环境中,容器网络配置可能因以下原因需要重置：

Shell脚本如何重置容器网络配置

网络冲突：多个容器（或与宿主机）分配了相同的IP或子网
配置错误：错误的DNS、MTU、网桥参数导致连通性失效
容器运行时异常：如docker0网桥状态异常，容器无法获取IP
更换宿主机网络栈：如从桥接模式切换为macvlan或overlay
安全审计需求：需要彻底清理残留的路由规则或iptables条目

重置容器网络不仅仅是“重启服务”，而是需要系统性地清除旧配置、恢复初始状态，再重新应用参数，Shell脚本恰好提供了灵活、可重复执行的方案。

理解容器网络的核心组件

在编写重置脚本前,必须理解以下关键元素：

组件	作用	重置要点
`docker0`（或自定义网桥）	默认的虚拟网桥，连接容器与宿主机	需要拆除、重建
`iptables`/`nftables`规则	实现NAT、端口映射	需清除所有Docker相关链
网络命名空间（netns）	每个容器拥有独立网络栈	容器删除后自动释放
DNS配置（`/etc/docker/daemon.json`）	全局DNS或MTU参数	需备份并重置
持久化存储（如`/var/lib/docker/network`）	保存网络状态数据库	清理后需重建

核心原则：重置网络时，不要直接删除/var/lib/docker下的数据（除非确认无容器运行）,否则会损坏已有容器。

Shell脚本重置网络的分步策略

一个健壮的Shell脚本应包含以下阶段,并为每一步提供错误处理：

检测当前状态：列出所有网络、容器、iptables规则
安全停止所有容器（非强制停止,而是优雅stop）
清理网络组件：
- 移除所有自定义网络（docker network prune）
- 拆除默认docker0网桥
- 清除iptables中DOCKER、DOCKER-USER链
重启docker守护进程（重新初始化网桥和iptables）
验证重置结果：检查网桥、IP分配、容器网络联通性

注意：重置过程会导致所有运行容器中断,建议在维护窗口执行。

三种典型场景下的重置脚本实例

常规Docker环境重置（最安全）

#!/bin/bash
# reset-docker-network.sh - 安全重置Docker网络
set -euo pipefail
echo "【1】正在停止所有运行容器..."
docker stop $(docker ps -q) 2>/dev/null || echo "没有运行中的容器"
echo "【2】清理自定义网络..."
docker network prune -f
echo "【3】清理Docker默认桥接和iptables规则..."
# 移除docker0网桥（但注意：ifconfig方式已被淘汰，改用ip命令）
ip link delete docker0 2>/dev/null || true
# 清除docker创建的iptables规则链
iptables -F DOCKER 2>/dev/null || true
iptables -t nat -F DOCKER 2>/dev/null || true
iptables -t nat -F POSTROUTING 2>/dev/null || true
echo "【4】重启Docker服务..."
systemctl restart docker
echo "【5】验证网络状态..."
if docker network ls | grep -q bridge; then
    echo "✓ Docker桥接网络已自动重建"
    ip addr show docker0
else
    echo "✗ 网络重建失败，检查Docker日志"
fi

强制重置（网络完全崩溃）

#!/bin/bash
# force-reset-docker-network.sh
STOP_TIMEOUT=10
echo "警告：此脚本将强制停止所有容器并清空网络状态"
read -p "继续？(y/N): " confirm
[[ "$confirm" == "y" ]] || exit 0
echo "强制停止所有容器（含非运行状态）..."
docker kill $(docker ps -q) 2>/dev/null || true
docker rm $(docker ps -aq) 2>/dev/null || true
echo "关闭Docker服务..."
systemctl stop docker
echo "清理残留网络文件..."
rm -rf /var/lib/docker/network/files/*.db
rm -rf /var/lib/docker/network/files/*.json
echo "清理iptables规则（保留系统规则）..."
iptables-save | grep -v DOCKER | iptables-restore
echo "重启Docker..."
systemctl restart docker

重置容器DNS/MTU配置（不停止容器）

#!/bin/bash
# reset-dns-mtu.sh
DOCKER_CONFIG="/etc/docker/daemon.json"
echo "备份当前配置..."
cp "$DOCKER_CONFIG" "${DOCKER_CONFIG}.bak.$(date +%Y%m%d%H%M)"
echo "重置为默认DNS（Google DNS）..."
cat > "$DOCKER_CONFIG" <<EOF
{
  "dns": ["8.8.8.8", "8.8.4.4"],
  "mtu": 1500
}
EOF
echo "重新加载Docker配置（不重启容器）..."
systemctl reload docker
echo "验证DNS配置..."
docker run --rm alpine nslookup google.com

常见陷阱与排错问答（FAQ）

Q1：重置后容器无法访问外网，怎么办？

A：检查iptables的MASQUERADE规则是否恢复,执行：

iptables -t nat -L POSTROUTING -v

若无任何规则,手动添加：

iptables -t nat -A POSTROUTING -s 172.17.0.0/16 ! -o docker0 -j MASQUERADE

Q2：重置后碰到`device or resource busy`错误？

A：说明有进程（如旧网络命名空间）仍在占用docker0,执行：

ip netns list  # 查看残留命名空间
ip netns delete <name>  # 清理无用空间

或者重启宿主机来彻底释放。

Q3：如何只重置某个自定义网络而不影响其他？

A：使用docker network disconnect先断开容器，然后docker network rm <网络名>，最后重新创建并连接容器,脚本示例：

NET_NAME="my-custom-bridge"
for cid in $(docker ps -q --filter network=$NET_NAME); do
    docker network disconnect -f $NET_NAME $cid
done
docker network rm $NET_NAME
docker network create --driver bridge --subnet 10.10.0.0/16 $NET_NAME

Q4：使用`kubeadm`/`containerd`时如何重置？

A：对于containerd，使用crictl停止所有sandbox和容器，然后清理/var/lib/cni/networks目录，对于kubeadm，则执行kubeadm reset后再重建集群。

最佳实践与安全建议

始终先备份：重置前备份/etc/docker/和iptables规则。
```
iptables-save > /tmp/iptables-backup-$(date +%F).rules
```
使用幂等脚本：每次执行脚本前先检测状态,避免重复操作导致错误。
区分测试与生产：在生产环境执行前，先在测试环境验证脚本,并设置确认提示。
监控日志：重置后检查journalctl -u docker -n 50是否有bridge setup failed等错误。
考虑CNI插件：如果使用flannel、calico等CNI，需要额外清理CRI（如crictl）中sandbox配置。