本地运行Docker化Vite应用遇阻：localhost:5173无法访问

1. 补全端口映射参数 #

你的docker run命令缺少端口映射，容器内部的5173端口未暴露到主机网络。修改运行命令为：

docker run -d -p 5173:5173 <你的镜像tag>

若主机5173端口被占用，可替换为其他端口（如5174）：

docker run -d -p 5174:5173 <你的镜像tag>

之后访问localhost:5174即可。

2. 验证容器运行状态 #

• 执行docker ps查看容器是否处于Up状态。如果容器已退出，通过日志排查错误：

  docker logs <容器ID或名称>
  

  重点关注是否出现dist目录不存在、serve命令未找到等启动报错。

3. 确认构建产物是否生成 #

检查builder阶段是否正确生成了dist目录：

1. 构建builder阶段镜像：

   docker build --target builder -t vite-builder .
   

2. 运行临时容器查看dist目录：

   docker run --rm vite-builder ls -la /app/dist
   

   如果目录为空，检查Vite配置文件中build.outDir是否设置为dist，或执行npm run build时是否有构建错误。

4. 验证容器内服务启动逻辑 #

进入运行中的容器，手动测试serve命令：

docker exec -it <容器ID> sh

在容器内执行：

serve -s dist -l 5173

观察终端输出是否正常，同时在主机访问localhost:5173，确认是否能正常加载页面。

5. 排除主机网络干扰 #

如果以上步骤都正常，检查主机防火墙是否允许5173端口的入站请求，或是否有代理软件（如VPN、浏览器代理）拦截了本地请求。

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