同一主机部署Vue+Nginx与Express API：SSL及Nginx配置问题

是否需要为Express单独配置SSL证书？ #

不需要。Nginx已经作为SSL终止点，外部所有HTTPS请求先由Nginx处理证书验证与加密，再通过HTTP协议转发给内部的Express容器。这种方式既简化了配置，也避免了在多个服务上重复维护证书的麻烦。

解决502 Bad Gateway错误的具体步骤 #

502错误的核心原因是Nginx无法成功连接到Express服务，结合Docker环境，主要排查以下几点：

1. 修复Docker网络连通性（最常见问题）

如果你的Nginx是运行在Docker容器中，localhost:8080在Nginx容器内指向的是容器自身，而非宿主机，因此无法访问到宿主机上的Express容器。解决方法：

• 创建自定义Docker网络：

  docker network create app-network
  

• 启动Express容器时加入该网络：

  docker run --network app-network --name express-api your-express-image
  

• 启动Nginx容器时也加入该网络：

  docker run --network app-network --name nginx-web your-nginx-image
  

• 修改Nginx的代理配置，使用容器名代替localhost：

  location /api {
      proxy_pass http://express-api:8080/;
  }
  

如果Nginx是直接安装在宿主机（非容器），需确认Express容器已将8080端口映射到宿主机：

• 启动Express容器时必须添加端口映射参数：

  docker run -p 8080:8080 your-express-image
  

• 先在宿主机执行curl http://localhost:8080/foo测试，确认能正常获取响应后，再检查Nginx配置。

2. 修正代理路径匹配逻辑

当前配置中，location /api会将https://domain/api/foo转发到http://localhost:8080/api/foo，但你的Express路由是/foo，因此会出现匹配失败。需调整proxy_pass的路径格式，并添加必要的代理头：

location /api {
    proxy_pass http://localhost:8080/;  # 末尾添加斜杠，自动去除/api前缀
    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;
}

末尾的斜杠会让Nginx将/api/foo重写为/foo转发给Express，同时添加的代理头能让Express正确识别请求的来源与协议。

3. 验证配置并重启Nginx

每次修改配置后，先验证配置合法性：

nginx -t

若提示test is successful，再重启Nginx生效：

# 宿主机安装的Nginx
systemctl restart nginx
# 容器化Nginx
docker restart nginx-web

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