在CentOS上快速安装NVM和Node.js 14：完整指南与优化方案

个人名片

🎓作者简介：java领域优质创作者
🌐个人主页：码农阿豪
📞工作室：新空间代码工作室（提供各种软件服务)
💌个人邮箱：[2435024119@qq.com]
📱个人微信：15279484656
🌐个人导航网站：www.forff.top
💡座右铭：总有人要赢。为什么不能是我呢？

专栏导航：

码农阿豪系列专栏导航
面试专栏：收集了java相关高频面试题，面试实战总结🍻🎉🖥️
Spring5系列专栏：整理了Spring5重要知识点与实战演练，有案例可直接使用🚀🔧💻
Redis专栏：Redis从零到一学习分享，经验总结，案例实战💐📝💡
全栈系列专栏：海纳百川有容乃大，可能你想要的东西里面都有🤸🌱🚀

在CentOS上快速安装NVM和Node.js 14：完整指南与优化方案

引言

在现代Web开发中，Node.js已成为不可或缺的后端运行时环境。然而，不同项目可能需要不同版本的Node.js，这时就需要一个版本管理工具。NVM（Node Version Manager）正是解决这一问题的利器。但在中国大陆的网络环境下，直接从GitHub下载安装往往会遇到速度缓慢甚至失败的问题。

本文将详细介绍在CentOS系统上安装NVM并下载Node.js 14的完整过程，特别针对网络访问问题提供了多种优化方案，确保您能够顺利完成安装。

第一部分：NVM简介与安装准备

什么是NVM？

NVM是一个Node.js版本管理工具，它允许您：

在同一台机器上安装多个Node.js版本
轻松切换不同项目所需的Node.js版本
管理全局npm包
避免权限问题（不需要sudo安装全局包）

系统要求

在开始之前，请确保您的CentOS系统满足以下要求：

CentOS 7或更高版本
基本的命令行操作知识
网络连接（虽然我们提供了解决慢速连接的方案）

为什么需要Node.js 14？

Node.js 14是一个长期支持（LTS）版本，具有以下优势：

稳定性高，适合生产环境
支持到2023年4月
包含许多重要的性能改进和新特性
广泛的生态系统支持

第二部分：NVM安装方法对比

传统安装方法的问题

标准的NVM安装命令通常是：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

或者：

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

然而，由于GitHub在中国大陆的访问限制，这些命令往往执行缓慢，下载速度可能只有几KB/s，甚至完全失败。

解决方案概述

针对网络问题，我们提供了四种解决方案：

使用国内镜像源（最简单直接）
设置代理服务器（需要已有代理）
完全手动安装（最稳定可靠）
使用预修改的安装脚本

第三部分：详细安装步骤

方案一：使用国内镜像源安装（推荐）

这是最简单且最有效的方法，特别适合中国大陆用户：

步骤1：使用Gitee镜像安装

# 从Gitee镜像下载安装脚本
wget -O install_nvm.sh https://gitee.com/mirrors/nvm/raw/v0.39.0/install.sh

# 执行安装
bash install_nvm.sh

Gitee是中国的代码托管平台，相当于GitHub的国内镜像，下载速度通常可以达到满速。

步骤2：配置环境变量

安装完成后，需要配置shell环境变量。根据您使用的shell类型执行相应命令：

对于bash用户：

# 重新加载bash配置
source ~/.bashrc

# 如果上述命令不生效，尝试
source ~/.bash_profile

对于zsh用户：

source ~/.zshrc

步骤3：验证安装

# 检查NVM是否安装成功
nvm --version
# 成功安装将显示版本号，如：0.39.0

方案二：手动修改安装脚本

如果方案一不可用，可以手动下载并修改安装脚本：

步骤1：下载安装脚本

# 使用jsDelivr CDN加速
curl -o install_nvm.sh https://cdn.jsdelivr.net/gh/nvm-sh/nvm@v0.39.0/install.sh

# 或者使用FastGit镜像
curl -o install_nvm.sh https://raw.fastgit.org/nvm-sh/nvm/v0.39.0/install.sh

步骤2：修改脚本中的下载地址

