在 Debian 上搭建 Node.js 运行环境
一 安装方式与版本选择
- 使用 NodeSource 仓库：适合需要特定主版本（如 14.x、16.x）且希望用 apt 统一管理的场景。通过官方脚本添加仓库后安装，命令简洁、可自动配置仓库与 GPG。
- 使用 NVM（Node Version Manager）：适合在同一台机器上管理多个 Node.js 版本（如 LTS 与最新版切换），对开发与测试更灵活。
- 使用 Debian 官方仓库：命令最简，但版本通常较旧，适合对版本不敏感的环境。
以上三种方式均为常见且可靠的安装路径，可按你的版本需求与运维策略选择其一。
二 方法一 NodeSource 仓库安装（推荐）
- 更新系统并安装必要工具：
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl ca-certificates gnupg
- 添加 NodeSource 仓库（以 16.x 为例，可按需替换为 18.x/20.x 等）：
curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
- 安装 Node.js 与 npm：
sudo apt install -y nodejs
- 验证安装：
node -v
npm -v
该方式来自 NodeSource 官方脚本，适合需要较新或指定主版本的场景。
三 方法二 NVM 安装与多版本管理
- 安装 NVM（示例版本号可按需调整）：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
安装脚本会将 NVM 写入 ~/.bashrc / ~/.zshrc / ~/.profile 等，执行以下命令使配置生效：
source ~/.bashrc
- 查看可安装版本并安装 LTS：
nvm ls-remote
nvm install --lts
- 使用指定版本：
nvm use <版本号>
- 验证：
node -v
npm -v
NVM 可在用户态管理多个 Node.js 版本，便于开发与生产环境切换。
四 快速验证与第一个应用
- 初始化项目并安装依赖：
mkdir my-node-app && cd my-node-app
npm init -y
npm install express --save
- 创建入口文件 app.js：
const express = require(‘express’);
const app = express();
const port = 3000;
app.get(‘/’, (req, res) => {
res.send(‘Hello World!’);
});
app.listen(port, () => {
console.log(Example app listening at http://localhost:${port});
});
- 启动服务：
node app.js
- 浏览器访问 http://localhost:3000，看到 “Hello World!” 即表示环境可用。
五 进程守护与反向代理（生产建议）
- 使用 PM2 守护进程：
sudo npm install -g pm2
pm2 start app.js --name “my-app”
pm2 status
pm2 startup # 按提示生成开机自启服务（需 sudo）
- 使用 Nginx 反向代理（将 3000 端口转发到 80/443）：
sudo apt install -y nginx
编辑站点配置（如 /etc/nginx/sites-available/default）：
server {
listen 80;
server_name your_domain_or_ip;
location / {
proxy_pass http://localhost: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;
}
}
校验并重载 Nginx：
sudo nginx -t && sudo systemctl reload nginx
PM2 提供进程守护、日志与集群等能力；Nginx 负责静态资源、压缩、缓存与 HTTPS 终止，适合对外服务。