Docker Compose配置容器网络访问局域网虚拟机报错排查
这不是Docker或Docker Compose的bug，是Docker Desktop for Mac的运行架构特性导致的，不需要手动配置宿主机桥接网卡即可实现需求。
自定义bridge网络失效原因
自定义bridge网络属于Docker独立维护的虚拟二层网络，和物理局域网的192.168.1.0/24网段完全隔离。手动给bridge指定和物理网段一致的子网、给容器分配同网段IP，本质是制造了地址重叠的路由冲突，Docker不会自动将虚拟bridge和物理网卡做桥接转发，容器内报Destination Host Unreachable是预期结果。
macvlan配置报错原因
Docker Desktop for Mac的所有容器实际运行在Mac系统后台的轻量化Linux虚拟机内，你在Mac宿主机通过ifconfig看到的en0是MacOS系统的WiFi网卡，对容器所在的隐藏Linux虚拟机不可见，因此指定parent为en0时Docker会提示接口不存在。
额外说明两点：
en0.0的VLAN子接口写法不符合Docker对macvlan父接口的格式校验规则，因此会触发VLAN命名格式报错- 消费级WiFi网卡普遍不支持macvlan要求的混杂模式单播帧转发，就算在原生Linux环境下，用WiFi网卡做macvlan父接口也大概率出现连通性故障，这条路在WiFi场景下本身就不通用。
以下方案均不需要开发者修改宿主机任何网络配置，拿到Compose文件可直接启动：
方案1：静态路由转发（最稳定，推荐优先使用）
Docker Desktop for Mac默认提供host-gateway映射，容器访问网关地址的流量会直接转发到Mac宿主机，再由宿主机物理网卡转发到局域网，配置步骤如下：
- 新建普通自定义bridge网络即可，不要指定和物理网段重叠的子网，使用Docker默认分配的172.x私网段就行
- 在业务服务的配置中添加静态路由，将访问
192.168.1.0/24的流量指向Docker虚拟网络网关，由宿主机代为转发
对应Compose配置片段：
services: your-business-service: image: 你的业务镜像地址 # 原有启动命令前追加静态路由配置 command: > sh -c "ip route add 192.168.1.0/24 via 172.17.0.1 && 你的原有服务启动命令" extra_hosts: - "host.docker.internal:host-gateway" networks: - default
上述配置中172.17.0.1是Docker默认bridge网络的容器侧网关地址，也就是宿主机在Docker虚拟网络中的入口IP，所有发往该地址的流量都会被Docker自动转发到宿主机网络栈，全程不需要修改宿主机任何配置。
方案2：适配Docker Desktop的macvlan配置（需容器持有物理网段独立IP时使用）
如果业务要求容器必须在192.168.1.0/24网段持有独立IP，创建macvlan网络时不要指定parent为Mac宿主机的en0，Docker已经将隐藏Linux虚拟机的上行接口映射为eth0，直接用这个接口作为父接口即可。同时需要预留一段IP范围给容器使用，避免和局域网内现有设备IP冲突。
对应Compose网络配置片段：
networks: my-lan-access: driver: macvlan driver_opts: parent: eth0 ipam: config: - subnet: 192.168.1.0/24 gateway: 192.168.1.254 ip_range: 192.168.1.144/28 # 预留192.168.1.145-192.168.1.158共14个IP给容器，避开现有设备地址
注意：该方案在部分Mac机型的WiFi连接下可能出现随机丢包问题，如果遇到连通性不稳定的情况，切换为方案1即可。
- 不要尝试在MacOS上手动创建绑定en0的桥接接口：MacOS系统不支持桥接WiFi网卡，手动配置也无法生效
- 不要给Docker自定义bridge网络配置和物理局域网重叠的子网：该操作会引发路由冲突，必然导致连通性故障
- 不要在Docker Desktop for Mac环境下直接用宿主机物理网卡名作为macvlan的parent：容器运行在隐藏虚拟机中，无法直接识别宿主机的物理接口
内容的提问来源于stack exchange，提问作者Glen
