debian nodejs有哪些坑点

在 Debian 上跑 Node.js，常见的“坑点”主要集中在版本管理、权限、系统包冲突、服务部署等方面。下面按使用场景给你梳理一下：

一、系统自带 Node.js 版本太旧（最常见坑）

问题

Debian 官方源里的 nodejs 通常非常旧：

• Debian 10 (Buster): Node 10
• Debian 11 (Bullseye): Node 12
• Debian 12 (Bookworm): Node 18

很多现代项目（Next.js、Vite、NestJS）需要 Node 18 / 20+。

解决

✅ 不要用 apt 默认 nodejs 做开发 推荐方式：

• 使用 NodeSource：

curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt install -y nodejs

• 或用 nvm：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
nvm install 20

二、npm 全局安装需要 root 权限（权限坑）

问题

Debian 下直接用：

npm install -g xxx

可能报：

EACCES: permission denied

解决

✅ 不要 sudo npm

推荐方案：

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

或直接使用 nvm（天然隔离）

三、/usr/bin/node 和 /usr/local/bin/node 冲突

问题

• apt 安装：/usr/bin/node
• 手动/nvm：/usr/local/bin/node

导致：

which node
node -v

不一致，脚本调用错版本。

解决

which -a node

确保 PATH 顺序正确，或卸载系统 node：

apt remove nodejs

四、systemd 服务运行 Node（部署坑）

问题

• 用 root 跑 Node（不安全）
• 环境变量缺失（.env 不加载）
• cwd 不正确

正确示例

[Unit]
Description=Node App
After=network.target

[Service]
User=node
WorkingDirectory=/var/www/app
ExecStart=/usr/bin/node index.js
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target

五、glibc / OpenSSL 兼容问题（少见但致命）

问题

• Debian 旧版本编译的二进制（如 puppeteer、sharp）
• 在新 Node 上报：

node: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.28' not found

解决

• 升级 Debian
• 或在该系统重新编译原生模块

六、npm 在 Debian 上很慢（网络坑）

原因

• 默认 registry 在境外
• IPv6 问题

解决

npm config set registry https://registry.npmmirror.com

七、Debian + Docker 的坑

• node:xx 官方镜像基于 Debian
• 小镜像用 slim，但缺 build-essential
• 编译原生模块失败

解决：

apt update && apt install -y build-essential python3

八、总结一句话

Debian 跑 Node.js 最大的坑：别用系统 apt 的 Node

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

• Debian 版本
• Node 用途（开发 / 生产 / Docker）
• 具体报错

我可以给你更针对性的建议。