应使用host.docker.internal替代localhost：docker desktop for mac原生支持该域名，需版本≥18.03，启动容器时加--add-host=host.docker.internal:host-gateway参数，或在docker-compose.yml中配置extra_hosts。
Mac上Docker容器启动后，应用代码里写死的http://localhost:3000在容器内始终连接拒绝，因为容器的localhost指向自身网络命名空间，而非你Mac上正在运行的前端开发服务器或本地API服务——这不是代码bug，是macOS底层虚拟机架构导致的网络语义错位。
用 host.docker.internal 替代 localhost（推荐首选）
这是 Docker Desktop for Mac 原生支持的方案，无需改网络模式，也不依赖IP硬编码。
第一步：确认你的 Docker Desktop 版本 ≥ 18.03（2026年新装默认满足）。
第二步：启动容器时添加 --add-host 参数强制注入解析规则，避免某些镜像 DNS 缓存导致解析失败：
docker run --add-host=host.docker.internal:host-gateway -d my-web-app
第三步：在容器内应用配置中，把所有 localhost:端口 改成 host.docker.internal:端口。例如 Node.js 中：fetch("http://host.docker.internal:3000/api")。
注意：如果使用 Docker Compose，直接在 service 下加 extra_hosts 字段即可，不用每次手动加参数。
改用 docker.for.mac.host.internal（仅限旧版 Docker Desktop）
该域名在 Docker Desktop 早期版本（2020年前）中可用，新版已逐步弃用，但部分遗留项目仍在用。
在容器内直接访问：curl http://docker.for.mac.host.internal:8080。
这一步操作起来很简单，直接把代码里的 localhost 换成这个域名就行。
【不兼容新版 Docker Desktop】如果你用的是 2025 年后发布的 Docker Desktop，此域名将无法解析，会返回 Name or service not known 错误。
获取宿主机真实 IP 并硬编码访问（通用但需维护）
当 DNS 方案失效、或你在 Orbstack 等非 Docker Desktop 环境中运行时，可手动定位宿主机在虚拟网络中的可达地址。
方法一：在 Mac 终端执行：ifconfig | grep "inet " | grep -v 127.0.0.1 | awk '{print $2}' | head -n1
方法二：更精准的方式是查 hyperkit VM 的网关侧地址：netstat -nr | grep 'default' | grep '192.168' | awk '{print $2}'（通常为 192.168.65.1 或 192.168.64.1）
得到 IP 后，在容器内用该地址访问宿主机服务，例如：http://192.168.65.1:3000。
⚠️ 这个 IP 不稳定：重启 Docker Desktop 或 macOS 网络切换后可能变化，不适合长期部署，仅作临时调试。
在 Docker Compose 中统一配置 host.docker.internal
如果你用 docker-compose.yml 管理多服务，避免每个容器单独加参数。
在对应 service 下添加：extra_hosts: - "host.docker.internal:host-gateway"
完整示例：version: "3.8"services: app: image: node:18 extra_hosts: - "host.docker.internal:host-gateway"
这样所有基于该 compose 文件启动的容器，都能通过 host.docker.internal 访问 Mac 上的服务，无需逐个修改启动命令。
