MacOS下Colima环境Docker端口映射失效问题求助

问题场景 #

拉取Python 3.8镜像后执行以下命令启动HTTP服务器：

docker run -ti -p 8080:8080 900972ffeecd python -m http.server 8080

容器内通过docker exec进入后执行curl localhost:8080正常，但宿主机执行相同命令无响应。

原因分析 #

Colima在MacOS上默认采用虚拟机网络模式，端口映射并非直接绑定到宿主机的localhost，而是绑定到Colima虚拟机的专属IP地址。

快速解决方法 #

1. 获取Colima虚拟机IP：

   colima status
   

   输出结果中会显示类似IP: 192.168.5.15的字段，记录该IP。

2. 宿主机使用该IP访问服务：

   curl 192.168.5.15:8080
   

永久配置（绑定到localhost） #

如果希望后续直接用localhost访问，可重新启动Colima并开启网络地址绑定：

1. 停止当前Colima实例：

   colima stop
   

2. 带参数启动Colima：

   colima start --network-address
   

3. 重新启动Docker容器后，即可用curl localhost:8080正常访问。

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