Node.js在Ubuntu上如何实现跨平台部署

在 Ubuntu 上实现 Node.js 跨平台部署的可落地方案

一、方案总览

使用 Docker 容器化：将应用及其依赖打包成镜像，在 Linux/Windows/macOS 的开发机与生产服务器上一致运行，避免“本机能跑、线上报错”的环境差异问题。
使用 NodeSource 二进制分发 或 NVM 在 Ubuntu 上标准化安装 Node.js，便于多版本并存与回滚。
使用 PM2 进行进程守护、日志聚合与开机自启，适合直接裸机/虚拟机部署。
使用 Nginx 反向代理 统一暴露端口、支持 HTTP/HTTPS 与静态资源服务。

二、方案一 Docker 容器化部署（优先推荐）

适用目标：一次构建，跨平台运行；同时覆盖 开发/测试/预发/生产 环境一致性。
步骤
1. 在 Ubuntu 上安装 Docker（如尚未安装）：sudo apt-get update && sudo apt-get install -y docker.io
2. 在项目根目录创建 Dockerfile（示例为 Node 20）：
```
FROM node:20
WORKDIR /usr/src/app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
EXPOSE 3000
ENV NODE_ENV=production
CMD ["npm","start"]
```
3. 构建镜像：docker build -t my-node-app .
4. 运行容器：docker run -d -p 4000:3000 --name myapp my-node-app
5. 多服务可用 Docker Compose（示例含 MongoDB）：
```
version: "3"
services:
  web:
    build: .
    ports:
      - "3000:3000"
    depends_on:
      - db
  db:
    image: mongo
    volumes:
      - db-data:/data/db
volumes:
  db-data:
```
6. 本地开发可挂载源码热更新：docker run -it --rm -v $PWD:/usr/src/app -w /usr/src/app -p 3000:3000 node:20 npm run dev
说明：镜像可在 Windows/macOS/Linux 主机上运行，端口映射如 -p 4000:3000 将宿主机端口映射到容器内端口，实现跨平台一致的网络访问。

三、方案二裸机或虚拟机部署（NodeSource + PM2 + Nginx）

适用目标：无容器化约束的服务器环境，强调进程守护与反向代理。

步骤

安装 Node.js（NodeSource 示例，Node 20.x）：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v && npm -v

上传代码并安装依赖：

npm ci --only=production    # 或 npm install（开发环境）

使用 PM2 守护进程与开机自启：

npm i -g pm2
pm2 start app.js --name "my-app"
pm2 startup systemd     # 按提示完成开机自启
pm2 save

配置 Nginx 反向代理（HTTP 到 3000 端口）：

sudo apt-get install -y nginx
# /etc/nginx/sites-available/default 或 /etc/nginx/conf.d/default.conf
server {
  listen 80;
  server_name example.com;
  location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;
  }
}
sudo systemctl reload nginx

环境变量建议通过 .env 或系统环境设置，避免硬编码在代码中。

四、跨平台一致性与多版本管理

使用 NVM 在同一台 Ubuntu 上管理多个 Node.js 版本，便于开发与生产对齐或快速回滚：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重新加载 shell 后
nvm install 20
nvm use 20
nvm alias default 20
node -v && npm -v

如需在容器内也使用 nvm，可在 Dockerfile 中安装 nvm 并切换版本（适合多项目/多版本场景）。

五、关键注意事项与最佳实践

使用精确版本：在 package.json 中锁定 engines 与依赖版本，避免不同机器安装差异。
区分环境依赖：生产环境使用 npm ci --only=production，仅安装生产依赖。
非 root 运行：容器内建议以 node 用户运行，宿主机上避免以 root 直接启动应用。
日志与监控：PM2 日志文件与集群监控便于排障与容量规划；容器化建议统一日志驱动输出到宿主机或集中式日志系统。
安全：限制对外暴露端口，仅开放 80/443；启用 HTTPS（如 Let’s Encrypt）；及时升级 Node.js 与依赖包以修复漏洞。

最新问答

相关标签