最可靠方式是执行ip route | awk '/default/ {print $3}'获取宿主机网关IP；Linux需手动添加--add-host=host.docker.internal:host-gateway才支持该域名解析；推荐通过环境变量HOST_IP注入宿主机IP。
容器内 PHP 怎么拿到宿主机的 IP（不是 127.0.0.1）
PHP 运行在 Docker 容器里，默认 $_SERVER['SERVER_ADDR'] 或 gethostbyname('localhost') 返回的是容器自己的网络地址（比如 172.17.0.2），不是宿主机真实 IP。要让 PHP 调用宿主机上的服务（如 MySQL、Redis、本地开发 API），必须拿到宿主机在 Docker 网络中的真实网关地址。
最可靠的方式是利用 Docker 默认桥接网络的网关规则：宿主机对容器而言，其 IP 就是默认路由的网关 IP。
- 在容器内执行
ip route | awk '/default/ {print $3}'，通常输出类似172.17.0.1—— 这就是宿主机在docker0网桥上的 IP - PHP 中可用
exec('ip route | awk \'/default/ {print $3}\'', $output)拿到该值，$output[0]即目标 IP - 注意：该方法依赖
iproute2工具，Alpine 镜像需先apk add iproute2；Debian/Ubuntu 镜像一般自带 - 如果用了自定义网络（如
docker network create mynet），网关可能不同，建议改用host.docker.internal（见下一条）
为什么 host.docker.internal 在 PHP 里有时不生效
Docker Desktop（macOS/Windows）默认注入 host.docker.internal 到容器 hosts，但 Linux 上默认不支持，除非手动启动时加 --add-host=host.docker.internal:host-gateway。
- Linux 用户必须显式添加：运行容器时带上
docker run --add-host=host.docker.internal:host-gateway ... - 在 docker-compose.yml 中对应写成：
extra_hosts: - "host.docker.internal:host-gateway"
- PHP 中直接用
gethostbyname('host.docker.internal')即可，无需 exec 外部命令，更轻量也更稳定 - 若已部署到生产环境且用的是 Linux Docker 引擎，又没加
--add-host，gethostbyname()会返回 false 或空字符串 —— 这是常见故障点
$_SERVER['REMOTE_ADDR'] 和 gethostname() 都不能用来取宿主机 IP
这两个是高频误用项，务必避开：
立即学习“PHP免费学习笔记（深入）”；
-
$_SERVER['REMOTE_ADDR']是客户端（比如浏览器）的真实 IP，跟宿主机无关；在 Nginx + PHP-FPM 架构中还可能被反向代理覆盖，需靠X-Forwarded-For解析，但依然不是宿主机 -
gethostname()返回的是容器自身的 hostname（如abc123def456），不是 IP，且解析出来的通常是容器 ID 对应的短名，gethostbyname()后大概率还是回环地址 - 试图读取
/etc/hosts或/proc/net/route手动解析，容易因格式差异或权限失败（尤其非 root 容器），不推荐
生产环境建议：用环境变量传入宿主机 IP，而非运行时探测
自动探测（exec 或 DNS）在 CI/CD、快速扩缩容、多网络场景下容易出错。更可控的做法是启动时由编排层明确注入。
- 启动容器时加
-e HOST_IP=192.168.1.100（填你宿主机的真实局域网 IP） - PHP 中直接读取：
$_ENV['HOST_IP']或getenv('HOST_IP') - docker-compose.yml 示例：
environment: - HOST_IP=192.168.1.100
- 注意：不要用
127.0.0.1，宿主机的 127.0.0.1 对容器不可达；也不要依赖 DHCP 分配的 IP，建议静态配置或通过脚本生成后注入
实际中最容易卡住的地方，是以为 host.docker.internal 在所有平台开箱即用，结果在 Linux 服务器上死活解析不出来——它真不是默认存在的。
