Ubuntu Nodejs与Docker如何结合

在 Ubuntu 上将 Node.js 应用容器化：从环境搭建到生产部署

将 Node.js 应用打包进 Docker 容器，听起来技术感十足，但核心流程其实非常清晰：准备环境、编写配置文件、构建并运行。整个过程需要兼顾开发时的便捷与生产环境的高效安全。下面，我们就来一步步拆解。

一、 环境准备：打好地基

万事开头先搭环境。在 Ubuntu 上，你需要准备好 Node.js 运行时和 Docker 引擎。

• 安装 Node.js（三选一即可）
  • 官方仓库：最直接的方式，执行 sudo apt update && sudo apt install -y nodejs npm。
  • NodeSource 仓库：如果想获取更新的 LTS 版本，需要先导入 GPG 密钥并添加对应的软件源，再进行安装。
  • NVM（Node Version Manager）：对于需要灵活切换多个 Node.js 版本的场景，安装 nvm 后，执行 nvm install 16 && nvm use 16 即可。
• 安装 Docker（三选一）
  • 官方脚本：最省心的方式，一条命令搞定：curl -fsSL https://get.docker.com | sudo sh。
  • APT 安装 docker.io：通过系统包管理器安装，执行 sudo apt update && sudo apt install -y docker.io。
  • APT 安装 docker-ce：同样通过 APT，但需要先添加 Docker 的官方 GPG 密钥和仓库，安装后别忘记启动服务：sudo systemctl start docker && sudo systemctl enable docker。
• 验证安装
  • 查看版本确认安装成功：node -v、npm -v。
  • 运行 Docker 的测试容器，如果能看到欢迎信息，说明 Docker 已就绪：docker run hello-world。

二、 快速上手：构建你的第一个容器化应用

理论说再多，不如动手跑一遍。我们用一个简单的 Express 应用来演示完整流程。

• 示例应用
  • 创建项目目录并初始化：mkdir my-node-app && cd my-node-app && npm init -y。
  • 安装 Express 框架：npm install express。
  • 创建应用入口文件 app.js，内容如下：

    const express = require('express');
    const app = express();
    app.get('/', (_, res) => res.send('Hello, Docker'));
    app.listen(3000, () => console.log('Server on 3000'));

• Dockerfile（生产就绪版）
  • 在项目根目录创建 Dockerfile，内容如下：

    FROM node:18-alpine
    WORKDIR /usr/src/app
    COPY package*.json ./
    RUN npm ci --only=production
    COPY . .
    EXPOSE 3000
    USER node
    CMD ["node", "app.js"]

  • 关键点说明：基础镜像选择了体积更小的 node:18-alpine；使用 npm ci 替代 npm install，能确保依赖安装更快且完全可复现；通过 USER node 指令让应用以非 root 用户运行，提升安全性；EXPOSE 3000 声明了容器监听的端口；最后用 CMD 指定启动命令。
• 构建与运行
  • 构建镜像：docker build -t my-node-app .
  • 运行容器：docker run -d --name my-running-app -p 3000:3000 my-node-app
  • 打开浏览器，访问 http://<服务器IP>:3000 或本地的 http://localhost:3000，就能看到 “Hello, Docker” 的问候了。

三、 开发环境最佳实践：效率与便捷并存

开发阶段，我们追求的是修改代码后能立刻看到效果。Docker Compose 和热重载工具是这里的黄金搭档。

• 使用 Docker Compose 管理多服务

  如果你的应用需要数据库（比如 MongoDB），Compose 能一键启动所有服务。创建一个 docker-compose.yml 文件：

  version: "3.8"
  services:
    app:
      build: .
      ports:
        - "3000:3000"
      environment:
        - NODE_ENV=development
        - MONGO_URI=mongodb://mongo:27017/mydb
      volumes:
        - .:/usr/src/app
        - /usr/src/app/node_modules
      depends_on:
        - mongo
    mongo:
      image: mongo:6
      environment:
        MONGO_INITDB_ROOT_USERNAME: root
        MONGO_INITDB_ROOT_PASSWORD: example
      volumes:
        - mongo-data:/data/db
  volumes:
    mongo-data:

  执行 docker-compose up -d 即可启动。这里有两个技巧：一是通过卷（volumes）将本地代码目录挂载到容器中，实现代码实时同步；二是单独挂载一个 node_modules 卷，防止容器内的依赖被本地空目录覆盖。

• 使用 nodemon 实现代码变更自动重启
  • 安装开发依赖：npm i -D nodemon。
  • 在 package.json 中添加脚本："dev": "nodemon app.js"。
  • 在 Compose 文件中，为 app 服务覆盖启动命令，使其在开发模式下运行：

    command: ["npm", "run", "dev"]

• 环境变量管理

  将配置信息如数据库连接字符串写入 .env 文件，在代码中通过 process.env 读取。这样做既能避免硬编码，也便于区分不同环境的配置。

四、 生产优化与常见问题排查

当应用要上线时，镜像体积、安全性和稳定性就成了首要考虑因素。

• 多阶段构建：大幅减小镜像体积

  这是生产构建的标配，它能将构建依赖和运行时依赖分离，最终只保留运行所需的最小内容。

  FROM node:18-alpine AS builder
  WORKDIR /usr/src/app
  COPY package*.json ./
  RUN npm ci
  COPY . .
  RUN npm run build
  
  FROM node:18-alpine
  WORKDIR /usr/src/app
  COPY --from=builder /usr/src/app/dist ./dist
  COPY package*.json ./
  RUN npm ci --only=production
  USER node
  CMD ["node", "dist/index.js"]

• 使用 .dockerignore 文件

  在项目根目录创建 .dockerignore，排除 node_modules、.git、.env 等不必要的文件和目录。这能显著减少构建上下文大小，加速构建过程。

• 以非 root 用户运行

  正如前面 Dockerfile 所示，使用 USER node 指令。同时，在挂载卷时要注意策略，避免覆盖容器内已安装的 node_modules。

• 添加健康检查

  在 Compose 文件中为服务添加健康检查配置，让编排工具能感知应用状态。

  healthcheck:
    test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
    interval: 30s
    timeout: 5s
    retries: 3

• 常见问题与解决思路
  • 端口无法访问：首先确保云服务器的安全组或防火墙规则已放行对应端口（如3000）；本地测试则使用 http://localhost:3000。
  • 本地模块覆盖容器依赖：在 Compose 的卷配置中使用匿名卷 /usr/src/app/node_modules 进行隔离。
  • 依赖缓存导致不一致：坚持使用 npm ci 命令，并确保 package-lock.json 或 yarn.lock 文件被提交到版本控制，以锁定依赖版本。