debian nodejs有哪些坑

在 Debian 上用 Node.js，常见“坑”主要集中在版本陈旧、权限、服务管理、架构差异几个方面。下面按实战经验总结：

1. 系统自带 Node 版本太旧（最大坑）

Debian 稳定版（如 Debian 11/12）仓库里的 nodejs 通常是 很老的 LTS：

Debian 11：node 12
Debian 12：node 18

问题

新项目（Vite / Next / Nest 等）直接报错
不支持新语法 / 新 API

解决 ✅ 不要用 apt install nodejs 当主力
✅ 用以下方式之一：

NodeSource：

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

或用 nvm（推荐开发环境）

2. 用 root 跑 npm 全局安装（权限坑）

Debian 默认禁止 npm -g 写到系统目录（尤其 NodeSource 安装后）

典型错误

EACCES: permission denied

解决

开发机：用 nvm

服务器：

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

或加 --unsafe-perm

3. systemd 服务不会自动重启（部署坑）

很多人写完 Node 服务：

node app.js

关掉 SSH 就挂了。

正确做法 写 systemd：

[Unit]
Description=Node App

[Service]
ExecStart=/usr/bin/node /opt/app/index.js
Restart=always
User=www-data

[Install]
WantedBy=multi-user.target

systemctl enable nodeapp
systemctl start nodeapp

4. 端口 < 1024 不能绑定（权限坑）

Node 监听 80 / 443 会失败（非 root）

解决

用 nginx 反代

或：

setcap cap_net_bind_service=+ep /usr/bin/node

5. Debian 架构问题（ARM / 32位）

树莓派 / 旧设备：
- 很多原生模块（bcrypt / sharp / sqlite）编译失败
32 位 Debian 已基本不支持现代 Node

建议

用 64 位 Debian
原生模块优先用预编译包

6. glibc 版本太低（老 Debian）

某些新版 Node（20+）需要较新 glibc
老 Debian（如 9）会直接无法运行

检查

ldd --version

7. npm 缓存撑爆磁盘

服务器长期运行 npm：

/root/.npm 或 /home/xxx/.npm 很大

清理

npm cache clean --force

8. 时间 / 时区问题（隐性坑）

日志时间不对，排查困难

timedatectl set-timezone Asia/Shanghai

9. 防火墙没开端口

Node 起来了，外部访问不了

ufw allow 3000

10. 用 apt 升级把 Node 搞崩

apt upgrade 可能覆盖 NodeSource

建议

锁定版本：
```
apt-mark hold nodejs
```

总结一句话

Debian 上 Node.js 的坑，90% 来自“用系统包管理器管 Node”

最佳实践

开发：nvm
生产：NodeSource + systemd + nginx

如果你愿意，我可以：

给你一套 Debian + Node + PM2/nginx 标准部署模板
或针对你具体 Debian 版本 & 使用场景（开发 / 服务器 / 树莓派）细讲