使用Nginx镜像运行HTML最稳最快，只需将文件放入/usr/share/nginx/html并正确配置root和try_files指令，避免403/404；生产环境必须COPY进镜像而非-v挂载，且需确保index.html位于根目录、权限可读、MIME类型正确。
直接用 nginx 镜像跑 HTML 是最稳、最快、最不容易翻车的方式，不需要自己装环境、不碰 Node、不写服务逻辑——只要把文件放对位置，配对路径，就能上线。
为什么不用 Node 启动静态 HTML？
有人习惯用 http-server 或 live-server 本地预览，但它们不是为生产设计的：
– 没有缓存控制、无 gzip 压缩、不支持 try_files 路由回退
– 权限模型松散，容易暴露源码或目录遍历
– 进程管理弱，OOM 或崩溃后不会自动恢复
– Docker 镜像体积大（Node + npm + dev 依赖），而 nginx:alpine 仅约 5MB
docker run -v 挂载方式适合谁？
适合本地调试、CI/CD 中临时预览、或配置未定型阶段。关键点：
– 必须确保本地目录结构里有 index.html，且在根路径（不能是 src/index.html）
– 挂载命令中的路径要绝对或用 $(pwd)，避免相对路径失效：docker run -d -p 8080:80 -v $(pwd)/dist:/usr/share/nginx/html:ro --name site nginx
– 加 :ro 是硬性要求：防止容器内 Nginx 进程意外覆盖你本地文件
– 容器启动后，若看到 403，大概率是宿主机文件权限不足（Linux/macOS 下检查 ls -l dist，确保其他用户有读权限）
正式部署必须用 Dockerfile 构建镜像
挂载（-v）在生产环境不可靠：容器重启后挂载点可能丢失、K8s 不支持裸挂载、安全策略常禁用 hostPath。
正确做法是把 HTML 文件 COPY 进镜像：
– Dockerfile 示例：
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
立即学习“前端免费学习笔记（深入）”；
FROM nginx:1.25-alpine RUN rm /etc/nginx/conf.d/default.conf COPY nginx.conf /etc/nginx/conf.d/ COPY dist/ /usr/share/nginx/html/ # 确保 index.html 在 dist/ 下一级，否则 404
– 对应的 nginx.conf 至少包含：
• root /usr/share/nginx/html;（别漏掉分号）
• try_files $uri $uri/ /index.html;（Vue/React Router history 模式必需）
• 若有静态资源（js/css），建议加缓存：location ~* \.(js|css|png|jpg)$ { expires 1y; }
常见错误和对应解法
– 浏览器打开白屏，F12 看 Network 标签页发现 /js/app.js 404：
• 检查 HTML 中 script src 路径是否带了错误前缀（如写成 /my-app/js/app.js，但你没配 sub-path）
• 检查构建产物是否真的输出到了 dist/js/app.js，而不是 dist/my-app/js/app.js
– 刷新子路由（如 /about）返回 404：
• 只有一个原因：Nginx 配置里缺 try_files $uri $uri/ /index.html;
– 构建后页面样式错乱、字体不显示：
• 大概率是 CSS 或 font 文件 MIME 类型未被识别，nginx.conf 里要确保 include /etc/nginx/mime.types; 存在（官方镜像默认已含）
– docker build 报错 “no such file or directory”：
• COPY 的源路径是构建上下文内的相对路径，不是你当前终端 pwd；确认 dist/ 目录真在 Dockerfile 同级
真正容易被忽略的是：HTML 项目没有“入口文件”概念，它的部署成败完全取决于路径映射是否精确。哪怕只差一个斜杠、少一个 root、多一个嵌套目录，都会导致 403/404，而且错误日志里往往不报具体缺失路径——得靠浏览器 Network 面板反向排查。
