现象:宿主机能连,容器里就是拒绝
本机装了 MySQL 或 Redis,宿主机用客户端连接 127.0.0.1:3306 正常。把应用打包进容器后,配置文件里写 localhost,启动就报 Connection refused。把地址换成宿主机内网 IP,有时能通有时不行。
原因:localhost 指的是容器自己
容器有自己的网络命名空间,localhost 和 127.0.0.1 指向的是容器内部,不是物理机。容器里没有跑数据库,自然连不上。另外两个常见问题:
- 宿主机上的服务只监听了
127.0.0.1,即使地址写对,外部也进不来; host.docker.internal在 Docker Desktop 上开箱可用,在 Linux 上需要额外配置,直接写会解析失败。
解决步骤
第一步,优先改成服务名。如果用 compose 启动,直接用服务名做主机名,走内部 DNS,最稳定:
services:
app:
environment:
DB_HOST: mysql
mysql:
image: mysql:8
第二步,必须访问宿主机时加特殊域名,Linux 下显式映射网关地址:
extra_hosts:
- "host.docker.internal:host-gateway"
第三步,让宿主机服务监听所有地址。MySQL 改 bind-address = 0.0.0.0,Redis 去掉 bind 127.0.0.1 并设置密码,改完重启服务。
第四步,放行防火墙,只对容器网段开放端口,不要直接对公网暴露:
firewall-cmd --zone=trusted --add-source=172.17.0.0/16
第五步,进容器实测连通性,不要只看应用报错:
docker exec -it app sh -c "nc -zv host.docker.internal 3306"
小结
容器里的 localhost 只代表容器本身。用 compose 服务名最省心,跨宿主机访问就加 host-gateway 映射,同时确认服务监听地址和防火墙都放行。
另外别忽略 IPv6:有些镜像默认启用了 IPv6,localhost 先解析到 ::1,而服务只监听了 IPv4,报错依旧是连接被拒绝。遇到"配置看着都对但就是不通"的情况,用 getent hosts 看实际解析结果,再把地址明确写成 IPv4,往往立刻恢复。生产环境更推荐把依赖服务也放进同一个 compose 网络,用服务名互相访问,彻底绕开宿主机地址差异。
