如何手动修改Jenkins job的config.xml配置文件

Jenkins的每个任务都有对应的配置文件用于存储任务的全部配置信息，这个文件就是config.xml，当网页端的配置选项无法满足特殊需求时，手动修改这个文件是高效的解决方式。

config.xml文件的位置查找

Jenkins的任务配置文件默认存放在Jenkins的主目录下，不同安装方式的路径略有区别：

• 如果是通过系统包管理器安装的Jenkins，主目录通常在/var/lib/jenkins，对应任务的config.xml路径为/var/lib/jenkins/jobs/任务名称/config.xml
• 如果是通过war包运行的Jenkins，主目录默认是当前用户家目录下的.jenkins文件夹，路径为~/.jenkins/jobs/任务名称/config.xml
• 如果是Docker容器运行的Jenkins，需要先进入容器内部，主目录默认是/var/jenkins_home，对应路径为/var/jenkins_home/jobs/任务名称/config.xml

也可以通过Jenkins网页端的系统信息页面查看JENKINS_HOME变量的值，确认主目录的具体位置。

手动修改config.xml的步骤

1. 备份原配置文件

修改前一定要先备份原文件，避免修改错误导致任务无法使用，执行以下命令即可完成备份：

# 假设任务名称为test_job，Jenkins主目录为/var/lib/jenkins
cp /var/lib/jenkins/jobs/test_job/config.xml /var/lib/jenkins/jobs/test_job/config.xml.bak

2. 编辑配置文件

使用任意文本编辑器打开config.xml文件，比如用vim编辑：

vim /var/lib/jenkins/jobs/test_job/config.xml

修改时注意XML的语法规范，标签必须正确闭合，属性值需要用双引号包裹，不要随意删除原有的必填标签。比如要给任务添加一个自定义的环境变量，可以在<properties>标签下添加如下内容：

<hudson.model.ParametersDefinitionProperty>
  <parameterDefinitions>
    <hudson.model.StringParameterDefinition>
      <name>CUSTOM_VAR</name>
      <description>自定义环境变量</description>
      <defaultValue>test_value</defaultValue>
      <trim>false</trim>
    </hudson.model.StringParameterDefinition>
  </parameterDefinitions>
</hudson.model.ParametersDefinitionProperty>

3. 让配置生效

修改完成后保存文件，有两种方式让新配置生效：

• 方式一：重启Jenkins服务，执行命令systemctl restart jenkins（系统包安装场景）或者重启容器即可
• 方式二：不重启Jenkins，通过网页端重新加载配置，进入对应任务的配置页面，不做任何修改直接点击保存，或者访问http://ipipp.com/reload触发Jenkins重新加载所有配置（将ipipp.com替换为你的Jenkins访问地址）

常见修改注意事项

• 修改XML文件时要严格遵循XML语法，标签大小写敏感，比如<builders>不能写成<Builders>
• 不要删除Jenkins自动生成的UUID、插件相关的专属标签，否则可能导致任务无法识别或者插件功能失效
• 如果不确定修改是否正确，可以先在测试环境的Jenkins中做验证，确认无误后再在生产环境操作
• 修改后如果任务无法运行，可以查看Jenkins的系统日志，定位配置错误的具体位置

修改示例：调整任务的构建超时时间

假设要给任务设置构建超时时间为30分钟，原配置中没有相关配置，可以在<buildWrappers>标签下添加如下内容：

<hudson.plugins.build_timeout.BuildTimeoutWrapper>
  <strategy class="hudson.plugins.build_timeout.impl.AbsoluteTimeOutStrategy">
    <timeoutMinutes>30</timeoutMinutes>
  </strategy>
  <operationList>
    <hudson.plugins.build_timeout.operations.AbortOperation/>
  </operationList>
</hudson.plugins.build_timeout.BuildTimeoutWrapper>

保存后重新加载配置，任务的构建超时规则就会生效。

Jenkinsjob配置config.xml手动修改配置修改时间：2026-06-22 03:30:18