macOS下使用Colima自定义Docker容器IP无法访问的问题

核心原因 #

你在docker-compose.yml里把端口绑定到127.42.90.84:5432，但这个127.x.x.x是Colima虚拟机内部的回环地址，本地主机的回环网络和Colima虚拟机的回环网络相互隔离，因此本地直接访问这个IP无法连接到容器。

解决方案 #

1. 获取Colima的外部可访问IP #

执行以下命令查看Colima虚拟机的实际IP：

colima status

输出里会显示类似IP: 192.168.5.15的字段，这个就是本地可用来访问Colima服务的IP。

2. 修改端口绑定配置 #

修改docker-compose.yml的ports字段，有两种可选方式：

• 方式一（推荐）：绑定到所有接口，通过Colima的IP即可访问：

ports:
  - "5432:5432"

• 方式二：指定绑定到Colima的实际IP：

ports:
  - "192.168.5.15:5432:5432" # 替换为你的Colima实际IP

3. 验证Postgres监听配置（可选） #

确认Postgres容器内的监听地址允许外部访问：

docker exec -it database-1 psql -U user -c "SHOW listen_addresses;"

正常输出应为listen_addresses | *，Docker官方Postgres镜像默认已配置此参数，一般无需修改。

4. 重启容器生效 #

docker-compose down && docker-compose up -d

5. 测试连接 #

用Colima的IP测试Postgres连接：

psql -h 192.168.5.15 -p 5432 -U user -d app

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