ubuntu nodejs环境如何配置

Ubuntu Node.js 环境配置指南

一安装方式选择

二安装步骤

方式一（推荐）NodeSource APT 安装指定或 LTS 版本
1. 更新索引并添加仓库（以 LTS 为例）：
  sudo apt update
  curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
  如需 18.x/20.x，将 setup_lts.x 替换为 setup_18.x/setup_20.x。
2. 安装：sudo apt install -y nodejs（包含 node 与 npm）
3. 验证：node -v；npm -v
方式二 NVM 安装与多版本管理
1. 安装 NVM：
  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
  source ~/.bashrc（如使用 zsh 则 source ~/.zshrc）
2. 安装与切换：
  nvm install --lts（或 nvm install 18.16.1）
  nvm use --lts（或 nvm use 18.16.1）
  nvm alias default 18.16.1（设置默认版本）
3. 验证：node -v；npm -v
方式三 Ubuntu 官方仓库（仅建议快速试用）
sudo apt update && sudo apt install -y nodejs npm
注意：官方仓库版本可能较旧，生产环境不推荐。

三配置 npm 与全局包路径

避免每次使用 sudo 安装全局包，建议配置用户级全局目录：
1. 创建目录：mkdir -p ~/.npm-global
2. 配置前缀：npm config set prefix ‘~/.npm-global’
3. 写入 PATH（针对 bash）：echo ‘export PATH=~/.npm-global/bin:$PATH’ >> ~/.bashrc && source ~/.bashrc
  如使用 zsh：echo ‘export PATH=~/.npm-global/bin:$PATH’ >> ~/.zshrc && source ~/.zshrc
4. 验证：npm config get prefix；which npm
国内网络可换源加速：
npm config set registry https://registry.npmmirror.com
npm config get registry

四快速验证与第一个应用

创建项目并启动服务：
mkdir myapp && cd myapp
npm init -y
npm install express
cat > app.js <<‘EOF’
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 http://localhost:3000’));
EOF
node app.js
使用 PM2 守护进程：
npm install -g pm2
pm2 start app.js --name “myapp”
pm2 list
pm2 startup（按提示完成开机自启）
pm2 save
服务器外部访问（云服务器示例）：
在云厂商控制台安全组放行 TCP 3000；本机防火墙（如 ufw/firewalld）同样需放行。
验证：curl http://<公网IP>:3000 或浏览器访问。

五常见问题与最佳实践

命令未找到（command not found）：安装后执行 source ~/.bashrc 或重新登录；如使用 zsh 则 source ~/.zshrc。
多版本并存与切换：优先使用 NVM；必要时用 nvm alias default 设置默认版本。
避免使用 root 运行应用：以普通用户运行，配合 PM2 或 systemd 管理进程。
端口与防火墙：确保云安全组与系统防火墙均放行应用端口（如 3000）。
版本选择：生产环境建议使用 LTS（如 18.x、20.x），兼顾稳定性与安全性。

最新问答