macvlan是让Docker容器直接接入物理网络的核心方式，它为容器分配独立MAC和局域网IP（如192.168.1.150），使其像物理设备一样被局域网直接访问，无需NAT或端口映射。
要让 Docker 容器直接访问物理网络（即拥有和宿主机同网段的 IP、能被局域网其他设备直接访问），不能依赖默认 bridge 模式（它走 NAT，容器在私有子网里），也不能用 host 模式（虽共享网络栈但无独立 IP、端口易冲突）。真正实现“容器像物理机一样接入局域网”的核心方式是：macvlan 网络模式。
macvlan 模式：给容器分配真实局域网 IP
macvlan 允许为容器创建一个虚拟网络接口，并绑定到宿主机的物理网卡（如 eth0）上，使容器获得一个独立的 MAC 地址和局域网 IP（比如 192.168.1.150），就像一台直连交换机的物理设备。局域网内其他机器可直接 ping 通、访问该 IP，无需端口映射或 NAT。
- 宿主机物理网卡需处于混杂模式（通常自动处理，无需手动 ifconfig eth0 promisc）
- 不建议在笔记本 Wi-Fi 接口上使用 macvlan（多数驱动不支持），优先用于有线网卡
- 同一物理网卡下，macvlan 子接口之间默认二层互通，但与宿主机自身 IP 默认隔离（可通过
--parent=eth0@eth0或调整路由优化）
快速配置步骤（以 eth0 + 192.168.1.0/24 为例）
执行以下命令即可创建并运行具备物理网 IP 的容器：
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
- 创建 macvlan 网络：
docker network create -d macvlan \<br> --subnet=192.168.1.0/24 \<br> --gateway=192.168.1.1 \<br> -o parent=eth0 \<br> my-macvlan
- 启动容器并指定静态 IP：
docker run -d --name web-lan \<br> --network my-macvlan \<br> --ip=192.168.1.150 \<br> -e TZ=Asia/Shanghai \<br> nginx
- 验证：从局域网另一台电脑执行
ping 192.168.1.150或访问http://192.168.1.150即可直达容器
替代方案：ipvlan（更轻量，适合高密度场景）
若 macvlan 因驱动或环境限制不可用（如某些云服务器虚拟网卡），可考虑 ipvlan 模式。它复用宿主机 MAC 地址，仅隔离 IP 层，资源开销更低，同样支持 L2/L3 模式和同网段 IP 分配，配置语法类似 macvlan（仅将 -d macvlan 换为 -d ipvlan，并加 -o ipvlan_mode=l2）。
为什么不用 bridge + 静态 IP？
bridge 模式下的自定义网络（如 docker network create --subnet=192.168.1.0/24）看似可行，但实际仍依赖 docker0 网桥和 NAT 规则，容器 IP 对外部不可见；即使强行指定 IP，流量仍需经过宿主机转发，无法实现真正的“物理网直通”。只有 macvlan/ipvlan 能绕过宿主机协议栈，让容器帧直接出现在物理网络中。
