Macvlan使容器直连物理网络获独立IP，需配置物理网卡、交换机、子网及宿主机路由：绑定UP状态真实网卡，创建macvlan网络指定子网/网关/IP范围，容器静态分配IP，宿主机通过shim接口和路由访问容器。

在 Docker 中用 Macvlan 让容器获得物理网络独立 IP，核心是让容器跳过 NAT 和 docker0 网桥，直接“插”进局域网——就像给它配了一张真实网卡。这不是简单改个参数就能跑通的事，得兼顾宿主机、交换机、IP 分配和通信连通性四个环节。

确认物理网卡与网络环境

Macvlan 必须绑定真实物理网卡（如 enp0s3、eth0 或群晖的 ovs_eth0），不能是 docker0、lo 或 bond 接口。操作前先执行：

• ip link show 查网卡名，确认它处于 UP 状态
• ip addr show enp0s3 看当前 IP（比如 192.168.1.10/24），这个子网就是容器要加入的网段
• 检查路由器或交换机：是否允许该端口学习多个 MAC 地址？家庭路由器常需关闭“端口隔离”，企业交换机建议设为 trunk 或开启混杂模式（ip link set enp0s3 promisc on）

创建 Macvlan 网络（关键命令）

用 docker network create 命令声明子网、网关和父接口。示例（假设物理网卡是 enp0s3，局域网为 192.168.1.0/24）：

Docker Image Puller

使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。

下载

docker network create -d macvlan \
  --subnet=192.168.1.0/24 \
  --gateway=192.168.1.1 \
  --ip-range=192.168.1.128/25 \
  -o parent=enp0s3 \
  my_macvlan

• --ip-range 很重要：避开宿主机 IP（如 192.168.1.10）和网关（192.168.1.1），避免冲突
• 若需 VLAN 隔离，可写 -o parent=enp0s3.100（绑定子接口）
• 默认 macvlan_mode=bridge，适合绝大多数场景（容器间可互通）

启动带静态 IP 的容器

Macvlan 不支持内置 DHCP，必须指定 --ip，且 IP 必须落在 --subnet 内、未被占用：

docker run -d \
  --name web-server \
  --network=my_macvlan \
  --ip=192.168.1.150 \
  -p 80:80 \
  nginx:alpine

• 局域网内其他设备可直接访问 http://192.168.1.150
• 宿主机默认无法 ping 通该 IP —— 这是正常行为，不是故障
• 容器内无需配置路由或 DNS；但若应用需要域名解析，建议手动加 --dns=192.168.1.1

让宿主机也能访问容器（实用补丁）

宿主机与 Macvlan 容器默认二层隔离。要打通，推荐创建一个轻量级 shim 接口：

ip link add macvlan-host link enp0s3 type macvlan mode bridge<br>ip addr add 192.168.1.250/32 dev macvlan-host<br>ip link set macvlan-host up

• 分配一个不冲突的临时 IP（如 192.168.1.250），仅用于宿主机路由
• 加一条路由：ip route add 192.168.1.128/25 dev macvlan-host
• 之后宿主机就能 ping 192.168.1.150，也方便调试