Vite SSR 项目 Docker 镜像最小化打包方案
内容提要
最近准备将部署在Cloudfalre、Vercel和Netlify上的项目迁移到自己的VPS上通过Docker运行。研究了一下Node.js项目Docker镜像最小化打包方案，将镜像大小从1.06GB缩小到了135MB。主要思路是使用Alpine Linux镜像、多层构建和将node_modules内联进JavaScript文件。这样可以减小镜像大小并提高构建速度。
延伸解读
从 1.06GB 到 135MB：优化效果与关键手段
文章通过三个版本逐步优化 Docker 镜像：第 0 版使用 Alpine 基础镜像但未做分层，镜像达 1.06GB；第 1 版采用多层构建，将生产依赖与构建依赖分离，镜像降至 306MB；第 2 版利用 Vite SSR 的 noExternal 选项将 node_modules 内联进 JavaScript 产物，最终镜像仅 135MB。构建时间也从 113.8 秒缩短至 24.9 秒。
多层构建的收益与依赖管理风险
第 1 版通过多层构建将镜像从 1.06GB 缩小到 306MB，但需要显式指定生产依赖。如果遗漏某个运行时必需的依赖，容器启动后会报错。因此，采用此方案时必须确保 package.json 中 dependencies 与 devDependencies 的划分准确，或通过工具自动校验，否则可能引入运行时故障。
内联 node_modules 的适用条件与配置要点
第 2 版的核心是修改 Vite 配置，在 Docker 构建时设置环境变量 DOCKER=true，触发 ssr.noExternal 将依赖内联进 JavaScript 文件。这样运行时无需 node_modules，只需复制 dist 目录。但此方案依赖于 Vite SSR 对内联的支持，且可能增加构建产物体积，需确保所有依赖均可被正确打包。
迁移自托管部署的实践参考
作者将项目从 Cloudflare、Vercel、Netlify 迁移到自建 VPS 并用 Docker 运行，通过优化镜像显著降低了资源占用。对于类似场景，可参考此方案：先采用 Alpine 基础镜像，再引入多层构建，最后评估内联依赖的可行性。注意示例项目为 Astro + Vite SSR，其他框架需验证兼容性。
Q&A
如何将Node.js项目的Docker镜像大小从1.06GB缩小到135MB？
通过使用Alpine Linux镜像、多层构建和将node_modules内联进JavaScript文件，可以将镜像大小缩小到135MB。
使用Alpine Linux镜像有什么好处？
使用Alpine Linux镜像可以显著减小Docker镜像的体积，提高构建速度。
多层构建方案的缺点是什么？
多层构建方案需要明确指定生产依赖，如果未指定，运行时可能会报错。
最终的Docker镜像构建时间减少了多少？
最终的Docker镜像构建时间从113.8秒减少到24.9秒。
如何将node_modules内联进JavaScript文件？
可以在Vite的配置中设置ssr.noExternal为true，以实现将node_modules内联进JavaScript文件。
示例项目在哪里可以找到？
示例项目是开源的，可以在GitHub上查看。
