在 Linux 上配置 Node.js 时,有几个常见坑点和最佳实践需要注意,下面按「安装 → 权限 → 环境 → 运行 → 安全」几个维度总结:
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 20
nvm use 20
✅ 优点:可多版本切换、不影响系统
❌ 不推荐:sudo apt install nodejs(版本旧)
❌ 错误:
sudo npm install -g xxx
✅ 正确:
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH
或:
sudo chown -R $USER:$USER /usr/local/lib/node_modules
⚠️ 否则会出现:
确保:
which node
which npm
如果 nvm 不生效:
source ~/.bashrc
# 或
source ~/.zshrc
node app.js✅ 使用进程管理器:
npm i -g pm2
pm2 start app.js
pm2 save
pm2 startup
# 用 nginx 反向代理
node -> 3000
nginx -> 80
防火墙:
sudo ufw allow 3000
timedatectl
locale
Node 默认 UTF-8,但数据库/日志要注意
npm auditevalnode_modules.env + dotenv| 问题 | 原因 |
|---|---|
| command not found | PATH 没配 |
| EACCES | 用 root 装 npm |
| 端口占用 | 进程没关 |
| 生产崩 | 没 PM2/systemd |
| 版本不一致 | 多 node 混用 |
如果你愿意,可以告诉我:
我可以给你一份专属配置方案。