debian装nodejs要注意啥

在 Debian 上装 Node.js，有几个常见坑和推荐做法，下面按“注意事项 + 推荐方式”说明。

一、不建议直接用 apt 默认源（重要）

Debian 自带源里的 Node.js 版本通常很旧（比如 Debian 11 还是 Node 12）。

✅ 适合：

• 只跑旧项目
• 不在意版本

❌ 不适合：

• 现代前端（Vite / Next / Nuxt）
• 新 API（fetch、ESM 等）

二、推荐安装方式（按场景）

✅ 方式 1：NodeSource（最常用，推荐）

适合大多数人。

# 以 Node 20 为例
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

检查：

node -v
npm -v

优点：

• 版本新
• 更新方便
• 社区主流

✅ 方式 2：nvm（开发机强烈推荐）

适合开发 / 多版本切换

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20

优点：

• 不影响系统
• 可多版本共存
• 不需要 sudo

⚠️ 注意：

• nvm 不适合生产服务
• CI / 服务器建议用 NodeSource

✅ 方式 3：官方二进制（不常用）

适合：

• 无网络源
• 特殊环境

直接下载 node-vXX-linux-x64.tar.xz 解压即可。

三、权限问题（非常常见）

❌ 不要这样：

sudo npm install -g xxx

✅ 推荐做法：

npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH

或干脆用 npx

四、systemd 跑 Node 服务注意

如果用 systemd：

• 用 非 root 用户
• 设置 Environment=NODE_ENV=production
• 用 npm ci 而不是 npm install

示例：

[Service]
User=node
WorkingDirectory=/var/www/app
ExecStart=/usr/bin/node server.js

五、架构 & 版本选择

• x86_64：随便选
• ARM（树莓派 / 云 ARM）：确认 Node 支持
• 老 Debian（9/10）：Node 18+ 可能不支持

六、常见坑总结

快速建议

• 服务器：NodeSource
• 本地开发：nvm
• 别用 apt 默认 Node

如果你愿意，可以告诉我：

• Debian 版本（cat /etc/os-release）
• 用途（开发 / 生产 / Docker）

我可以直接给你最合适的命令。