Macvlan让容器直连物理交换机，本质是绕过宿主机网络栈、以独立设备接入二层网络，需物理网卡、交换机、IP规划与Docker配置四者协同：确认网卡UP且为真实接口，交换机启用混杂模式或关闭端口隔离，创建macvlan网络时--subnet和--gateway须严格匹配物理网络，容器必须静态指定--ip且不冲突，宿主机默认不可访问容器需额外配shim接口。
用 macvlan 驱动让 docker 容器直连物理交换机，本质是让容器跳过宿主机网络栈，以独立设备身份接入二层网络。这要求物理网卡、交换机端口、ip 规划和 docker 配置四者严格协同，不是仅执行一条命令就能生效。
确认物理网卡与交换机支持混杂模式
macvlan 依赖真实物理网卡（如 enp0s3、eth0），不能是 docker0、lo 或 bond 接口。先运行：
-
ip link show查出可用网卡名 -
ip addr show <网卡名>确认它已 UP 并有 IP（如192.168.1.10/24） - 登录交换机或家用路由器后台：必须允许该端口学习多个 MAC 地址；常见操作包括关闭「端口隔离」、「MAC 地址绑定」或启用「混杂模式」；企业级交换机建议设为 trunk 模式并放行对应 VLAN
创建 macvlan 网络并绑定父接口
使用 docker network create 声明与物理网络完全对齐的参数：
-
--subnet必须等于宿主机所在子网，例如192.168.1.0/24（不能写成192.168.1.1/24） -
--gateway设为局域网网关，如192.168.1.1 -
-o parent=后填查到的真实网卡名，如enp0s3 - 可选加
--ip-range=192.168.1.128/25避开宿主机 IP 和网关，防止冲突
示例命令：
docker network create -d macvlan \<br> --subnet=192.168.1.0/24 \<br> --gateway=192.168.1.1 \<br> --ip-range=192.168.1.128/25 \<br> -o parent=enp0s3 \<br> my-macvlan
启动容器并指定静态 IP 和 MAC（可选）
macvlan 不提供 DHCP，必须显式分配未被占用的 IP：
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
-
--ip=192.168.1.150必须落在--subnet范围内，且不与宿主机、路由器、其他设备重复 - 可加
--mac-address=02:42:c0:a8:01:96指定 MAC（Docker 默认自动生成，一般无需干预） - 容器启动后，局域网内任意设备可直接访问该 IP，例如
http://192.168.1.150
示例：
docker run -d \<br> --name web-app \<br> --network=my-macvlan \<br> --ip=192.168.1.150 \<br> nginx:alpine
让宿主机也能访问容器（非必需但实用）
默认情况下，宿主机无法 ping 通 macvlan 容器 IP——这是设计行为，不是故障。若需调试或管理，可添加 shim 接口：
ip link add macvlan-host link enp0s3 type macvlan mode bridgeip addr add 192.168.1.250/32 dev macvlan-hostip link set macvlan-host up
此后宿主机可通过 192.168.1.250 访问容器，也可在该地址上监听服务。
