Ubuntu Nodejs与Docker如何结合使用

在 Ubuntu 上把 Node.js 应用容器化，通常做法是准备应用代码与依赖、编写 Dockerfile、构建镜像并运行容器；多服务场景再配合 Docker Compose 管理。下面给出从零到部署的实操步骤与要点。

一环境准备

二构建镜像与运行容器

示例项目结构
- 假设项目根目录包含：package.json、package-lock.json、源码（如 app.js），应用监听 3000 端口。
Dockerfile（生产就绪示例）
- 使用官方 Node 镜像、分层复制依赖、设置非 root 用户、非缓存安装、健康检查和优雅停止。
- 参考要点：
  - 基础镜像：FROM node:20
  - 工作目录：WORKDIR /usr/src/app
  - 复制依赖：COPY package.json ./*
  - 安装依赖（生产）：RUN npm ci --only=production
  - 复制源码：COPY . .
  - 非 root 用户：RUN adduser --disabled-password --gecos ‘’ app && chown -R app:app /usr/src/app
  - 声明端口：EXPOSE 3000
  - 健康检查：HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 CMD curl -f http://localhost:3000/health || exit 1
  - 启动命令：CMD [“node”, “app.js”]
  - 如需更小镜像，可改用 node:20-alpine。
构建与运行
- 构建：docker build -t my-node-app .
- 运行（前台）：docker run -p 4000:3000 my-node-app
- 运行（后台、自动重启）：docker run -d --restart=always --name my-running-app -p 3000:3000 my-node-app
- 查看日志：docker logs -f my-running-app
- 进入容器：docker exec -it my-running-app bash
- 说明：-p 4000:3000 将宿主机 4000 端口映射到容器 3000 端口。

三多服务与 Docker Compose

四开发工作流与最佳实践

开发模式建议
- 使用 Dockerfile.dev 与 docker-compose.dev.yml，挂载源码卷实现热更新：
  - 示例 Compose 片段：
    - web:
      - build:
        
        context: .
        
        dockerfile: Dockerfile.dev
      - volumes:
        
        .:/usr/src/app
        
        /usr/src/app/node_modules
      - environment:
        
        NODE_ENV=development
      - command: npm run dev（或 nodemon）
- 常用工具：nodemon 监听文件变化并自动重启，提升开发效率。
生产要点
- 使用 .dockerignore 忽略 node_modules、.git、日志与本地配置。
- 使用 npm ci 替代 npm install 以获得可重复构建；多阶段构建可进一步减小镜像体积。
- 使用 非 root 用户运行进程，设置最小权限与健康检查。
- 通过 restart=always 提升可用性，配合进程管理或编排（如 swarm/k8s）做高可用。

最新问答