运行NestJS的Docker后端容器无法被主机、其他容器及nginx代理访问

DevOps 小满

2026-11-4

问题根因与修复方案

高频核心根因：NestJS 服务监听地址绑定错误

本地运行应用正常、但容器内完全收不到请求的最常见原因，是NestJS启动时默认绑定了回环地址127.0.0.1。这个地址仅对应容器自身的内部回环网卡，无论是nginx容器转发的流量、还是宿主机端口映射进来的流量，都无法触达这个监听套接字。
快速验证方法：进入backend容器执行 netstat -tulpn 命令查看5000端口的监听状态，如果显示绑定地址为127.0.0.1:5000而非0.0.0.0:5000，即可确诊该问题。
修复方式：修改NestJS启动入口文件（通常为src/main.ts），显式指定监听所有网卡：
```
// 原默认监听逻辑
await app.listen(5000);
// 修复后逻辑
await app.listen(5000, '0.0.0.0');
```
同时检查start:dev对应的npm脚本，确认没有被强行注入HOST=127.0.0.1的环境变量限制。

Nginx路径转发逻辑缺陷：当前location /backend的配置未做路径重写，转发到后端的请求会保留/backend路径前缀，如果后端没有匹配对应前缀的路由，会出现请求无响应的情况。可以根据业务需求二选一调整：
- 在后端NestJS全局配置统一的/backend路由前缀
- 在Nginx配置中添加路径重写规则，去掉转发时的/backend前缀：
```
location /backend/ {
    rewrite ^/backend/(.*)$ /$1 break;
    proxy_pass http://docker-backend;
    # 其余原有代理头配置保持不变
}
```
连通性校验：进入nginx容器内部执行 curl -v backend:5000，确认网络层面能否正常访问后端服务。当前compose配置中所有服务都挂载在同一个default桥接网络下，理论上服务名解析没有问题，如果出现连接超时，需要检查容器是否因为异常退出导致网络条目被移除。
端口映射校验：执行 docker port <backend容器ID> 命令，确认5000端口确实映射到宿主机的0.0.0.0:5000，而非被错误配置为仅绑定宿主机回环地址，导致外部请求无法触达。

查看backend容器的实时启动日志 docker logs <backend容器ID>，确认NestJS服务是否正常完成启动流程。如果服务因为MongoDB连接配置错误在启动阶段直接崩溃，即使端口映射、网络配置全部正确，也不会响应任何请求。
对比同套compose下client、admin容器的正常表现：NextJS启动时默认会显式绑定0.0.0.0，所以相同的代理逻辑下可以正常接收请求，而部分版本的NestJS在开发模式下未指定监听地址时，会默认绑定回环地址，这就是同套配置下只有backend服务异常的核心差异点。

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