在服务器上配置 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)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc # 重新加载配置
-
列出可用版本

nvm list-remote
-
安装指定版本(如 20.13.1)
nvm install 20.13.1
-
设为默认版本
nvm alias default 20.13.1
验证安装
node -v # 检查 Node.js 版本 npm -v # 检查 npm 版本
配置优化
-
修复权限问题
避免全局安装时使用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')); -
启动应用
node app.js # 直接运行 pm2 start app.js # 或用 PM2 守护进程
常见问题解决
EACCES权限错误:按上文配置npm权限或使用sudo chown -R $USER /usr/local。- 端口占用:用
lsof -i :3000查找占用进程。 - 版本切换:使用
nvm use <version>或更新PATH。
提示:生产环境建议用 PM2 管理进程,确保崩溃后自动重启:
pm2 startup # 设置开机自启 pm2 save # 保存当前进程列表
按需选择安装方式,NVM 适合多项目环境,NodeSource 适合快速部署最新稳定版。
图片来源于AI模型,如侵权请联系管理员。作者:酷小编,如若转载,请注明出处:https://www.kufanyun.com/ask/291462.html

