Shell脚本如何配置容器网络模式

wen 实用脚本 2026-07-16 1

Shell脚本配置容器网络模式：从入门到生产级实践

目录导读

容器网络模式概述
Shell脚本操作Docker网络的必备知识
实战：Shell脚本配置bridge网络模式
实战：Shell脚本配置host与none网络模式
实战：Shell脚本配置overlay跨主机网络
企业级Shell脚本：动态网络分配与错误处理
常见问题与解答（FAQ）

容器网络模式概述

在Docker和容器化部署中，网络模式决定了容器如何与宿主机、其他容器以及外部网络通信,主流网络模式包括：

Shell脚本如何配置容器网络模式

bridge：默认模式，容器通过Docker虚拟网桥（docker0）通信,适用于单机多容器隔离。
host：容器直接使用宿主机网络栈，无独立IP,性能最优但隔离性差。
none：容器无网络接口，完全隔离,适用于安全敏感或自定义网络的场景。
overlay：跨多台宿主机容器通信,需配合Swarm或Kubernetes使用。
macvlan/ipvlan：为容器分配物理网络MAC/IP,适合网络设备模拟。

通过Shell脚本管理这些模式，可以大幅提升自动化部署效率，以下将结合真实代码,讲解如何编写健壮的配置脚本。

Shell脚本操作Docker网络的必备知识

核心命令一览

# 创建自定义bridge网络
docker network create --driver bridge --subnet=192.168.10.0/24 mynet
# 运行容器并指定网络
docker run -d --name web --network mynet --ip 192.168.10.5 nginx
# 查看当前网络信息
docker network ls
docker network inspect mynet

Shell脚本注意事项

使用 set -e 确保任何命令失败时脚本退出
用 trap 捕获退出信号进行清理
变量引用时使用双引号避免空格问题
检查Docker守护进程是否在运行：if ! docker info > /dev/null 2>&1; then

实战：Shell脚本配置bridge网络模式

场景：创建隔离的开发环境，3个微服务（web、api、db）在同一个bridge网络中通信。

#!/bin/bash
set -e
BRIDGE_NET="dev-bridge"
SUBNET="172.20.0.0/24"
# 函数：检查网络是否存在
network_exists() {
    docker network ls --filter name=^${1}$ --format '{{.Name}}' | grep -w "$1" > /dev/null 2>&1
}
# 1. 创建自定义bridge网络（若不存在）
if network_exists "$BRIDGE_NET"; then
    echo "[INFO] 网络 $BRIDGE_NET 已存在，跳过创建"
else
    docker network create --driver bridge --subnet=$SUBNET $BRIDGE_NET
    echo "[OK] 创建网络 $BRIDGE_NET"
fi
# 2. 启动容器并分配静态IP
echo "[INFO] 启动web服务..."
docker run -d --name web-dev --network $BRIDGE_NET --ip 172.20.0.10 nginx:alpine
echo "[INFO] 启动API服务..."
docker run -d --name api-dev --network $BRIDGE_NET --ip 172.20.0.20 node:14-alpine sleep 3600
echo "[INFO] 启动数据库..."
docker run -d --name db-dev --network $BRIDGE_NET --ip 172.20.0.30 postgres:13
# 3. 验证连通性
echo "[TEST] 测试web->api连通性..."
docker exec web-dev ping -c 2 172.20.0.20
echo "[DONE] Bridge网络配置完成"

提示：生产环境避免硬编码静态IP,可使用DHCP或Docker内置DNS。

实战：Shell脚本配置host与none网络模式

host模式：适用于需要高网络性能的Nginx反向代理

#!/bin/bash
# host-mode-proxy.sh
docker run -d --name nginx-proxy --network host nginx:latest
# 此时容器直接监听宿主机80/443端口
# 验证：curl http://localhost

none模式：用于安全审计或自定义网络栈

#!/bin/bash
# none-mode-audit.sh
docker run -d --name isolated-auditor --network none alpine sleep 3600
# 容器无任何网络接口，只有lo (127.0.0.1)
docker exec isolated-auditor ip addr  # 仅看到lo

实战：Shell脚本配置overlay跨主机网络

场景：多台Docker Swarm节点,需要让服务跨越主机通信。

