Docker容器运行TCP服务器无法通过Telnet连接的问题求助

问题现象 #

在Docker容器中运行Node.js TCP服务器，镜像构建完成并启动容器后，执行telnet 127.0.0.1 3000出现如下错误：

telnet 127.0.0.1 3000
Trying 127.0.0.1...
Connected to 127.0.0.1.
Escape character is '^]'.
Connection closed by foreign host.

服务器在本地环境运行正常，容器端口已完成映射，但拒绝外部连接。要求不使用Docker host网络，也无法使用docker-compose。

相关配置信息 #

Dockerfile内容 #

FROM node:16.15-alpine
WORKDIR /app
COPY package.json yarn.lock /app/
RUN yarn install
COPY . .
RUN yarn build
COPY . /app/
EXPOSE 3000
CMD npm run start:prod

docker ps输出 #

CONTAINER ID   IMAGE     COMMAND                  CREATED        STATUS         PORTS                                       NAMES
dbf747c8a413   test-2    "docker-entrypoint.s…"   39 hours ago   Up 4 seconds   0.0.0.0:3000->3000/tcp, :::3000->3000/tcp   test-3

排查与解决步骤 #

• 修正服务器绑定地址：Node.js TCP服务器若默认绑定127.0.0.1，仅容器内部可访问。需修改代码将监听地址改为0.0.0.0，允许外部通过端口映射访问：

  // 原代码示例
  server.listen(3000, '127.0.0.1', () => { ... });
  // 修改后
  server.listen(3000, '0.0.0.0', () => { ... });
  

• 修复Dockerfile重复拷贝问题：Dockerfile中RUN yarn build后又执行COPY . /app/，会用本地未构建的源码覆盖容器内的构建产物。删除最后一行COPY . /app/，确保运行的是构建完成的代码。
• 容器内验证服务状态：进入容器内部，直接测试服务是否正常响应，排除容器内服务未启动的问题：

  docker exec -it test-3 sh
  telnet 127.0.0.1 3000
  

• 确认主机端口监听状态：执行netstat -tulpn | grep 3000或ss -tulpn | grep 3000，验证主机3000端口是否真的处于监听状态。

内容的提问来源于stack exchange，提问作者B Sai Uttej