单Docker主机部署React与Node.js容器遇服务端端口访问问题

问题背景 #

React客户端通过3002:3000端口映射可正常访问，Node.js服务端配置3001:3000映射却无法访问。服务端容器日志无报错，且在容器外运行完全正常，已连接MongoDB Atlas。

核心排查方向及解决步骤 #

1. 检查Node服务的监听地址 #

这是容器部署中最常见的问题：如果服务只监听localhost或127.0.0.1，容器外部（包括宿主机器）无法访问——容器的localhost是独立的网络空间，宿主机器无法直接穿透访问。

• 打开服务端启动文件（如index.js），确认监听代码：
  错误示例：

  app.listen(3000, 'localhost', () => {
    console.log('Server running on localhost:3000');
  });
  

  正确示例（二选一即可）：

  // 显式监听0.0.0.0，允许所有IP访问
  app.listen(3000, '0.0.0.0', () => {
    console.log('Server running on port 3000');
  });
  
  // 省略地址参数，默认监听0.0.0.0
  app.listen(3000, () => {
    console.log('Server running on port 3000');
  });
  

• 修改后重新构建镜像并重启服务：

  docker-compose build server
  docker-compose up -d
  

2. 检查宿主机器端口占用 #

宿主机器的3001端口可能被其他进程占用：

• Linux/macOS 查看端口占用：

  lsof -i :3001
  

• Windows 查看端口占用：

  netstat -ano | findstr :3001
  

• 若端口被占用，可杀掉对应进程，或修改docker-compose.yml中的端口映射（如改为3003:3000）。

3. 检查防火墙/安全组限制 #

宿主机器或云服务器的防火墙可能拦截了3001端口的入站请求：

• Linux（ufw防火墙）：

  sudo ufw allow 3001/tcp
  

• Linux（firewalld防火墙）：

  sudo firewall-cmd --add-port=3001/tcp --permanent
  sudo firewall-cmd --reload
  

• Windows：在Windows Defender防火墙中添加允许3001端口的入站规则
• 云服务器：检查安全组是否开放3001端口的TCP入站权限

4. 验证容器内部服务状态 #

进入server容器，测试服务是否在容器内正常运行：

docker-compose exec server curl http://localhost:3000

• 若能正常返回响应，说明服务本身没问题，问题出在外部访问链路；
• 若无法返回，需排查服务启动后的就绪状态（比如数据库连接延迟，但容器外正常的话此概率极低）。

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