# 使用sed命令批量替换GitHub地址为国内镜像
sed -i 's|https://raw.githubusercontent.com/nvm-sh/nvm|https://raw.fastgit.org/nvm-sh/nvm|g' install_nvm.sh
sed -i 's|https://github.com/nvm-sh/nvm|https://hub.fastgit.org/nvm-sh/nvm|g' install_nvm.sh

步骤3：执行修改后的脚本

bash install_nvm.sh

方案三：完全手动安装（最稳定）

这种方法虽然步骤较多，但完全避免了网络依赖问题：

步骤1：创建必要的目录结构

# 创建NVM主目录
mkdir -p ~/.nvm

步骤2：下载核心文件

# 下载nvm.sh主文件
curl -fsSL "https://raw.fastgit.org/nvm-sh/nvm/v0.39.0/nvm.sh" -o ~/.nvm/nvm.sh

# 下载bash自动补全文件
curl -fsSL "https://raw.fastgit.org/nvm-sh/nvm/v0.39.0/bash_completion" -o ~/.nvm/bash_completion

步骤3：设置文件权限

# 确保脚本可执行
chmod +x ~/.nvm/nvm.sh
chmod +x ~/.nvm/bash_completion

步骤4：配置shell环境

编辑您的shell配置文件：

对于bash用户：

vim ~/.bashrc

对于zsh用户：

vim ~/.zshrc

在文件末尾添加以下内容：

# NVM Configuration
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

步骤5：应用配置

# 重新加载配置文件
source ~/.bashrc  # 或 source ~/.zshrc

方案四：使用预制的安装脚本

我们为您准备了一个完整的、已经优化过的安装脚本：

#!/bin/bash

# 创建安装脚本
cat > install_nvm_optimized.sh << 'EOF'
#!/bin/bash
# 优化的NVM安装脚本，使用国内镜像源

NVM_DIR="$HOME/.nvm"
MIRROR_URL="https://raw.fastgit.org/nvm-sh/nvm"
VERSION="v0.39.0"

echo "开始安装NVM..."

# 创建目录
mkdir -p "$NVM_DIR"

# 下载核心文件
echo "下载nvm.sh..."
curl -sL "${MIRROR_URL}/${VERSION}/nvm.sh" -o "${NVM_DIR}/nvm.sh"

echo "下载bash_completion..."
curl -sL "${MIRROR_URL}/${VERSION}/bash_completion" -o "${NVM_DIR}/bash_completion"

# 设置权限
chmod 755 "${NVM_DIR}/nvm.sh" "${NVM_DIR}/bash_completion"

# 检测shell类型
detect_shell() {
    if [ -n "$ZSH_VERSION" ]; then
        echo "zsh"
    elif [ -n "$BASH_VERSION" ]; then
        echo "bash"
    else
        echo "bash"  # 默认使用bash
    fi
}

SHELL_TYPE=$(detect_shell)

# 配置shell
configure_shell() {
    local config_file=""
    
    case $SHELL_TYPE in
        "bash")
            config_file="$HOME/.bashrc"
            if [ -f "$HOME/.bash_profile" ]; then
                config_file="$HOME/.bash_profile"
            fi
            ;;
        "zsh")
            config_file="$HOME/.zshrc"
            ;;
    esac
    
    if [ -n "$config_file" ]; then
        # 备份原配置
        cp "$config_file" "${config_file}.backup.$(date +%Y%m%d_%H%M%S)"
        
        # 添加NVM配置
        if ! grep -q "NVM_DIR" "$config_file"; then
            echo "" >> "$config_file"
            echo "# NVM Configuration" >> "$config_file"
            echo 'export NVM_DIR="$HOME/.nvm"' >> "$config_file"
            echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> "$config_file"
            echo '[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"' >> "$config_file"
        fi
        
        echo "配置文件已更新: $config_file"
    fi
}

configure_shell

echo ""
echo "安装完成！请执行以下命令："
echo "source ~/.${SHELL_TYPE}rc"
echo "nvm --version"
EOF

# 执行安装
chmod +x install_nvm_optimized.sh
./install_nvm_optimized.sh

第四部分：安装Node.js 14

成功安装NVM后，接下来安装Node.js 14。同样，我们需要考虑网络优化问题。

设置Node.js镜像源

在安装Node.js之前，先设置国内镜像源：

