嗨，这个问题我太熟了！在Jenkins构建Maven项目时，想要用自定义仓库替代默认的Maven Central，核心就是让构建过程加载你指定的settings.xml文件。下面分几种常见场景给你一步步说清楚：

首先你需要编写一个包含自定义仓库配置的settings.xml，核心是通过<mirrors>节点替换默认的Central仓库，要是私有仓库的话还得加认证信息。示例如下：

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <!-- 用自定义仓库镜像替换默认Central -->
  <mirrors>
    <mirror>
      <id>custom-repo-mirror</id>
      <!-- mirrorOf设为central表示替换所有对Central的请求 -->
      <mirrorOf>central</mirrorOf>
      <url>http://your-custom-repo-url/repository/maven-public/</url>
    </mirror>
  </mirrors>

  <!-- 私有仓库需要的认证信息 -->
  <servers>
    <server>
      <id>custom-repo-mirror</id> <!-- 要和上面mirror的id一致 -->
      <username>your-repo-username</username>
      <password>your-repo-password</password>
    </server>
  </servers>
</settings>

根据你的需求，可以选择全局配置（所有项目通用）、项目级配置（仅单个项目用）或者流水线配置。

2.1 全局配置（所有Maven项目默认使用） #

如果你希望Jenkins上所有Maven构建都用这个自定义仓库：

• 登录Jenkins，进入Manage Jenkins → Global Tool Configuration
• 找到Maven区域，要么点击Add Maven配置一个新的Maven实例，要么找到已有的Maven配置
• 在对应Maven实例的配置项里，找到Settings file：
  • 选Provide a settings file in the Jenkins master filesystem，然后输入settings.xml在Jenkins服务器上的绝对路径（比如/var/lib/jenkins/custom-settings.xml）
  • 或者选Upload settings file，直接上传你本地写好的settings.xml，Jenkins会自动存储到服务器
• 保存配置后，所有使用这个Maven实例的项目都会自动加载自定义仓库

2.2 项目级配置（仅当前项目生效） #

如果只想让某个特定项目用自定义仓库：

• 打开目标Jenkins项目，进入Configure页面
• 找到Build部分（自由风格项目），在Invoke top-level Maven targets这个构建步骤里：
  • 点击Advanced展开更多选项
  • 在Settings下拉框里，选择你之前全局配置好的自定义settings；或者选Settings file path输入路径，甚至直接在Settings file content里粘贴xml内容
• 保存后，这个项目构建时就会优先用你指定的settings

2.3 Jenkins Pipeline（流水线）项目配置 #

如果是用Jenkinsfile的流水线项目，有两种方式配置：

方式一：引用全局配置的settings文件 #

pipeline {
  agent any
  tools {
    maven 'Maven-3.8.6' // 这里填你在Global Tool Config里配置的Maven名称
  }
  stages {
    stage('Build') {
      steps {
        // 直接指定settings文件路径
        sh 'mvn clean install -s /var/lib/jenkins/custom-settings.xml'
      }
    }
  }
}

方式二：直接在Jenkinsfile中定义settings内容 #

适合临时测试或者不想在服务器上存文件的场景：

pipeline {
  agent any
  tools {
    maven 'Maven-3.8.6'
  }
  stages {
    stage('Build') {
      steps {
        // 先把settings内容写入临时文件
        writeFile file: 'settings.xml', text: '''
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <mirrors>
    <mirror>
      <id>custom-repo-mirror</id>
      <mirrorOf>central</mirrorOf>
      <url>http://your-custom-repo-url/repository/maven-public/</url>
    </mirror>
  </mirrors>
</settings>
        '''
        // 用这个临时settings执行构建
        sh 'mvn clean install -s settings.xml'
      }
    }
  }
}

• 私有仓库认证：如果你的自定义仓库是私有的，尽量不要在settings里写明文密码，Jenkins可以用Credentials管理账号密码，在配置settings时关联对应的凭证即可
• 验证配置生效：可以在构建步骤里加一句mvn help:effective-settings，查看实际生效的配置，确认自定义仓库已经替换了默认的Central
• 网络连通性：确保Jenkins服务器能访问到你的自定义仓库地址，避免防火墙或者网络代理的限制

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