Docker环境下Nginx路由至其他容器API的问题求助

需求完全可行 #

你的场景是Docker容器网络隔离+Nginx反向代理的典型用法，完全可以实现API仅通过Nginx的/api路径对外提供服务，无需暴露API容器的端口。

排查并解决404错误 #

你在Nginx容器内能正常访问API，但外部访问http://localhost/api返回404，大概率是Nginx的路由配置问题，常见原因和修复方案如下：

1. 路径重写缺失 #

如果API服务本身的接口基于根路径（比如/）提供，Nginx直接转发/api请求时，会把/api前缀也传递给API，导致API找不到对应接口。比如你访问http://localhost/api/get-data，Nginx会转发到http://my-api:8000/api/get-data，但API实际只有/get-data接口，自然返回404。

修复方法：在Nginx配置中添加路径重写，剥离/api前缀后再转发：

location /api {
    # 重写路径，去掉/api前缀，$1表示/api之后的内容
    rewrite ^/api/(.*)$ /$1 break;
    proxy_pass http://my-api:8000;
    # 传递必要请求头，保证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;
}

2. 配置未生效 #

如果修改了Nginx配置但没重新加载或重启容器，新配置不会生效。可以进入Nginx容器执行：

# 热加载配置，无需重启容器
nginx -s reload

或者直接重启Nginx容器：

docker restart <你的Nginx容器名称>

3. 匹配规则优先级冲突 #

如果Nginx配置中有其他location规则（比如默认的/规则）优先级更高，可能导致/api规则不被匹配。确保/api的location规则写在默认规则之前，或者使用更精确的匹配方式。

验证转发有效性 #

修复配置后，先在Nginx容器内测试转发：

curl http://localhost/api

如果返回预期响应，再从宿主机访问http://localhost/api，就能正常获取API的响应了。

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