Docker端口转发异常：post-retrieval等服务无法本地访问

以下是逐步排查和解决的方法：

1. 检查主机端口是否被占用 #

首先确认主机的3000、3001端口有没有被其他进程抢占：

• Windows：打开命令提示符，执行：

  netstat -ano | findstr :3000
  netstat -ano | findstr :3001
  

  找到输出中的PID，打开任务管理器结束对应进程。
• Linux/macOS：打开终端执行：

  lsof -i :3000
  lsof -i :3001
  

  用kill -9 <PID>杀掉占用端口的进程。
  如果不想杀进程，也可以修改docker-compose.yml里的端口映射，比如把3000:3000改成3002:3000，避开被占用的端口。

2. 确认服务实际监听的地址和端口 #

进入容器内部，检查服务是否真的在监听0.0.0.0:3000/0.0.0.0:3001：

1. 先查容器ID或名称：docker ps
2. 进入post-retrieval容器：docker exec -it <容器ID/名称> bash
3. 执行监听端口检查命令：

   netstat -tulpn | grep LISTEN
   

   如果输出里是127.0.0.1:3000而不是0.0.0.0:3000，说明服务只允许容器内部访问，需要修改启动命令，明确指定端口和监听地址：

   npx nx serve services-post-retrieval-service --host=0.0.0.0 --port=3000
   

   同理修改post-management的启动命令，加上--port=3001，确保服务在指定端口监听所有网卡。

3. 排查防火墙或安全软件拦截 #

主机的防火墙、杀毒软件可能会阻止Docker的端口转发：

• Windows：打开「Windows Defender防火墙」→「允许应用通过防火墙」，确认Docker Desktop或对应端口的规则已启用。
• Linux：临时关闭防火墙测试（sudo systemctl stop firewalld），如果能访问了，再添加端口允许规则：

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

• macOS：打开「系统偏好设置」→「安全性与隐私」→「防火墙」，检查是否阻止了Docker的网络请求。

4. 验证Docker端口映射状态 #

执行docker ps，查看post-retrieval和post-management的PORTS列，确认显示的是0.0.0.0:3000->3000/tcp和0.0.0.0:3001->3001/tcp。如果显示的是127.0.0.1:3000->3000/tcp，说明端口只绑定了本地回环地址，外部无法访问，需要确保docker-compose.yml里的ports配置是3000:3000格式（默认绑定0.0.0.0）。

5. 检查base配置文件的冲突 #

因为两个服务都继承自nx-app-base，打开docker-compose.base.yml检查是否有网络模式、端口、环境变量的配置，可能base配置里的某些设置覆盖了当前服务的端口或监听地址，比如指定了network_mode: host或者其他冲突的配置。

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