Ubuntu Nodejs怎样配置环境

Ubuntu 上配置 Node.js 环境的实用步骤

一 安装方式选择

• 使用 NodeSource APT 仓库：获取较新的 LTS 或指定版本，系统级安装，适合生产环境。
• 使用 NVM（Node Version Manager）：多版本并存与切换，适合开发与测试。
• 使用 Ubuntu 默认仓库：命令最简，但版本通常较旧，适合快速试用。上述三种方式均为常见且可靠的安装路径，可按场景选择。

二 方式一 NodeSource APT 仓库安装（推荐用于生产）

• 更新索引并添加仓库（以 LTS 为例，亦可选择 18.x/20.x 等具体版本）：
  • sudo apt update
  • curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
  • 如需指定版本：curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
• 安装 Node.js（同时包含 npm）：sudo apt install -y nodejs
• 验证：node -v 与 npm -v 显示版本号即成功。

三 方式二 使用 NVM 管理多版本（推荐用于开发）

• 安装 NVM（示例版本 v0.39.7，可按需调整）：
  • curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
  • 重新加载环境：source ~/.bashrc（如使用 zsh 则 source ~/.zshrc）
• 常用命令：
  • 查看远程版本：nvm ls-remote
  • 安装指定版本：nvm install 18.16.1（或 nvm install --lts 安装最新 LTS）
  • 设置默认版本：nvm alias default 18.16.1
  • 切换版本：nvm use 18.16.1
• 验证：node -v 与 npm -v。

四 配置 npm 与全局包路径

• 配置国内镜像加速（可选，提升下载速度）：
  • npm config set registry https://registry.npmmirror.com
  • 验证：npm config get registry
• 避免 sudo 安装全局包（推荐）：
  • 创建目录：mkdir ~/.npm-global
  • 设置全局安装前缀：npm config set prefix ‘~/.npm-global’
  • 将全局 bin 加入 PATH：echo ‘export PATH=~/.npm-global/bin:$PATH’ > > ~/.bashrc & & source ~/.bashrc
• 常用全局工具示例：npm install -g yarn pm2 nodemon typescript。

五 快速验证与常见问题

• 快速验证示例（创建最小 Express 服务）：
  • mkdir myapp & & cd myapp
  • npm init -y
  • npm install express
  • 新建 app.js：
    • const express = require(‘express’);
    • const app = express();
    • app.get(‘/’, (req, res) => res.send(‘Hello from Ubuntu Node.js’));
    • app.listen(3000, () => console.log(‘Server running on 3000’));
  • 启动：node app.js；浏览器访问 http://服务器IP:3000
• 进程守护（生产推荐）：使用 PM2 启动与守护
  • 全局安装：npm install -g pm2
  • 启动应用：pm2 start app.js --name “myapp”
  • 设置开机自启：pm2 startup 并按提示执行命令
  • 常用：pm2 list、pm2 logs、pm2 restart myapp
• 常见问题处理：
  • 命令未找到：确认 PATH 包含 ~/.nvm/versions/node/*/bin（NVM）或 ~/.npm-global/bin（自定义全局路径），并执行 source 相应配置文件。
  • 端口无法访问（云服务器）：在 安全组/防火墙 放行对应端口（如 3000），或临时关闭防火墙测试。
  • 多版本并存冲突：优先使用 NVM 隔离版本，避免系统级多版本互相干扰。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！