Macvlan网络配置¶
macvlan网络¶
特点:
- 容器有 独立的 MAC + IP
- 直接接入 物理网卡所在的二层网络
- 局域网设备可以 直接访问容器
- 不走 docker0 / NAT
⚠️ 重要限制(后面会解决):
- 宿主机 ↔ macvlan 容器 默认不能互通
┌──────────────┐
│ 交换机 │
└──────┬───────┘
│
┌──────▼───────┐
│ 宿主机 enp1s0│
└──────┬───────┘
│ macvlan
┌─────────┴─────────┐
│ │ │
┌────▼───┐ ┌──▼────┐ ┌───▼────┐
└────────┘ └────────┘ └────────┘
一、创建 macvlan 网络(核心步骤)¶
1️⃣ 确认宿主机物理网卡¶
假设你用的是:
enp1s0
2️⃣ 创建 macvlan 网络¶
docker network create -d macvlan \
--subnet=10.10.0.0/24 \
--gateway=10.10.0.1 \
-o parent=br0 \
macvlan_lan
说明:
| 参数 | 含义 |
|---|---|
| subnet | 局域网网段 |
| gateway | 网关 |
| parent | 宿主机物理接口 |
| macvlan_lan | 网络名 |
📌 IP 不要和 DHCP 冲突(建议预留一段)
二、给宿主机加一个 macvlan 子接口¶
1 在宿主机创建 macvlan 接口¶
2 给它分配 IP(同一网段)¶
3 配置路由 (告诉宿主机,去往容器网段的流量走这个新接口):¶
- Bash
现在,宿主机可以通过 macvlan-host 访问容器了。
⚠️ 这个 IP:
- 不能是宿主机原 IP
- 建议专门留一个
4 启用接口¶
现在:
- 宿主机 → 容器 ✅
- 容器 → 宿主机 ✅
三、启动容器并指定 macvlan
示例:启动一个 nginx¶
这时:
- 局域网任意设备 →
10.1.0.100 - 跟访问真实主机 完全一样
四、docker-compose 示例¶
version: "3.9"
networks:
macvlan_lan:
driver: macvlan
driver_opts:
parent: enp1s0
ipam:
config:
- subnet: 10.1.0.0/24
gateway: 10.1.0.1
services:
smartdns:
image: pymumu/smartdns
container_name: smartdns
networks:
macvlan_lan:
ipv4_address: 10.1.0.53
restart: unless-stopped
使用 Docker 的 Macvlan 网络模式是一种高级网络配置,它允许你为每个容器分配一个唯一的 MAC 地址。这使得容器在物理网络中表现得像一个独立的物理设备。
这通常用于需要容器直接连接到物理网络、处理遗留应用,或者需要容器拥有独立物理网段 IP 的场景。
以下是使用 Docker Macvlan 管理网络的完整指南。
核心概念与架构¶
在 Macvlan 模式下,流量直接通过主机的物理网卡(Parent Interface)进出,不需要经过 Docker 的网桥(Bridge)进行 NAT 转换。
- 性能: 非常高,接近物理机性能。
- 外观: 路由器/交换机将看到每个容器都有自己的 MAC 地址和 IP 地址。
准备工作¶
在创建 Macvlan 网络之前,你需要确定以下信息:
- 物理网卡名称: 你希望 Macvlan 绑定到哪个物理接口(例如
eth0,ens33等)。 - 子网信息: 你的物理网络的子网(例如
10.1.0.0/24)和网关。 - 避开 IP 冲突: 这一点至关重要。你需要划出一个 Docker 专用的 IP 范围,确保路由器 DHCP 不会将这些 IP 分配给其他设备。
查看主机网络信息:
(假设物理网卡为 eth0 ,网段为 10.1.0.0/24 ,网关为 10.1.0.1 )
创建 Macvlan 网络¶
使用 docker network create 命令。
关键参数解释:
-d macvlan: 指定驱动为 macvlan。--subnet: 物理网络的子网。--gateway: 物理网络的网关。--ip-range: (强烈推荐) 指定 Docker 可以分配的 IP 范围,防止与局域网其他设备冲突。-o parent: 指定绑定的物理网卡。
命令示例:
docker network create -d macvlan \
--subnet=10.1.0.0/24 \
--gateway=10.1.0.1 \
--ip-range=10.1.0.128/28 \
-o parent=eth0 \
macnet
在这个例子中,Docker 只会分配 10.1.0.128 * 到 10.1.0.143 * 之间的 IP 给容器。
运行容器¶
创建好网络后,你可以在启动容器时指定该网络和(可选的)静态 IP。
指定静态 IP 启动(推荐):
自动获取 IP 启动:
如果不指定 --ip,Docker 会从 --ip-range 中自动选择一个空闲 IP。
验证网络:
你现在可以从局域网内的其他机器(非宿主机)ping 通 10.1.0.130。
重要限制:宿主机与容器通信问题¶
这是 Macvlan 最常见的坑:出于安全设计(为了防止环路),宿主机(Host)无法直接通过 Macvlan 接口与运行在上面的容器通信。
- 其他电脑 -> 容器:✅ 通
- 容器 -> 其他电脑/公网:✅ 通
- 容器 -> 容器:✅ 通
- 宿主机 -> 容器:❌ 不通
解决方案:添加宿主机 Macvlan 接口¶
如果你必须让宿主机访问容器,需要在宿主机上创建一个 Macvlan 虚拟接口,并配置路由。
- 创建虚拟接口 (命名为
macvlan-shim):
- 给该接口分配一个 IP (必须在同网段,但不能和容器或物理机 IP 冲突):
- 启用接口:
- 配置路由 (告诉宿主机,去往容器网段的流量走这个新接口):
现在,宿主机可以通过 macvlan-shim 访问容器了。
高级用法:802.1q VLAN 标记¶
如果你需要容器连接到特定的 VLAN(例如 VLAN 10),可以直接使用子接口作为父接口。
docker network create -d macvlan \
--subnet=10.10.0.0/24 \
--gateway=10.10.0.1 \
-o parent=eth0.10 \
macnet-vlan10
Docker 会自动创建并处理 eth0.10 的 VLAN 标记。
总结与对比¶
| 特性 | Bridge (默认) | Macvlan |
|---|---|---|
| IP 地址 | Docker 内部私有 IP | 物理网络真实 IP |
| 端口映射 | 需要 (-p 8080:80) | 不需要,直接访问标准端口 |
| 性能 | 经过 NAT,略有损耗 | 极高,无 NAT |
| 适用场景 | 微服务、一般应用 | 监控应用、需要固定物理 IP 的应用 |
| 主机通信 | 直接通 | 默认不通 (需配置 Shim) |
实现方案:Systemd 自启动服务¶
我们可以创建一个自定义服务,在 Docker 启动后自动配置网络接口。
编写配置脚本¶
首先,在 /usr/local/bin/ 下创建一个脚本,将你的命令整合进去。
Bash
粘贴以下内容:
Bash
#!/bin/bash
# 1. 检查并创建 Docker macvlan 网络 (如果不存在)
docker network inspect macvlan_lan >/dev/null 2>&1 || \
docker network create -d macvlan \
--subnet=10.10.0.0/24 \
--gateway=10.10.0.1 \
-o parent=br0 \
macvlan_lan
# 2. 创建宿主机 macvlan 子接口# 先清理旧接口防止报错
ip link delete dk0 >/dev/null 2>&1
ip link add dk0 link br0 type macvlan mode bridge
# 3. 分配 IP 并启动
ip addr add 10.10.0.223/28 dev dk0
ip link set dk0 up
# 4. 配置路由-分配10.10.0.208/28网段给docker直连网络使用
# 确保路由指向你容器所在的特定网段
ip route add 10.10.0.208/28 dev dk0
赋予执行权限:
Bash
创建 Systemd 服务文件¶
创建一个服务来管理这个脚本。
Bash
粘贴以下配置:
Ini, TOML
[Unit]
Description=Setup Macvlan Bridge for Docker Host Communication
After=docker.service
Requires=docker.service
[Service]
Type=oneshot
ExecStart=/usr/local/bin/setup-macvlan.sh
RemainAfterExit=yes
[Install]
WantedBy=multi-user.target
启用并启动服务¶
执行以下命令使配置生效:
Bash
# 重新加载配置
sudo systemctl daemon-reload
# 启用开机自启
sudo systemctl enable macvlan-docker.service
# 立即启动测试
sudo systemctl start macvlan-docker.service
为什么这样做?¶
- 依赖管理:通过
After=docker.service,确保 Docker 守护进程启动后再创建网络,避免报错。 - 清理机制:脚本中加入了
ip link delete,防止机器热重启(非关机重启)时,因为接口已存在而导致脚本执行失败。 - 兼容性:这种方法不依赖于具体的发行版网络管理工具(如 NetworkManager 或 netplan),在 Ubuntu、CentOS、Debian 上通用。
关键点提示¶
- 网卡名称:请确保你的物理桥接接口确实叫
br0。 - 路由冲突:宿主机的
10.10.0.253不要和局域网内的其他设备(或 DHCP 池)冲突。 - 防火墙:如果依然无法通信,请检查宿主机的 iptables 规则,有时需要放行该网段的流量:
iptables -P FORWARD ACCEPT
需要我帮你把这个脚本改造成适配 Netplan (Ubuntu 常用) 的静态配置方式吗?