Next.js应用Docker镜像超2GB，如何优化体积？

一、用多阶段构建剥离构建依赖 #

这是优化体积最核心的手段——将构建过程和生产运行拆成两个独立的镜像阶段，只把生产必需的文件打包到最终镜像里，彻底抛弃构建阶段的开发依赖、编译工具等冗余内容。

示例Dockerfile：

# 第一阶段：构建项目（仅用于编译，最终镜像不会包含这个阶段的内容）
FROM node:18-alpine AS builder
WORKDIR /app
# 先拷贝依赖配置文件，利用Docker缓存层优化构建速度
COPY package*.json ./
# 安装全量依赖（构建Next.js需要开发依赖，比如TypeScript、babel等）
RUN npm ci
# 拷贝项目源码
COPY . .
# 执行生产构建，生成.next产物
RUN npm run build

# 第二阶段：生产镜像（只保留运行必需的最小内容）
FROM node:18-alpine AS production
WORKDIR /app
# 从构建阶段拷贝依赖配置，仅安装生产依赖
COPY --from=builder /app/package*.json ./
RUN npm ci --only=production
# 拷贝构建好的.next产物和静态资源
COPY --from=builder /app/.next ./.next
COPY --from=builder /app/public ./public
# 拷贝Next.js配置文件（如果有）
COPY --from=builder /app/next.config.js ./

EXPOSE 3000
CMD ["npm", "start"]

通过这种方式，生产镜像里的node_modules只会包含生产依赖，体积能从1GB压缩到几百MB甚至更小。

二、压缩node_modules体积 #

• 梳理依赖清单：检查package.json，把仅用于开发的依赖（比如eslint、jest、typescript、prettier等）移到devDependencies里，构建完成后生产镜像不需要这些包。
• 用Alpine基础镜像：替换node:18为node:18-alpine，Alpine基于musl libc，基础体积只有几十MB，比Debian版本小几百MB。
• 严格安装生产依赖：始终用npm ci --only=production或yarn install --production安装依赖，避免混入开发依赖。

三、缩小.next文件夹体积 #

• 启用Next.js独立构建模式：在next.config.js里添加output: 'standalone'，Next.js会生成一个包含所有运行必需依赖的独立包，无需单独安装node_modules：

/** @type {import('next').NextConfig} */
const nextConfig = {
  output: 'standalone', // 生成独立运行包，减少冗余文件
  compress: true, // 启用gzip压缩产物
  images: {
    unoptimized: false, // 自动压缩图片资源
  },
}

module.exports = nextConfig

对应的Dockerfile生产阶段可以简化为：

FROM node:18-alpine AS production
WORKDIR /app
# 仅拷贝独立运行包、静态资源和public文件
COPY --from=builder /app/.next/standalone ./
COPY --from=builder /app/.next/static ./.next/static
COPY --from=builder /app/public ./public

EXPOSE 3000
CMD ["node", "server.js"]

这种模式下，.next的体积会从1.4GB大幅缩减，而且不需要单独维护node_modules。

• 清理构建残留：构建前执行rm -rf .next，避免旧的构建产物累积增加体积。

四、其他细节优化 #

• 配置.dockerignore：避免把无关文件拷贝到镜像里，示例内容：

node_modules
.next
.git
.gitignore
npm-debug.log
README.md
.env.local
.env.development.local
.env.test.local

• 静态资源托管到CDN：把图片、字体等大体积静态资源放到OSS、Cloudflare等CDN上，不再打包进Docker镜像。
• 利用Docker分层缓存：把COPY package*.json和RUN npm ci放在COPY . .前面，依赖不变时复用缓存层，加快构建速度。

内容的提问来源于stack exchange，提问作者Ondřej Krajčík