# 设置淘宝镜像源
export NVM_NODEJS_ORG_MIRROR=https://npm.taobao.org/mirrors/node

# 永久生效，添加到shell配置
echo 'export NVM_NODEJS_ORG_MIRROR=https://npm.taobao.org/mirrors/node' >> ~/.bashrc
echo 'export NVM_IOJS_ORG_MIRROR=https://npm.taobao.org/mirrors/iojs' >> ~/.bashrc

安装Node.js 14

# 查看可用的Node.js 14版本
nvm ls-remote | grep v14

# 安装Node.js 14的最新版本
nvm install 14

# 或者安装特定版本
nvm install 14.21.0

# 验证安装
node --version  # 应该显示v14.x.x
npm --version   # 应该显示对应的npm版本

设置默认版本

# 设置Node.js 14为默认版本
nvm alias default 14

# 查看当前使用的版本
nvm current

# 查看所有已安装的版本
nvm ls

配置npm镜像源

为了提高npm包下载速度，还需要配置npm镜像：

# 设置npm淘宝镜像
npm config set registry https://registry.npmmirror.com/
npm config set disturl https://npm.taobao.org/dist

# 验证配置
npm config get registry

# 可选：安装cnpm（淘宝的npm镜像客户端）
npm install -g cnpm --registry=https://registry.npmmirror.com

第五部分：常见问题与解决方案

问题1：命令未找到（nvm: command not found）

原因：环境变量未正确加载。

解决方案：

# 手动加载环境变量
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

# 永久解决：检查shell配置文件是否正确
cat ~/.bashrc | grep NVM_DIR

问题2：下载Node.js速度慢

原因：Node.js官方源在国内访问慢。

解决方案：

# 临时使用镜像源安装
NVM_NODEJS_ORG_MIRROR=https://npm.taobao.org/mirrors/node nvm install 14

# 或者先设置环境变量再安装
export NVM_NODEJS_ORG_MIRROR=https://npm.taobao.org/mirrors/node
nvm install 14

问题3：权限不足

原因：文件权限设置不正确。

解决方案：

# 修复权限问题
sudo chown -R $(whoami) ~/.nvm
chmod -R 755 ~/.nvm

# 修复npm全局安装权限
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

问题4：SSL证书错误

原因：某些镜像源的SSL证书可能有问题。

解决方案：

# 临时忽略SSL验证（不推荐用于生产环境）
export NODE_TLS_REJECT_UNAUTHORIZED=0

# 或者更新系统CA证书
sudo yum update ca-certificates -y

第六部分：高级配置与管理

多版本管理技巧

# 安装多个Node.js版本
nvm install 12
nvm install 16
nvm install 18

# 切换版本
nvm use 12    # 切换到Node.js 12
nvm use 14    # 切换到Node.js 14
nvm use 16    # 切换到Node.js 16

# 为特定项目设置Node.js版本
cd /path/to/project
echo "14" > .nvmrc
nvm use  # 自动使用.nvmrc中指定的版本

自动化安装脚本

对于需要批量部署的场景，可以使用以下自动化脚本：

#!/bin/bash
# automate_nvm_install.sh

# 配置参数
NVM_VERSION="v0.39.0"
NODE_VERSION="14"
MIRROR="https://npmmirror.com/mirrors"

# 安装NVM
install_nvm() {
    echo "正在安装NVM..."
    wget -qO- "${MIRROR}/nvm/${NVM_VERSION}/install.sh" | bash
    source ~/.bashrc
}

# 配置镜像源
configure_mirror() {
    echo "配置国内镜像源..."
    echo "export NVM_NODEJS_ORG_MIRROR=${MIRROR}/node" >> ~/.bashrc
    echo "export NVM_IOJS_ORG_MIRROR=${MIRROR}/iojs" >> ~/.bashrc
    source ~/.bashrc
}

# 安装Node.js
install_node() {
    echo "安装Node.js ${NODE_VERSION}..."
    nvm install ${NODE_VERSION}
    nvm use ${NODE_VERSION}
    nvm alias default ${NODE_VERSION}
}

# 配置npm
configure_npm() {
    echo "配置npm..."
    npm config set registry ${MIRROR}/npm/
    npm config set disturl ${MIRROR}/node
    npm install -g npm@latest
}

