跳转至

Macvlan网络配置

macvlan网络

特点:

  • 容器有 独立的 MAC + IP
  • 直接接入 物理网卡所在的二层网络
  • 局域网设备可以 直接访问容器
  • 不走 docker0 / NAT

⚠️ 重要限制(后面会解决):

  • 宿主机 ↔ macvlan 容器 默认不能互通
  ┌──────────────┐

  │   交换机     │

  └──────┬───────┘

         │

  ┌──────▼───────┐

  │ 宿主机 enp1s0│

  └──────┬───────┘

         │ macvlan

┌─────────┴─────────┐

│ │ │

┌────▼───┐ ┌──▼────┐ ┌───▼────┐

  │容器 A  │                  │容器 B │                        │容器 C │

      │192.168 │                     │192.168│                         │192.168│

└────────┘ └────────┘ └────────┘

一、创建 macvlan 网络(核心步骤)

1️⃣ 确认宿主机物理网卡

ip link

假设你用的是:

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 接口

ip link add dk0 link br0 type macvlan mode bridge

2 给它分配 IP(同一网段)

ip addr add 10.10.0.253/24 dev dk0

3 配置路由 (告诉宿主机,去往容器网段的流量走这个新接口):

  1. Bash
ip route add 10.10.0.128/28 dev dk0

现在,宿主机可以通过 macvlan-host 访问容器了。

⚠️ 这个 IP:

  • 不能是宿主机原 IP
  • 建议专门留一个

4 启用接口

ip link set dk0 up

现在:

  • 宿主机 → 容器 ✅
  • 容器 → 宿主机 ✅

三、启动容器并指定 macvlan

示例:启动一个 nginx

docker run -d \
  --name test-nginx \
  --network macvlan_lan \
  --ip 10.1.0.100 \
  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 网络之前,你需要确定以下信息:

  1. 物理网卡名称: 你希望 Macvlan 绑定到哪个物理接口(例如 eth0, ens33 等)。
  2. 子网信息: 你的物理网络的子网(例如 10.1.0.0/24)和网关。
  3. 避开 IP 冲突: 这一点至关重要。你需要划出一个 Docker 专用的 IP 范围,确保路由器 DHCP 不会将这些 IP 分配给其他设备。

查看主机网络信息:

ip addr show
# 或者
ifconfig

(假设物理网卡为 ​​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 启动(推荐):

docker run -d \
  --name web-server \
  --network macnet \
  --ip 10.1.0.130 \
  nginx

自动获取 IP 启动:

如果不指定 --ip,Docker 会从 --ip-range 中自动选择一个空闲 IP。

docker run -d \
  --name app-server \
  --network macnet \
  alpine sleep 3600

验证网络:

你现在可以从局域网内的其他机器(非宿主机)ping 通 10.1.0.130。


重要限制:宿主机与容器通信问题

这是 Macvlan 最常见的坑:出于安全设计(为了防止环路),宿主机(Host)无法直接通过 Macvlan 接口与运行在上面的容器通信。

  • 其他电脑 -> 容器:✅ 通
  • 容器 -> 其他电脑/公网:✅ 通
  • 容器 -> 容器:✅ 通
  • 宿主机 -> 容器:❌ 不通

解决方案:添加宿主机 Macvlan 接口

如果你必须让宿主机访问容器,需要在宿主机上创建一个 Macvlan 虚拟接口,并配置路由。

  1. 创建虚拟接口 (命名为 macvlan-shim):
ip link add macvlan-shim link eth0 type macvlan mode bridge
  1. 给该接口分配一个 IP (必须在同网段,但不能和容器或物理机 IP 冲突):
ip addr add 10.1.0.222/32 dev macvlan-shim
  1. 启用接口:
ip link set macvlan-shim up
  1. 配置路由 (告诉宿主机,去往容器网段的流量走这个新接口):
ip route add 10.1.0.128/28 dev macvlan-shim

现在,宿主机可以通过 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

sudo nano /usr/local/bin/setup-macvlan.sh

粘贴以下内容:

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

sudo chmod +x /usr/local/bin/setup-macvlan.sh

创建 Systemd 服务文件

创建一个服务来管理这个脚本。

Bash

sudo nano /etc/systemd/system/macvlan-docker.service

粘贴以下配置:

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 常用) 的静态配置方式吗?