如何配置Nginx Docker镜像作为ASP.NET Core Web API正向代理？遇502错误

核心原因 #

Docker容器内部的localhost指向容器自身，而非宿主机。你的Nginx配置中proxy_pass https://localhost:8443是让容器访问自己的8443端口，但该端口并未运行后端服务，因此返回502错误。

可行解决方法 #

方法1：使用宿主机实际IP地址

找到宿主机的局域网IP（如192.168.1.100），修改default.conf中的proxy_pass：

server {
    listen 8989;
    server_name localhost 127.0.0.1;

    location /api {
        proxy_pass https://192.168.1.100:8443;
        proxy_set_header X-Forwarded-For $remote_addr;
        # 若后端是自签名HTTPS证书，需添加以下行跳过验证
        proxy_ssl_verify off;
    }
}

修改后重启Nginx容器：

docker restart docker-nginx

方法2：使用Docker Host网络模式

运行容器时添加--network host参数，让容器与宿主机共享网络命名空间，此时容器内的localhost直接指向宿主机：

docker run --name docker-nginx --network host -v ./default.conf:/etc/nginx/conf.d/default.conf -d nginx

注意：此模式无需再用-p映射端口，直接通过宿主机的8989端口访问即可。

方法3：使用Docker内置宿主机域名（Linux/macOS）

Docker 18.03及以上版本支持host.docker.internal作为宿主机的别名，直接修改proxy_pass：

server {
    listen 8989;
    server_name localhost 127.0.0.1;

    location /api {
        proxy_pass https://host.docker.internal:8443;
        proxy_set_header X-Forwarded-For $remote_addr;
        # 自签名证书需添加
        proxy_ssl_verify off;
    }
}

重启容器生效。

额外检查项 #

• 确认宿主机的8443端口服务已正常启动，可通过curl https://localhost:8443/api验证
• 检查宿主机防火墙是否放行8443端口，允许容器所在网段访问

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