温馨提示×

debian装nodejs要注意什么

小樊
35
2026-09-29 11:27:42
栏目: 编程语言

在 Debian 上安装 Node.js,有几个常见坑和推荐做法需要注意,下面按「重要性 + 场景」给你总结。


一、不要直接用 apt 默认源(很重要)

Debian 官方仓库里的 Node.js 版本通常很旧(比如 Debian 11 还是 Node 12)。

✅ 推荐方式:

  • 用 NodeSource 官方源
  • 或用 nvm(Node Version Manager)

二、推荐安装方式对比

✅ 方式 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

⚠️ 注意:

  • 会替换系统 node
  • 不适合“多版本切换”

✅ 方式 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 npm -g

❌ 错误:

sudo npm install -g xxx

✅ 正确做法:

npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

或直接使用 nvm


四、系统依赖(编译原生模块时)

有些 npm 包需要编译:

sudo apt install -y build-essential python3 make g++

否则可能报错:

  • node-gyp
  • bcrypt
  • sharp

五、架构 & 版本注意

  • 确认是 amd64 还是 arm64
  • 老机器别装太新 Node(如树莓派)

查看:

uname -m

六、防火墙 & 端口(部署时)

Node 默认端口如:

  • 3000
  • 8080

记得:

sudo ufw allow 3000

或用 nginx 反代


七、生产环境建议

  • 用 pm2 或 systemd 管理
  • 不要直接 node app.js 跑前台
  • 用 nginx 反向代理

快速总结

✅ 新手建议:

  • 开发 → nvm
  • 服务器 → NodeSource + pm2

❌ 避免:

  • apt 默认 node
  • sudo 全局 npm

如果你告诉我:

  • Debian 版本(如 11 / 12)
  • 用途(开发 / 服务器 / 宝塔 / Docker)

我可以给你精确命令。

0 踩