macvlan跨主机通信需宿主机接入同一二层网络，手动在各主机创建参数一致的macvlan网络，compose中仅通过external引用；容器获物理网段ip，直连无nat，性能高但依赖交换机配置与ip规划。
在 Docker Compose 中配置跨主机的 Macvlan 网络实现容器直连，核心难点不在 Compose 本身（它不直接管理跨主机网络），而在于底层网络基础设施的协同。Macvlan 是 Linux 内核提供的二层网络驱动，容器通过独立 MAC 地址直接接入物理网络，但默认只在单机生效。要跨主机互通，必须确保所有宿主机的 Macvlan 子接口连接到同一广播域（即同一 VLAN 或扁平二层网络），且交换机允许对应 MAC 地址泛洪与转发。
1. 前提：统一二层网络基础
Macvlan 跨主机通信不依赖 Docker daemon 间通信，而是靠物理/交换网络打通：
- 所有宿主机的 Macvlan 接口必须桥接到同一物理网段（例如都接在 192.168.10.0/24 的交换机下）；
- 若使用 VLAN，需在宿主机物理网卡上配置子接口（如 eth0.100），并在交换机侧开启对应 VLAN trunk 和 access 模式；
- 禁用宿主机防火墙对 ICMP/TCP 相关端口的拦截（如
ufw disable或开放对应端口）； - 确认交换机未启用端口安全、DHCP Snooping 等可能阻断未知 MAC 的功能。
2. 宿主机侧：手动创建 Macvlan 网络（必须）
Docker Compose 不支持自动创建跨主机 Macvlan 网络，需先在每台宿主机上执行相同命令：
docker network create -d macvlan \ --subnet=192.168.10.0/24 \ --gateway=192.168.10.1 \ --ip-range=192.168.10.128/25 \ -o macvlan_mode=bridge \ -o parent=eth0 \ my-macvlan-net
-
parent=eth0替换为实际承载流量的物理网卡名（如 enp0s3、ens1f0）； -
macvlan_mode=bridge是最常用模式，允许同网段容器互相访问； -
所有宿主机必须使用完全相同的参数创建同名网络（
my-macvlan-net），否则 Compose 无法引用。
3. Compose 文件中声明并使用该网络
在 docker-compose.yml 中不定义网络，只声明使用已存在的外部网络：
version: '3.8'
services:
web:
image: nginx:alpine
networks:
- my-macvlan-net
# 可选：指定静态 IP，避免 DHCP 冲突
# ipv4_address: 192.168.10.200
<p>networks:
my-macvlan-net:
external: true</p>
-
external: true表示该网络由 Docker 外部创建，Compose 不尝试新建； - 无需配置 driver、subnet 等字段——这些已在宿主机上固定；
- 若需固定 IP，建议配合
ipam在宿主机创建网络时指定范围，并在 service 中用ipv4_address显式分配。
4. 验证与排错关键点
启动后检查是否真正直连：
- 进入容器执行
ip a，确认获得的是物理网段 IP（非 172.x 或 192.168.x 的 Docker 默认网段）； - 从容器 ping 同一网段的其他宿主机物理 IP、其他宿主机上的 Macvlan 容器 IP、以及网关，三者都应通；
- 在不同宿主机上运行容器，互相
ping或telnet ip port测试； - 若不通，优先在宿主机上用
tcpdump -i eth0 icmp抓包，确认 ARP 请求是否发出、响应是否收到。
Macvlan 跨主机本质是“把容器当物理机插网线”，所以没有 Overlay 封装开销，延迟低、性能接近裸机。但它牺牲了网络抽象和灵活性——IP 地址需手动规划，不能动态分配，也不支持跨子网或 NAT。适合边缘计算、工业控制、低延迟服务等强二层需求场景。