#!/bin/bash
# swarm-overlay.sh
# 前提：已初始化Docker Swarm（docker swarm init）
OVERLAY_NET="cross-host-net"
# 在管理节点创建overlay网络（仅Swarm集群有效）
docker network create --driver overlay --attachable $OVERLAY_NET
# 部署services到此网络
docker service create --name web-service \
    --network $OVERLAY_NET \
    --replicas 2 \
    nginx:alpine
# 使用attach模式可以让独立容器也加入overlay网络
docker run -d --name standalone-client --network $OVERLAY_NET alpine sleep 3600

重要：overlay网络需要配置至少一个管理节点，且物理主机间网络需互通（需开端口如2377、7946、4789）。

企业级Shell脚本：动态网络分配与错误处理

以下脚本集成了配置校验、回滚机制和日志记录，可直接用于CI/CD管道：

#!/bin/bash
# enterprise-net-setup.sh
set -euo pipefail
LOG_FILE="/var/log/container-net-setup.log"
ROLLBACK_ACTIONS=()
# 日志函数
log() {
    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" | tee -a "$LOG_FILE"
}
# 错误处理与回滚
cleanup() {
    if [ $? -ne 0 ]; then
        log "[ERROR] 脚本执行失败，执行回滚..."
        for action in "${ROLLBACK_ACTIONS[@]}"; do
            eval "$action" || true
        done
        exit 1
    fi
}
trap cleanup EXIT
# 主逻辑
main() {
    local NET_NAME="${1:-auto-net}"
    local NET_SUBNET="10.10.${RANDOM:0:2}.0/24"  # 随机子网避免冲突
    # 验证Docker运行
    if ! docker info > /dev/null 2>&1; then
        log "[FATAL] Docker守护进程未运行"
        exit 2
    fi
    # 创建网络并记录回滚命令
    docker network create --driver bridge --subnet="$NET_SUBNET" "$NET_NAME"
    ROLLBACK_ACTIONS+=("docker network rm $NET_NAME")
    log "[OK] 创建网络 $NET_NAME ($NET_SUBNET)"
    # 运行容器并分配随机IP（仅演示）
    local container_id=$(docker run -d --network "$NET_NAME" --hostname app-01 nginx:alpine)
    ROLLBACK_ACTIONS+=("docker rm -f $container_id")
    log "[OK] 容器 $container_id 已加入网络 $NET_NAME"
    # 输出网络信息
    docker network inspect "$NET_NAME" --format '{{range .Containers}}{{.Name}}: {{.IPv4Address}}{{"\n"}}{{end}}'
}
# 执行
main "$@"

常见问题与解答（FAQ）

Q1：Shell脚本中如何动态获取容器的IP地址？

IP=$(docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' container_name)

Q2：配置host网络后，为什么端口冲突报错？

原因：host模式下的容器直接占用宿主机端口，若宿主机已有进程监听该端口（如Apache占用了80端口）,容器会启动失败。
解决：使用 ss -tlnp 检查端口占用,或在脚本中添加端口检测逻辑。

Q3：overlay网络中的容器无法互访怎么办？

检查Swarm集群节点状态：docker node ls
确保防火墙放开了必要端口：TCP 2377（管理）、UDP 4789（VXLAN）、TCP/UDP 7946（节点通信）
使用 docker network inspect overlay_net 查看容器是否均在 Containers 列表中

Q4：如何让bridge网络中的容器通过名称而非IP通信？

Docker内置DNS解析：只要容器在同一自定义bridge网络中，即可通过容器名称（或 --name 指定的别名）解析。

docker run -d --name web --network mynet nginx
docker run -d --network mynet alpine ping web   # 成功

Q5：Shell脚本中如何优雅地删除网络及其关联容器？

# 先停止并删除容器，再删除网络
for container in $(docker ps -a --filter network=old-net --format '{{.ID}}'); do
    docker rm -f "$container"
done
docker network rm old-net

通过Shell脚本配置容器网络模式，能大幅降低人工干预风险，本文从 基础命令 到 企业级错误处理，覆盖了bridge、host、none和overlay四种核心模式的脚本化配置，实际生产环境中,建议：

统一使用自定义bridge网络,避免默认bridge网络导致DNS解析问题；
对关键操作（如网络创建）添加幂等性检查；
将网络配置脚本集成到Ansible或Terraform中，实现基础架构即代码（IaC）。

掌握这些技巧，你将能高效构建高可用、可复现的容器网络环境。