Debian Jenkins如何配 node

在 Debian 上让 Jenkins 使用 Node.js，常见有 3 种方式。下面从「最推荐」到「进阶」依次说明。

一、推荐方式：Jenkins 插件管理 Node（最简单）

1. 安装 NodeJS 插件

1. 打开 Jenkins
2. Manage Jenkins → Manage Plugins
3. 搜索 NodeJS
4. 安装并重启 Jenkins

2. 配置 Node 版本

1. Manage Jenkins → Global Tool Configuration
2. 找到 NodeJS
3. 点击 Add NodeJS
   • Name: node18
   • 勾选 Install automatically
   • 选择版本（如 18.x / 20.x）
4. Save

3. 在 Pipeline 中使用

pipeline {
    agent any
    tools {
        nodejs 'node18'
    }
    stages {
        stage('Build') {
            steps {
                sh 'node -v'
                sh 'npm -v'
            }
        }
    }
}

✅ 优点：干净、可切换版本、适合 CI

二、Debian 系统直接安装 Node（全局可用）

1. 安装 Node（官方源）

curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt-get install -y nodejs

验证：

node -v
npm -v

2. Jenkins 直接使用系统 Node

• 不需要 NodeJS 插件
• Pipeline 中直接用：

sh 'node app.js'

⚠️ 注意：

• Jenkins 用户（jenkins）要有执行权限
• 不适合多版本切换

三、使用 nvm（多版本 Node，灵活）

1. 安装 nvm

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

2. 使用

source ~/.nvm/nvm.sh
nvm install 18
nvm use 18

3. Jenkins 中调用

sh '''
source ~/.nvm/nvm.sh
nvm use 18
npm install
npm run build
'''

四、常见问题

Jenkins 找不到 node

• 检查 PATH
• 或在 Jenkins 中指定绝对路径：

sh '/usr/bin/node -v'

权限问题

chown -R jenkins:jenkins /var/lib/jenkins

npm install 慢

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

五、推荐方案总结

如果你是 Freestyle / Pipeline / Docker Jenkins，可以告诉我，我可以给你更精确的配置示例。