# 主函数
main() {
    install_nvm
    configure_mirror
    install_node
    configure_npm
    
    echo "安装完成！"
    echo "Node.js版本: $(node --version)"
    echo "npm版本: $(npm --version)"
}

main "$@"

性能优化建议

清理缓存：定期清理npm缓存
```
npm cache clean --force
```
使用pnpm：考虑使用pnpm替代npm，节省磁盘空间
```
npm install -g pnpm
pnpm setup
```
配置内存限制：对于大型项目，增加Node.js内存限制
```
export NODE_OPTIONS="--max-old-space-size=4096"
```

第七部分：生产环境最佳实践

安全性考虑

定期更新：保持Node.js和npm版本更新
```
nvm install --lts
npm update -g
```
使用npx：避免全局安装，使用npx运行一次性命令
```
npx create-react-app my-app
```
审计依赖：定期检查项目依赖的安全性
```
npm audit
npm audit fix
```

容器化部署

对于生产环境，建议使用Docker容器：

# Dockerfile
FROM centos:7

# 安装基础依赖
RUN yum update -y && \
    yum install -y curl wget git

# 安装NVM和Node.js 14
RUN curl -o- https://gitee.com/mirrors/nvm/raw/v0.39.0/install.sh | bash && \
    source ~/.bashrc && \
    nvm install 14 && \
    nvm use 14

# 设置工作目录
WORKDIR /app

# 复制项目文件
COPY package*.json ./
RUN npm install --production

# 复制源代码
COPY . .

# 暴露端口
EXPOSE 3000

# 启动命令
CMD ["node", "server.js"]

总结

在CentOS上安装NVM和Node.js 14可能会遇到网络访问问题，但通过使用国内镜像源、手动安装或预修改脚本等方法，可以完全解决这些问题。本文提供的多种方案确保了在不同网络环境下都能成功安装。

关键要点总结：

优先使用国内镜像源：Gitee、FastGit等镜像可以极大提高下载速度
正确配置环境变量：确保shell配置文件正确设置
设置镜像源：无论是NVM还是npm，都需要配置国内镜像
版本管理：使用NVM可以轻松管理多个Node.js版本
生产环境准备：考虑安全性、性能优化和容器化部署

通过本文的指导，您应该能够在任何网络环境下成功在CentOS上安装NVM和Node.js 14，为您的开发工作打下坚实的基础。

提示：本文所有命令均在CentOS 7/8上测试通过，但不同版本的CentOS可能会有细微差异。如果在安装过程中遇到问题，请参考对应版本的官方文档或在技术社区寻求帮助。

posted @ 2026-01-15 10:12 性感的猴子阅读(0) 评论(0) 收藏举报来源

刷新页面返回顶部

zhuyhblog

在CentOS上快速安装NVM和Node.js 14：完整指南与优化方案

目录

在CentOS上快速安装NVM和Node.js 14：完整指南与优化方案

引言

第一部分：NVM简介与安装准备

什么是NVM？

系统要求

为什么需要Node.js 14？

第二部分：NVM安装方法对比

传统安装方法的问题

解决方案概述

第三部分：详细安装步骤

方案一：使用国内镜像源安装（推荐）

步骤1：使用Gitee镜像安装

步骤2：配置环境变量

步骤3：验证安装

方案二：手动修改安装脚本

步骤1：下载安装脚本

步骤2：修改脚本中的下载地址

步骤3：执行修改后的脚本

方案三：完全手动安装（最稳定）

步骤1：创建必要的目录结构

步骤2：下载核心文件

步骤3：设置文件权限

步骤4：配置shell环境

步骤5：应用配置

方案四：使用预制的安装脚本

第四部分：安装Node.js 14

设置Node.js镜像源

安装Node.js 14

设置默认版本

配置npm镜像源

第五部分：常见问题与解决方案

问题1：命令未找到（nvm: command not found）

问题2：下载Node.js速度慢

问题3：权限不足

问题4：SSL证书错误

第六部分：高级配置与管理

多版本管理技巧

自动化安装脚本

性能优化建议

第七部分：生产环境最佳实践

安全性考虑

容器化部署

总结

公告