前端应用本地Yarn启动正常，但Docker容器运行后端口无法访问

• 本地执行yarn和yarn start命令，可正常在127.0.0.1:3000访问前端应用
• Docker容器启动后，日志显示可访问地址为http://127.0.0.1:3000和http://172.17.0.2:3000，但浏览器访问提示“无法访问此网站”
• 该问题同时出现在两个项目中
• 本地Node版本：v18.12.1
• 使用的Dockerfile内容：

FROM node:16-alpine
RUN apk add --no-cache libc6-compat git python3 py3-pip make g++
WORKDIR /app
COPY . .

# install deps
RUN yarn 

ENV NODE_ENV production

# Next.js collects completely anonymous telemetry data about general usage.
# Learn more here: https://nextjs.org/telemetry
# Uncomment the following line in case you want to disable telemetry during the build.
ENV NEXT_TELEMETRY_DISABLED 1

EXPOSE 3000

ENV PORT 3000

CMD [ "yarn", "start" ]

• 容器能完成代码编译并运行，但无法通过浏览器访问预期的3000端口

1. 确保容器端口映射正确 #

Docker容器的端口不会自动暴露给宿主机，启动容器时必须添加端口映射参数：

docker run -p 3000:3000 <你的镜像名称/ID>

执行该命令后，宿主机的3000端口会转发到容器内的3000端口，此时访问127.0.0.1:3000即可。

2. 修改应用绑定地址 #

Next.js生产模式下默认仅绑定localhost（容器内部的127.0.0.1），外部无法访问。需要让应用监听所有网卡地址：

• 方式一：修改Dockerfile的启动命令：

CMD [ "yarn", "start", "--", "-H", "0.0.0.0" ]

• 方式二：在项目package.json的scripts中修改start命令：

"start": "next start -H 0.0.0.0"

3. 验证容器内部应用状态 #

进入容器内部，测试应用是否正常响应：

docker exec -it <容器ID/名称> curl http://localhost:3000

如果能返回HTML内容，说明应用在容器内正常运行，问题出在外部访问的配置；如果无响应，检查容器日志确认应用是否真的启动成功。

4. 对齐Node版本 #

本地使用v18.12.1，而Docker镜像用的是node:16-alpine，版本差异可能导致依赖或运行时问题。建议将Dockerfile的基础镜像改为和本地一致的版本：

FROM node:18-alpine

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