带有 MAC 地址的 Docker 容器如何创建

创建指定MAC地址的Docker容器需用--mac-address参数，bridge和macvlan网络支持，host/none不支持；bridge适用于测试，macvlan可实现局域网直连；Compose中须用v2且mac_address置于service下，格式须为小写十六进制冒号分隔。

创建带有指定 MAC 地址的 Docker 容器，核心在于使用 --mac-address 参数，并确保网络驱动支持该功能。默认 bridge 网络完全支持，macvlan 也支持（且更常用），但 host 或 none 模式不支持。

用 bridge 网络手动指定 MAC 地址

这是最简单直接的方式，适合开发测试或需要固定链路层标识的场景：

1. 先创建一个自定义 bridge 网络（可选，但推荐避免与默认 docker0 冲突）：

   docker network create my-bridge

2. 运行容器时传入 --mac-address，格式必须是标准十六进制 MAC 格式（如 02:42:ac:11:00:05）：

   docker run -d --network=my-bridge --mac-address 02:42:ac:11:00:05 --name test-nginx nginx:alpine

3. 验证是否生效：

   docker inspect -f '{{.NetworkSettings.Networks.my-bridge.MacAddress}}' test-nginx

用 macvlan 网络让容器拥有“真实”MAC 和 IP

如果目标是让容器像物理设备一样接入局域网（同网段、可被其他设备直连），macvlan 是唯一可靠方案。它会自动为每个容器生成唯一 MAC（也可手动指定）：

1. 确认宿主机有启用的有线网卡（如 enp0s3），并记下其所在子网（如 192.168.1.0/24）
2. 创建 macvlan 网络，绑定物理网卡：

   docker network create -d macvlan --subnet=192.168.1.0/24 --gateway=192.168.1.1 -o parent=enp0s3 macvlan-net

3. 启动容器时同时指定 IP 和 MAC（MAC 可选，不指定也会自动生成）：

   docker run -d --network=macvlan-net --ip=192.168.1.200 --mac-address 02:42:c0:a8:01:c8 --name web-server nginx:alpine

4. 此时局域网内任意设备都能用 http://192.168.1.200 直接访问，无需端口映射

在 Docker Compose 中配置 MAC 地址

适用于编排多个容器并统一管理网络身份的场景。注意：必须使用 Docker Compose v2（不是旧版 docker-compose）：

1. Compose 文件中，mac_address 必须写在 service 下，不能放在 networks 块里：

2. services:app:image: nginx:alpinemac_address: "02:42:ac:11:00:0a"networks:mvlan:ipv4_address: 192.168.50.10

3. 对应 networks 定义需为 macvlan 类型，并正确设置 parent 和子网

注意事项和常见问题

避免踩坑的关键点：

1. MAC 地址必须唯一：同一网络内重复会导致 ARP 冲突，访问异常甚至断网
2. 格式要严格：必须是 6 组两位十六进制数，用冒号分隔，字母小写（如 02:42:ac:11:00:02），大写或短格式会失败
3. 某些网络模式不支持：host、none、ipvlan（部分版本）无法设置 MAC；overlay 网络也不支持
4. 权限要求：macvlan 需要宿主机开启 promiscuous 模式（通常自动处理），若报错可尝试 ip link set enp0s3 promisc on