最直接方案是使用nginx:alpine镜像挂载Bootstrap构建后的dist目录至/usr/share/nginx/html，配以最小化nginx.conf启用SPA路由重写（try_files $uri $uri/ /index.html）和gzip压缩，避免冗余构建。
用 nginx:alpine 镜像托管 Bootstrap 静态文件最直接
Bootstrap 本身是纯前端资源（HTML/CSS/JS），不需要 Node.js 运行时。硬套 node 镜像反而增加体积、启动慢、暴露不必要的攻击面。直接用轻量级 nginx:alpine 是更合理的选择。
常见错误是把开发环境配置（比如 npm run docs-serve）误当成部署方案——那只是本地预览，不适合生产。
- 确保你的 Bootstrap 项目已构建完成，
dist/或docs/dist/目录下有可运行的静态文件 - 不要在 Dockerfile 中执行
npm install或grunt build，这些应提前在 CI 或本地完成 -
nginx:alpine镜像约 5–7MB，比node:18-alpine（~120MB）小一个数量级
docker-compose.yml 里怎么配路径映射和端口
关键不是“能跑”，而是路径别映射错导致 403 或 404。Nginx 默认只服务 /usr/share/nginx/html 下的文件，而 Bootstrap 构建产物通常在 dist/ 目录。
正确做法是把本地 dist/ 挂载为 Nginx 的 root：
services:
web:
image: nginx:alpine
ports:
- "8080:80"
volumes:
- ./dist:/usr/share/nginx/html:ro
restart: unless-stopped
-
:ro表示只读挂载，避免容器意外写入文件 - 端口映射写成
"8080:80"，不是"9001:9001"—— 后者会让 Nginx 在容器内监听 9001，但镜像默认只监听 80 - 如果本地没有
dist/目录，docker-compose up会静默失败（日志里显示directory not found）
需要自定义 Nginx 配置？优先改 nginx.conf 而不是用 location 补丁
Bootstrap 页面常依赖 HTML5 History 模式（比如路由跳转不刷新），或者要压缩 CSS/JS。这时候光靠挂载目录不够，得覆盖默认配置。
做法是准备一个最小化 nginx.conf，然后在 docker-compose.yml 中挂载进去：
volumes: - ./dist:/usr/share/nginx/html:ro - ./nginx.conf:/etc/nginx/nginx.conf:ro
其中 nginx.conf 至少包含：
events { worker_connections 1024; }
http {
include mime.types;
default_type application/octet-stream;
server {
listen 80;
root /usr/share/nginx/html;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
}
}
-
try_files $uri $uri/ /index.html是 SPA 路由重写的必要项，缺了会导致子路径刷新 404 - 不要直接修改镜像里的
/etc/nginx/conf.d/default.conf—— 它会被nginx.conf的include覆盖，容易混乱 - gzip、缓存头等优化项，加在
http块里比在server块里更安全（全局生效且不易遗漏）
构建镜像时用多阶段构建，但仅当需要编译时才启用
如果你的 Bootstrap 项目含 Sass 编译、JS 打包等步骤（比如用 bootstrap-sass 或自定义主题），那就不能只靠 nginx:alpine 挂载——得先构建。
此时用多阶段构建更干净：
FROM node:18-alpine AS builder WORKDIR /app COPY package*.json ./ RUN npm ci --only=production COPY . . RUN npm run dist <p>FROM nginx:alpine COPY --from=builder /app/dist /usr/share/nginx/html</p>
- 第一阶段用
node编译，第二阶段只保留nginx和产出文件，最终镜像仍只有 ~7MB -
npm ci比npm install更确定、更快，适合 CI 环境 - 如果项目没有构建步骤（比如直接下载官方
bootstrap-5.3.x-dist.zip解压），就完全跳过多阶段，直接挂载
最容易被忽略的是：很多人把 dist/ 放进 Git，又在 Dockerfile 里重复构建，结果既拖慢 CI，又让镜像层冗余。判断标准很简单——运行 ls dist 有内容，且 git ls-files | grep dist 为空，才需要构建阶段。
