上一篇
服务器如何配置Node.js运行环境?超详细步骤教程分享
- 互联网
- 2026-02-11
- 2123
在服务器上配置 Node.js 运行环境,以下是详细步骤(以 Ubuntu 22.04 为例,其他 Linux 发行版类似):
通过 NodeSource 安装(推荐,获取最新版本)
-
更新系统包
sudo apt update && sudo apt upgrade -y -
安装依赖
sudo apt install -y curl -
添加 NodeSource 源
访问 NodeSource 官方仓库 查看最新版本号(如 x):
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - -
安装 Node.js 和 npm
sudo apt install -y nodejs
通过 NVM 安装(灵活管理多版本)
-
安装 NVM(Node Version Manager)
-
列出可用版本
nvm list-remote
-
安装指定版本(如 20.13.1)
nvm install 20.13.1 -
设为默认版本
nvm alias default 20.13.1 -
修复权限问题
避免全局安装时使用 sudo:
mkdir ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc -
安装常用工具
npm install -g pm2 yarn # PM2 用于进程管理,Yarn 替代 npm
-
防火墙开放端口(如需)
sudo ufw allow 3000 # 允许 Node.js 应用端口 sudo ufw enable -
创建示例文件 app.js:
const http = require('http'); const server = http.createServer((req, res) => { res.end('Hello Node.js!'); }); server.listen(3000, () => console.log('Running on http://localhost:3000'));
-
启动应用
常见问题解决
- EACCES 权限错误:按上文配置 npm 权限或使用 sudo chown -R $USER /usr/local。
- 端口占用:用 lsof -i :3000 查找占用进程。
- 版本切换:使用 nvm use <version> 或更新 PATH。
提示:生产环境建议用 PM2 管理进程,确保崩溃后自动重启:
pm2 startup # 设置开机自启 pm2 save # 保存当前进程列表按需选择安装方式,NVM 适合多项目环境,NodeSource 适合快速部署最新稳定版。
验证安装
node -v # 检查 Node.js 版本 npm -v # 检查 npm 版本
配置优化
部署测试应用