MacOS下Docker容器指定IP(10.1.0.5)端口映射失败问题排查

错误原因 #

MacOS上的Docker是运行在HyperKit虚拟机中的，并非直接集成在主机内核，主机网络和Docker虚拟机网络是隔离的：

• 你指定的10.1.0.5既不是主机网卡实际配置的IP，也不属于Docker虚拟机默认的IP段，导致Docker daemon无法在主机上绑定该地址，触发can't assign requested address错误。
• 直接在docker run命令中绑定主机不存在的IP，自然会绑定失败。

解决办法 #

1. 绑定主机实际可用的IP #

先查主机当前的有效IP：

ifconfig

找到对应网卡（比如WiFi的en0、以太网的en1）的IP，比如192.168.3.10，然后用这个IP启动容器：

docker run --name relay -p 192.168.3.10:3000:3000 image

2. 绑定所有主机IP（不限定特定地址） #

如果只是不想仅限localhost访问，直接绑定0.0.0.0即可，这样服务会通过主机所有可用IP对外提供：

docker run --name relay -p 0.0.0.0:3000:3000 image

此时同一局域网内的设备可以通过主机的局域网IP访问，公网设备（如果主机有公网IP）也能访问。

3. 自定义Docker网络并分配固定IP（进阶） #

如果一定要使用10.1.0.5这类自定义IP，需要先配置Docker的自定义网络：

• 第一步，创建自定义子网：

  docker network create --subnet=10.1.0.0/24 my-relay-network
  

• 第二步，在该网络下启动容器并指定固定IP：

  docker run --name relay --network my-relay-network --ip 10.1.0.5 -p 3000:3000 image
  

  注意：此时主机访问容器服务仍需通过端口映射的3000端口，其他设备可以通过主机IP+3000端口访问，容器之间可以直接用10.1.0.5通信。

内容的提问来源于stack exchange，提问作者bob