Node.js 和 Java 项目怎么写 Dockerfile

概念

你已经学会了为 Python 应用编写 Dockerfile，但实际工作中，你可能更多面对的是 Node.js（前端/后端） 或 Java（Spring Boot） 项目，它们的打包方式和依赖管理不同，Dockerfile 也略有差异

为 Node.js 应用编写 Dockerfile

假设你有一个简单的 Express.js 项目，项目结构如下：

复制代码

my-node-app/
├── package.json
├── server.js
└── package-lock.json

server.js 示例

javascript 复制代码

const express = require('express');
const app = express();
const port = 3000;

app.get('/', (req, res) => {
  res.send('Hello from Node.js in Docker!');
});

app.listen(port, () => {
  console.log(`Server running at http://localhost:${port}`);
});

编写 Dockerfile

Dockerfile 复制代码

# 1. 使用官方 Node.js 镜像（Alpine 版本更轻量）
FROM node:18-alpine

# 2. 设置工作目录
WORKDIR /app

# 3. 先复制 package.json 和 package-lock.json
COPY package*.json ./

# 4. 安装生产依赖（使用 --only=production 减少体积）
RUN npm ci --only=production

# 5. 复制应用代码
COPY . .

# 6. 暴露端口
EXPOSE 3000

# 7. 启动命令
CMD ["node", "server.js"]

构建并运行

bash 复制代码

# 构建镜像
docker build -t my-node-app:1.0 .

# 运行容器
docker run -d -p 3000:3000 my-node-app:1.0

访问 http://localhost:3000，看到欢迎信息，说明成功

为 Java（Spring Boot）应用编写 Dockerfile

Java 项目通常使用 Maven 或 Gradle 构建，生成一个可执行的 JAR 包。

我们以 Maven 为例，项目结构如下：

复制代码

my-spring-app/
├── pom.xml
├── src/
└── target/my-spring-app-0.0.1-SNAPSHOT.jar

注意：Java 项目通常先在本地或 CI 中构建 JAR，再用 Docker 打包运行。

编写 Dockerfile

Dockerfile 复制代码

# 1. 使用轻量基础镜像（如 Eclipse Temurin）
FROM eclipse-temurin:17-jre-alpine

# 2. 设置工作目录
WORKDIR /app

# 3. 复制 JAR 文件（注意：JAR 文件名可能不同）
COPY target/my-spring-app-*.jar app.jar

# 4. 暴露端口（Spring Boot 默认 8080）
EXPOSE 8080

# 5. 启动命令
ENTRYPOINT ["java", "-jar", "app.jar"]

构建并运行

bash 复制代码

# 确保已构建 JAR（使用 Maven）
mvn clean package

# 构建 Docker 镜像
docker build -t my-spring-app:1.0 .

# 运行容器
docker run -d -p 8080:8080 my-spring-app:1.0

访问 http://localhost:8080，看到 Spring Boot 页面，成功！

最佳实践

通用技巧

技巧	说明
分层优化	先复制依赖文件（如 `package.json`、`pom.xml`），再复制代码，利用缓存
使用轻量镜像	优先使用 `alpine`、`slim` 版本，减少镜像体积
添加 .dockerignore	忽略 `node_modules`、`target/`、`.git` 等，提升构建速度
使用非 root 用户（进阶）	提升安全性，避免容器以 root 运行

Node.js 专属

使用 npm ci 替代 npm install，构建更稳定
考虑使用多阶段构建，分离构建环境和运行环境

Java 专属

不要在 Docker 中运行 mvn package：构建应放在 CI/CD 中完成，Docker 只负责运行
使用 jre 镜像而非 jdk，减少体积（除非需要编译）
JAR 文件名使用通配符（如 *-SNAPSHOT.jar），避免版本变更问题

常见问题

为什么 Java 项目不直接在 Docker 里编译？

构建过程慢，且需要下载大量依赖
本地或 CI 构建一次，Docker 只打包运行，效率更高
符合"单一职责"原则

如何减小镜像体积？

Node.js：使用 alpine 镜像，清理缓存
Java：使用 JRE 镜像，开启 --trim（GraalVM）或使用 Distroless 镜像

如何处理环境变量？

使用 -e 参数传递：

bash 复制代码

docker run -e NODE_ENV=production -p 3000:3000 my-node-app

总结

项目类型	关键点
Node.js	先复制 `package.json`，用 `npm ci`，忽略 `node_modules`
Java	先构建 JAR，Docker 只 COPY 并运行，使用 JRE 镜像

无论你是前端、后端还是全栈开发者，掌握为不同语言项目编写 Dockerfile 的能力，是迈向自动化交付和云原生的关键一步