如何通过命令行设置Nexus私有仓库的npm认证令牌？

核心问题分析 #

你遇到的401/404错误，本质是npm的认证配置需要与完整的私有仓库路径精准绑定，而非仅绑定根域名。直接设置全局_authToken无法关联到具体仓库路径，导致认证失效；仅绑定根域名则会让npm在错误的路径下查找依赖，触发404。

正确的命令行配置方式 #

针对你的私有仓库http://nexus.global.dns/repository/npm-all/，需要为该具体路径单独配置认证项，而非全局配置。

1. 用户名密码认证（最常用场景）

先将你的Nexus用户名和密码拼接为username:password，用Base64编码（注意去掉换行符）：

echo -n "your-nexus-username:your-nexus-password" | base64 | tr -d '\n'

然后通过命令行设置registry和对应路径的认证：

# 设置默认registry为私有仓库
npm config set registry http://nexus.global.dns/repository/npm-all/
# 为该仓库路径配置Base64编码的认证信息
npm config set //nexus.global.dns/repository/npm-all/:_auth "YOUR_BASE64_ENCODED_CREDENTIALS"
# 强制npm对该仓库的所有请求都使用认证（可选，避免部分依赖拉取时跳过认证）
npm config set //nexus.global.dns/repository/npm-all/:always-auth true

2. Bearer令牌认证（若Nexus使用令牌机制）

如果你的Nexus是通过Bearer令牌认证，替换为以下配置：

npm config set registry http://nexus.global.dns/repository/npm-all/
npm config set //nexus.global.dns/repository/npm-all/:_authToken "YOUR_NEXUS_BEARER_TOKEN"
# 部分npm版本要求配置邮箱（可填任意有效邮箱）
npm config set //nexus.global.dns/repository/npm-all/:email "your-email@example.com"

结合frontend-maven-plugin的Jenkins流水线配置 #

由于frontend-maven-plugin每次会安装独立的npm，需要在插件执行npm install前完成配置。推荐两种方式：

方式一：在pom.xml中嵌入npm config命令

直接在插件的执行步骤中添加配置命令，通过Jenkins环境变量注入认证信息：

<plugin>
    <groupId>com.github.eirslett</groupId>
    <artifactId>frontend-maven-plugin</artifactId>
    <version>1.15.0</version>
    <executions>
        <!-- 第一步：设置npm registry -->
        <execution>
            <id>configure-npm-registry</id>
            <goals>
                <goal>npm</goal>
            </goals>
            <configuration>
                <arguments>config set registry http://nexus.global.dns/repository/npm-all/</arguments>
            </configuration>
        </execution>
        <!-- 第二步：配置仓库认证 -->
        <execution>
            <id>configure-npm-auth</id>
            <goals>
                <goal>npm</goal>
            </goals>
            <configuration>
                <arguments>config set //nexus.global.dns/repository/npm-all/:_auth ${NEXUS_AUTH_TOKEN}</arguments>
            </configuration>
        </execution>
        <!-- 第三步：执行依赖安装 -->
        <execution>
            <id>npm-install</id>
            <goals>
                <goal>npm</goal>
            </goals>
            <configuration>
                <arguments>install</arguments>
            </configuration>
        </execution>
    </executions>
    <configuration>
        <nodeVersion>v20.9.0</nodeVersion>
        <npmVersion>10.1.0</npmVersion>
        <!-- 根据你的项目需求调整Node/NPM版本 -->
    </configuration>
</plugin>

方式二：Jenkins流水线中临时生成.npmrc文件

在Jenkins脚本中临时创建.npmrc，避免修改pom.xml，执行完后可删除：

pipeline {
    agent any
    environment {
        // 从Jenkins凭据管理中读取认证信息
        NEXUS_AUTH_TOKEN = credentials('nexus-npm-auth-token')
    }
    stages {
        stage('Install Frontend Dependencies') {
            steps {
                // 临时生成.npmrc文件
                sh '''
                cat > .npmrc << EOF
registry=http://nexus.global.dns/repository/npm-all/
//nexus.global.dns/repository/npm-all/:_auth=${NEXUS_AUTH_TOKEN}
//nexus.global.dns/repository/npm-all/:always-auth=true
EOF
                '''
                // 执行Maven构建（包含frontend-maven-plugin的npm install）
                sh 'mvn clean install'
                // 删除临时.npmrc，避免提交到Git
                sh 'rm .npmrc'
            }
        }
    }
}

关键验证步骤 #

1. 执行npm config list，检查输出中是否包含//nexus.global.dns/repository/npm-all/:_auth或_authToken配置项，确保路径和值正确。
2. 测试单个npm包拉取：npm install lodash --registry=http://nexus.global.dns/repository/npm-all/，验证是否能成功拉取且无认证错误。
3. 确保Jenkins凭据中的认证信息有Nexus私有仓库的拉取权限。

内容的提问来源于stack exchange，提问作者Babyburger