Node.js 项目用 `Docker Compose` 发布的完整流程

Node.js 项目用 Docker Compose 发布的完整流程

✅ 一、基本项目结构示例

以一个简单 Express 项目为例：

复制代码

my-node-app/
├── app.js               # 启动文件
├── package.json
├── package-lock.json
├── Dockerfile           # 构建 Node 容器
├── docker-compose.yml   # 启动服务
└── README.md

🛠️ 二、Dockerfile 编写

Dockerfile 描述如何构建这个 Node 应用：

dockerfile 复制代码

# 使用官方 Node.js 镜像
FROM node:18

# 设置工作目录
WORKDIR /usr/src/app

# 拷贝依赖描述文件
COPY package*.json ./

# 安装依赖
RUN npm install --production

# 拷贝项目代码
COPY . .

# 启动服务（app.js 是入口）
CMD ["node", "app.js"]

# 开放端口
EXPOSE 3000

📦 三、docker-compose.yml 编写

让我们通过 Docker Compose 管理服务（构建+运行）：

yaml 复制代码

version: "3.8"

services:
  app:
    build: .
    ports:
      - "3000:3000"  # 宿主机:容器
    volumes:
      - .:/usr/src/app  # 开发模式可选：代码同步
    environment:
      - NODE_ENV=production
    restart: unless-stopped

▶️ 四、启动服务

在项目根目录执行：

bash 复制代码

docker-compose up --build

你会看到 Node.js 启动并监听 3000 端口。

浏览器访问：http://localhost:3000

🔁 五、可选优化（生产建议）

项	优化建议
PM2 管理 Node 应用	用 `CMD ["npx", "pm2-runtime", "start", "ecosystem.config.js"]`
多阶段构建	分离依赖构建和运行阶段，减小镜像体积
.env 文件	使用 `env_file: .env` 配置环境变量
反向代理	结合 nginx（可用 nginx 容器）做流量转发、SSL 支持

🧪 示例：简单 `app.js`

js 复制代码

const express = require('express');
const app = express();
const PORT = process.env.PORT || 3000;

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

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

✅ 总结步骤（纯 Node.js 项目 Docker Compose 发布流程）

步骤	说明
1️⃣ 创建 `Dockerfile`	定义镜像构建流程
2️⃣ 创建 `docker-compose.yml`	定义服务，设置端口、环境变量等
3️⃣ 构建并启动	`docker-compose up --build`
4️⃣ 验证服务运行	访问 http://localhost:3000
5️⃣ 部署上线	搭配服务器 + 反向代理部署

Node.js 项目 用 `Docker Compose` 发布的完整流程