CentOS中Node.js依赖如何解决

在 CentOS 中解决 Node.js 依赖的实用指南

一安装 Node.js 与包管理器

使用 NodeSource 仓库（推荐，便于版本管理）
- 更新系统并安装基础工具：sudo yum update -y && sudo yum groupinstall -y "Development Tools"
- 添加仓库并安装（示例为 Node.js 16 LTS，对 glibc 要求更友好）：
```
curl -fsSL https://rpm.nodesource.com/setup_16.x | sudo bash -
sudo yum install -y nodejs
node -v && npm -v
```
- 如需其他版本，将 16.x 替换为目标版本号（如 18.x、20.x）。

使用 NVM（多版本并存、切换方便）

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm use --lts
node -v && npm -v

使用 Yarn（可选，更快更稳的依赖管理）
```
npm install -g yarn
yarn -v
```

以上步骤完成后，系统即具备运行与安装 Node.js 依赖的 node/npm/yarn 环境。

二安装与维护项目依赖

初始化与安装

npm init -y
npm install express           # 生产依赖
npm install webpack --save-dev # 开发依赖

使用 Yarn

yarn init -y
yarn add express
yarn add webpack --dev

常用维护

npm update              # 更新依赖
npm uninstall pkg       # 移除依赖
npm ci                  # 以 package-lock.json 为准的干净安装（CI/生产推荐）
npm audit fix           # 自动修复已知漏洞（必要时再执行）

锁文件与团队协作
- 提交 package.json 与 package-lock.json（或 yarn.lock），确保依赖版本一致与可复现构建。

三常见依赖问题与修复

原生模块编译失败（如 node-gyp、bcrypt、canvas 等）
- 安装编译工具与头文件：
```
sudo yum groupinstall -y "Development Tools"
sudo yum install -y gcc-c++ make openssl-devel
```
- 重新安装依赖（必要时清理缓存）：
```
npm cache clean --force
npm install
```

版本不兼容导致的 GLIBC/GLIBCXX 错误

典型现象：/lib64/libc.so.6: version 'GLIBC_2.28' not found（常见于 CentOS 7 上误装 Node.js 18+）

处理步骤：

# 1) 移除高版本 NodeSource 源
sudo rm -f /etc/yum.repos.d/nodesource*.repo
# 2) 清理缓存
sudo yum clean all && sudo rm -rf /var/cache/yum
# 3) 安装与系统兼容的版本（如 16.x）
curl -fsSL https://rpm.nodesource.com/setup_16.x | sudo bash -
sudo yum install -y nodejs
node -v

全局包权限问题

推荐创建本地目录并配置 npm 前缀，避免写入系统目录：

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

使用国内镜像加速（可选）

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

以上措施覆盖了 编译工具链、版本兼容 与 权限/镜像 等高频问题。

四生产环境运行与反向代理

进程守护与开机自启

sudo npm install -g pm2
pm2 start app.js --name myapp
pm2 startup systemd -u $USER --hp $HOME
pm2 save && pm2 status

Nginx 反向代理（将 3000 端口代理到域名）

sudo yum install -y nginx
sudo systemctl enable --now nginx

编辑 /etc/nginx/conf.d/default.conf：

server {
  listen 80;
  server_name your_domain.com;
  location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;
  }
}
sudo systemctl reload nginx

上述方案可提升 可用性 与 可维护性，适合长期运行的服务。

最新问答

相关标签