Debian 系统中 Node.js 配置步骤

Debian 系统中 Node.js 配置步骤

一 安装方式选择

• 使用 NodeSource 二进制分发库：适合在系统范围内安装并维护特定版本的 Node.js，步骤简洁、与 APT 生态兼容好。
• 使用 NVM（Node Version Manager）：适合在同一台机器上管理多个 Node.js 版本，开发/测试环境切换方便。
• 从源码编译安装：适合需要特定构建选项或深度定制的场景，过程相对复杂。
  以上三种方式均为常见且可靠的安装途径，可按用途选择其一。

二 方法一 NodeSource 安装与系统级配置

• 更新索引并安装必要工具：
  sudo apt update && sudo apt install -y ca-certificates curl gnupg
• 添加 NodeSource 仓库（示例为 20.x，可按需替换为 18.x/22.x 等）：
  curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
• 安装 Node.js 与 npm：
  sudo apt install -y nodejs
• 验证安装：
  node -v
  npm -v
• 可选 全局包目录与权限：
  • 建议将全局包安装到用户目录，避免系统目录权限问题：
    mkdir -p ~/.npm-global
    npm config set prefix ‘~/.npm-global’
  • 将全局 bin 目录加入 PATH（写入 ~/.bashrc 或 ~/.zshrc）：
    echo ‘export PATH=$HOME/.npm-global/bin:$PATH’ >> ~/.bashrc
    source ~/.bashrc
  • 验证：npm config get prefix。

三 方法二 NVM 安装与多版本管理

• 安装 NVM（示例版本 v0.39.7）：
  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
• 加载 NVM（或重新打开终端）：
  source ~/.bashrc
• 安装与切换版本：
  • 安装最新 LTS：nvm install --lts
  • 安装指定版本：nvm install 18.18.2
  • 使用版本：nvm use 18.18.2；设为默认：nvm alias default 18.18.2
• 验证：
  node -v
  npm -v
• 说明：NVM 安装的 Node.js 位于用户目录，通常无需额外配置系统级 PATH。

四 环境变量与多版本切换

• 使用 NVM 时的 Shell 配置（确保每次登录可用）：
  echo ‘export NVM_DIR=“$HOME/.nvm”’ >> ~/.bashrc
  echo ‘[ -s “$NVM_DIR/nvm.sh” ] && . “$NVM_DIR/nvm.sh”’ >> ~/.bashrc
  source ~/.bashrc
• 系统级 PATH 调整（仅在非 NVM 场景或自定义安装路径时需要）：
  • 编辑全局环境：sudo nano /etc/environment（在 PATH 末尾追加如 /usr/local/bin）
  • 或编辑用户环境：echo ‘export PATH=$PATH:/usr/local/bin’ >> ~/.bashrc && source ~/.bashrc
• 多版本共存与切换（不使用 NVM 时可选）：
  sudo update-alternatives --install /usr/bin/node node /usr/bin/nodejs 100
  sudo update-alternatives --install /usr/bin/npm npm /usr/bin/npm 100
  sudo update-alternatives --config node
  sudo update-alternatives --config npm

五 部署与运行最佳实践

• 使用 PM2 守护进程：
  sudo npm install -g pm2
  pm2 start app.js --name my-app
  pm2 startup # 按提示生成 systemd 服务，随系统自启
  pm2 save
• 使用 Nginx 反向代理（示例将 80 端口转发到 3000）：
  sudo apt install -y nginx
  sudo tee /etc/nginx/sites-available/node <<‘EOF’
  server {
  listen 80;
  server_name your_domain_or_ip;
  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;
  }
  }
  EOF
  sudo ln -s /etc/nginx/sites-available/node /etc/nginx/sites-enabled/
  sudo nginx -t && sudo systemctl reload nginx
• 防火墙放行（如使用 UFW）：
  sudo ufw allow ‘Nginx Full’
  sudo ufw enable