当前位置:首页 > 互联网 > 正文

服务器如何配置Node.js运行环境?超详细步骤教程分享

在服务器上配置 Node.js 运行环境,以下是详细步骤(以 Ubuntu 22.04 为例,其他 Linux 发行版类似):


通过 NodeSource 安装(推荐,获取最新版本)

  1. 更新系统包

    sudo apt update && sudo apt upgrade -y
  2. 安装依赖

    sudo apt install -y curl
  3. 添加 NodeSource 源

    访问 NodeSource 官方仓库 查看最新版本号(如 x):

    curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
  4. 安装 Node.js 和 npm

    服务器如何配置Node.js运行环境?超详细步骤教程分享 第1张

    sudo apt install -y nodejs


通过 NVM 安装(灵活管理多版本)

  1. 安装 NVM(Node Version Manager)

  2. 列出可用版本

    服务器如何配置Node.js运行环境?超详细步骤教程分享 第2张

    nvm list-remote
  3. 安装指定版本(如 20.13.1)

    nvm install 20.13.1
  4. 设为默认版本

    nvm alias default 20.13.1
  5. 验证安装

    node -v # 检查 Node.js 版本 npm -v # 检查 npm 版本


    配置优化

    1. 修复权限问题

      避免全局安装时使用 sudo:

      mkdir ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc
    2. 安装常用工具

      服务器如何配置Node.js运行环境?超详细步骤教程分享 第3张

      npm install -g pm2 yarn # PM2 用于进程管理,Yarn 替代 npm
    3. 防火墙开放端口(如需)

      sudo ufw allow 3000 # 允许 Node.js 应用端口 sudo ufw enable


    部署测试应用

    1. 创建示例文件 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'));

    2. 启动应用

      常见问题解决

      • EACCES 权限错误:按上文配置 npm 权限或使用 sudo chown -R $USER /usr/local。
      • 端口占用:用 lsof -i :3000 查找占用进程。
      • 版本切换:使用 nvm use <version> 或更新 PATH。

      提示:生产环境建议用 PM2 管理进程,确保崩溃后自动重启:

      pm2 startup # 设置开机自启 pm2 save # 保存当前进程列表

      按需选择安装方式,NVM 适合多项目环境,NodeSource 适合快速部署最新稳定版。

0