Jenkins流水线内能否本地访问RESTful API？权限及连接问题咨询

为什么curl localhost:8080/api返回连接拒绝？ #

• 若你的流水线在Jenkins代理节点（agent）上执行，此时localhost指向的是代理节点本身，而非Jenkins主节点——代理节点上未运行Jenkins服务，因此会返回连接拒绝。
• 若流水线在主节点运行仍出现该问题，可能是Jenkins服务未监听127.0.0.1，或者主节点本地防火墙拦截了8080端口。

有没有无需密钥/用户认证的Jenkins REST API本地访问方式？ #

Jenkins出于安全设计，没有原生开放无需认证的本地REST API端点，但可以通过以下几种方案实现类似需求：

1. 从流水线直接传递数据给部署脚本 #

既然你已经能通过currentBuild.getBuildCauses()等Jenkins内置函数获取信息，直接把数据传递给部署脚本是最简便的方案：

• 将数据写入临时文件供脚本读取：

  script {
    def buildCauses = currentBuild.getBuildCauses()
    writeFile file: 'build_causes.json', text: buildCauses as JsonOutput
    sh './your_deploy_script.sh build_causes.json'
  }
  

• 或者将数据作为环境变量传入脚本：

  script {
    def cause = currentBuild.getBuildCauses()[0].shortDescription
    sh "BUILD_CAUSE='${cause}' ./your_deploy_script.sh"
  }
  

2. 使用Jenkins CLI本地访问 #

在Jenkins主节点上运行流水线时，可利用jenkins-cli.jar基于本地文件权限访问API，无需额外认证：

java -jar /var/lib/jenkins/jenkins-cli.jar -s http://localhost:8080/ get-build-info ${BUILD_NUMBER}

注：jenkins-cli.jar通常位于Jenkins主目录下，路径可根据你的部署环境调整。

3. 限制范围的匿名访问（不推荐） #

如果必须使用REST API，可在Jenkins全局安全配置中，给匿名用户添加仅限本地IP的读取权限：

• 进入「Manage Jenkins」→「Configure Global Security」
• 开启「Allow anonymous read access」，并通过IP白名单插件（如IP Whitelist Plugin）限制仅127.0.0.1可访问
• 此方式存在安全风险，仅建议在完全可信的内部环境中使用

4. 用httpRequest插件自动处理认证 #

在流水线中使用httpRequest插件，它会自动利用流水线运行的上下文权限访问API，无需手动管理密钥：

script {
  def response = httpRequest url: "http://jenkins-master:8080/job/${JOB_NAME}/${BUILD_NUMBER}/api/json"
  def buildData = readJSON text: response.content
  // 将解析后的数据传递给部署脚本
}

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