温馨提示×

linux系统nodejs如何配置

小樊
40
2026-10-24 21:25:19
栏目: 编程语言

在 Linux 系统上配置 Node.js,通常包括安装 Node.js、配置环境变量、管理版本、以及常见使用配置。下面按常见场景给你说明。


一、安装 Node.js(推荐方式)

方式 1:使用 NodeSource(官方推荐,版本新)

以 Node.js 20 为例(可换版本):

# 更新系统
sudo apt update

# 安装依赖
sudo apt install -y curl

# 添加 NodeSource 源
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

# 安装 Node.js
sudo apt install -y nodejs

验证:

node -v
npm -v

方式 2:使用 nvm(推荐开发环境)

适合多版本切换:

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 重新加载 shell
source ~/.bashrc

# 安装 Node
nvm install 20
nvm use 20

设置默认版本:

nvm alias default 20

方式 3:包管理器直接安装(版本可能较旧)

sudo apt install nodejs npm

二、配置 npm(国内加速)

设置 npm 镜像(国内推荐)

npm config set registry https://registry.npmmirror.com

查看配置:

npm config get registry

三、配置全局目录(避免权限问题)

不推荐用 sudo npm -g

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'

添加到环境变量:

echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

四、防火墙 & 端口(运行服务时)

如运行 Web 服务:

sudo ufw allow 3000

五、后台运行 Node 服务

简单方式

node app.js &

推荐方式(pm2)

npm install -g pm2
pm2 start app.js
pm2 save
pm2 startup

六、常见环境变量配置

export NODE_ENV=production
export PORT=3000

可写入:

~/.bashrc 或 ~/.profile

七、常见问题

1. node: command not found

  • 检查 PATH
  • 重开终端或 source ~/.bashrc

2. 权限错误

  • 不要用 sudo npm
  • 用 nvm 或自定义 prefix

3. 版本不对

nvm ls
nvm use 20

如果你能说明:

  • 使用的 Linux 发行版(Ubuntu / CentOS / Debian)
  • 用途(前端 / 后端 / 服务器部署)
  • 是否用 Docker

我可以给你更精确的一步步配置方案。

0 踩