Ubuntu Nodejs与Docker如何结合使用

在 Ubuntu 上把 Node.js 应用容器化，这个需求其实很常见——准备好应用代码和依赖，写一个 Dockerfile，构建镜像、运行容器，如果涉及多个服务再上 Docker Compose。下面从头到尾梳理一遍实操步骤，附带一些关键要点，帮你少走弯路。

一 环境准备

安装 Docker（Ubuntu）

安装完 Docker 之后，跑一个 docker run hello-world 验证一下，看到欢迎信息就说明装好了，没什么复杂的。

准备 Node.js

Node.js 的安装有两种主流方式，根据场景选一个就行。

• 方式一（推荐）：用 NodeSource 仓库安装指定版本。比如想装 20.x，执行：curl -sL https://deb.nodesource.com/setup_20.x | sudo -E bash -，然后 sudo apt-get install -y nodejs，最后 node -v 和 npm -v 确认版本。
• 方式二：用 NVM 管理多个 Node 版本，适合开发机。安装命令：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash，然后 source ~/.bashrc 启用，之后就可以用 nvm install 16、nvm use 16 随意切换了。

二 构建镜像与运行容器

示例项目结构

假设项目根目录下放了 package.json、package-lock.json 和源码（比如 app.js），应用监听 3000 端口，这个结构很典型。

Dockerfile（生产就绪示例）

直接给一个生产可用的 Dockerfile 模板，关键点都标出来了：

• 基础镜像：FROM node:20
• 工作目录：WORKDIR /usr/src/app
• 复制依赖文件：COPY package*.json ./
• 安装生产依赖（用 npm ci 保证可重复构建）：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 端口，访问宿主机 4000 端口就等于访问容器里的应用。

三 多服务与 Docker Compose

当需要多个服务（比如 Node + MongoDB）时，用 Docker Compose 编排会更方便。下面是一个典型的 docker-compose.yml 示例：

• 版本：version: '3'
• 服务：
  • web：构建当前目录下的镜像，端口映射 3000:3000，依赖 db
  • db：使用 image: mongo，数据卷挂载 db-data:/data/db
• 启动：docker-compose up -d；查看状态：docker-compose ps；查看日志：docker-compose logs -f web

Compose 特别适合本地开发、集成测试和小型部署，能有效管理多容器之间的依赖关系。

四 开发工作流与最佳实践

开发模式建议

开发时一般会单独写一个 Dockerfile.dev 配合 docker-compose.dev.yml，核心思路是挂载源码卷实现热更新。比如在 Compose 文件里，web 服务加上：

• build.context: . 和 build.dockerfile: Dockerfile.dev
• volumes 挂载当前目录到容器的工作目录，并排除 node_modules：.:/usr/src/app 和 /usr/src/app/node_modules
• 设置环境变量 NODE_ENV=development
• 启动命令改为 npm run dev（或直接使用 nodemon）

常用的工具是 nodemon，它监听文件变化后自动重启 Node 进程，开发效率能提升不少。

生产要点

生产环境需要注意几个关键点：

• 编写 .dockerignore 文件，把 node_modules、.git、日志文件、本地配置等忽略掉，避免不必要的文件进入镜像。
• 使用 npm ci 替代 npm install，保证每次构建的依赖完全一致；多阶段构建可以进一步压缩镜像体积。
• 必须用非 root 用户运行进程，配合最小权限原则和健康检查，提升安全性。
• 设置 restart=always 让容器在崩溃后自动重启，不过这只是基础保障。如果追求高可用，建议配合进程管理工具或编排系统（如 Docker Swarm、Kubernetes）来做。