如何配置Debian服务器JS环境

在 Debian 服务器上配置 JavaScript 运行环境（Node.js + NPM）

一 安装 Node.js 与 NPM

• 更新索引并安装基础工具
  • sudo apt update && sudo apt install -y ca-certificates curl gnupg
• 方式 A 使用 NodeSource 官方仓库（推荐，版本可控）
  • 选择版本（示例为 20.x）：NODE_MAJOR=20
  • 导入 GPG 并添加源：
    • curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
    • echo “deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main” | sudo tee /etc/apt/sources.list.d/nodesource.list
  • 安装：sudo apt update && sudo apt install -y nodejs
• 方式 B 使用系统默认仓库（版本通常较旧）
  • sudo apt install -y nodejs npm
• 验证安装
  • node -v
  • npm -v 说明：NodeSource 方式可获取较新的 Node.js LTS 版本；默认仓库适合快速试用或兼容性要求不高的场景。

二 配置 NPM 与常用工具

• 设置国内镜像（可选，提升下载速度）
  • npm config set registry https://registry.npmmirror.com
• 全局与本地包管理
  • 全局安装：sudo npm install -g nodemon
  • 本地安装：npm install express
• 使用 NPM 脚本
  • package.json 示例：
    • { “scripts”: { “start”: “node app.js”, “test”: “mocha” } }
  • 运行：npm start / npm test
• 代理设置（如需要）
  • npm config set proxy http://127.0.0.1:10810
  • npm config set https-proxy http://127.0.0.1:10810
  • 取消：npm config delete proxy / delete https-proxy 以上命令覆盖镜像、全局/本地包、脚本与代理的常用配置。

三 运行与守护 Node.js 应用

• 运行脚本
  • node app.js
• 使用进程管理器 PM2（生产推荐）
  • 安装：sudo npm install -g pm2
  • 启动：pm2 start app.js --name “my-app”
  • 常用：pm2 list / logs / restart my-app / stop my-app
• 常用运维
  • 开机自启：pm2 startup（按提示执行）
  • 保存当前进程列表：pm2 save PM2 可守护进程、自动重启、日志聚合，适合生产环境长期运行。

四 对外发布与反向代理（Nginx）

• 安装 Nginx
  • sudo apt install -y nginx
• 站点配置示例（/etc/nginx/sites-available/default）
  • server { listen 80; server_name your_domain.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 nginx -t && sudo systemctl reload nginx
• 防火墙放行（如使用 UFW）
  • sudo ufw allow 80,443/tcp Nginx 作为反向代理可统一端口、支持 HTTP/HTTPS 与静态资源服务。

五 多版本管理与卸载清理

• 多版本管理 NVM（适合开发与测试）
  • 安装：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
  • 加载：source ~/.bashrc
  • 使用：nvm install 18 / nvm use 18 / nvm list-remote
• 卸载 NodeSource（如需回退）
  • sudo apt-get purge nodejs
  • rm -r /etc/apt/sources.list.d/nodesource.list
  • rm -r /etc/apt/keyrings/nodesource.gpg NVM 可在用户态管理多个 Node.js 版本，互不干扰；卸载时清理源与包即可。