Jenkins 的 config.xml 文件位于 JENKINS_HOME 目录下,保存全局配置;需先停止服务、备份、校验 XML 后再修改,常见修改项包括禁用 CSRF、调整 Jenkins URL、配置 LDAP 和全局代理。

Jenkins 的 config.xml 文件默认位于 Jenkins 主目录(JENKINS_HOME)下,路径是:$JENKINS_HOME/config.xml
这个文件保存了 Jenkins 全局配置,比如系统设置、安全策略、代理配置、插件更新站点等。修改它需要谨慎,建议先备份再操作。
怎么找到 JENKINS_HOME 目录
常见位置如下(取决于安装方式):
- Linux/macOS:通常是
/var/lib/jenkins(deb/rpm 包安装)或~/jenkins(war 包启动时指定) - Windows:一般是
C:\Program Files\Jenkins或%USERPROFILE%\.jenkins - 如果你用 Docker 启动,JENKINS_HOME 由
-v挂载路径决定,比如-v /my/jenkins:/var/jenkins_home,那 config.xml 就在/my/jenkins/config.xml
最稳妥的方式是登录 Jenkins 页面 → 点击右上角用户名 → “系统信息”,查找 hudson.home 这一项的值。
修改 config.xml 的正确步骤
不建议直接在 Jenkins 运行时编辑并保存 config.xml,容易导致配置错乱或服务异常。推荐流程:
- 停止 Jenkins 服务(如
systemctl stop jenkins或关闭 war 进程) - 备份原文件:
cp config.xml config.xml.bak - 用文本编辑器打开修改(注意 XML 格式规范,避免标签不闭合、特殊字符未转义)
- 检查语法是否合法(可用在线 XML 验证工具或命令行
xmllint --noout config.xml) - 启动 Jenkins,观察日志(
$JENKINS_HOME/logs/或系统日志)是否有解析错误
哪些配置常通过 config.xml 修改
有些设置在 Web 界面里不开放或无法生效,必须改 XML:
- 禁用 CSRF 保护(
,仅限测试环境)false - 调整 Jenkins URL(
)https://ci.example.com - 启用 LDAP 绑定账号(
块) - 设置全局代理(
节点)... - 自定义插件更新中心地址(修改
下的和镜像 URL)
基本上就这些。改完别忘了重启 Jenkins,而且每次升级 Jenkins 版本前,最好确认 config.xml 是否被新版兼容 —— 某些旧字段可能已被弃用。










