从Docker Desktop切换到Colima后无法通过localhost访问容器

问题分析 #

Colima基于QEMU虚拟机实现Docker环境，和Docker Desktop的网络转发机制存在差异。虽然/etc/hosts中localhost已正确映射127.0.0.1和::1，但Colima默认未启用IPv6端口转发，当系统优先通过IPv6（::1）解析localhost时，就会出现无法连接容器端口的情况。

解决步骤 #

1. 验证localhost解析优先级 #

执行以下命令，查看localhost的解析结果：

ping localhost

如果返回::1（IPv6地址），说明系统优先用IPv6访问localhost，而Colima默认未转发IPv6端口，这就是连接失败的原因。

2. 启用Colima的IPv6端口转发 #

编辑Colima的配置文件~/.colima/default/colima.yaml，添加或修改网络配置：

network:
  ipv6: true
  forward-ipv6: true

保存配置后重启Colima：

colima stop && colima start

3. 显式指定容器绑定IPv4地址（可选） #

如果不想启用IPv6，可在运行容器时显式指定绑定IPv4的0.0.0.0，确保端口转发覆盖IPv4的所有地址：

docker run --name dynamodb -d -p 0.0.0.0:8000:8000 amazon/dynamodb-local

4. 确认Docker上下文正确 #

确保当前使用的是Colima的Docker上下文，避免残留的Docker Desktop上下文影响：

docker context ls

如果默认上下文不是colima，执行以下命令切换：

docker context use colima

5. 临时调整localhost解析（不推荐） #

如果上述方法无效，可临时修改/etc/hosts，将localhost仅映射到127.0.0.1（注释掉IPv6映射行）：

127.0.0.1   localhost
# ::1         localhost

注意：该方法会影响其他依赖IPv6的应用，仅作为临时 workaround。

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