Laravel项目Docker部署后url()等助手返回容器名而非域名如何解决

问题根因 #

• 生产环境请求会先经过Nginx/反向代理再转发到Laravel容器，反向代理默认转发请求时会把目标地址（也就是你的容器名mining-api）作为Host头传递，Laravel读取该值作为站点域名
• Laravel默认不信任来自代理的请求头，即使反向代理传了原始Host、协议头也不会主动读取
• 部分场景下url()助手函数会优先读取.env里的APP_URL配置，配置错误也会导致生成的链接不对
• 本地开发时直接访问Laravel服务，没有经过反向代理转发，所以读取的Host就是你输入的本地访问地址，不会出现问题

修复步骤 #

1. 配置反向代理传递原始请求头 #

如果使用Nginx作为反向代理，在站点配置的location转发块中添加以下配置：

proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Port $server_port;

如果使用Traefik、Caddy等其他反向代理，对应配置传递上述X-Forwarded系列请求头即可。

2. 配置Laravel信任代理 #

修改Laravel项目下app/Http/Middleware/TrustProxies.php文件，配置信任所有代理（如果你的反向代理有固定IP段，可替换为对应IP段提升安全性）：

protected $proxies = '*';

3. 修正生产环境配置 #

打开Laravel根目录下的.env文件，将APP_URL修改为实际站点域名：

APP_URL=https://你的实际站点域名

修改完成后执行php artisan config:cache清除配置缓存使配置生效。

4. （可选）强制指定全局域名 #

如果上述配置后仍不生效，可在app/Providers/AppServiceProvider.php的boot方法中强制指定请求根地址：

public function boot()
{
    \URL::forceRootUrl(config('app.url'));
    // 若站点为HTTPS，额外添加以下行强制生成HTTPS链接
    \URL::forceScheme('https');
}

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