在腾讯云的 Debian 云服务器上安装 Node.js,推荐通过 NodeSource 官方源或 nvm(Node Version Manager) 进行安装。以下是两种最常用、最稳定的方法:
✅ 方法一:使用 NodeSource 安装指定版本(推荐生产环境)
1. 更新系统包索引
sudo apt update
sudo apt upgrade -y
2. 安装依赖工具
sudo apt install -y curl gnupg ca-certificates
3. 添加 NodeSource 仓库并安装 Node.js
安装 Node.js 18.x(LTS,推荐)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs
或安装 Node.js 20.x(最新 LTS)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
⚠️ 注意:
setup_XX.x脚本会自动配置 APT 源并导入 GPG 密钥。
4. 验证安装
node -v
npm -v
输出示例:
v18.19.0
10.2.3
✅ 方法二:使用 nvm 安装多个 Node.js 版本(推荐开发/测试环境)
1. 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
2. 使 nvm 立即生效
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion"
💡 建议将上述两行
export和source命令添加到~/.bashrc或~/.zshrc中,以便每次登录自动加载。
3. 安装指定版本的 Node.js
nvm install 18
# 或
nvm install 20
4. 设置默认版本
nvm use 18
nvm alias default 18
5. 验证
node -v
npm -v
📌 补充说明
| 项目 | 说明 |
|---|---|
| Debian 版本 | 腾讯云默认镜像多为 Debian 11 (Bullseye) 或 Debian 12 (Bookworm),上述命令均兼容 |
| 权限问题 | 所有命令前加 sudo 确保有足够权限 |
| 防火墙 | 如果部署 Web 应用,记得在腾讯云控制台安全组中开放对应端口(如 3000、80、443) |
| PM2 管理进程 | 安装后可用 npm install -g pm2 安装 PM2 来持久化运行 Node.js 服务 |
🔍 常见问题排查
-
command not found: node
检查是否成功安装,或尝试重启终端 / 重新 source 配置文件。 -
GPG 密钥错误
确保已正确执行 NodeSource 的 setup 脚本,它会自动导入密钥。 -
权限拒绝
不要使用sudo npm install -g <package>,而是配置 nvm 或使用sudo chown -R $USER:$USER ~/.npm避免权限问题。
如需进一步帮助(如配置 Nginx 反向X_X、设置 systemd 服务守护进程等),欢迎继续提问!
云知识CLOUD